Objectif
Vous avez un bot Botpress et vous voulez le rendre vraiment utile : présent sur votre site, mesurable, et itérable.
Dans ce guide, on voit comment :
- intégrer le widget Webchat sur n’importe quel site (HTML, Next.js, WordPress, Webflow, etc.)
- éviter les pièges classiques (perfs, consentement cookies, sécurité)
- mettre en place un tracking propre (événements + conversions)
- suivre des analytics actionnables (qualité, volumes, sujets, taux de résolution)
Pour aller plus loin côté hébergement/ops, vous pouvez aussi déployer Botpress en production proprement : Installer Botpress avec Docker Compose + HTTPS.
1) Choisir la bonne méthode d’intégration (Webchat vs API)
Pour intégrer Botpress dans un site, vous avez 2 grandes approches :
- Webchat : le plus simple pour un site “marketing” ou un espace client. Vous collez un script d’intégration et vous avez un widget prêt à l’emploi.
- Chat API : utile si vous voulez un front sur-mesure (par exemple une expérience entièrement intégrée à votre produit).
La doc Botpress distingue explicitement ces deux voies : Webchat (site web) vs Chat API (intégration applicative).
Si votre objectif est “un widget de chat sur le site”, partez sur Webchat.
2) Intégrer le widget Webchat (embed)
Le principe est simple :
- Récupérer le code d’embed depuis le Dashboard Botpress (Webchat → Deploy Settings)
- Ajouter les scripts dans le
<head>de votre site - Vérifier que le widget apparaît et que la conversation fonctionne
Exemple (structure typique) :
<script src="https://cdn.botpress.cloud/webchat/vX.X/inject.js"></script>
<script src="https://files.bpcontent.cloud/.../your-bot.js" defer></script>
Sur un site SSR (Next.js, Nuxt, etc.), l’idée reste la même : charger l’embed côté client (éviter de l’exécuter pendant le rendu serveur).
Astuce : si vous avez déjà une page d’acquisition, vous pouvez mettre le widget sur des pages stratégiques (tarifs, contact, étude de cas) pour capter l’intention.
3) Perfs, UX et consentement : les trois pièges qui ruinent un widget
Ne pas dégrader le chargement
- Chargez les scripts en
deferquand c’est possible. - Sur un site à fort trafic, ne chargez pas le widget sur 100% des pages “par défaut” : commencez par les pages BOFU (pricing, démo, contact).
Respecter le consentement (RGPD)
Si vous utilisez un outil type Axeptio/Didomi/OneTrust, vous pouvez :
- charger le widget uniquement après consentement (catégorie “fonctionnel” ou “mesure” selon votre politique)
- sinon, au minimum : éviter d’envoyer des événements analytics identifiants sans consentement
Garder un CTA clair
Un widget n’est pas juste “un chat”. Donnez-lui un objectif : prise de RDV, qualification, support, lead.
Si vous voulez un exemple de bot orienté support, vous pouvez lire : Créer un chatbot support client Botpress.
4) Mettre en place le tracking (événements utiles, pas du bruit)
L’erreur la plus fréquente : tracker “chat_opened” et s’arrêter là. Vous voulez des événements qui répondent à des questions business.
Événements recommandés
chat_opened: ouverture du widgetchat_started: premier message utilisateurlead_captured: email/téléphone récupéré (si votre bot le fait)handoff_requested: demande d’humainresolved: l’utilisateur confirme que c’est résolu (si vous posez la question)appointment_booked: RDV pris
Implémentation simple (GTM / analytics)
Le pattern le plus robuste : pousser des événements dans une couche type dataLayer (ou une API interne), puis laisser GTM / votre outil analytics faire la collecte.
Important : si vous associez ces événements à des pages (UTM, source, campagne), vous pourrez relier le chatbot à votre acquisition.
5) Analytics : quoi mesurer pour améliorer le bot (et pas juste “compter des chats”)
Voici un tableau de bord minimal qui sert vraiment :
- Volume : conversations/jour, messages/conversation
- Taux d’activation :
chat_started / chat_opened - Taux de résolution : conversations résolues / conversations démarrées
- Handoff : demandes d’humain (et sur quels sujets)
- Top intentions / top questions : les sujets qui reviennent
- Temps de réponse perçu : latence entre message utilisateur et réponse
Ensuite, boucle d’amélioration :
- si une intention revient souvent → enrichissez la base de réponses
- si un sujet déclenche du handoff → ajoutez un parcours guidé
- si les conversions viennent d’une campagne → adaptez le script d’accueil selon l’UTM
Lancez-vous avec Botpress.
Envie de vous lancer avec Botpress ? Créez votre site web en quelques clics.
Botpress
Plateforme open-source de chatbots
Vidéo (FR)
Héberger Botpress et le publier sur Adgents.cloud (option la plus simple)
Si vous voulez éviter de passer des heures sur l’infra (reverse proxy, certificats, backups, scaling), vous pouvez déployer Botpress sur Adgents.cloud :
- déploiement en 1 clic
- facturation à l’heure
- stop/start (compute non facturé à l’arrêt ; stockage conservé)
- backups automatiques (24h par défaut, jusqu’à 1/h)
- rétention longue (jusqu’à 10 ans)
- scaling CPU/RAM à la demande
