Ajouter ChatLab à votre site Web permet aux visiteurs d'interagir directement avec votre chatbot IA sur votre site. Ce guide vous explique comment récupérer le code d'intégration et l'ajouter à votre site Web.
Avant de commencer
Créez et entraînez votre chatbot avant de le mettre à la disposition des clients. Pour l'installation, vous devez également disposer des droits pour modifier et publier le site Web. Consultez Comment créer votre premier chatbot.
Ouvrir l'onglet Test & Deploy
Sélectionnez votre chatbot depuis le tableau de bord principal, puis cliquez sur l'onglet Test & Deploy (Tester et déployer). Vous pouvez aussi cliquer sur le bouton vert Test chatbot (Tester le chatbot) sur la page Overview (Aperçu) du chatbot. L'onglet comporte deux parties :
- Test (à gauche) - votre chatbot fonctionne en direct sur une scène qui simule votre site web, ce qui vous permet de l'essayer avant que les visiteurs ne le voient. En mode Widget, la fenêtre de chat s'affiche dans le coin inférieur droit à sa taille réelle, avec l'icône de chat en dessous, exactement comme les visiteurs la verront. Le sélecteur Widget / Frame situé dans le coin supérieur droit de la scène bascule vers Frame, le chat toujours ouvert fourni par le code iframe.
- Deploy (à droite) - vous y choisissez la plateforme de site web ou le canal de messagerie et suivez ses instructions. En dessous, Share a test link (Partager un lien de test) vous donne des liens à envoyer à d'autres personnes (voir Envoi d'un lien vers votre chatbot).
Votre site web derrière le chatbot
Lorsque votre chatbot est entraîné sur un seul site web, la scène affiche une capture d'écran de ce site derrière la fenêtre de chat, afin que vous puissiez voir à quoi ressemble le chatbot sur vos propres pages. La capture d'écran est effectuée une seule fois lorsque vous ouvrez l'onglet pour la première fois (en attendant qu'elle soit prête, la scène affiche un contour de page neutre, et le chatbot fonctionne déjà) et elle est conservée ; une nouvelle capture n'est prise que si vous modifiez l'adresse. Les chatbots entraînés sur plusieurs sites web, ou uniquement sur des fichiers et du texte, affichent à la place un contour de page neutre.
Cliquez sur l'adresse du site web en haut de la scène pour gérer l'arrière-plan :
- Website address (Adresse du site web) avec Save (Enregistrer) - affiche une autre page, par exemple une page produit. Try again (Réessayer) permet de relancer une capture d'écran ayant échoué.
- Hide background (Masquer l'arrière-plan) / Show background (Afficher l'arrière-plan) - active ou désactive la capture d'écran sans la supprimer.
- Remove background (Supprimer l'arrière-plan) - supprime la capture d'écran. La scène affiche le contour neutre jusqu'à ce que vous saisissiez à nouveau une adresse.
L'arrière-plan n'est qu'un aperçu dans le panneau d'administration. Il ne modifie rien sur votre site web.
Choisir votre plateforme
Sous Where do you want to add the chatbot? (Où souhaitez-vous ajouter le chatbot ?), la section Deploy (Déployer) répertorie les destinations prises en charge réparties en trois groupes : Website (Site web), pour installer le chatbot sur les pages que vous contrôlez, Online store platforms (Plateformes de boutique en ligne - cliquez sur le titre pour dérouler la liste), et Messaging channels (Canaux de messagerie), pour le connecter à un compte de messagerie existant. Cliquez sur l'option correspondant à l'endroit où vous voulez afficher le chatbot pour consulter les instructions dédiées.
Plateformes prises en charge :
- HTML Code - fonctionne avec tout site web où vous pouvez modifier le code HTML
- WordPress - via l'extension officielle ChatLab ou par insertion manuelle du code
- Wix - via Settings > Custom Code (Paramètres > Code personnalisé)
- Webflow - via Site settings > Custom code (Paramètres du site > Code personnalisé), avec l'accès au code personnalisé activé pour votre site ou votre espace de travail
- PrestaShop - via le module PrestaShop de ChatLab ou par insertion manuelle du code
- Shopify - via l'application ChatLab depuis le Shopify App Store (un embed d'application dans votre thème) ou par ajout manuel du code dans le fichier theme.liquid
- WooCommerce - via l'extension WordPress ou par insertion manuelle du code
- Shoper - via l'application ChatLab depuis le Shoper App Store ou par insertion manuelle du code
- Abicart - via Store design > Themes > Site header
- Ecwid - via Website > Overview > Custom JavaScript code
- CS-Cart - via le module complémentaire ChatLab ou par code manuel dans Design > Layouts > Custom HTML code
- BigCommerce - ajouté automatiquement dès la connexion de la boutique, ou via Storefront > Script Manager
Canaux de messagerie :
- WhatsApp Business - répond sur un compte WhatsApp Business, voir WhatsApp for Business
- Facebook Messenger - répond aux messages de votre page Facebook, voir Integration with Facebook Messenger
- Instagram - répond aux messages directs Instagram, voir Integration with Instagram
Les canaux de messagerie n'utilisent pas le code d'intégration ci-dessous. Ils sont connectés à un compte que vous possédez déjà, aucun code n'est donc à coller sur un site web.
Chaque plateforme présente des instructions pas à pas propres à cette intégration. Pour les plateformes disposant d'articles d'aide dédiés, un lien View full instructions (Voir les instructions complètes) apparaît en bas.
Ajouter via HTML Code
L'option HTML Code fonctionne avec n'importe quel site Web sur lequel vous avez accès au code source. Deux options d'intégration vous seront proposées : Widget et Iframe.
Mode Widget
L'onglet Widget affiche le code permettant d'ajouter une icône de chat sur votre site Web. Lorsque les visiteurs cliquent sur l'icône, une fenêtre de chat s'ouvre.
- Cliquez sur l'onglet Widget
- Cliquez sur Copy to clipboard (Copier dans le presse-papiers) pour copier le code
- Repérez la section
<head>de votre site Web - Collez le code comme dernier élément de la section
<head> - Actualisez votre navigateur pour vérifier que l'icône du chatbot apparaît bien
Mode Iframe
L'onglet Iframe affiche le code qui intègre le chatbot directement au cœur du contenu de votre page. Le chatbot reste toujours visible et peut être entouré d'autres éléments de la page.
- Cliquez sur l'onglet Iframe
- Cliquez sur Copy to clipboard (Copier dans le presse-papiers) pour copier le code
- Collez le code à l'endroit de votre code HTML où vous souhaitez que le chatbot apparaisse
- Ajustez les attributs
widthetheightpour adapter le rendu à votre mise en page
Vous hésitez sur le choix à faire ? Consultez l'article Quelle est la différence entre widget et Iframe ? pour obtenir une comparaison détaillée.
Ajouter via une extension ou une application : WordPress, WooCommerce, PrestaShop, Shopify, Shoper et CS-Cart
Pour ces six plateformes, ChatLab propose sa propre extension, module, application ou add-on. Une fois connecté à votre chatbot, il ajoute automatiquement le chatbot à votre site, sans aucun code à copier. Pour les boutiques en ligne, il connecte également la boutique, permettant au chatbot de rechercher vos produits et de vérifier le statut des commandes. Coller le code manuellement reste possible comme alternative, mais cela affiche uniquement le widget de chat.
Lorsque vous sélectionnez l'une de ces plateformes, deux onglets apparaissent : Plugin Installation (Installation via extension, recommandé) et Manual Installation (Installation manuelle).
Installation via extension (recommandé)
- Cliquez sur le bouton en haut de l'onglet Plugin Installation : Get the plugin on WordPress.org pour WordPress et WooCommerce, Download the ChatLab module (.zip) pour PrestaShop, Get the app in the Shopify App Store pour Shopify, Get the app in the Shoper App Store pour Shoper, ou Download the ChatLab add-on (.tgz) pour CS-Cart. Le bouton PrestaShop n'ouvre pas de page de marketplace - il télécharge le module sur votre ordinateur sous la forme d'un fichier ZIP unique (
chatlab.zip), que vous importerez dans votre boutique à l'étape suivante. - Installez l'extension, le module, l'application ou l'add-on ChatLab dans le panneau d'administration de votre site. Pour PrestaShop, ouvrez Modules > Module Manager > Upload a module (Modules > Gestionnaire de modules > Installer un module) dans votre back-office PrestaShop et sélectionnez le fichier ZIP téléchargé. Le guide complet pour PrestaShop se trouve dans How to add chatbot to PrestaShop. Pour CS-Cart, ouvrez Add-ons > Downloaded add-ons, choisissez Manual installation dans le menu en forme d'engrenage et importez le fichier téléchargé.
- Ouvrez ChatLab à cet endroit, connectez-vous avec votre compte ChatLab et sélectionnez ce chatbot lorsqu'on vous le demande. Pour PrestaShop, cliquez sur Configure (Configurer) sur le module installé, puis sur Connect my store. Pour CS-Cart, ouvrez Marketing > ChatLab AI Chatbot et cliquez sur Continue. Pour une boutique WooCommerce, laissez cochée l'option WooCommerce integration afin que les données de la boutique soient également connectées.
- La connexion se termine automatiquement et le chatbot apparaît sur votre site. Sur Shopify, ouvrez également Online Store > Themes > Customize > App embeds (Boutique en ligne > Thèmes > Personnaliser > Intégrations d'applications), activez ChatLab AI Chat et enregistrez. Ouvrez votre site et envoyez un message de test.
Chaque plateforme dispose d'un guide dédié avec chaque étape et des captures d'écran :
- WordPress - How to add your chatbot to WordPress website
- PrestaShop - How to add chatbot to PrestaShop
- WooCommerce - Integration with WooCommerce
- Shopify - Integration with Shopify
- Shoper - Integration with Shoper
- CS-Cart - Integration with CS-Cart
Shoper
Sélectionnez Shoper dans la liste des plateformes de la section Deploy (Déployer). Dans l'onglet Plugin Installation, cliquez sur Get the app in the Shoper App Store pour ouvrir l'application gratuite ChatLab dans le Shoper App Store.
- Installez l'application gratuite ChatLab depuis le Shoper App Store. Vous pouvez également la trouver dans votre administration Shoper sous Add-ons and integrations > Applications.
- Ouvrez l'application ChatLab dans votre administration Shoper. Le panneau ChatLab s'ouvre dans une nouvelle fenêtre.
- Définissez votre mot de passe, ou connectez-vous avec votre compte ChatLab, puis connectez la boutique à ce chatbot lorsqu'on vous le demande.
- Votre boutique se connecte automatiquement et le chatbot apparaît sur votre vitrine.
Pour ajouter uniquement le widget de chat sans l'application, passez à Manual Installation, copiez le code, puis dans votre administration Shoper, allez dans Add-ons and integrations > Custom integrations, collez le code dans le champ Page header et enregistrez. Actualisez votre boutique pour vérifier que le chatbot s'affiche. Pour le guide complet, consultez Integration with Shoper.
Installation manuelle
Passez à Manual Installation, copiez le code et collez-le dans l'en-tête de votre site en suivant les étapes indiquées pour votre plateforme. Pour WordPress et WooCommerce, cela s'effectue à l'aide d'une extension d'insertion de code comme Insert Headers and Footers. Publiez vos modifications et testez le chat. N'installez le chatbot qu'une seule fois, en utilisant soit l'extension ou l'application, soit le code manuel, mais pas les deux.
Ajouter via d'autres plateformes
Pour Wix, Webflow et Abicart, aucun plugin n'est à installer : vous collez vous-même le code sur votre site. Pour Ecwid, l'application ChatLab de l'Ecwid App Market connecte la boutique à votre chatbot ; si le widget de chat n'apparaît pas sur votre boutique en ligne, collez le code dans Custom JavaScript code (code JavaScript personnalisé), ou dans le site web où votre boutique est intégrée. Pour BigCommerce, ChatLab ajoute le widget pour vous lorsque la boutique est connectée avec l'accès au contenu ; sinon, collez le code dans le Script Manager (gestionnaire de scripts). Sélectionnez la plateforme dans la section Deploy (Déployer) pour voir :
- Le code d'intégration avec les options Widget et Iframe
- Les instructions de collage étape par étape spécifiques à la plateforme
- Un lien View full instructions (Voir toutes les instructions) vers le guide complet de la plateforme
Guides complets pour ces plateformes :
- Comment ajouter votre chatbot à un site Wix
- Comment ajouter votre chatbot à un site Webflow
- Intégration avec Abicart
- Intégration avec Ecwid
- Intégration avec BigCommerce
Conformité RGPD
Si vous devez faire en sorte que votre chatbot ne se charge qu'après l'obtention du consentement aux cookies, consultez Configurer ChatLab pour la conformité RGPD pour accéder aux guides d'intégration de CookieBot, Usercentrics et Google Tag Manager.
Content Security Policy (CSP)
Si votre site Web utilise des en-têtes Content Security Policy, vous devez autoriser les domaines de ChatLab pour que le chatbot puisse fonctionner. Les directives nécessaires varient selon que vous utilisez le mode Widget ou le mode Iframe.
Mode Widget
Le widget charge un script sur votre page qui génère l'interface de chat. Fusionnez les origines ChatLab suivantes avec vos directives CSP existantes ; ne remplacez pas la politique du reste de votre site Web :
script-src https://script.chatlab.com;
style-src https://script.chatlab.com https://fonts.googleapis.com 'unsafe-inline';
connect-src https://api.chatlab.com wss://api.chatlab.com;
font-src https://fonts.gstatic.com;
Par défaut, le widget injecte certains styles en ligne (inline). Votre politique doit également autoriser le script de configuration en ligne, par exemple à l'aide d'un nonce CSP ou d'un hachage. Autorisez les origines d'images utilisées par votre bot et par les fiches produits dans img-src ; l'audio et d'autres fonctionnalités activées peuvent nécessiter des origines supplémentaires. Pour un domaine d'agence, utilisez les domaines figurant dans votre extrait de code généré.
Mode sécurisé CSP - éviter unsafe-inline
Si la politique de sécurité de votre site Web n'autorise pas 'unsafe-inline' dans style-src, vous pouvez activer le CSP Safe Mode (Mode sécurisé CSP). Cela permet de charger la feuille de style du conteneur du widget à partir d'un fichier CSS externe. Cette option n'autorise pas votre script de configuration en ligne et ne garantit pas que chaque style personnalisé ou fonctionnalité activée soit conforme à votre politique.
Pour l'activer, ajoutez window.aichatbotCspSafe = true; avant la balise de script ChatLab :
<script>
window.aichatbotApiKey = "YOUR_API_KEY";
window.aichatbotCspSafe = true;
</script>
<script src="https://script.chatlab.com/aichatbot.js" defer></script>
Une fois le CSP Safe Mode activé, testez une directive de styles sans 'unsafe-inline'. Voici une configuration de base :
script-src https://script.chatlab.com;
style-src https://script.chatlab.com https://fonts.googleapis.com;
connect-src https://api.chatlab.com wss://api.chatlab.com;
font-src https://fonts.gstatic.com;
Mode Iframe
La page parente doit autoriser l'origine mentionnée dans l'URL de l'iframe copiée. Pour l'hébergement standard de ChatLab, ajoutez ceci à votre politique existante :
frame-src https://api.chatlab.com;