Documentation

Déployer

Intégrez votre agent sur n’importe quel site web grâce au widget JavaScript ou à une iframe.

Déployez votre agent sur votre site web pour que les visiteurs puissent interagir avec lui. Choisissez entre un widget de chat flottant et une intégration iframe pleine page.

Options d’intégration

Widget de chat (recommandé)

Une bulle de chat flottante qui se déploie en fenêtre de discussion. Fonctionne sur n’importe quel site web.

Intégration iframe

Intégrez l’interface de chat complète dans une section de page. Utile pour les pages d’assistance dédiées.

Ajouter le widget de chat

  1. Accédez à l’onglet Publier de votre agent
  2. Copiez l’extrait JavaScript
  3. Collez-le dans le HTML de votre site web, avant </body> :
<script
  src="https://your-domain.com/widget.js"
  data-chatbot-id="your-chatbot-id"
  async
></script>
  1. Actualisez votre site web : la bulle de chat apparaît !

Le widget apparaît sous la forme d’un bouton flottant (généralement en bas à droite). Les visiteurs cliquent dessus pour ouvrir le chat.

Guides par plateforme

Pour des instructions détaillées sur des plateformes spécifiques :

Personnalisation du widget

Personnalisez l’apparence dans l’onglet Design :

Couleurs

  • Couleur principale (bulle de chat, en-tête)
  • Couleurs d’accentuation
  • Thème clair/sombre

Position

  • En bas à droite (par défaut)
  • En bas à gauche
  • Positionnement personnalisé via CSS

Image de marque

  • Message d’accueil
  • Titre du chat
  • Messages suggérés
  • Supprimer la mention « Powered by » (forfaits Standard/Pro)

Paramètres de visibilité

Contrôlez qui peut accéder à votre agent :

SettingDescription
PublicTout le monde peut utiliser le widget intégré
PrivéAccessible uniquement depuis le Playground du tableau de bord

Configurez ce paramètre dans Paramètres > Sécurité > Visibilité.

Restrictions de domaine

Limitez les sites web autorisés à intégrer votre agent :

  1. Accédez à Paramètres > Sécurité
  2. Recherchez Domaines autorisés
  3. Ajoutez les domaines autorisés à intégrer votre widget

Une fois configuré, le widget ne se charge que sur les domaines approuvés. Cela empêche toute utilisation non autorisée de votre agent.

Vérifier votre intégration

Une fois le code ajouté :

  1. Visitez votre site web dans un navigateur
  2. Repérez la bulle de chat
  3. Cliquez pour ouvrir le chat
  4. Envoyez un message de test
  5. Vérifiez que la réponse est correcte

Dépannage

Le widget n’apparaît pas :

  • Vérifiez que le code d’intégration se trouve avant </body>
  • Vérifiez que l’ID de l’agent est correct
  • Videz le cache de votre navigateur
  • Vérifiez la console du navigateur pour repérer d’éventuelles erreurs

Le widget est mal positionné :

  • Ajustez la position dans les paramètres Design
  • Vérifiez les conflits CSS

Le chat ne répond pas :

  • Assurez-vous d’avoir du contenu d’entraînement
  • Vérifiez la limite de messages de votre forfait
  • Testez d’abord dans le Playground

Liste de contrôle avant mise en ligne

Avant d’annoncer votre agent :

  1. [ ] Tester dans le Playground avec des questions courantes
  2. [ ] Vérifier que le contenu d’entraînement est complet
  3. [ ] Personnaliser l’apparence pour l’adapter à votre marque
  4. [ ] Configurer les restrictions de domaine (facultatif)
  5. [ ] Configurer la limite de débit pour éviter les abus
  6. [ ] Vérifier les paramètres de visibilité

Étapes suivantes