Configurer le chatbot

Intégration web

Ajoutez le chatbot à votre site avec une seule balise script et définissez où il peut fonctionner.

Ajouter le script

Configuration › Intégration web

Copiez le code d'intégration depuis le tableau de bord et collez-le juste avant la balise de fermeture </body>. Ajoutez-le à chaque page où le chatbot doit apparaître, ou une seule fois dans un modèle commun à toutes les pages. L'attribut defer garantit qu'il ne ralentit pas votre page.

HTML

<script defer src="https://cdn.swai.chat/chatbot-public/frontend/loader.js?chatbotId=YOUR_CHATBOT_ID"></script>

L'intégration sur un site en ligne nécessite un abonnement payant. Pendant l'essai, testez avec l'aperçu du tableau de bord.

Où coller le code

WordPress: Avec une extension pour les scripts d'en-tête et de pied de page, ou via le réglage de code personnalisé de votre thème.
Webflow: Site settings › Custom code › Footer code, puis publiez.
Shopify: Boutique en ligne › Thèmes › Modifier le code › theme.liquid, avant </body>.
Wix: Paramètres › Code personnalisé › Ajouter un code, placé dans « Body – fin » sur toutes les pages.
HTML: Collez-le dans le modèle de page avant </body>.

Utilisez toujours un bloc de code personnalisé, d'intégration ou HTML. Les blocs de texte des éditeurs de site suppriment les scripts.

Modes d'affichage

Le paramètre mode détermine comment le chatbot apparaît. Vous pouvez essayer chaque mode avec les boutons d'aperçu du tableau de bord.

bubble (par défaut): Un bouton de chat dans le coin inférieur qui ouvre la fenêtre de chat. Le bon choix pour la plupart des sites.
floating: Un champ de saisie en bas de la page qui invite les visiteurs à poser une question immédiatement.
embedded: Le chat remplit son conteneur, pour une page d'aide ou de chat dédiée. Veillez à ce que le conteneur ait une hauteur.

Paramètres

Ajoutez des paramètres à l'URL du script, séparés par & :

HTML

<script defer src="https://cdn.swai.chat/chatbot-public/frontend/loader.js?chatbotId=YOUR_CHATBOT_ID&mode=floating"></script>

chatbotId: Obligatoire. L'identifiant de votre chatbot, déjà renseigné dans le code copié.
mode: bubble, floating ou embedded. Par défaut : bubble.
openOnLoad: true ouvre le chat au chargement de la page. S'applique aux modes bubble et floating et reste sans effet en mode embedded. Lorsqu'un visiteur ferme le chat, il reste fermé dans cet onglet du navigateur et s'ouvre à nouveau automatiquement dans un nouvel onglet ou une nouvelle session de navigation. Par défaut : désactivé.

Restriction de domaine

Sous Restrictions de domaine, saisissez l'adresse du site sur lequel le chatbot fonctionne, par exemple https://www.example.com. Le chatbot ne fonctionne alors que là, et d'autres sites ne peuvent pas l'intégrer avec votre code pour épuiser votre quota de messages.

La restriction de domaine protège contre l'intégration sur d'autres sites, mais ce n'est pas un contrôle d'accès. Elle vérifie l'adresse du site que le navigateur envoie avec chaque requête, et un script exécuté hors d'un navigateur peut falsifier cette adresse. Ne considérez donc pas le chatbot et sa base de connaissances comme confidentiels.

Le domaine doit correspondre : www.example.com et example.com comptent comme le même domaine, mais tout autre sous-domaine, comme shop.example.com, est un domaine différent.