Flujos (conversaciones guiadas)
Un flujo es una conversación guiada: tú defines los pasos y el cliente avanza tocando botones, eligiendo de una lista o escribiendo. Sirve para menús de atención, preguntas frecuentes guiadas, captura de datos (nombre, correo, pedido) y filtros antes de pasar con un humano.

Crear un flujo
Sección titulada «Crear un flujo»Pulsa Nuevo flujo. La creación tiene tres partes:

- Identidad — nombre del flujo y una descripción opcional (solo las ve tu equipo).
- Alcance — en qué cuenta de WhatsApp corre y si aplica a todos los números o a uno específico.
- Disparador — «¿Cuándo se dispara?»:
- Al iniciar la conversación (cualquier mensaje): arranca con el primer mensaje, como máximo una vez cada 24 horas por cliente. Cerrar la conversación lo vuelve a habilitar.
- Cuando el cliente escribe una palabra clave: por ejemplo “menú” o “pedido”. La coincidencia es por “contiene” y no distingue mayúsculas.
- Solo manual: lo inicia un agente o lo llama otro flujo.
- Lo dispara una auto-respuesta: una auto-respuesta con acción “Iniciar un flujo”.
Después agregas los pasos. El flujo queda en borrador mientras lo armas; cuando esté listo, pulsa Publicar para que empiece a funcionar. Puedes despublicarlo, duplicarlo o eliminarlo desde la lista.
Tipos de paso
Sección titulada «Tipos de paso»Cada paso hace una cosa y dice cuál es el siguiente paso (o si el flujo termina ahí):
| Paso | Qué hace |
|---|---|
| Enviar texto | Manda un mensaje. Puede incluir variables, por ejemplo {{contact.profileName}} para el nombre del cliente. |
| Enviar imagen | Manda una imagen de la sección Bot → Archivos, con un pie de foto opcional. |
| Enviar documento | Manda un PDF, Word o Excel de Bot → Archivos: catálogo, lista de precios, condiciones. |
| Enviar botones | Mensaje con hasta 3 botones. Cada botón lleva a un paso distinto. Define también qué pasa si el cliente escribe en vez de tocar. |
| Enviar lista | Menú desplegable con secciones y hasta 10 opciones en total. Ideal cuando 3 botones no alcanzan. |
| Enviar plantilla | Manda una plantilla aprobada. Si su cabecera lleva imagen, video o documento, sale con el archivo guardado en la plantilla; sin uno guardado, el envío falla y el paso te avisa. |
| Esperar respuesta | Pausa hasta que el cliente conteste y guarda lo que escribió en una variable (por ejemplo, su correo). Puedes validar el formato (correo, teléfono, número, opciones) y definir qué pasa si no responde a tiempo. |
| Ramificar (if/else) | Toma caminos distintos según una condición: es igual o distinto, contiene o no contiene, empieza o termina en, mayor, mayor o igual, menor, menor o igual, vacío o no vacío. Con «Y además» una condición exige varias cosas a la vez; para un «o», agrega otra condición (gana la primera que se cumpla). |
| Asignar variable | Guarda un valor para usarlo más adelante. En modo Cálculo hace cuentas con + − × ÷ y paréntesis ({{variables.precio}} * 1.19) y le das formato: entero, dos decimales, moneda ($178.500), mayúsculas o minúsculas. |
| Reservar cita | Ofrece horarios libres de tu agenda para el tipo de cita que elijas y reserva el que toque el cliente. Si no hay horarios, sigue por el paso que indiques. |
| Botón de enlace | Un mensaje con un botón que abre una página web. |
| Pasar a humano | Termina el flujo y deja la conversación con tu equipo (con un mensaje opcional al cliente). |
| Pasar a la IA | Termina el flujo y le entrega la conversación a la inteligencia artificial, con un mensaje opcional. En «Agente que toma la conversación» eliges qué agente sigue, o dejas «El que decida el enrutador». |
| Finalizar | Cierra el flujo, con un mensaje de despedida opcional. |
Pasos avanzados
Sección titulada «Pasos avanzados»Cuatro pasos conectan el flujo con tus otros sistemas y con el tiempo. Están en el grupo Avanzado al agregar un paso y vienen en los planes Business y superiores.
| Paso | Qué hace |
|---|---|
| Llamar a un sistema | Hace una petición a otro sistema (GET, POST, PUT, PATCH o DELETE) con las variables del flujo: consultar un pedido, el saldo de un cliente o registrar un lead en tu CRM. De la respuesta guardas lo que necesites en variables (por ejemplo cliente.nombre o items[0].precio) y el flujo sigue por Bien o por Falló (error, sin respuesta en el tiempo máximo o código 4xx/5xx). |
| Esperar | Espera minutos, horas o días (hasta 30) y sigue solo. Ideal para «si en 2 días no pagó, recuérdale». |
| Esperar aviso de otro sistema | Pausa el flujo hasta que otro sistema avise: una pasarela de pago, tu tienda, un sistema de envíos. Lo que mande queda en variables. Si no llega a tiempo, sigue por No llegó. |
| Acción del CRM | Hace algo con el cliente de la conversación: poner o quitar una etiqueta, cambiar su etapa, asignar dueño, crear una tarea, avisar al equipo, crear una oportunidad, inscribirlo en un seguimiento o guardar un dato en un campo del cliente. |
Llamar a un sistema
Sección titulada «Llamar a un sistema»- Credenciales en un conector, nunca en el paso. Si el sistema pide una clave, créala como conector HTTP en Integraciones y elígelo en el paso: la clave va cifrada y el flujo solo escribe la ruta (
/clientes/{{contact.phone}}). El paso no acepta cabeceras comoAuthorizationoX-Api-Keyescritas a mano. Usar un conector exige permiso para manejar integraciones. - Cuerpo JSON con variables. Pon las variables entre comillas (
{"nombre": "{{contact.name}}"}): aunque el cliente escriba comillas o saltos de línea, el cuerpo no se rompe. Fuera de comillas, una variable entra como número si lo es y, si no, como texto. - Probar llamada. En el editor, el botón Probar llamada hace la petición de verdad con valores de ejemplo y te muestra el código, la respuesta y lo que guardaría en cada variable.
- Solo se llama a direcciones públicas, con un tiempo máximo de 15 segundos y respuestas de hasta 1 MB.
Esperas: el bot sigue atendiendo
Sección titulada «Esperas: el bot sigue atendiendo»Mientras un flujo está en Esperar o Esperar aviso de otro sistema, el bot atiende la conversación normal: si el cliente escribe, le responden las reglas, la IA o tu equipo. Cuando se cumple la espera, el flujo sigue solo. Cerrar la conversación o pasarla a un asesor no cancela esas esperas; despublicar el flujo sí las detiene.
El aviso de otro sistema
Sección titulada «El aviso de otro sistema»En un paso anterior usa la variable {{flow.webhook_url}}: es la dirección única de esa ejecución. Mándala en el cuerpo de un Llamar a un sistema (por ejemplo, como dirección de notificación de un pago) y el otro sistema avisa ahí con POST (JSON) o GET (parámetros). Cada dirección sirve para un solo aviso; si el aviso llega antes de que el flujo empiece a esperarlo, igual se usa.
Iniciar un flujo sin que el cliente escriba
Sección titulada «Iniciar un flujo sin que el cliente escriba»- Desde el panel: en un flujo publicado, Iniciar con un cliente pide el teléfono, el número de salida y variables opcionales.
- Desde tu sistema:
POST /organizations/{orgId}/bot/flows/{id}/iniciaren la API. - Desde una automatización del CRM: la acción Iniciar un flujo (por ejemplo, «cuando un contacto pasa a Cliente, inicia el flujo de bienvenida»).
Si el cliente no te ha escrito en las últimas 24 horas, WhatsApp solo deja empezar con una plantilla: el primer mensaje del flujo tiene que ser Enviar plantilla.
Ejecuciones
Sección titulada «Ejecuciones»La vista Ejecuciones del flujo muestra cada vez que corrió: con qué cliente, en qué va (esperando hasta cuándo, completada, vencida…) y, arriba, los pasos que más fallaron en los últimos 7 días. Al abrir una ves sus variables y todo lo que pasó: cada llamada con su código y su tiempo, las esperas, los avisos y los errores. Si falló, Reintentar desde el paso que falló la retoma en ese punto.
Preguntas frecuentes de los flujos avanzados
Sección titulada «Preguntas frecuentes de los flujos avanzados»¿El bot puede esperar 2 días y recordarle al cliente que pague? Sí. Pon un paso Esperar de 2 días y después un Enviar plantilla con el recordatorio (pasadas 24 horas sin que el cliente escriba, WhatsApp solo deja enviar plantillas). Mientras espera, el bot sigue atendiendo normal.
¿El flujo puede esperar a que mi pasarela de pago confirme el pago? Sí. Manda {{flow.webhook_url}} a tu pasarela como dirección de notificación (en un Llamar a un sistema o en el enlace de pago) y pon un paso Esperar aviso de otro sistema. Cuando la pasarela avisa, el flujo guarda lo que mandó (por ejemplo el estado del pago) y sigue; si no avisa a tiempo, sale por No llegó.
¿Un flujo puede consultar mi sistema, mi ERP o una API? Sí, con Llamar a un sistema: consulta un pedido, un saldo o un inventario con los datos del cliente, y usa la respuesta en los siguientes mensajes.
¿Dónde pongo la clave o el token de la API? En un conector HTTP de Integraciones, nunca escrita en el flujo. En el paso eliges el conector y escribes solo la ruta.
¿Puedo arrancar un flujo desde mi sistema o mi tienda? Sí: por la API, desde el panel con Iniciar con un cliente o con una automatización del CRM.
¿Cómo sé si un flujo falló? En la vista Ejecuciones del flujo: ves cada ejecución, qué respondió cada llamada y el error, y puedes reintentar desde el paso que falló.
Variables: personaliza y captura datos
Sección titulada «Variables: personaliza y captura datos»- En cualquier texto puedes usar
{{contact.profileName}}(nombre de WhatsApp del cliente),{{contact.<campo>}}(un campo propio del cliente),{{variables.loquesea}}(lo que capturaste con “Esperar respuesta”, “Asignar variable” o lo que guardaste de una llamada o un aviso) o{{flow.webhook_url}}(la dirección para el aviso de otro sistema). - Ejemplo: el paso 1 pregunta el nombre y lo guarda en
nombre; el paso 2 dice “¡Gracias,{{variables.nombre}}! ¿En qué te ayudamos?”. - Lo capturado puede quedar guardado en la memoria del contacto para futuras conversaciones.
Ejemplo: menú de atención
Sección titulada «Ejemplo: menú de atención»- Enviar botones — “Hola 👋 ¿Qué necesitas?” con botones Ventas, Soporte y Hablar con alguien.
- Ventas → Enviar texto con el catálogo → Finalizar.
- Soporte → Esperar respuesta “Cuéntanos tu problema” (se guarda en una variable) → Pasar a humano.
- Hablar con alguien → Pasar a humano con el mensaje “Te conectamos con un asesor 🙋”.
Reglas de oro
Sección titulada «Reglas de oro»- Un flujo activo no se interrumpe: mientras el cliente esté dentro de un flujo, las auto-respuestas y la IA no se meten.
- Si el cliente escribe una de las palabras de pase a humano (“agente”, “humano”…), siempre puede salir del flujo y pedir una persona.
- Prueba tu flujo escribiéndole al número desde tu propio WhatsApp antes de publicarlo para clientes.
- Los botones y listas de un flujo se mandan siempre. El interruptor «Botones y listas» de un agente solo controla lo que escribe la IA. Si no quieres botones, cambia ese paso por uno de texto. En Instagram se convierten en texto solos.
- «Pasar a la IA» manda sobre la configuración del agente. El agente que elijas atiende la conversación aunque no tenga ese número en «Atiende en», y la IA responde incluso si el número está en «Solo reglas». Si el agente elegido está apagado o se borró, decide el enrutador.