Cómo añadir Dashbot a Botpress para análisis de chatbot

En este artículo, detallaremos los pasos necesarios para conectar Botpress con Dashbot, una herramienta de análisis específica para chatbot, con un nivel gratuito. Incluimos código que puedes copiar y pegar para que puedas capturar correctamente los tipos de respuesta de contenido más comunes sin apenas esfuerzo.

¿Por qué utilizar algo distinto a los análisis integrados de Botpress? Los análisis externos te permiten extraer datos de Botpress y utilizarlos en la plataforma que elijas. Si utilizas diferentes tipos de bots y quieres fusionarlos, o quieres tener un mayor control sobre las analíticas, una solución dedicada como Dashbot puede ayudarte a gestionar tus analíticas con mayor facilidad y control.

Acerca de Dashbot

Para proyectos más pequeños, Dashbot te permitirá monitorizar el engagement para ver cómo va tu bot en términos generales. También puedes consultar conversaciones individuales para tener una idea visual de cómo van las conversaciones. Si tu chatbot está empezando a tener un gran volumen, puedes utilizar Dashbot para personalizar la conversación a tu gusto. Puedes pensar que es como tener Power BI para el análisis de chatbot.

Dashbot es gratuito para 1000 mensajes / mes, por lo que puedes probarlo fácilmente. También tiene otros dos niveles, uno para pequeñas y medianas chatbots con un límite mucho más alto mensaje mensual, y una empresa personalizada. Puedes elegir el plan que más te convenga.

Instrucciones

Crear tu bot en Dashbot y obtener tu clave API

1. Ve a reports.dashbot.io/signup y crea tu cuenta dashbot.
2. Haz clic en "Añadir chatbot".
3. Rellene el formulario y envíelo
4. Elige cualquier nombre para tu chatbot. Esto es sólo para su referencia.
5. Seleccione "Universal" para la plataforma.
6. Elija una categoría que se adapte a su caso de uso.
7. Seleccione prod o dev. Esto es sólo para su referencia.
8. Mantén abierta la ventana después de enviar. La necesitarás para copiar la clave api más tarde (¡dos veces!) y también para verificar y acceder a los análisis del chatbot.

Añadir el código de conexión + la clave API correcta en Botpress

1. Instala Botpress (si aún no lo has hecho) y ábrelo.
   
2. Crear (si aún no lo has hecho) y abre el bot haciendo clic en su nombre.
3. Vaya a la página del editor de código.
4. Haga clic en el botón más situado junto a "Hooks", seleccione "Event Hooks" -> "Before Outgoing Middleware".
5. Nombra tu archivo dashbot-analytics-outgoing.js y envíalo
6. En el editor del hook recién creado, copia el texto de aquí, y pégalo en el contenido principal del hook.
7. Cambia el valor de "DASHBOT_KEY" por el obtenido en el paso 4.
8. [Recomendado] Si es la primera vez que lo prueba, establezca DEBUG_DEV en true.
9. Guardar
10. Haga clic en el botón más situado junto a "Hooks", seleccione "Event Hooks" -> "After Incoming Middleware".
11. Nombra tu archivo dashbot-analytics-incoming.js y envíalo
12. En el editor del hook recién creado, copia el texto de aquí, y pégalo en el contenido principal del hook.
13. Cambia el valor de "DASHBOT_KEY" por el obtenido en el paso 4.
14. [Recomendado] Si es la primera vez que lo prueba, establezca DEBUG_DEV en true.
15. Guardar
16. Abre el emulador y envía un mensaje.

Asegurarse de que todo funciona en Dashbot

1. Vuelve a Dashbot y haz clic en verificar.
2. Si el texto del botón no se muestra verificado, vuelve atrás y asegúrate de que has pegado la clave api correcta, y establece DASHBOT_KEY en true antes de enviar un mensaje.
3. Haga clic en el botón "Ver informes" situado junto al botón Verificado.
4. Diviértete echando un vistazo a los análisis de tu chatbot.

Importante - para la producción

El comportamiento por defecto es que sólo envía análisis si la bandera de desarrollo se establece en true (DEBUG_DEV en los dos archivos de middleware) o para la producción, es necesario agregar una variable de entorno llamada EXPOSED_EXTERNAL_ANALYTICS y establecerlo en true. Puedes añadirla donde normalmente configuras las variables de entorno Botpress .

Ya está. Siéntase libre de reutilizar este código para otros fines de seguimiento. Usted podría incluso enviar su análisis a Google Analytics, Segment, o cualquier solución personalizada. Sólo tiene que ajustar las funciones sendAnalytics para adaptarse a su implementación.

‍