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 lead capté dans le chat arrive dans votre CRM, qu’un nouveau produit soit indexé automatiquement, ou qu’un déploiement crée un bot par client : c’est le rôle de l’API.
Le widget : une ligne de script
Depuis le dashboard, ouvrez votre bot puis l’onglet Widget & 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. 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
Sur le plan Business, une clé API donne un accès complet à votre espace : création et mise à jour de bots, synchronisation des sources de connaissance, récupération des conversations et des leads. Trois usages reviennent chez nos clients :
- ✓Le CRM alimenté sans ressaisie : chaque lead capté par le formulaire du chat est récupéré et poussé dans votre outil commercial, avec l’historique de la conversation.
- ✓Les contenus toujours à jour : une automatisation resynchronise les sources quand votre catalogue, vos tarifs ou vos fiches changent, sans passer par le dashboard.
- ✓Le déploiement multi-clients pour les agences : un bot créé et configuré par client depuis vos propres scripts, puis livré en marque blanche.
Où trouver la référence
La clé API se génère dans les réglages du dashboard, et la référence complète des appels (ressources, paramètres, exemples) est publiée dans le dashboard, section API. 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 ; resynchronisez, ou passez au RAG illimité du plan Business.