Deux façons d’intégrer un chatbot IA
La question « comment intégrer une API de chatbot à mon site » cache deux besoins différents. Le premier est d’afficher un assistant qui répond aux visiteurs : c’est le rôle du widget, et il ne demande aucune ligne de code métier. Le second est de relier le chatbot au reste de votre système, pour qu’un contact capté dans le chat arrive dans votre CRM, ou que vos conversations alimentent vos tableaux de bord : c’est le rôle du webhook et de l’API.
Le widget : une ligne de script
Depuis le dashboard, ouvrez votre bot puis l’onglet Intégration. Le snippet s’affiche avec son identifiant ; collez-le avant la balise de fin de body :
<script src="https://dashboard.causeriebot.com/widget.js"
data-id="VOTRE_IDENTIFIANT_DE_BOT"
data-url="https://dashboard.causeriebot.com" defer></script>- ✓WordPress : le plugin officiel sur wordpress.org, ou le snippet dans footer.php. Le guide complet est sur la page chatbot WordPress.
- ✓Shopify : theme.liquid, juste avant la fin de body.
- ✓Webflow : Custom Code, section Footer.
- ✓Wix : Code personnalisé, zone Corps.
- ✓HTML, Next.js, Squarespace, PrestaShop : le même script, au même endroit.
Le bot apparaît immédiatement, et le guide complet du widget chatbot détaille les réglages, la performance et les pannes courantes. Le widget ne contient aucune clé secrète : l’attribut data-id identifie votre bot, rien de plus, et peut donc être rendu public sans risque.
L’API Causerie : ce qu’elle permet
Une clé API, créée sur n’importe quel plan, donne un accès en lecture à vos chatbots, y compris ceux partagés avec vous : la liste des bots sur tous les plans, puis, dès le plan Pro, les contacts, les conversations, et le détail de chacune avec ses messages. Elle ne crée ni ne modifie de bot, et ne touche pas aux sources. Elle s’appelle depuis un serveur, jamais depuis une page web :
curl "https://dashboard.causeriebot.com/api/public/leads?since=2026-09-01T00:00:00Z&limit=100" \
-H "Authorization: Bearer csb_live_VOTRE_CLE"- ✓
GET /api/public/chatbots: vos chatbots. - ✓
GET /api/public/leads: les contacts, du plus ancien au plus récent. - ✓
GET /api/public/conversations: les conversations, sans les messages. - ✓
GET /api/public/conversations/{id}: une conversation avec ses messages et son contact. - ✓Paramètres des listes :
chatbot_id,since(date ISO 8601),limit(1 à 200, 50 par défaut) etcursorpour la page suivante.
Deux usages reviennent. Le CRM alimenté sans ressaisie : le webhook envoie chaque contact à votre CRM, à Zapier, Make ou n8n dès sa création, et l’API rattrape l’historique avec since. Les tableaux de bord : les conversations et leurs messages, récupérés pour vos analyses ou vos archives.
Où trouver la référence
La clé API se crée dans le dashboard, Paramètres puis Clés API, et la référence complète (réponses, erreurs, signature du webhook, exemples Node.js et PHP) est sur la page Intégrations du dashboard. Elle évolue avec le produit ; c’est la source à jour, ce guide ne la duplique pas.
Tout construire soi-même sur l’API OpenAI ou Mistral
C’est possible, et c’est ce que nous faisions avant de créer Causerie : des chatbots sur mesure branchés sur l’API OpenAI, intégrés dans le code du site. Le principe tient en trois briques : un serveur intermédiaire qui reçoit la question du visiteur (la clé du modèle ne doit jamais se trouver dans le code envoyé au navigateur), une couche qui retrouve les passages pertinents de vos contenus pour les fournir au modèle, et l’appel au modèle lui-même avec des instructions strictes. Voici ce qui reste à votre charge une fois ces trois briques écrites :
- ✓indexer vos pages et vos documents, puis les réindexer à chaque changement (c’est le poste qui coûte le plus dans la durée) ;
- ✓écrire et maintenir les garde-fous : sujets interdits, formulation des refus, transfert vers un humain ;
- ✓capter les demandes (formulaire, email, export) et donner au client une vue sur les conversations ;
- ✓surveiller le coût par requête, les quotas et les pannes du fournisseur, et tenir la conformité RGPD (hébergement, durée de conservation, droits des utilisateurs).
Notre expérience : ça marchait, mais chaque mise à jour d’un tarif ou d’une prestation demandait une intervention technique, et le client n’avait aucune visibilité sur ce que le bot racontait. Causerie existe pour régler ces deux points : l’autonomie du client sur ses contenus, et la transparence sur les conversations. Le guide comment fonctionne un chatbot IA détaille la mécanique sans jargon.
Les erreurs d’intégration les plus fréquentes
- ✓« Invalid token » : clé expirée, régénérée ou mal copiée. Le guide de dépannage donne les six causes et la méthode.
- ✓Widget invisible : snippet collé au mauvais endroit, cache non purgé, ou bot désactivé dans le dashboard.
- ✓Clé exposée : une clé API dans un fichier JavaScript public est lisible par n’importe qui. Elle se garde côté serveur, jamais dans le navigateur.
- ✓Réponses à côté : les sources ne sont pas à jour ou la jauge de contexte est saturée ; réimportez les pages qui ont changé, ou passez les gros contenus en mode Sémantique (dès Essentiel, base sans limite sur Business).
