Hola, Humans. ¿En qué podemos ayudarte?

Construyendo un flujo
31 min
Creado por Humanz en 03/06/2022 12:28
Actualizado por Maria Malheiro en 26/10/2023 16:58

Después de seleccionar la creación de un nuevo flujo, será redirigido al Diseño del Bot, la pantalla de construcción del flujo de conversación.

La pantalla de construcción del flujo tiene burbujas de inicio y fin del flujo y una línea de conexiones entre cada paso.

En la barra inferior, encontrará los botones de Recargar, Guardar, Probar y Publicar flujo, y Exportar como imagen.



En el lado derecho, al hacer clic en el ícono morado, se muestra el código JSON del flujo. 


Conexiones
En el flujo de la conversación, existen três botones:


icone-adicionar-flow.png :crea un nuevo paso de interacción en el flujo o integraciones para ser utilizadas durante la conversación.


icone-editar-flow.png :abre la pantalla para editar el nombre de la conexión (etiqueta).


icone-excluir-flow.png :elimina la conexión entre cada paso (step).



La conexión se puede hacer arrastrando el ratón al siguiente paso.

Inclusión de pasos

Al hacer clic en el ícono de inclusión de un nuevo paso, aparece la pantalla Crear nuevo paso con las siguientes opciones disponibles:


  • Mensaje del sistema: corresponde al paso activo del sistema, activado automáticamente. Ejemplo: solicitud de API o pregunta de chatbot.
  • Mensaje del usuario: es la absorción de información durante el recorrido, creando una variable con un valor a completar. Ejemplo: respuesta del usuario a partir de una pregunta.
  • Punto de decisión: división del camino del flujo, basada en decisiones.
  • Control de variables: Durante la construcción del flujo, en cualquier punto entre el paso inicial y final, se puede agregar el componente de variables, y su funcionalidad se limita a declarar y asignar valor a las variables. Estas variables se pueden utilizar en otros componentes o lógicas en el flujo.


  • Título: título para el control de variables (opcional).

  • Nombre: nombre de la variable.

  • Expresión: valor que se asignará a la variable o expresión que definirá el valor.


Justo debajo, se enumeran las integraciones disponibles para utilizar durante la conversación.

  • Disparar SMS: permite enviar un SMS a un teléfono determinado en un momento específico.
  • Generar URL: paso que genera la URL de la sesión de chat que se enviará al usuario.
  • Temporizador: tiempo de espera para ejecutar el siguiente paso del chatbot.
  • Lead: integración con herramientas de Inbound Marketing (RD Station o Sharpspring) para la generación de leads.
  • Ticket: integración con la herramienta ZenDesk para la creación de tickets.
  • Fork: crea una bifurcación (paralelismo) en el flujo, permitiendo la ejecución de dos recorridos simultáneos.
  • Join: agrupa la bifurcación de los pasos (steps) realizada por Fork.
  • Json API: crea una llamada de API externa.
  • Configurar Webhook: crea la comunicación de un Webhook.
  • Recibe Webhook: permite configurar la recepción de una respuesta de retorno a través de un Webhook.


También hay pasos (steps) de interacción en el flujo que ya almacenan la respuesta del usuario. Consulte.

  • Validar correo electrónico;
  • Validar CNPJ;
  • Validar DNI;
  • Google Calendar;
  • Consultar CEP;
  • Validar correo electrónico;
  • Validar teléfono;
  • Integración Watson;
  • Componente Zenvia Chat;
  • Pregunta Nombre;
  • Pregunta Fecha;
  • Encuesta NPS.

Crear nuevo paso: Mensaje del Sistema

Vamos a ver un ejemplo de cómo crear los pasos (steps) de las conversaciones por chat? El paso de la conversación por chat se puede construir con cinco tipos de presentación disponibles en la interfaz del usuario, como se muestra a continuación:


  1. Mensaje (mensaje simple o pregunta)

Aquí, podemos enviar un mensaje simple al usuario o hacer una pregunta.

Para usar datos patrocinados*, debe cambiar el dominio del chat a m.chatbot.zenvia.com.


*Los datos utilizados en la navegación no se cobran al usuario, también se llaman números gratuitos (0800).


Al agregar tráfico de datos multimedia (imágenes, por ejemplo), la navegación comienza a tener costo. Opción disponible para el plan Enterprise. Para agregar preguntas de interacción con el usuario en las que ofrezca respuestas, complete los campos a continuación.

  • Pregunta: cuerpo del mensaje de la pregunta.
  • Opciones de respuesta: serán opciones de respuesta para los usuarios, siendo necesario al menos 2 respuestas.
  1. Multimedia

