## Visión general

El **Flow Builder** es el constructor visual de flujos conversacionales de ConversaLabs. En lugar de
escribir código, armas el diálogo conectando **nodos** en un lienzo: un mensaje lleva a un menú de
opciones, que lleva a una condición, que puede consultar una API y seguir caminos distintos según la
respuesta del contacto.

Es la herramienta adecuada cuando la automatización necesita **varios pasos e interacción** —
autoservicio por menú, calificación de leads, agendamiento, captura de datos e integraciones — más
allá de lo que puede hacer una regla simple.

## Requisitos previos

- El módulo **Flow Builder** habilitado para tu cuenta (recurso opcional, activado por plan/flag). Si
  no aparece en el menú, habla con un administrador.
- Permiso de administrador para crear y publicar flujos.
- Una bandeja de entrada (por ejemplo, WhatsApp) donde se disparará el flujo.
- Para nodos que dependen de otros módulos (Pagos, Follow-ups, CRM, Contratos), el módulo
  correspondiente debe estar activo.

## Paso a paso

1. Abre el **Flow Builder** y crea un nuevo flujo (puedes partir de una plantilla de la galería).
2. Configura el **disparador** del flujo (el evento que lo inicia) en el nodo de inicio.
3. Arrastra **nodos** desde el panel al lienzo y conéctalos para dibujar el camino de la conversación.
4. Configura cada nodo en el panel lateral (texto del mensaje, opciones del menú, regla de la
   condición, URL de la solicitud, etc.).
5. Usa **variables** para guardar y reutilizar las respuestas del contacto y los datos de integraciones.
6. **Prueba** el flujo (hay herramientas de prueba de solicitud y de seguimiento de sesión) y **publícalo**.

## Configuración y opciones

Tipos de nodo más usados:

| Nodo | Para qué sirve |
| --- | --- |
| Mensaje de texto | Envía un texto al contacto. |
| Menú de opciones | Presenta botones o una lista para que el contacto elija. |
| Multimedia | Envía imagen, video, audio o documento. |
| Condición | Sigue caminos distintos según una regla/variable. |
| Solicitud HTTP | Consulta una API externa y usa la respuesta en el flujo. |
| Variación A/B | Divide el tráfico entre caminos para probar mensajes. |
| Pago | Crea/envía un cobro y espera el pago (módulo Pagos). |
| Follow-up | Inscribe o cancela al contacto en una secuencia (módulo Follow-ups). |
| Contrato | Envía un contrato para firma (módulo Contratos). |
| Acción de contacto | Ejecuta acciones en el contacto: etiqueta, nota y atributo personalizado (categoría Contactos). |
| Crear contacto | Crea un contacto (nombre, correo, teléfono), con deduplicación nativa. |
| Crear conversación | Abre una conversación en una bandeja, con estado y mensaje inicial opcionales. |
| Nota privada | Deja una nota privada en la conversación (también disponible en los flujos). |

- **Variables**: captura respuestas y datos de API y reutilízalos en mensajes y condiciones.
- **Disparador Reserva de calendario**: inicia el flujo cuando una reserva se crea o cambia de estado
  en el módulo Agenda; el contacto y la conversación vinculados están disponibles cuando existen.
- **Disparador Cita de la agenda**: inicia el flujo cuando una **cita** se crea, se reprograma o se
  cancela — incluidas las creadas desde el panel, desde Maestro, desde una automatización o cambiadas
  directamente en Google Calendar. Usa este cuando la cita **no** nace de la página pública de reservas
  (que es el disparador anterior). El estado llega al flujo, así que una **Condición** puede separar
  creada de reprogramada y de cancelada.
- **Galería de plantillas**: empieza desde un flujo listo y adáptalo.
- **Prueba y seguimiento de sesión**: valida el comportamiento antes de publicar.

### Botones y listas en WhatsApp

Los nodos **Enviar botones** y **Enviar lista** llegan como mensaje interactivo nativo en WhatsApp Cloud,
Coexistencia, WhatsApp Web y la bandeja híbrida unificada. Además del mensaje y los elementos, puedes
definir:

| Campo | Nodo | Qué aparece en WhatsApp |
| --- | --- | --- |
| Encabezado | Botones y lista | Título en negrita encima del mensaje, hasta 60 caracteres. |
| Texto del botón de la lista | Lista | Texto del botón que abre la lista, hasta 20 caracteres. |
| Descripción | Elementos de la lista | Texto más pequeño debajo de cada elemento, hasta 72 caracteres. |
| Título de la sección | Lista (Avanzado) | Título encima de los elementos cuando se abre la lista, hasta 24 caracteres. |
| Pie de página | Botones y lista (Avanzado) | Texto pequeño en gris debajo del mensaje, hasta 60 caracteres. |

Todos los campos son opcionales y aceptan variables. Deja el **encabezado** vacío para que la lista llegue
sin título. Si el **texto del botón de la lista** está vacío, usamos "Elige un elemento" en el idioma de la
cuenta. En WhatsApp Web los botones siempre muestran un título: sin encabezado, usamos "Opciones" en el
idioma de la cuenta. El **valor** de cada elemento identifica la opción elegida: es lo que el flujo compara en una espera por
opción. En las demás esperas, el flujo recibe el título del elemento.

### Esperas de respuesta y atención humana

