Aller au contenu

Installer un agent IA sur n'importe quel site avec une ligne de code

Une balise script suffit à installer le widget de chat sur n'importe quel site. Où la coller, comment la vérifier, et que faire si rien ne s'affiche.

Widget et intégration6 min de lecture

Pour une agence, l’installation est souvent le moment où un projet simple devient compliqué. Le site du client tourne sur un CMS que vous ne connaissez pas, l’accès à l’hébergement passe par un prestataire, et le moindre module à installer demande trois échanges d’e-mails. Un assistant IA qui exige une intégration lourde a peu de chances d’être déployé sur beaucoup de sites.

blabla.bot a fait le choix inverse : le widget s’installe avec une seule balise <script>, la même pour tous les sites. Cet article explique où la coller, ce qu’elle fait réellement, et comment vérifier que tout fonctionne.

La ligne à coller

Le code d’intégration ressemble à ceci :

<script src="https://…/loader.js" data-bb-public-key="pk_…" async></script>

Il contient deux informations :

  • l’adresse du script, identique pour tous les sites ;
  • la clé publique du site (data-bb-public-key), qui indique à quel site et donc à quel agent ce widget correspond.

La console vous donne ce code, prêt à copier, avec la bonne clé. Collez-le dans les pages du site, juste avant la balise de fermeture </body>.

L’attribut async demande au navigateur de télécharger le script sans bloquer l’affichage de la page, puis de l’exécuter dès qu’il est disponible. Le contenu du site s’affiche donc normalement, même si le widget arrive un instant après.

Ce que fait cette ligne, concrètement

Le script est volontairement petit et ne dépend d’aucune bibliothèque. Son fonctionnement se résume en trois temps.

  1. Il affiche le bouton du chat, en bas à droite ou en bas à gauche selon le réglage choisi. Ce bouton est isolé du reste de la page (on parle de Shadow DOM) : les styles du site ne le déforment pas, et ses propres styles ne débordent pas sur le site.
  2. Il ouvre la session au premier clic. C’est seulement quand le visiteur clique que la fenêtre de discussion est créée, dans une iframe, c’est-à-dire un cadre séparé de la page. Un visiteur qui n’ouvre pas le chat ne déclenche aucune conversation.
  3. Il vérifie l’adresse du site. Le serveur compare l’adresse de la page à la liste des adresses autorisées pour ce site. Si elle ne correspond pas exactement, le widget ne s’ouvre pas.

Ce dernier point mérite une explication. La clé publique n’est pas un secret : elle est visible dans le code de la page, par définition. La protection vient de la liste d’adresses autorisées, qui empêche un autre site de copier votre code et d’utiliser l’agent à vos frais.

Où coller le code selon le site

Le principe est toujours le même : trouver l’endroit où l’outil permet d’ajouter du code personnalisé à toutes les pages.

Type de siteOù chercher
Site sur mesureLe gabarit commun des pages (pied de page, layout)
CMS avec thèmeLes réglages du thème ou une zone « code personnalisé » du pied de page
Constructeur de sites en ligneLes paramètres du site, rubrique code personnalisé ou intégrations
Gestionnaire de balisesUne balise HTML personnalisée déclenchée sur toutes les pages

Les noms exacts changent d’un outil à l’autre et d’une version à l’autre. En cas de doute, la documentation de l’outil, à la rubrique « ajouter un script », donne la marche à suivre. Des extensions dédiées pour certains CMS font partie des pistes envisagées, sans calendrier : aujourd’hui, la balise script est la méthode d’installation.

Vérifier l’installation en cinq étapes

  1. Publiez la page et ouvrez-la dans une fenêtre de navigation privée, pour éviter le cache.
  2. Cherchez le bouton en bas de l’écran, du côté choisi dans l’apparence.
  3. Cliquez dessus : la fenêtre doit s’ouvrir avec le message d’accueil, s’il en existe un.
  4. Posez une question dont vous connaissez la réponse sur le site, et vérifiez que les sources affichées sont les bonnes.
  5. Testez sur mobile : la fenêtre doit rester utilisable sur un petit écran.

Si rien ne s’affiche

Dans la très grande majorité des cas, la cause est l’une des suivantes.

L’adresse ne correspond pas. La vérification est exacte : https://www.exemple.fr et https://exemple.fr sont deux adresses différentes, tout comme http et https. Vérifiez que l’adresse sur laquelle le site est réellement servi est bien celle autorisée pour ce site. La console l’indique au moment de l’installation.

Le code n’est pas sur la page. Certains outils n’injectent le code que sur une partie des pages, ou seulement après publication. Affichez le code source de la page et cherchez data-bb-public-key.

Une politique de sécurité bloque le script. Si le site déclare une politique de sécurité du contenu (en-tête Content-Security-Policy), elle doit autoriser l’adresse du script dans la directive script-src et celle de la fenêtre de discussion dans frame-src. C’est fréquent sur les sites bien sécurisés, et c’est une bonne nouvelle : il suffit d’ajouter ces deux adresses.

Le compte n’a plus de crédits, ou le site a atteint son budget. Dans ce cas, le widget s’ouvre, mais au moment de répondre il indique que l’assistant fait une pause, sans détail pour le visiteur, et peut proposer de laisser un message à l’équipe. L’état apparaît dans votre portefeuille.

Ce que l’installation ne change pas

L’installation n’est faite qu’une fois. Ensuite, vous modifiez l’agent depuis la console, sans toucher au site :

  • les connaissances (ajout ou ré-indexation de pages et de PDF) ;
  • le comportement (mission, ton, sujets interdits) ;
  • l’apparence (couleur, logo, position, message d’accueil, questions suggérées) ;
  • l’option IA.

Pour l’apparence, les visiteurs voient les changements à la prochaine ouverture du widget. C’est un argument fort auprès d’un client : vous n’avez pas besoin d’un nouvel accès au site pour faire évoluer son assistant.

Le petit plus pour les visiteurs

Une fois la conversation lancée, le widget la garde en mémoire dans le navigateur du visiteur, d’une page à l’autre et après un rechargement. Si ce stockage est bloqué, par exemple en navigation privée stricte, le widget fonctionne de la même façon, simplement sans mémoire entre deux pages.

En résumé

Une seule ligne, collée avant </body>, suffit à installer l’agent sur un site, quel que soit l’outil qui le fait tourner. Le script est léger, isolé de la page, et il ne s’ouvre que sur les adresses autorisées. Si rien ne s’affiche, vérifiez d’abord l’adresse exacte du site, puis la présence du code et l’éventuelle politique de sécurité.

D’autres questions sur l’intégration ? La FAQ regroupe les réponses les plus fréquentes.

Sources

Mots-clés

  • widget
  • intégration
  • script
  • CMS