Agregar y/o configurar un Bot

Para agregar y configurar un nuevo bot, haz clic en el botón Agregar Bot desde el módulo BotBuilder.

Sagicc te llevará a la vista de configuración de un nuevo bot. Inicialmente, Sagicc te pedirá que especifiques la siguiente información básica para el bot:

• Nombre: Especifica un nombre para el bot.

• Descripción: Agrega una descripción, indicando el objetivo/finalidad del bot.

• Tipo: Por defecto, estará seleccionada la opción BOT VACIO. Próximamente estarán disponibles plantillas predeterminadas para comenzar a construir bots de diferentes tipos.

Una vez digitada la información solicitada, haz clic en Continuar para acceder al constructor de bots. En este, encontrarás la pantalla dividida en tres (3) secciones principales:

1. La barra superior incluirá los datos básicos del bot, y te permitirá editarlos al hacer clic en el botón Editar a la izquierda de la barra. También, incluirá las diferentes opciones de guardado del bot, como Guardar versión, Publicar versión, etc.

2. El panel a la izquierda de la pantalla mostrará los diferentes nodos que conforman el bot y las conexiones entre ellos. Esta visualización gráfica del bot te ayudará seguir de mejor manera el flujo de la conversación. En este panel puedes utilizar tu mouse para aumentar o disminuir el zoom, y también para seleccionar un nodo específico o sus conexiones y mover su posición dentro del panel.

3. El panel a la derecha de la pantalla te permitirá agregar nuevos nodos y editar la configuración de los nodos existentes. Al hacer clic en el botón Editar de un nodo especifico, la configuración del mismo de mostrará en este panel y podrás hacer las modificaciones necesarias.

Construir el Bot: Nodos y Conexiones

Para construir la lógica de un bot conversacional o transaccional, debes tener en cuenta que estos son básicamente flujos o estructuras conformadas por nodos conectados. En palabras más simples, construir el bot consiste en agregar los nodos y las conexiones necesarias para que el asistente virtual tenga una conversación fluida y con sentido con el cliente.

Cada nodo del flujo de bot determina un paso o acción de la conversación entre el asistente virtual y el cliente, y dependiendo del objetivo del bot, tiene un tipo y una configuración específica. Si hacemos la comparación entre una conversación real y los nodos de un flujo de bot, tendríamos la siguiente analogía:

Cada nodo del flujo de bot está representado en el panel por una tarjeta, y las conexiones entre los nodos están representadas por líneas que unen dichas tarjetas. La tarjeta de un nodo específico y sus conexiones, contienen las siguientes opciones y/o elementos:

1. Información básica del nodo: Muestra datos básicos del nodo, como el nombre, descripción y tipo de nodo.

2. Editar Nodo: Haz clic aquí para visualizar la configuración del nodo en el panel de la derecha y hacer La modificaciones necesarias al nodo.

3. Borrar Nodo: Haz clic aquí para eliminar el nodo del panel y del bot.

4. Agregar Nodo: Haz clic aquí para agregar un nuevo nodo, y dejarlo conectado al nodo seleccionado.

5. Punto de conexión entre nodos: Es el punto en el cual se conectan dos nodos. Utilizando el mouse, puedes crear una conexión entre dos nodos, haciendo clic sostenido desde el botón Agregar Nodo de un nodo hasta el punto de conexión de otro nodo.

6. Eliminar Conexión: Haz clic aquí para eliminar la conexión entre dos nodos.

Algunos otros puntos a tener en cuenta en la construcción del bot y los nodos son:

• Ten en cuenta cual va a ser el mensaje o tipo de mensaje disparador de la conversación. El primer nodo del bot debe ser capaz de reconocer este mensaje y actuar con base en este.

• A excepción del primer y último nodo del flujo, todos los nodos tienen un nodo padre y uno o más nodos hijos.

• La lógica es importante al construir un flujo de conversación del bot, por lo que el orden de los nodos influirá en la fluidez y efectividad de la conversación.

• En caso de dejar nodos “huérfanos” o sin conexiones, estos estarán escuchando los mensajes del cliente de forma constante, sin tener en cuenta el resto del flujo.

Configuración de un Nodo

• Nombre: Es el nombre del nodo.

• Descripción: Es la descripción y/o objetivo del nodo dentro del flujo.

• Intención: Es la intención específica del cliente final al ingresar en el nodo. Es recomendable que las intenciones de cada uno de los nodos sean únicas y diferentes, ya que este valor servirá para sacar estadísticas y analizar las conversaciones del bot.