En **Esperar respuesta** y **Esperar respuesta de follow-up**, configura el tipo de entrada y las
opciones válidas. Mientras queden intentos, una respuesta no válida envía el **Mensaje de respuesta
no válida**; si está vacío, usa el **Mensaje de reintento**. Completa al menos uno para orientar al
contacto, por ejemplo: "No entendí. Responde 1 para confirmar o 2 para cancelar". Volver a procesar
el mismo mensaje del contacto no consume otro intento ni envía el aviso dos veces.

En **Atención humana**, el valor predeterminado es **Finalizar espera y sesión**: cuando un agente
envía una respuesta pública en la conversación, se cancelan esa espera de respuesta y su sesión.
Las notas privadas, los mensajes de bots, las campañas y los mensajes identificados como
automatización no cuentan como atención humana. La cancelación no envía mensajes, no reabre la conversación ni cambia su
asignación. Una respuesta posterior del contacto no reanuda la sesión cancelada ni ejecuta sus
siguientes pasos. En el historial de la sesión, la salida del nodo registra el motivo
`human_takeover` y el disparador `agent_message`.

Las sesiones del mismo flujo que ya estaban en la cola de esa conversación también se cancelan,
con el mismo motivo en su historial. No empiezan más tarde para responder encima del agente.

Una macro enviada manualmente por un agente y un borrador de follow-up aprobado por él cuentan
como respuestas humanas. Una entrega de mensaje programado no cuenta, aunque el remitente sea
un agente o se adelante con enviar ahora. Una copia inmediata fuera de esa entrega programada
cuenta cuando usa el usuario del agente. El enlace de reunión enviado automáticamente por la
Agenda no cuenta.

**Este valor predeterminado también se aplica a flujos publicados que no tienen el campo
configurado.** Para mantener la espera después de la respuesta de un agente, elige **Mantener
espera** en el nodo y publica una nueva versión. La elección se registra al empezar la espera;
editar el nodo no modifica esperas que ya empezaron. Esta regla no cambia **Esperar hasta** ni las
esperas de eventos.

Resolver la conversación sin responder **no finaliza la espera**: el flujo aún puede consumir el
siguiente mensaje del contacto. Envía una respuesta pública antes de resolver **o cancela la sesión
desde la pantalla de sesiones**. Una resolución automática tampoco cancela esta espera.

Una integración o herramienta MCP que envía una respuesta pública usando el usuario de un agente
cuenta como atención humana y finaliza la espera. Para mantener el comportamiento anterior en ese
caso, selecciona **Mantener espera** en el nodo. La atención desde el teléfono o el eco de un mensaje
externo sin un usuario de agente identificado no finaliza la espera según esta regla; el eco también
puede confirmar un mensaje que envió la propia plataforma.

## Casos de uso

- **Autoservicio por menú**: el contacto elige un tema y es dirigido al equipo correcto.
- **Calificación de leads**: preguntas en secuencia que guardan respuestas en variables y en el CRM.
- **Agendamiento y cobro**: recopilar datos, crear un cobro y confirmar tras el pago.
- **Integración**: consultar un pedido mediante una solicitud HTTP y responder el estado al cliente.

## Consejos, límites y buenas prácticas

- Dibuja el flujo en papel antes de armarlo — mapea los caminos y los puntos de salida.
- Ofrece siempre una salida para **hablar con un humano**; no todo debe quedar automático.
- Prueba cada camino, incluidas las respuestas inesperadas del contacto.
- Cuidado con los bucles y el exceso de mensajes (buenas prácticas anti-ban de WhatsApp).
- Mantén los flujos cortos y concretos — divide los flujos muy grandes en partes reutilizables.

## Solución de problemas

- **No veo el Flow Builder**: el módulo puede no estar habilitado para la cuenta o tu rol.
- **El flujo no inicia**: revisa el disparador y que el flujo esté publicado y vinculado a la bandeja
  de entrada correcta.
- **El flujo se detuvo a la mitad**: probablemente un nodo no tiene camino de salida para la respuesta
  recibida — cubre todas las opciones y añade un camino por defecto.
- **La solicitud HTTP falló**: usa el probador de solicitud para revisar la URL, las cabeceras y la respuesta.
- **La lista llegó con título o botón en otro idioma**: define el **Encabezado** y el **Texto del botón
  de la lista** en el nodo. Los campos vacíos usan los textos predeterminados en el idioma configurado en la
  cuenta.
- **El texto del botón o del encabezado llegó cortado**: WhatsApp limita estos campos y los emojis ocupan
  más espacio. Acorta el texto o la variable utilizada.

## Ver también

- [Visión general de Automatización y Flujos](/hc/ajuda/articles/automation-flows-overview-es)
- [Reglas de automatización: disparadores, condiciones y acciones](/hc/ajuda/articles/automation-flows-regras-de-automacao-es)
- [Flow Builder: acciones nativas y el nodo de acción de contacto](/hc/ajuda/articles/automation-flows-flow-builder-acoes-nativas-es)
- [Bots y Captain (IA de atención)](/hc/ajuda/articles/automation-flows-bots-e-captain-es)
- [Enrutamiento inteligente (Smart Routing)](/hc/ajuda/articles/automation-flows-smart-routing-es)
- [Envíos masivos en el Flow Builder](/hc/ajuda/articles/automation-flows-flow-builder-disparos-em-massa-es)