Al iniciar el Workflow Designer podemos ver las Start Activities.

Estas son la actividad inicial de cualquier flujo, al arrastrar una hacia la mesa de trabajo, se define qué tipo de flujo es.

Tipos de start activities:

StartActivity - Para flujos de Telefonía.
BotStartActivity - Para flujos de bots.
BotFunctionStartActivity - Para crear extensiones de bots.
ChannelProviderStartActivity - Para enviar información hacia un tercero.
WebhookStartActivity - Para recibir información desde un tercero.
BlacklistStartActivity - Actividad que inicia el flujo de blacklist.

Una vez que se coloque la start activity deseada, se despliegan las actividades relacionadas con su canal y necesarias para la creación del flujo.

Descripción de Start Activities

StartActivity

Es necesaria esta actividad para darle el inicio al flujo, en la misma se indicará para que contexto y extensión se realizará el flujo.

context: Indica el contexto en el que se aplica el flujo.
exten: Indica la extensión en la que se aplica el flujo.

BotStartActivity

Esta actividad es la primera del flujo, siempre debe estar incluida en todos los flujos creados, la misma indica al bot por dónde comienzan las actividades.

name incluye el nombre que posee el bot.
botTimeout es el tiempo en minutos que espera el bot sin recibir respuesta para terminar la interacción y darla por abandonada, por defecto son 30 minutos.
msgBotTimeout es el mensaje que se muestra luego de que se de el botTimeout.

BotFunctionStartActivity

Para poder crear un bot function se cuenta con la actividad BotFunctionStartActivity.

Esta actividad, a diferencia de la BotStartActivity, únicamente posee el campo ‘nombre’.

Es decir, la actividad inicial de un bot function no posee el campo ‘bot_timeout’, ni tampoco el campo ‘timeout_message’, lo que significa que el timeout que se tomará en cuenta es el del bot que llama al bot function.

ChannelProviderStartActivity

name
Va a ser el nombre del proveedor, el mismo va a aparecer en las campañas de SMS/WhatsApp y en los discadores del mismo canal.

Si el nombre del proveedor contiene la palabra "WhatsApp" en la unified inbox va a aparecer con iconos de WhatsApp y el agente va a tener la posibilidad de enviar attachments.

WebhookStartActivity

name
Es el nombre del webhook que al mismo tiempo se va a corresponder con la ruta para poder ejecutar el flujo.

Los métodos aceptados son: POST, PUT, GET, DELETE.

https://instance.ucontactcloud.com/IntegraChannels/resources/webhook/{name}

BlacklistStartActivity

Actividad que inicializa el flujo de blacklist.

Log de flows

Se emplea log4j2 como librería para el log de flows, y el archivo donde se puede ver todo lo relacionado con los bots se encuentra en var/log/ucontact/flows.log

Este archivo no solo loguea los errores, sino que de manera similar a lo que se hace en el https://integra-scm.atlassian.net/l/c/nY4voq0m, loguea todas las actividades que se van recorriendo a medida que se recorre el flow.

El formato en que se imprime la información en flows.log es el siguiente:

AAAA-MM-DD HH:mm:ss - [Número de thread] - [Nombre del flow - guid del flow] [Número de pasos de la actividad]

Primero se va a loguear la ejecución de la actividad y luego se loguean los parámetros de la actividad que se ejecutó.

Cuando el flow finaliza se imprime el mensaje FINISH.

Ejemplo:

Logger

Una vez que se carga un flujo con contexto bots, channel providers o webhooks en Workflow Designer, se puede visualizar la opción Logger, la cual permite ver el log de todas las ejecuciones del flow que está cargado.

Por defecto, el logger está desactivado, para activarlo hay que presionar en el interruptor que se encuentra en la esquina superior izquierda.

También cuenta con la posibilidad de filtrar los mensajes en la consola del workflow según nivel de error. Los niveles disponibles son Info, Warning y Severe.

Ejemplo de Logger:

Diseñador de flujos