Aller au contenu principal

Installer le widget

Intégrez le chatbot Sens-AI sur votre site web en une ligne de code.


Le snippet d’intégration

Le widget Sens-AI s’intègre sur n’importe quel site web grâce à une seule ligne de JavaScript. Il fonctionne en Shadow DOM pour éviter tout conflit avec vos styles existants.

Obtenir le snippet

  1. Dans la configuration de votre bot, allez dans l’onglet Snippet
  2. Copiez le code affiché :
<script src="https://api.sens-ai.work/widget.js" data-bot-id="VOTRE_BOT_ID"></script>
  1. Collez ce code juste avant la balise </body> de votre site

Où placer le code ?

  • Site statique (HTML) : dans chaque page HTML, avant </body>
  • WordPress : dans le footer via un plugin « Insert Headers and Footers »
  • Shopify : dans Paramètres > Checkout > Scripts additionnels
  • React/Vue/Next.js : dans votre composant Layout principal

Vérifier l’installation

Après avoir ajouté le snippet :

  1. Ouvrez votre site dans un navigateur
  2. Une bulle de chat doit apparaître en bas à droite
  3. Cliquez dessus pour ouvrir la fenêtre de conversation
  4. Posez une question — le bot doit répondre en utilisant vos sources

Personnalisation

Le widget est entièrement personnalisable depuis l’onglet Widget de votre bot :

  • Couleurs : couleur principale, fond des messages bot/utilisateur
  • Logo : uploadez votre logo pour remplacer l’icône par défaut
  • Position : bas-droite ou bas-gauche
  • Bulle : taille, icône, message teaser
  • Messages suggérés : ajoutez des suggestions cliquables

Consultez Personnalisation du widget pour plus de détails.

Teaser (bulle d’accroche)

Vous pouvez configurer un message teaser qui apparaît automatiquement après un délai configurable (1 à 60 secondes) pour attirer l’attention des visiteurs. Le teaser ne s’affiche qu’une fois par session.

Dépannage

ProblèmeSolution
La bulle n’apparaît pasVérifiez que le data-bot-id est correct
Le bot ne répond pasVérifiez que des sources ont été indexées
Conflit CSSLe widget utilise Shadow DOM, les conflits sont rares. Contactez le support.
Erreur CORSLe widget est servi depuis api.sens-ai.work, assurez-vous que votre CSP l’autorise