Comment ajouter Dashbot à Botpress pour l'analyse des chatbots ?

Dans cet article, nous allons détailler les étapes nécessaires pour connecter Botpress à Dashbot, un outil d'analyse spécifique aux chatbots, avec un niveau gratuit. Nous incluons un code que vous pouvez copier et coller pour que vous puissiez capturer correctement les types de réponses de contenu les plus courants avec peu ou pas de travail !

Pourquoi utiliser autre chose que les outils d'analyse intégrés de Botpress? External Analytics vous permet d'extraire des données de Botpress et de les utiliser dans la plateforme de votre choix. Si vous utilisez différents types de bots et que vous souhaitez les fusionner, ou si vous voulez avoir plus de contrôle sur les analyses, une solution dédiée comme Dashbot peut vous aider à gérer vos analyses avec plus de facilité et de contrôle.

À propos de Dashbot

Pour les petits projets, Dashbot vous permettra de surveiller l'engagement pour voir comment votre robot se comporte de manière générale. Vous pouvez également consulter des conversations individuelles pour avoir une compréhension visuelle de la façon dont les conversations se déroulent. Si votre chatbot commence à prendre un volume important, vous pouvez utiliser Dashbot pour personnaliser votre conversation à votre convenance. C'est un peu comme si vous disposiez de Power BI pour l'analyse des chatbots.

Dashbot est gratuit pour 1000 messages/mois, vous pouvez donc facilement l'essayer. Il existe également deux autres niveaux, l'un pour les petites et moyennes entreprises chatbots avec un plafond de messages mensuels beaucoup plus élevé, et l'autre pour les entreprises personnalisées. Vous pouvez choisir le plan qui vous convient.

Instructions

Créer votre bot dans Dashbot et obtenir votre clé API

1. Rendez-vous sur reports.dashbot.io/signup et créez votre compte dashbot.
2. Cliquez sur "Ajouter un chatbot".
3. Remplir le formulaire et l'envoyer
4. Choisissez n'importe quel nom pour votre chatbot. Il s'agit d'un nom de référence.
5. Sélectionnez "Universel" pour la plateforme.
6. Choisissez une catégorie qui correspond à votre cas d'utilisation.
7. Sélectionnez prod ou dev. Ceci n'est qu'une référence.
8. Gardez la fenêtre après soumission ouverte. Vous en aurez besoin pour copier la clé api plus tard (deux fois !) et aussi pour vérifier et accéder aux analyses du chatbot.

Ajouter le code de connexion + la bonne clé API dans Botpress

1. Installez Botpress (si ce n'est pas déjà fait !) et ouvrez-le.
   
2. Créez (si ce n'est pas déjà fait) et ouvrez le bot en cliquant sur son nom.
3. Accédez à la page de l'éditeur de code.
4. Cliquez sur le bouton plus à côté de "Hooks", sélectionnez "Event Hooks" -> "Before Outgoing Middleware".
5. Nommez votre fichier dashbot-analytics-outgoing.js et soumettez-le
6. Dans l'éditeur du crochet nouvellement créé, copiez le texte qui se trouve ici et collez-le dans le contenu principal du crochet.
7. Remplacer la valeur "DASHBOT_KEY" par celle obtenue à l'étape 4.
8. [Recommandé] Si vous l'essayez pour la première fois, mettez DEBUG_DEV à true.
9. Sauvegarder
10. Cliquez sur le bouton plus à côté de "Hooks", sélectionnez "Event Hooks" -> "After Incoming Middleware".
11. Nommez votre fichier dashbot-analytics-incoming.js et soumettez-le
12. Dans l'éditeur du crochet nouvellement créé, copiez le texte qui se trouve ici et collez-le dans le contenu principal du crochet.
13. Remplacer la valeur "DASHBOT_KEY" par celle obtenue à l'étape 4.
14. [Recommandé] Si vous l'essayez pour la première fois, mettez DEBUG_DEV à true.
15. Sauvegarder
16. Ouvrez l'émulateur et envoyez un message.

S'assurer que tout fonctionne dans Dashbot

1. Retournez à Dashbot et cliquez sur vérifier.
2. Si le texte du bouton ne s'affiche pas vérifié, revenez en arrière et assurez-vous que vous avez collé la bonne clé api, et mettez DASHBOT_KEY à true avant d'envoyer un message.
3. Cliquez sur le bouton "Voir les rapports" situé à côté du bouton "Vérifié".
4. Amusez-vous bien à consulter les analyses de votre chatbot !

Important - pour la production

Le comportement par défaut est de n'envoyer des analyses que si l'indicateur de développement est à true (DEBUG_DEV dans les deux fichiers middleware) ou pour Production, vous devez ajouter une variable d'environnement appelée EXPOSED_EXTERNAL_ANALYTICS et la mettre à true. Vous pouvez l'ajouter là où vous configurez normalement les variables d'environnement de Botpress .

Voilà, c'est fait ! N'hésitez pas à réutiliser ce code à d'autres fins de suivi. Vous pouvez même envoyer vos données analytiques à Google Analytics, Segment ou toute autre solution personnalisée. Il vous suffit d'ajuster les fonctions sendAnalytics pour qu'elles correspondent à votre implémentation.

‍