...
Nombre: Especifica un nombre para el bot.
Descripción: Agrega una descripción, indicando el objetivo/finalidad del bot.
Plantilla de Bot: Selecciona una de las plantillas de bot disponibles para comenzar a construir tu bot, o selecciona Bot Vacío si quieres crear tu bot desde cero. Las plantillas disponibles contienen ejemplos de diferentes tipos de nodos y permiten tener conversaciones con los clientes para tres casos de uso específicos:
Agendamiento de Citas: Genera una conversación para el agendamiento de una cita para un servicio específico. Contiene un nodo que consulta horarios de citas disponibles a través de un web service y las muestra al cliente para su selección.
Captura de Prospectos: Genera una conversación para la captura de prospectos para tu empresa. Captura y almacena diferentes datos del prospecto (nombre, tipo de documento, email, etc.).
Encuesta de Satisfacción: Genera una conversación para realizar una encuesta de satisfacción al cliente. Solicita al cliente la calificación de la atención recibida (en una escala de 1 a 5) y recopila comentarios.
Usar un bot existente como plantilla: Activa esta opción si deseas utilizar un bot previamente creado en la plataforma como plantilla para tu nuevo bot. Al hacerlo, se mostrará un selector con los bots disponibles. Selecciona el bot que desees y su versión publicada se duplicará y cargará automáticamente como plantilla para el nuevo bot.
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:
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á el listado con todas las versiones disponibles del bot, y las diferentes opciones de guardado del bot, como Guardar versión, : Guardar Versión y Publicar versión, etc.
El panel a la izquierda corresponde al área de trabajo, y 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 esta área de trabajo 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 área de trabajo.
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. Adicionalmente, al hacer clic en el botón "Vista Previa de la Conversación", se abrirá en este panel una ventana en la que podrás enviar un mensaje.
...
El bot iniciará el flujo de la conversación, permitiéndote validar su correcto funcionamiento.
Construir el Bot: Nodos y Conexiones
...
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 {{webhook.response}}.
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.
Usar plantilla: Activa esta opción si el mensaje que deseas enviar en el nodo corresponde a una plantilla previamente creada en Sagicc. Al activarla, podrás seleccionar la plantilla deseada.
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 ), formato específico (*hola*, _hola_, ~hola~), y puede incluir variables asociadas al caso, cliente, y demás entidades de Sagicc. Utiliza la opción Variables para copiar variables e incluirlas en el mensaje.
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
Tipo de Nodo | Descripción | Campos Adicionales | Ejemplo de Uso |
---|---|---|---|
Decir | Este tipo de nodo te permitirá decir (enviar) un mensaje específico al cliente y pasar inmediatamente al siguiente nodo del flujo. | Ninguno |
|
Preguntar | Este tipo de nodo te permitirá realizar una pregunta específica al cliente y esperar una respuesta. Las respuestas aceptadas en este nodo, como palabras, números o frases, deben estar definidas en los siguientes nodos para definir el flujo dependiendo de la respuesta dada por el cliente. | Ninguno |
|
Capturar | Este tipo de nodo te permitirá decir (enviar) un mensajes, esperar y capturar la respuesta del cliente para guardarla en una variable de Sagicc. Es posible agregar una expresión regular para validar la respuesta enviada por el cliente, y especificar la variable en la cual será almacenado dicha respuesta. Importante: Es recomendable configurar al menos 2 nodos hijos para este tipo de nodo: uno para los casos donde la respuesta del cliente si cumple con el patrón de validación, y uno para los casos donde la respuesta no cumple con el patrón. |
|
* El nombre es almacenado como primer nombre del cliente Sagicc.
* El correo electrónico es almacenado como dato de contacto del cliente Sagicc. |
Lista | Este tipo de nodo te permitirá mostrar al cliente una lista de opciones para seleccionar. Estas opciones pueden ser estáticas, o pueden consultarse previamente con un nodo de tipo Web Service. Importante: Es recomendable configurar al menos 2 nodos hijos para este tipo de nodo: uno para los casos donde el cliente selecciona una opción válida, y uno para los casos donde el cliente selecciona una opción inválida. |
|
|
Fallback | Este tipo de nodo te permitirá ejecutar una acción específica en caso de que el bot no reconozca la intención del cliente. El nodo te permitirá decir (enviar) un mensaje al cliente, y volver al nodo anterior para que el cliente intente seguir con la conversación. Este comportamiento se repetirá un número especifico de veces, y en caso de llegar al máximo de intentos, se podrá mover la conversación a otro nodo o bot específicos. |
|
|
Nodo Programado | Este nodo te permitirá ejecutar una acción en un periodo/rango de tiempo específico (por ejemplo, enviar a tu cliente un mensaje durante las festividades). Este nodo tiene en cuenta una fecha de inicio y una fecha de fin, para definir si se aplica la lógica del nodo y se envía el mensaje al cliente. Si el nodo no es aplicable, el bot se saltará este nodo y pasara al siguiente. |
|
|
Validador | Este nodo te permitirá realizar validaciones avanzadas de las variables de entrada capturadas por el bot. Es posible configurar una o mas reglas de validación en este nodo. Importante: Es recomendable configurar al menos 2 nodos hijos para este tipo de nodo: uno para los casos donde la variable de entrada cumpla las reglas de validación, y uno para los casos donde la variable de entrada no cumple las reglas de validación. |
| |
Web Service | Este tipo de nodo te permitirá realizar integraciones con servicios externos a Sagicc, consumir APIs o web service y procesar información para ser utilizada por el bot. Este nodo realiza una petición a un web service de tipo REST, y almacena la información obtenida en la variable {{webhook.response}}, que podrá ser utilizada en los nodos siguientes. Importante: Es recomendable configurar al menos 2 nodos hijos para este tipo de nodo: uno para los casos donde la petición al web service sea exitosa y se obtenga información, y uno para los casos donde la petición al web service falle o se presente un error. |
|
* El nodo consume el web service configurado y obtiene la información del cliente. |
Dialog Flow | Este nodo te permitirá realizar una fácil integración con el servicio Dialog Flow (Google) y conectar tus proyectos con el bot (más información sobre Dialog Flow aquí https://dialogflow.cloud.google.com/ ). Recuerda que necesitas acceso administrador a la cuenta de Dialog Flow para obtener las credenciales del proyecto y configurar este nodo. | ||
Ir a | Este nodo te permitirá enviar la conversación con el cliente a un nodo específico del bot o mover la conversación a otro bot de Sagicc. |
|
Guardar y Publicar el Bot
...