Flujos de Conversación

La página de Flujos de Conversación permite a los administradores del tenant diseñar flujos basados en datos que el chatbot ejecuta cuando un contacto selecciona un nodo Flujo en un Menú de Conversación. Un flujo es una secuencia de variables tipadas y pasos ordenados; cada paso puede pedir entrada al contacto, invocar una Habilidad de Conversación o ramificar según lo que el contacto haya respondido.

Acceso a la Página

• Ruta: /communications/flows
• Ruta del Menú: Comunicaciones → Flujos de Conversación
• Audiencia principal: Administradores del tenant que construyen flujos conversacionales de autoservicio.

Permisos

Permiso	Descripción
communications.access (Lectura)	Ver los flujos y sus pasos
communications.access (Admin)	Crear, editar, clonar y eliminar flujos; agregar o reordenar variables y pasos

Distribución de la Página

• Panel izquierdo — lista de flujos del tenant. Cada entrada muestra el nombre del flujo y una descripción corta.
• Panel derecho — tres pestañas para el flujo seleccionado: Variables, Pasos y Configuración.

Estado del Flujo

Estado	Descripción
Borrador	El flujo está siendo diseñado y aún no está adjunto a ningún menú.

Una vez que un flujo se adjunta a un nodo Flujo en un Menú de Conversación, los contactos pueden invocarlo; no existe un paso “publicar” separado más allá de guardar el flujo.

Pestaña Variables

Cada variable declara una ranura tipada que el flujo llena con la entrada del contacto o la salida de una habilidad, y que los pasos posteriores pueden referenciar.

Campo	Descripción
Nombre	Identificador usado por los pasos (por ejemplo, customer_phone)
Tipo	Texto, número, fecha, booleano, ID de SN u otros tipos registrados
Descripción	Nota interna sobre el uso de la variable
Predeterminado	Valor por defecto opcional cuando el contacto no proporciona uno

Las variables se pueden reordenar arrastrando y soltando.

Pestaña Pasos

Los pasos se ejecutan secuencialmente. Cada paso es uno de:

Tipo de Paso	Descripción
Prompt	Envía un mensaje al contacto y espera una respuesta, almacenándola en una variable.
Habilidad	Invoca una Habilidad de Conversación usando las variables actuales como parámetros y escribe el resultado en una variable.
Ramificación	Elige el siguiente paso según el valor de una variable.
Envío	Envía un mensaje final al contacto (frecuentemente el resultado formateado de una llamada anterior a una habilidad).

Los pasos se pueden reordenar arrastrando y soltando.

Pestaña Configuración

Campo	Descripción
Nombre	Nombre para mostrar del flujo
Descripción	Descripción interna de qué hace el flujo

Acciones

Acciones de Página

Acción	Descripción	Permiso
Nuevo flujo	Abre el diálogo de creación de flujo	communications.access (Admin)

Acciones del Flujo

Acción	Descripción
Clonar	Duplica el flujo, incluyendo sus variables y pasos, en un nuevo flujo Borrador
Eliminar	Elimina el flujo. Los nodos Flujo que apuntaban a él aparecen en el editor de menús con la insignia “Flujo no disponible”.
Añadir variable / paso	Agrega una nueva variable o paso a la pestaña correspondiente
Reordenar	Arrastra y suelta una variable o paso a una nueva posición

Notas

• La clonación preserva variables y pasos pero siempre crea la copia en estado Borrador, con "(copy)" añadido al nombre original.
• Un flujo no se puede eliminar mientras algún Menú de Conversación tenga un nodo Flujo apuntando a él — primero elimina el nodo del menú.
• Las referencias a variables en el contenido de los pasos usan la sintaxis {{nombre_variable}}, reflejando cómo las plantillas de correo y WhatsApp renderizan los marcadores.
• Los pasos Habilidad fallan en tiempo de ejecución si la habilidad destino fue retirada o el tenant perdió acceso al módulo origen. La conversación regresa al menú padre y el fallo se registra en Registros de Conversación.

Tareas Comunes

1. Abre Comunicaciones → Flujos de Conversación.
2. Haz clic en Nuevo flujo y nómbralo “Onboarding de cliente nuevo”.
3. En la pestaña Variables, agrega una variable prospect_name (Texto) y una variable prospect_phone (Texto).
4. En la pestaña Pasos, agrega un paso Prompt pidiendo el nombre del cliente y guárdalo en prospect_name, luego un paso Habilidad llamando a prospects.create_or_find.
5. Abre Comunicaciones → Menús de Conversación, edita el menú predeterminado y agrega un nodo Flujo que apunte a este flujo.

Páginas Relacionadas

• Menús de Conversación — adjunta un flujo a un nodo Flujo en un menú
• Habilidades de Conversación — las habilidades que puedes llamar desde un paso Habilidad
• Registros de Conversación — ver cómo se ejecutó un flujo para un contacto específico