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
- Dans la configuration de votre bot, allez dans l’onglet Snippet
- Copiez le code affiché :
<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 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è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 |