Installer le widget
Intégrez le chatbot Sens Ai sur votre site web en une ligne de code.
Dernière mise à jour :
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
- Dans le menu de gauche de votre agent, ouvrez Canaux › Chat web
- Dans la section Code d’intégration, cliquez sur Copier le code :
<script src="https://api.sens-ai.work/widget.js" data-bot-id="VOTRE_BOT_ID"></script>
- 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 :
- Ouvrez votre site dans un navigateur
- Une bulle de chat doit apparaître en bas à droite
- Cliquez dessus pour ouvrir la fenêtre de conversation
- Posez une question — le bot doit répondre en utilisant vos sources
Personnalisation
Le widget est entièrement personnalisable depuis la même page Chat web ; le bouton Publier enregistre vos réglages :
- Couleurs de marque : Primaire, Texte et Bulle Bot (le fond des messages du bot)
- Logo de l’en-tête : uploadez votre logo, il remplace l’Avatar dans l’en-tête du widget
- Configuration du Launcher : Taille, Position (bas-droite ou bas-gauche) et Avatar de la bulle
- Bulle Teaser : le message d’accroche
- Suggestions de messages : 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 (5 à 60 secondes) pour attirer l’attention des visiteurs. Il réapparaît à chaque chargement de page jusqu’à ce que le visiteur le ferme (×) ou réduise le widget, revient à sa visite suivante (nouvel onglet), et ne s’affiche qu’avec l’état au repos Mini.
Dépannage
| Problème | Solution |
|---|---|
| La bulle n’apparaît pas | Vérifiez que le data-bot-id est correct |
| Le bot ne répond pas | Vérifiez que des sources ont été indexées |
| Conflit CSS | Le widget utilise Shadow DOM, les conflits sont rares. Contactez le support. |
| Erreur CORS | Le widget est servi depuis api.sens-ai.work, assurez-vous que votre CSP l’autorise |