Aller au contenu
Alaisia · Studios web Un site du réseau Alaisia

Guide

Intégrer un widget chatbot sur un site internet

Où coller le script d'un chatbot sur un site internet, comment le limiter aux bonnes pages et que vérifier avant la mise en ligne.

Mis à jour le

Un widget de chatbot s'intègre presque toujours de la même façon : l'outil fournit une balise <script>, vous la placez sur les pages du site, et elle affiche une bulle en bas de l'écran. Ce qui change d'un site à l'autre, c'est l'endroit où l'on colle ce code et les blocages qui peuvent l'empêcher de fonctionner. Cette page donne la méthode générale ; WordPress, Shopify et Wix ont chacun leur page.

Trois formes d'affichage

Forme Ce que voit le visiteur Intégration habituelle
Bulle flottante Une icône en coin d'écran, qui ouvre une fenêtre Un script chargé sur toutes les pages ou sur une sélection
Fenêtre intégrée Une zone de discussion fixe dans une page Une iframe (cadre qui affiche une page externe) ou un élément que le script remplit
Page dédiée Une page « Posez votre question » hébergée par l'outil Un simple lien ou bouton

La bulle est la plus répandue. La fenêtre intégrée convient à une page d'aide. La page dédiée ne touche pas du tout au site : utile quand le client ne peut pas ajouter de code.

Où coller le code, outil par outil

Outil du site Emplacement À savoir
WordPress Extension d'insertion de code (en-tête ou pied de page) ou thème enfant Logique conditionnelle par page possible avec une extension comme WPCode. Voir le chatbot sur WordPress
Shopify Intégration d'application dans l'éditeur de thème, ou section Custom Liquid À réactiver après un changement de thème. Voir le chatbot sur Shopify
Wix Paramètres > Code personnalisé, emplacement « Corps - fin » Site publié et domaine connecté requis. Voir le chatbot sur Wix
Squarespace Injection de code, champ « Footer » Disponible dans les formules Core, Plus, Advanced et certaines anciennes formules ; pas sur les pages de paiement
Site codé à la main ou généré Juste avant </body> dans le gabarit commun À ajouter au gabarit, pas page par page

Le cas de Squarespace

L'aide Squarespace précise que le code ajouté dans le champ « Footer » est injecté avant la balise de fermeture </body> sur toutes les pages. On peut aussi injecter du code page par page (icône d'engrenage de la page, puis « Advanced »), mais seulement dans l'en-tête de la page. Trois limites à connaître : les pages de paiement n'acceptent pas de code, l'injection n'apparaît pas sur les pages d'accueil de type « Index », et l'équipe de support de Squarespace n'aide pas à ajouter ou dépanner du code personnalisé.

Charger le script sans bloquer la page

Sans attribut, un script est téléchargé et exécuté immédiatement, et le navigateur arrête de lire la page en attendant. La documentation de référence MDN décrit deux attributs qui évitent ce blocage :

  • defer : le script se télécharge pendant la lecture de la page et s'exécute une fois la page lue, dans l'ordre d'apparition ;
  • async : le script se télécharge pendant la lecture et s'exécute dès qu'il est prêt, sans ordre garanti.

Ces attributs ne fonctionnent qu'avec une balise qui pointe vers un fichier (src). Si l'outil fournit un petit code « en ligne » qui crée lui-même la balise, c'est ce code qui décide du chargement : ne le modifiez pas sans l'accord du fournisseur. Pour aller plus loin, voyez l'effet d'un chatbot sur la vitesse du site.

Ne charger l'assistant que là où il sert

Un script ajouté à toutes les pages se charge partout, y compris sur les mentions légales ou le blog. Wix permet de choisir des pages précises, WPCode de poser des conditions, Squarespace d'injecter du code page par page dans l'en-tête. Demandez-vous avec le client où une conversation a du sens : contact, tarifs, réservation, fiches produits.

Les blocages qui empêchent le widget de s'afficher

Le domaine n'est pas autorisé. Certains outils demandent la liste des domaines où le widget peut s'afficher. Dans les mesures publiées par chatbot.fr le 06/08/2026, deux widgets ont cessé de se charger faute de domaine autorisé. Pensez à ajouter le domaine de préproduction pour vos tests, puis le domaine définitif.

La politique de sécurité du contenu. Certains sites envoient un en-tête HTTP Content-Security-Policy (CSP), qui liste les sources que le navigateur a le droit de charger. Un widget de chat peut en concerner plusieurs directives :

  • script-src pour le fichier JavaScript ;
  • connect-src pour les échanges avec le serveur de l'outil ;
  • frame-src si la fenêtre est une iframe ;
  • style-src pour ses feuilles de style.

Si une directive manque, c'est default-src qui s'applique. Pour tester sans risque, l'en-tête Content-Security-Policy-Report-Only signale les violations sans rien bloquer. Demandez au fournisseur la liste de ses domaines.

L'emplacement n'existe pas dans la formule. Sur Squarespace comme sur Wix, l'ajout de code dépend de la formule ou de l'état du site. Vérifiez-le avant de promettre l'assistant dans un devis.

La recette avant livraison

Testez toujours sur la version en ligne, pas seulement dans l'éditeur :

  1. la bulle apparaît sur les pages prévues, et seulement sur elles ;
  2. elle ne recouvre aucun bouton important, sur mobile comme sur ordinateur ;
  3. la console du navigateur n'affiche pas d'erreur de chargement ou de politique de sécurité ;
  4. aucun cookie de l'outil n'est déposé avant le choix du visiteur, si l'outil en a besoin d'un (voir chatbot et consentement aux cookies) ;
  5. la fenêtre s'utilise au clavier (voir les tests d'accessibilité) ;
  6. le message d'accueil dit qu'il s'agit d'une IA (voir les mentions à ajouter au site).

Gardez dans le dossier du client le code installé, son emplacement et le compte de l'outil : c'est ce qui permettra de le retrouver lors de la prochaine maintenance.

Questions fréquentes

Où placer le script d'un chatbot dans le code d'un site ?

Là où l'indique le fournisseur. S'il ne précise rien, juste avant la balise de fermeture </body>, avec l'attribut defer : le script se télécharge pendant la lecture de la page et ne s'exécute qu'après.

Pourquoi le chatbot ne s'affiche pas alors que le script est bien collé ?

Les causes les plus fréquentes : le domaine du site n'est pas autorisé dans l'outil, une politique de sécurité du contenu (en-tête Content-Security-Policy) bloque le script, ou l'emplacement de code n'existe pas dans la formule du site (sur Squarespace par exemple).

Sources

Pages consultées pour écrire cet article :

  1. https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/script
  2. https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Content-Security-Policy
  3. https://support.squarespace.com/hc/en-us/articles/205815908-Using-code-injection
  4. https://support.wix.com/en/article/embedding-custom-code-to-your-site
  5. https://help.shopify.com/en/manual/online-store/themes/customizing-themes/apps
  6. https://wordpress.org/plugins/insert-headers-and-footers/
  7. https://www.chatbot.fr/chatbot-site-internet/

À lire aussi