Documentation / Guides
Placez votre agent sur votre site web
Intégrez une bulle voix + chat sur n’importe quel site avec un seul extrait de code.
Dernière mise à jour:
Le widget web place votre agent sur votre propre site web sous la forme d’une bulle flottante. Les visiteurs cliquent dessus et parlent à l’agent ou discutent par écrit avec lui, directement depuis la page, sans aucun numéro de téléphone.
1. Activez-le#
Ouvrez l’agent et allez dans Web → Web widget. Cliquez sur Enable widget. Des valeurs par défaut pertinentes sont préremplies. Choisissez les canaux (voix, chat ou les deux) et, lorsque les deux sont actifs, l’onglet que les visiteurs voient en premier.
2. Personnalisez-le#
- Appearance : position sur la page, votre couleur de marque, taille et style du bouton, disposition du panneau, et ouverture automatique ou non.
- Texts : l’en-tête, les libellés du bouton et des onglets, les placeholders. Tout ce que vous laissez vide utilise une valeur par défaut intégrée et soignée.
- Pre-conversation form (facultatif) : demandez aux visiteurs leur nom, leur e-mail ou leur téléphone avant le début de la conversation. Chaque champ possède une clé, un libellé, un type et un indicateur d’obligation. Ce qu’ils y saisissent est joint à la conversation.
- Automation webhook (facultatif, pour les développeurs) : une URL https qui reçoit une notification (avec les données du formulaire) dès qu’une conversation démarre, afin que vos systèmes soient informés immédiatement.
3. Copiez l’extrait de code#
En bas de cette même page, vous obtenez un code d’intégration d’une seule ligne. Copiez-le et collez-le dans le HTML de votre site web, juste avant la balise fermante </body>. C’est tout : la bulle apparaît sur chaque page qui contient l’extrait.
4. Prévisualisez-le en direct#
Web → Preview affiche le vrai widget sur une page d’exemple : une véritable session en direct, avec la voix et le chat qui fonctionnent, en largeur bureau ou mobile. Les modifications enregistrées y apparaissent en 30 secondes environ.
5. Suivez les conversations#
Chaque session du widget arrive dans Calls comme n’importe quel appel téléphonique (transcription, résumé, notifications), avec l’origine Web au lieu de Phone.
Faites Save, puis Deploy : comme pour toute autre modification de l’agent, le widget sert la configuration déployée.
6. Partager un lien de test#
Vous n'avez pas besoin d'un site pour faire essayer l'agent. Dans le panneau d'aperçu de l'agent, cliquez sur Share puis Create link : nous hébergeons une page avec le widget et vous envoyez l'URL à un collègue, un client ou un relecteur. Choisissez la durée du lien (24 heures à 30 jours, ou sans expiration) et le nombre de sessions qu'il peut démarrer (10 à 1000) ; révoquez-le à tout moment depuis le même dialogue. Chaque session issue d'un lien consomme les minutes de ce projet exactement comme une session depuis votre propre site, et le widget doit déjà être activé.