Aquí se pueden cargar imágenes, fotos, archivos, GIFs.

  1. Botones

Los botones son opciones de respuesta o enlaces. Existe una limitación de 3 respuestas debido a las características de los canales. Hay un límite de caracteres por botón, es decir, si un cliente ingresa dos palabras en un botón, por ejemplo: (Botones de prueba), al usar un espacio entre las palabras, el límite será de 20 caracteres. Por otro lado, si no hay espacio entre las palabras, no hay un límite establecido.

En WhatsApp, la limitación es de solo 3 botones por regla del propio canal:

  1. Tarjeta

La tarjeta es una opción visual con imagen y descripción del producto.

Ingrese el título de la tarjeta y el mensaje a enviar. Luego, cargue la imagen o inserte una URL. Finalmente, agregue los botones con la posibilidad de enlaces externos y sugerencias de respuesta para el usuario.



  1. Carrusel

El carrusel es una forma o formato de anunciar su producto. El carrusel no es más que un conjunto de tarjetas en las que es posible tener secuencias con varias imágenes y descripciones del producto. El carrusel trabaja con el concepto de rotación, es decir, son mensajes diferentes que se mostrarán en forma rotativa.

Con esto, puede colocar de 3 a 5 imágenes de su producto en Facebook, por ejemplo (para mostrar diferentes detalles) o anunciar elementos diferentes. Además de la dinámica, otra ventaja es que cada imagen tiene descripciones y enlaces propios. Esto aumenta las posibilidades de clics por parte de los usuarios.

En Zenvia Bots, ingrese el título de la tarjeta y el mensaje a enviar en cada carrusel. Luego, cargue la imagen o inserte una URL. Finalmente, agregue los botones con la posibilidad de enlaces externos y sugerencias de para el usuario.





    6. Lista (WhatsApp)

La opción de lista permite literalmente enumerar las alternativas para que su cliente seleccione. Actualmente, esta función está disponible para el canal de WhatsApp y con limitaciones de 10 líneas y solo una opción seleccionable.

Puede crear hasta 10 secciones, pero el total de líneas de todas las secciones no puede superar los 10 elementos.

Ejemplo: En la lista a continuación, tenemos el número máximo de líneas (10), y el receptor del mensaje solo podrá elegir 1 opción entre las 10.


Sección 1 = Ropa

Ítems:

línea 1 = camiseta

línea 2 = pantalón

línea 3 = calcetines

línea 4 = traje de baño

línea 5 = falda

Sección 2 = Accesorios

Ítems

línea 6 = gafas

línea 7 = bolso

línea 8 = anillo

Sección 3 = Bebidas

Ítems

línea 9 = agua

línea 10 = café


Rellenando los campos iniciales:

  • Título: Elija un título para el mensaje (obligatorio).
  • Mensaje a enviar: Describa algo sobre las secciones que se crearán (obligatorio).
  • Pie de página: Cree un pie de página (opcional).
  • Título del botón: Cree un título para el botón (obligatorio).


Rellenando las secciones, siguiendo el ejemplo de la lista anterior, habrá campos para:

Título de la sección: Inserte la información principal de la sección.

Ítems de la sección: Identificador del ítem de la sección: en este campo debe ingresar el ID del ítem, que posteriormente podrá manejar en la continuación del flujo. Se considera el valor fijo de la opción seleccionada (obligatorio).

Título del ítem de la sección: Información que se mostrará en la pantalla del usuario (obligatorio).

Descripción del ítem de la sección: Información que se mostrará en la pantalla del usuario como descripción del ítem seleccionado (opcional).


Selección

En este momento, solo es posible seleccionar una de las opciones de la lista, debido a las limitaciones del canal de WhatsApp.

Crear nuevo paso: Mensaje del Usuario

Por definición, el paso (step) Mensaje del Usuario corresponde a la absorción de información durante la jornada, creando una variable con un valor que debe completarse. Para configurar, no es obligatorio ingresar un Título del paso. En el campo Nombre, debe ingresar el nombre de su variable, por ejemplo, fecha_nacimiento.

En Expresión, deje la palabra "payload", que representa cualquier carga de una transmisión de datos, es decir, se refiere a los datos recibidos por el sistema destinatario.



Dado que es un paso denominado Mensaje del Usuario, el flujo se detiene en este momento de la jornada, esperando la acción de respuesta para continuar.