• Patrón: Es el patrón o regla regular que debe coincidir con los mensajes entrantes enviados por tu cliente para que el bot ejecute la lógica del nodo. Este patrón puede ser una cadena de texto exacta (por ejemplo, si el patrón dado el “Hola”, la lógica del nodo de ejecutará cuando el cliente escriba “Hola”, o una expresión regular que abarque varias opciones. Más información sobre expresiones regulares y patrones aquí: https://mzl.la/3jecVOJ

• Tipo de Nodo: Es el tipo de nodo y debe ser seleccionado de acuerdo a la finalidad del mismo (dar un mensaje al cliente, preguntar información al cliente, consultar un servicio web externo, etc.). Los tipos de nodo disponibles son (encuentra la descripción detallada de cada tipo de nodo más abajo):

  • Preguntar

  • Decir

  • Capturar: Al seleccionar este tipo de campo, los siguientes campos adicionales se desplegarán en el formulario:

    • Esperado: Digita aquí una expresión regular para validar la respuesta enviada por el cliente.

  • Lista: Al seleccionar este tipo de campo, los siguientes campos adicionales se desplegarán en el formulario:

    • Lista: Especifica aquí la lista de valores que sean mostrados al cliente para su selección. En caso de que los casos provengan de un nodo anterior de tipo Web Service, utiliza la nomenclatura asdasd.

  • Fallback: Al seleccionar este tipo de campo, los siguientes campos adicionales se desplegarán en el formulario:

    • Bot: Selecciona aquí el bot al cual se moverá la conversación en caso de exceder los intentos máximos.

    • Nodo del Bot: Selecciona aquí el nodo del bot al cual se moverá la conversación en caso de exceder los intentos máximos.

    • Intentos Máximos: Especifica aquí el máximo de intentos que tendrá el cliente para reintentar el paso anterior a este nodo.

  • Nodo Programado: Al seleccionar este tipo de campo, los siguientes campos adicionales se desplegarán en el formulario:

    • Fecha Inicial: Especifica aquí la fecha de inicio del periodo/rango durante el cual se aplicara este nodo.

    • Fecha Final: Especifica aquí la fecha de fin del periodo/rango durante el cual se aplicara este nodo.

  • Validador: Al seleccionar este tipo de campo, los siguientes campos adicionales se desplegarán en el formulario:

    • Tipo de Condición: Especifica aquí si las reglas de validación se aplicarán con el condicional y (or - todas las reglas de cumplen) ó con el condicionar o (or - alguna de las reglas de cumple).

    • Reglas de Validación: Agrega una o más reglas de validación, especificando una variable, un operador, y un valor.

  • Web Service: Al seleccionar este tipo de campo, los siguientes campos adicionales se desplegarán en el formulario:

    • Tipo de Petición: Selecciona uno de los tipo de petición HTTP disponibles (GET, HEAD, POST, PUT, DELETE, CONNECT, OPTONS, TRACE, PATCH).

    • URL/ Endpoint / IP: Especifica aquí la URL / endpoint / dirección IP de acceso al webservice. Por ejemplo, https://mywebservice.mybusiness.com/getCustomerInfo/4224563

    • Headers: Especifica aquí los headers que deberán ser agregados a la petición HTTP para consumir el web service. Pr ejemplo, { “Authorization”: “AccessKey GoCsdWE5rR2x7oXTQ4cPn4fTb5R”}.

    • Body: Especifica aquí el body o cuerpo de la petición HTTP. Generalmente, este cuerpo deberá tener una estructura en JSON. Por ejemplo, {“nombre“: “Jane”, “apellido”: “Doe}.

    • Tiempo de Espera: Especifica aquí el tiempo máximo de espera que tendrá Sagicc al consumir el web service. Al exceder ese tiempo, se considerará fallida la petición.

  • Dialog Flow

  • Ir a

    • Bot: Selecciona aquí el bot al cual se moverá la conversación.

    • Nodo del Bot: Selecciona aquí el nodo del bot al cual se moverá la conversación.

• Mensaje: Es el mensaje que será enviado al cliente en este nodo de la conversación. Puede ser un mensaje personalizado con variables, emojis 😀😎😋, enlaces (https://google.com ), o con formato (*hola*, _hola_, ~hola~).

• Acción: Corresponde a una acción que será ejecutada en Sagicc cuando la conversación entre el bot y el cliente pase por este nodo. Las acciones disponibles son:

  • Transferir a un agente: Transfiere la conversación con el cliente a un agente humano de la campaña, modificando el usuario asignado al caso generado para la conversación.

  • Transferir a una campaña: Transfiere la conversación con el cliente a una campana diferente.

  • Finalizar conversación: Marca como cerrado el caso generado para la conversación con el cliente.

  • Liberar conversación: Remueve el usuario asignado al caso generado para la conversación (Sagicc Sistema) y deja el caso libre para que cualquier agente humano pueda tomarlo y continuar la conversación con el cliente.

• Habilitado: Especifica si el nodo se encuentra habilitado o inhabilitado dentro del flujo..

Tipos de Nodo

Guardar y Publicar el Bot

Una vez finalizada la configuración del bot y todos sus nodos, haz clic en el botón Guardar de la barra superior, para guardar los cambios y publicar tu primera versión del bot.

Una vez sean guardados los cambios, verás más opciones en la barra superior.

• Selector de Versiones: Te permitirá seleccionar entre las diferentes versiones del bot, la publicada y las no publicadas). Haz clic sobre una de las versiones para cargarla en el constructor de bots y configurar sus nodos.

• Guardar: Haz clic aquí para guardar los cambios sobre la versión seleccionada del bot.

  • Guardar como nueva versión: Luego de hacer modificaciones sobre una versión especifica del bot, puedes utilizar esta opción para guardar tus cambios como una nueva versión del bot. Sagicc te pedirá digitar el nombre de la nueva versión, y al hacer clic en Continuar, tendrás una nueva versión no publicada del bot.

  • Actualizar versión existente

  • Actualizar versión seleccionada

  • Eliminar versión seleccionada

• Publicar: Haz clic aquí para publicar la versión seleccionada del bot. Al publicar una versión del bot, esta será la que defina la conversación entre el asistente virtual y los clientes.

  • Publicar como nueva versión

  • Actualizar y publicar una versión existente

  • Actualizar y publicar sobre la versión publicada