Installer sur votre site

Une fois votre agent indexé, l'ajouter à votre site se résume à une seule balise de script. Trouvez votre extrait dans Widget → Script.

L'extrait d'intégration

Collez ceci juste avant la balise de fermeture </body> sur chaque page où vous voulez afficher le widget de chat :

<script
  src="https://botchata.net/api/widget.js"
  data-api-key="YOUR_KEY"
  data-api-url="https://botchata.net/api"
  defer
></script>

Le widget se charge de manière asynchrone (defer) et ne ralentit pas votre page. Il est rendu dans un Shadow DOM, il ne peut donc pas entrer en conflit avec le CSS de votre site.

Instructions par plateforme

Plateforme	Où coller
WordPress	Appearance → Theme File Editor → `footer.php`, avant `</body>` (ou une extension de scripts header/footer)
Shopify	Online Store → Themes → Edit code → `theme.liquid`, avant `</body>`
Wix	Settings → Custom Code → Add Custom Code → « Body - end »
Squarespace	Settings → Advanced → Code Injection → Footer
Webflow	Project Settings → Custom Code → Footer Code
Tilda	Réglages du site → Plus → Code HTML pour `<body>`
HTML personnalisé	Directement avant `</body>` dans votre modèle

Ajoutez le script sur chaque page (généralement dans le pied/modèle partagé), pas seulement sur la page d'accueil, pour que le widget soit disponible partout.

Vérifier qu'il est en ligne

Rechargez votre site — la bulle de chat devrait apparaître en bas à droite.

Vous ne la voyez pas ? Affichez le code source (Ctrl+U) et vérifiez que la balise de script est présente et que data-api-key n'est pas vide. Vérifiez la console du navigateur pour des erreurs et assurez-vous que le script n'est pas bloqué par un bloqueur de contenu.

Transmettre l'identité du visiteur (optionnel)

Si votre site sait déjà qui est le visiteur (il est connecté), transmettez son nom et son e-mail pour que le bot le salue par son nom et pré-remplisse les formulaires de prospect et de réservation :

<script
  src="https://botchata.net/api/widget.js"
  data-api-key="YOUR_KEY"
  data-api-url="https://botchata.net/api"
  data-user-name="Jean Dupont"
  data-user-email="jean@example.com"
  defer
></script>

Rendez ces attributs côté serveur depuis votre système d'authentification. Les valeurs sont transmises à l'IA comme contexte de visiteur identifié.

Persistance de session

Le widget mémorise la conversation de chaque visiteur pendant 48 heures (par navigateur). À son retour ou lorsqu'il navigue vers une autre page, la conversation précédente et l'historique des messages sont restaurés automatiquement.

Les sessions sont stockées dans le localStorage du navigateur, cloisonnées par clé API — ainsi, si vous exécutez plusieurs bots sur la même page, leurs conversations ne se mélangent jamais. Le visiteur peut toujours recommencer avec le bouton « Nouvelle conversation » dans l'en-tête du widget.

Plusieurs bots sur une page

Vous pouvez placer plusieurs scripts de widget sur la même page (p. ex. un bot commercial et un bot support), chacun avec sa propre data-api-key. Ils fonctionnent indépendamment et tiennent des conversations distinctes.

Supprimez la balise de script de votre modèle. Le widget disparaît au prochain chargement de page — il n'y a rien d'autre à nettoyer.