[Extensión] Cómo monitorear los errores de los flujos de tu chatbot con la extensión Registros y monitoreo de errores

1. Introducción

2. Funcionalidades

3. Instalación y configuración

4. Cómo analizar los errores monitoreados

5. Cómo configurar alertas por correo electrónico

6. Registros por contacto

7. Soporte

Descripción breve: Monitorea los errores de los flujos de tu chatbot en Blip, consulta qué contactos se vieron afectados y recibe alertas por correo electrónico para corregir fallas antes de que afecten a más usuarios.

Introducción

La extensión Registros y monitoreo de errores registra las fallas que ocurren durante la ejecución de los flujos de tu chatbot en Blip. Puedes consultar cada error en un solo panel, con el mensaje técnico, el bloque del flujo donde ocurrió la falla y la lista de contactos afectados. Así identificas fallas silenciosas y actúas antes de que el problema se repita con otros usuarios.

Por ejemplo, si un bloque de solicitud HTTP comienza a fallar porque una API dejó de funcionar, el error aparece en el panel agrupado con todas las ocurrencias de los últimos 7 días. Puedes ver cuántos contactos se vieron afectados, consultar los detalles técnicos de la falla y recibir un correo electrónico automático en cuanto ocurre.

Funcionalidades

• Panel con los errores de los flujos agrupados por tipo, que muestra la cantidad de ocurrencias y una gráfica de los últimos 7 días.

• Detalles técnicos de cada error: contacto afectado, bot de origen, bloque del flujo, tipo de acción, entrada del usuario y tiempo de ejecución.

• Exportación en CSV de los contactos afectados por un error.

• Alertas por correo electrónico cuando ocurre un error en el flujo, con la opción de enviarlas solo en la primera ocurrencia.

• Alertas por correo electrónico basadas en eventos rastreados y filtradas por categoría.

• Pestaña Registros por contacto para consultar los traces de un contacto específico.

• Monitoreo automático de todos los bots conectados cuando la extensión está instalada en un Router.

Compatible con los siguientes canales: todos los canales disponibles en la plataforma Blip.

Instalación y configuración

1. Activa la extensión Registros y monitoreo de errores en Blip Store e instálala en el bot que quieres monitorear. Si tu operación utiliza un Router, instala la extensión en el Router para monitorear automáticamente todos los bots conectados a él.

2. En el panel del bot, abre el menú de opciones (ícono de tres puntos) para localizar la extensión instalada.

3. Haz clic en la extensión para abrir el panel de monitoreo. A partir de ese momento, la extensión comienza a registrar automáticamente los errores de los flujos, sin configuración adicional.

Atención: los errores y los registros están disponibles durante 7 días. Después de este periodo, los registros más antiguos se eliminan automáticamente y dejan de aparecer en el panel.

Cómo analizar los errores monitoreados

El panel muestra los errores agrupados por tipo. Cada elemento muestra el mensaje de la falla, una gráfica con la distribución de las ocurrencias de los últimos 7 días, el total de ocurrencias en el periodo y la hora de la última vez que ocurrió el error. Usa el botón Actualizar para volver a cargar la lista.

Haz clic en un error para expandir los detalles de la última ocurrencia. En este panel puedes consultar el contacto afectado, la fecha, el bot de origen, el bloque del flujo donde ocurrió la falla, el tiempo de ejecución, el tipo de acción y la entrada enviada por el usuario. El ícono de depuración abre la configuración completa de la acción en formato JSON, lo que resulta útil para entender la causa técnica del error.

Analiza cada error observando en qué bloque ocurre, si es recurrente, cuántos contactos se vieron afectados y si algún cambio reciente en el flujo pudo haber causado la falla. Con estos detalles puedes identificar si el problema proviene de una condición mal configurada en Builder, de una solicitud HTTP fallida o de una variable que no se completó.

En el panel expandido, haz clic en Descargar CSV con usuarios afectados para exportar la lista de contactos afectados por el error. Usa el archivo para cruzar los datos con otra información o activar una acción de recuperación para esos contactos. Para eliminar un error que ya fue atendido, haz clic en Eliminar error.

Cómo configurar alertas por correo electrónico

1. En el panel de monitoreo, haz clic en Administrar alertas.

2. Completa el campo Correo electrónico para recibir alertas con la dirección que recibirá las notificaciones.

3. Activa Habilitar alertas de errores para recibir un correo electrónico cada vez que ocurra un error en el chatbot. Marca Enviar solo cuando el error aparezca por primera vez para evitar correos repetidos sobre el mismo error.

4. Activa Habilitar alertas basadas en eventos para recibir notificaciones sobre eventos específicos. Selecciona las Categorías de eventos que quieres monitorear y, si lo deseas, marca la opción para enviar la notificación solo en la primera ocurrencia.

5. Haz clic en Guardar. Las alertas se aplicarán a los próximos errores y eventos registrados.

Registros por contacto

En la pestaña Registros por contacto, puedes consultar el historial de un contacto específico. Busca por el ID del contacto o selecciona uno de los últimos contactos que conversaron con el bot para ver los traces registrados durante la atención. Esto ayuda a investigar un problema reportado por un usuario sin tener que buscar el error en el panel general.

Soporte

Si tienes preguntas durante la instalación o el análisis de los errores, comunícate con el equipo de soporte de Wiv por correo electrónico a support@wiv.com.br.

¿Necesitas más ayuda? Explora nuestros contenidos en Blip Academy o Blip Community, mira tutoriales en nuestro canal de YouTube o resuelve tus dudas en nuestro canal de atención 😃