Crear nuevo paso: Punto de Decisión/Árbol de Decisión

A partir de la respuesta del usuario, es posible decidir el camino que seguirá, creando puntos de decisión, según el llenado de los campos a continuación.


  • Título: título para el punto de decisión (opcional).
  • Nombre: nombre para el punto de decisión que será guiado por la flecha.
  • Tipo: Palabra clave o Lenguaje de Expresión: comprensión del chatbot.
  • Condición: relacionada con la respuesta del usuario.
  • Opciones de manejo de respuestas inválidas: el chatbot puede responder automáticamente cuando no comprende el mensaje del usuario.

Utilice la opción "Agregar tratamiento de respuestas de usuario no válidas" (opcional) para configurar un mensaje en el que su flujo responderá si el usuario escribe algo incorrecto o pregunta algo que su flujo aún no sabe. 


Palabra clave: es una función que busca palabras clave en la última interacción del usuario. Si existe la palabra, se toma una decisión en función de ella.

Lenguaje de Expresión: permite al usuario crear expresiones lógicas (como comparar un atributo para generar un booleano, por ejemplo) o validar condicionales. Esta opción se puede utilizar sin asociación con el mensaje. Vea aquí el artículo completo sobre el Punto de Decisión/Árbol de Decisión.

Json - Abriendo el Json del Flujo

En el menú lateral, como mencionamos al principio, en el ícono morado, puede abrir la vista del código del flujo del chatbot construido, en JSON.

Los cambios realizados en la interfaz modifican el código, al igual que los cambios en el código modifican el flujo mostrado.

En la primera parte, tenemos la configuración de los pasos. Esta parte del código es responsable de construir los pasos de interacción, respuesta o pasos avanzados.

En la segunda parte, tenemos la configuración de las conexiones, con referencias de/para, donde también se consideran las lógicas que determinan los caminos a seguir dentro del flujo.

Al final de la estructura se encuentra la configuración del canal de conversación.

Todos los flujos creados por la interfaz de Zenvia Bots agregan el campo "historic" en el json, con el valor inicial en falso.

Para que el historial se envíe en las integraciones con Zenvia Chat y Zenvia Conversion, por ejemplo, este campo debe configurarse en verdadero, como se muestra a continuación:


