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
- Abre el Flow Builder y crea un nuevo flujo (puedes partir de una plantilla de la galería).
- Configura el disparador del flujo (el evento que lo inicia) en el nodo de inicio.
- Arrastra nodos desde el panel al lienzo y conéctalos para dibujar el camino de la conversación.
- Configura cada nodo en el panel lateral (texto del mensaje, opciones del menú, regla de la condición, URL de la solicitud, etc.).
- Usa variables para guardar y reutilizar las respuestas del contacto y los datos de integraciones.
- 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.