Intégrer un Chatbot IA sur votre site web

Intégration sur un Site web

Il s'agit de la méthode universelle pour ajouter votre chatbot à n'importe quel site web. Vous collez deux courtes lignes dans le code HTML de votre site : une balise <script> qui charge le widget, et un élément <web-chat-agent> qui lui indique quel chatbot afficher. C'est tout, la bulle de chat flottante apparaît dans le coin de chaque page où le code est exécuté.

Si vous utilisez WordPress, TYPO3, Shopify, Wix, Squarespace ou Webflow, consultez plutôt le guide dédié à votre plateforme, il indique exactement où coller ce même code.

Où trouver votre Identifiant du chatbot

Vous n'avez jamais besoin de saisir l'identifiant à la main. Dans le tableau de bord WebChatAgent :

  1. Ouvrez votre chatbot.
  2. Allez dans Canaux → Widget de chat et développez Afficher les détails d’installation.
  3. Cliquez sur le bouton copier dans la zone de code.

L'extrait copié contient déjà votre Identifiant du chatbot, il suffit donc de le coller. (Si vous avez besoin de l'identifiant brut seul, il s'agit de la longue chaîne dans l'URL de votre tableau de bord : /dashboard/<your-chatbot-id>.)

Le code à coller

Collez ceci juste avant la balise fermante </body> de votre site :

<script src="https://webchatagent.com/widget/web-chat-agent.js" async></script>
<web-chat-agent chatbot-id="YOUR_ID"></web-chat-agent>

Remplacez YOUR_ID par votre Identifiant du chatbot (ou, plus simplement, copiez l'extrait prêt à l'emploi depuis le tableau de bord pour que l'identifiant soit déjà renseigné). Le widget se charge de manière asynchrone, il ne ralentira donc pas votre page, et il apparaît sous la forme d'un bouton de chat flottant dans le coin inférieur.

Attributs facultatifs

Le widget récupère ses couleurs, son titre, son message de bienvenue et son comportement à partir des paramètres de votre tableau de bord, vous n'avez donc normalement besoin que de chatbot-id. Pour remplacer directement certains éléments dans le HTML, ajoutez ces attributs à l'élément <web-chat-agent> :

  • chatbot-id, votre Identifiant du chatbot. Obligatoire.
  • theme, style visuel : "default" ou "modern". La valeur par défaut est "default".
  • initially-open, définissez sur "true" pour ouvrir le chat automatiquement au chargement de la page. La valeur par défaut est "false" (fermé).
  • tracking-consent, signal de consentement facultatif pour une personnalisation persistante : "unknown", "denied" ou "granted". S'il est omis, la valeur par défaut est "unknown" et les déclencheurs géographiques anonymes continuent de fonctionner.
  • context-data, contexte de session de votre page pour l'IA (par exemple "Customer=Acme GmbH;OrderID=A-1023"), utile lorsque le widget s'exécute dans un CRM ou un espace connecté. Formats, limites et remarques de sécurité dans le guide pour développeurs.
<web-chat-agent
  chatbot-id="YOUR_ID"
  theme="modern"
  initially-open="false"
></web-chat-agent>

Tout le reste, couleur de la marque, avatar, polices, position et comportement, est configuré sous Canaux → Widget de chat, vous n'avez donc pas besoin de modifier à nouveau le code pour changer le style du widget. La personnalité de l'assistant est configurée sous Paramètres → Style de réponse et rôle.

Consentement aux cookies et déclencheurs proactifs

Le widget n'ajoute pas de deuxième bannière de cookies. Sans signal de consentement, il fonctionne en mode de confidentialité anonyme : les déclencheurs de durée, de défilement, d'intention de sortie, d'inactivité, d'URL, de visibilité et de clics compulsifs sont évalués localement en mémoire. La reconnaissance des visiteurs récurrents, les compteurs persistants, les analyses proactives et les messages d'accueil générés par l'IA attendent un signal granted.

Consultez Consentement aux cookies et déclencheurs proactifs anonymes pour obtenir la matrice complète des comportements, des exemples de CMP et la référence de stockage.

Intégrer le chat directement dans la page

L'extrait ci-dessus vous fournit un bouton flottant. Si vous préférez placer le chat dans la mise en page de votre page, par exemple un volet de chat complet sur une page d'assistance dédiée, utilisez le widget intégré. Il charge un script différent et un élément différent :

<script src="https://webchatagent.com/widget/chat-widget-inline.js" async></script>
<web-chat-agent-inline chatbot-id="YOUR_ID"></web-chat-agent-inline>

Le chat intégré s'affiche là où vous placez l'élément, placez-le donc à l'intérieur du conteneur où vous souhaitez voir apparaître le chat. Consultez le guide du Chat intégré pour les détails de mise en page.

Fonctionne partout

Les deux extraits utilisent du simple HTML et un élément personnalisé, ils fonctionnent donc sur toutes les plateformes de sites web : WordPress, TYPO3, Shopify, Wix, Squarespace, Webflow et les sites codés à la main en HTML/JS. Collez le code dans le code HTML de votre site et publiez.

Dépannage

  • Le widget n'apparaît pas ? Vérifiez que le code se trouve bien dans le code HTML de la page (avant </body>) et que vous avez publié la page ou vidé le cache de votre extension de mise en cache. Vérifiez dans la console du navigateur si des scripts sont bloqués.
  • Affichage sur une seule page ? Placez l'extrait à un emplacement global sur tout le site (pied de page ou code global), et non sur une seule page.