Índice:
- ¿Qué es un evento?
- Anatomía de los eventos
- Crear un evento usando la acción Registro de eventos
- Registro y análisis de eventos mediante programación
La acción Registro de eventos permite registrar eventos importantes que ocurrieron dentro de un bot para su análisis futuro. Es a través de esta acción que el Builder puede generar información que luego será utilizada por el módulo de análisis Blip.
En la práctica, solo los eventos generados por esta acción se pueden usar al crear informes que usan eventos personalizados como fuente.
¿Qué es un evento?
Un evento representa algo que sucedió dentro del bot independientemente de su origen, es decir, los eventos pueden representar interacciones del usuario o incluso actividades realizadas por el bot. Algunos ejemplos de eventos:
- Número de mensajes que contienen la palabra ayuda;
- Número de solicitudes HTTP realizadas por el bot;
- Número de usuarios que interactuaron con el bot en un canal determinado;
- Número de imágenes recibidas por el bot;
- Cuántas veces se ha solicitado una funcionalidad de bot en particular;
- Número de veces que se reconoció una intención determinada.
Anatomía de los eventos
Cada evento tiene los siguientes componentes:
- Categoría (obligatorio): nombre para agrupar los eventos;
- Acción (obligatorio): nombre de un tipo de evento agrupado por categoría;
- Etiqueta (opcional): descripción adicional del evento generado;
- Valor (opcional): número que tiene un valor adicional para la información sobre un evento;
- Extras (opcional - accesible solo a través de la API de Blip) - Información adicional importante para el evento.
Cada información adicional se compone de una clave y un valor.
Ejemplo: el evento generado para un usuario de plan prémium puede tener información adicional donde la clave es Plan y el valor es Prémium
Imagina, por ejemplo, que es necesario analizar la cantidad de imágenes que recibe un bot. Una forma de organizar eventos para este análisis sería:
Categoría: "Contenidos"
Acción: "Imagen"
En otras palabras, la agrupación de eventos viene dada por la categoría Contenido y el tipo de contenido de la imagen se define a través de la acción Imagen. Siguiendo la misma lógica, para analizar la cantidad de mensajes de texto recibidos, simplemente usa:
Categoría: "Contenidos"
Acción: "Texto"
Asimismo, para representar la cantidad de solicitudes HTTP realizadas por el bot para un endpoint (punto final) de API específico, una posible configuración de eventos sería:
Categoría: "RequisicaoHTTP"
Acción: "/ products"
Etiqueta: "Solicitudes HTTP para búsqueda de productos"
Valor: 1
Donde el valor 1 indica, por ejemplo, el ID de producto buscado en la API.
Crear un evento usando la acción Registro de eventos
Analiza el flujo de tu bot y define qué bloque corresponde al momento en el que quieres generar un evento. En este bloque, crea una acción (entrada o salida) del tipo Registro de Eventos y complete la información relacionada con el evento que deseas analizar.
Observa en la imagen a continuación, un ejemplo para el registro de eventos que representan la cantidad de veces que se solicitó la función Servicio de Atención Humano.
Registro y análisis de eventos mediante programación
Además de registrar eventos a través de la acción Builder, es posible realizar el mismo proceso, de manera programática, a través de la API de Blip. Para obtener más detalles, acceda a la documentación de Blip haciendo clic aquí.
Para obtener más información, acceda a la discusión sobre el tema en nuestra comunidad o los videos en nuestro canal. 😃