Guide d'intégration développeur
Aperçu pour les développeurs
WebChatAgent vous propose trois méthodes pour intégrer un Chatbot auprès de vos utilisateurs. Choisissez l'option adaptée au niveau de contrôle souhaité sur l'interface.
| Intégration | Ce que vous obtenez | Idéal pour |
|---|---|---|
| Intégration du Widget | Une interface de chat prête à l'emploi via une seule balise script | Sites web et applications web |
| API REST | Envoyez un message, recevez une réponse (requête/réponse) | Interfaces personnalisées, applications mobiles, scripts serveur |
| API WebSocket | Flux de messages en temps réel avec indicateurs de frappe et présence | Tableaux de bord de Chat en direct, outils pour agents |
Les trois méthodes communiquent avec le même Chatbot, partagent la même Base de connaissances et sont décomptées du même quota de messages. Vous pouvez les combiner, par exemple en intégrant le Widget sur votre site tout en créant un Tableau de bord d'agent interne via l'API WebSocket.
Intégration du Widget (le plus rapide)
Ajoutez le Chatbot à n'importe quel Site web à l'aide d'une seule balise script et d'un élément HTML personnalisé (<web-chat-agent chatbot-id="...">). Aucun framework ni étape de compilation n'est requis. Toutes les couleurs, les textes et les Outils sont configurés dans le Tableau de bord et appliqués automatiquement. C'est le choix adapté pour 90 % des sites web.
- Guide d'intégration du Widget — Balise script, élément personnalisé, ensemble des attributs HTML, CSS personnalisé, mode intégré et utilisation au sein d'une SPA
API REST
Lorsque vous devez concevoir votre propre interface de chat, qu'il s'agisse d'une application mobile, d'un composant web personnalisé ou d'une automatisation backend, appelez directement le point de terminaison de chat. Vous envoyez un champ message ainsi que votre chatbotId, puis recevez une réponse reply générée par l'IA accompagnée de ses sources. Un ID de session renvoyé dans l'en-tête de réponse assure la continuité des conversations à plusieurs tours.
- Référence de l'API REST — Points de terminaison, authentification par Domaine, champs de requête/réponse, codes d'erreur et exemples de code en cURL, JavaScript, Python et PHP
API WebSocket
Conçue pour le Chat en direct, lorsque les messages doivent parvenir instantanément et que vous souhaitez afficher les indicateurs de frappe, la présence et la Traduction automatique. Le même socket alimente les widgets des visiteurs et le Tableau de bord des agents. Utilisez-le pour concevoir une console d'agent personnalisée ou pour gérer le Chat en direct depuis votre propre backend.
- Référence de l'API WebSocket — Connexion, rôles, événements émis et reçus, ainsi qu'un exemple complet de client fonctionnel
Quelle option utiliser ?
| Cas d'usage | Recommandé |
|---|---|
| Ajouter un Chatbot à un Site web | Intégration du Widget |
| Intégrer le chat directement dans la mise en page de votre site | Chat intégré (intégration du Widget) |
| Interface de chat personnalisée ou application mobile | API REST |
| Automatisation de Serveur à Serveur (sans interface graphique) | API REST |
| Tableau de bord de Chat en direct en temps réel pour agents humains | API WebSocket |
Consultez la section Cas d'usage pour découvrir des scénarios concrets rendus possibles par ces intégrations.