{

"alias": "30/01/2023 08:50:11",

"description": "",

"historic": true,

"steps": [

{

"id": "idEventoInicial".

 

03. Construyendo un flujo


Después de seleccionar la creación de un nuevo flujo, será redirigido al Diseño del Bot, la pantalla de construcción del flujo de conversación.


La pantalla de construcción del flujo tiene burbujas de inicio y fin del flujo y una línea de conexiones entre cada paso.


En la barra inferior, encontrará los botones de Recargar, Guardar, Probar y Publicar flujo, y Exportar como imagen.



En el lado derecho, al hacer clic en el ícono morado, se muestra el código JSON del flujo. 


Conexiones

En el flujo de la conversación, existen três botones:


icone-adicionar-flow.png :crea un nuevo paso de interacción en el flujo o integraciones para ser utilizadas durante la conversación.


icone-editar-flow.png :abre la pantalla para editar el nombre de la conexión (etiqueta).


icone-excluir-flow.png :elimina la conexión entre cada paso (step).



La conexión se puede hacer arrastrando el ratón al siguiente paso.


Inclusión de pasos


Al hacer clic en el ícono de inclusión de un nuevo paso, aparece la pantalla Crear nuevo paso con las siguientes opciones disponibles:


Mensaje del sistema: corresponde al paso activo del sistema, activado automáticamente. Ejemplo: solicitud de API o pregunta de chatbot.


Mensaje del usuario: es la absorción de información durante el recorrido, creando una variable con un valor a completar. Ejemplo: respuesta del usuario a partir de una pregunta.


Punto de decisión: división del camino del flujo, basada en decisiones.


Control de variables: Durante la construcción del flujo, en cualquier punto entre el paso inicial y final, se puede agregar el componente de variables, y su funcionalidad se limita a declarar y asignar valor a las variables. Estas variables se pueden utilizar en otros componentes o lógicas en el flujo.




  • Título: título para el control de variables (opcional).

  • Nombre: nombre de la variable.

  • Expresión: valor que se asignará a la variable o expresión que definirá el valor.



Justo debajo, se enumeran las integraciones disponibles para utilizar durante la conversación.


Disparar SMS: permite enviar un SMS a un teléfono determinado en un momento específico.


Generar URL: paso que genera la URL de la sesión de chat que se enviará al usuario.


Temporizador: tiempo de espera para ejecutar el siguiente paso del chatbot.


Lead: integración con herramientas de Inbound Marketing (RD Station o Sharpspring) para la generación de leads.


Ticket: integración con la herramienta ZenDesk para la creación de tickets.


Fork: crea una bifurcación (paralelismo) en el flujo, permitiendo la ejecución de dos recorridos simultáneos.


Join: agrupa la bifurcación de los pasos (steps) realizada por Fork.


Json API: crea una llamada de API externa.


Configurar Webhook: crea la comunicación de un Webhook.


Recibe Webhook: permite configurar la recepción de una respuesta de retorno a través de un Webhook.



También hay pasos (steps) de interacción en el flujo que ya almacenan la respuesta del usuario. Consulte.


  • Validar correo electrónico;

  • Validar CNPJ;

  • Validar DNI;

  • Google Calendar;

  • Consultar CEP;

  • Validar correo electrónico;

  • Validar teléfono;

  • Integración Watson;

  • Componente Zenvia Chat;

  • Pregunta Nombre;

  • Pregunta Fecha;

  • Encuesta NPS.




Crear nuevo paso: Mensaje del Sistema

Vamos a ver un ejemplo de cómo crear los pasos (steps) de las conversaciones por chat? El paso de la conversación por chat se puede construir con cinco tipos de presentación disponibles en la interfaz del usuario, como se muestra a continuación:



  1. Mensaje (mensaje simple o pregunta)

Aquí, podemos enviar un mensaje simple al usuario o hacer una pregunta.

Para usar datos patrocinados*, debe cambiar el dominio del chat a m.chatbot.zenvia.com.


*Los datos utilizados en la navegación no se cobran al usuario, también se llaman números gratuitos (0800).



Al agregar tráfico de datos multimedia (imágenes, por ejemplo), la navegación comienza a tener costo.


Opción disponible para el plan Enterprise.


Para agregar preguntas de interacción con el usuario en las que ofrezca respuestas, complete los campos a continuación.


Pregunta: cuerpo del mensaje de la pregunta.


Opciones de respuesta: serán opciones de respuesta para los usuarios, siendo necesario al menos 2 respuestas.


  1. Multimedia

Aquí se pueden cargar imágenes, fotos, archivos, GIFs.


  1. Botones

Los botones son opciones de respuesta o enlaces. Existe una limitación de 3 respuestas debido a las características de los canales. Hay un límite de caracteres por botón, es decir, si un cliente ingresa dos palabras en un botón, por ejemplo: (Botones de prueba), al usar un espacio entre las palabras, el límite será de 20 caracteres. Por otro lado, si no hay espacio entre las palabras, no hay un límite establecido.


En WhatsApp, la limitación es de solo 3 botones por regla del propio canal:



  1. Tarjeta

La tarjeta es una opción visual con imagen y descripción del producto.

Ingrese el título de la tarjeta y el mensaje a enviar. Luego, cargue la imagen o inserte una URL. Finalmente, agregue los botones con la posibilidad de enlaces externos y sugerencias de respuesta para el usuario.







  1. Carrusel

El carrusel es una forma o formato de anunciar su producto. El carrusel no es más que un conjunto de tarjetas en las que es posible tener secuencias con varias imágenes y descripciones del producto. El carrusel trabaja con el concepto de rotación, es decir, son mensajes diferentes que se mostrarán en forma rotativa.


Con esto, puede colocar de 3 a 5 imágenes de su producto en Facebook, por ejemplo (para mostrar diferentes detalles) o anunciar elementos diferentes. Además de la dinámica, otra ventaja es que cada imagen tiene descripciones y enlaces propios. Esto aumenta las posibilidades de clics por parte de los usuarios.


En Zenvia Bots, ingrese el título de la tarjeta y el mensaje a enviar en cada carrusel. Luego, cargue la imagen o inserte una URL. Finalmente, agregue los botones con la posibilidad de enlaces externos y sugerencias de para el usuario.






6. Lista (WhatsApp)

La opción de lista permite literalmente enumerar las alternativas para que su cliente seleccione. Actualmente, esta función está disponible para el canal de WhatsApp y con limitaciones de 10 líneas y solo una opción seleccionable.


Puede crear hasta 10 secciones, pero el total de líneas de todas las secciones no puede superar los 10 elementos.


Ejemplo: En la lista a continuación, tenemos el número máximo de líneas (10), y el receptor del mensaje solo podrá elegir 1 opción entre las 10.


Sección 1 = Ropa

Ítems:

línea 1 = camiseta

línea 2 = pantalón

línea 3 = calcetines

línea 4 = traje de baño

línea 5 = falda

Sección 2 = Accesorios

Ítems

línea 6 = gafas

línea 7 = bolso

línea 8 = anillo

Sección 3 = Bebidas

Ítems

línea 9 = agua

línea 10 = café


Rellenando los campos iniciales:


Título: Elija un título para el mensaje (obligatorio)

Mensaje a enviar: Describa algo sobre las secciones que se crearán (obligatorio)

Pie de página: Cree un pie de página (opcional)

Título del botón: Cree un título para el botón (obligatorio)


Flujo:



Rellenando las secciones:


Siguiendo el ejemplo de la lista anterior, habrá campos para:


Título de la sección: Inserte la información principal de la sección


Ítems de la sección:


Identificador del ítem de la sección: en este campo debe ingresar el ID del ítem, que posteriormente podrá manejar en la continuación del flujo. Se considera el valor fijo de la opción seleccionada (obligatorio).


Título del ítem de la sección: Información que se mostrará en la pantalla del usuario (obligatorio).


Descripción del ítem de la sección: Información que se mostrará en la pantalla del usuario como descripción del ítem seleccionado (opcional).



Selección

En este momento, solo es posible seleccionar una de las opciones de la lista, debido a las limitaciones del canal de WhatsApp.


Crear nuevo paso: Mensaje del Usuario

Por definición, el paso (step) Mensaje del Usuario corresponde a la absorción de información durante la jornada, creando una variable con un valor que debe completarse.


Para configurar, no es obligatorio ingresar un Título del paso.

En el campo Nombre, debe ingresar el nombre de su variable, por ejemplo, fecha_nacimiento.


En Expresión, deje la palabra "payload", que representa cualquier carga de una transmisión de datos, es decir, se refiere a los datos recibidos por el sistema destinatario.




Dado que es un paso denominado Mensaje del Usuario, el flujo se detiene en este momento de la jornada, esperando la acción de respuesta para continuar.


Crear nuevo paso: Punto de Decisión/Árbol de Decisión

A partir de la respuesta del usuario, es posible decidir el camino que seguirá, creando puntos de decisión, según el llenado de los campos a continuación.


Título: título para el punto de decisión (opcional).

Nombre: nombre para el punto de decisión que será guiado por la flecha.

Tipo: Palabra clave o Lenguaje de Expresión: comprensión del chatbot.

Condición: relacionada con la respuesta del usuario.

Opciones de manejo de respuestas inválidas: el chatbot puede responder automáticamente cuando no comprende el mensaje del usuario.


Utilice la opción "Agregar tratamiento de respuestas de usuario no válidas" (opcional) para configurar un mensaje en el que su flujo responderá si el usuario escribe algo incorrecto o pregunta algo que su flujo aún no sabe. 



Palabra clave: es una función que busca palabras clave en la última interacción del usuario. Si existe la palabra, se toma una decisión en función de ella.

Lenguaje de Expresión: permite al usuario crear expresiones lógicas (como comparar un atributo para generar un booleano, por ejemplo) o validar condicionales. Esta opción se puede utilizar sin asociación con el mensaje. Vea aquí el artículo completo sobre el Punto de Decisión/Árbol de Decisión.

Json - Abriendo el Json del Flujo

En el menú lateral, como mencionamos al principio, en el ícono morado, puede abrir la vista del código del flujo del chatbot construido, en JSON.


Los cambios realizados en la interfaz modifican el código, al igual que los cambios en el código modifican el flujo mostrado.


En la primera parte, tenemos la configuración de los pasos. Esta parte del código es responsable de construir los pasos de interacción, respuesta o pasos avanzados.


En la segunda parte, tenemos la configuración de las conexiones, con referencias de/para, donde también se consideran las lógicas que determinan los caminos a seguir dentro del flujo.


Al final de la estructura se encuentra la configuración del canal de conversación.


💡Consejo: Todos los flujos creados por la interfaz de Zenvia Bots agregan el campo "historic" en el json, con el valor inicial en falso.


Para que el historial se envíe en las integraciones con Zenvia Chat y Zenvia Conversion, por ejemplo, este campo debe configurarse en verdadero, como se muestra a continuación:


{

"alias": "30/01/2023 08:50:11",

"description": "",

"historic": true,

"steps": [

{

"id": "idEventoInicial".