# Pasos de un flujo

> Referencia de todos los pasos de un flujo en Agentclic: mensaje, condición, herramienta, derivar, llamar a otro flujo, plantilla de WhatsApp y calendario.

URL: https://agentclic.com/docs/flujos/pasos-de-un-flujo
Última revisión: 2026-11-02

Cada paso de un flujo es una acción: enviar un mensaje, decidir según una condición, consultar o crear citas, crear un contacto, esperar, llamar a otro servicio… Esta página explica qué hace cada paso y cómo se configura. Los pasos se añaden desde el [editor](https://agentclic.com/docs/flujos/editor-de-flujos#anadir-y-conectar-pasos).

Casi todos los campos de texto admiten [variables](https://agentclic.com/docs/flujos/variables) como `{{input.nombre}}`, para usar datos del activador o de pasos anteriores.

## Resumen de pasos

| Paso | Qué hace |
|---|---|
| [Mensaje](https://agentclic.com/docs/flujos/pasos-de-un-flujo#mensaje) | Envía un mensaje a la persona. |
| [Condición](https://agentclic.com/docs/flujos/pasos-de-un-flujo#condicion) | Divide el flujo en dos ramas, Sí y No, según una regla. |
| [Herramienta](https://agentclic.com/docs/flujos/pasos-de-un-flujo#herramienta) | Llama a una API que hayas conectado al agente. |
| [Derivar](https://agentclic.com/docs/flujos/pasos-de-un-flujo#derivar) | Pasa la conversación a una persona y le avisa. |
| [Llamar a otro flujo](https://agentclic.com/docs/flujos/pasos-de-un-flujo#llamar-a-otro-flujo) | Ejecuta otro flujo del mismo agente y le pasa datos. |
| [Enviar plantilla WhatsApp](https://agentclic.com/docs/flujos/pasos-de-un-flujo#enviar-plantilla-whatsapp) | Envía una plantilla aprobada por Meta. |
| [Petición Webhook](https://agentclic.com/docs/flujos/paso-peticion-webhook) | Envía datos a cualquier servicio externo. |
| [Calendario](https://agentclic.com/docs/flujos/pasos-de-un-flujo#calendario) | Crea, cambia, cancela o consulta citas y busca huecos libres. |
| [Crear contacto en CRM](https://agentclic.com/docs/flujos/pasos-del-crm) | Crea un contacto o completa sus datos. |
| [Cambiar estado CRM](https://agentclic.com/docs/flujos/pasos-del-crm#cambiar-estado-crm) | Mueve un contacto a otra etapa. |
| [Esperar](https://agentclic.com/docs/flujos/paso-esperar) | Pausa el flujo un tiempo o hasta una fecha. |

## Mensaje

Envía un texto a la persona. Escríbelo en **«Mensaje a enviar»**; la **Vista previa** muestra cómo quedará con las variables.

- Con **Inicio (manual)**, el texto vuelve al agente, que lo usa en su respuesta por el canal de la conversación en curso.
- Con un activador que arranca solo (webhook o programado), no hay conversación: indica el **canal** y el **destinatario**. Hoy el envío directo desde un flujo automático solo funciona por **WhatsApp**, con el teléfono en formato internacional (por ejemplo `+34600111222`).

> **Importante:** WhatsApp solo permite mensajes de texto libre durante las 24 horas siguientes al último mensaje de la persona. Fuera de ese plazo usa [Enviar plantilla WhatsApp](https://agentclic.com/docs/flujos/pasos-de-un-flujo#enviar-plantilla-whatsapp).

## Condición

Divide el flujo en dos ramas: **Sí** (verde) y **No** (roja). Cada regla tiene un **Valor a evaluar**, un **Operador** y, si hace falta, un valor con el que **comparar**. Con dos o más reglas eliges si deben cumplirse **todas (Y)** o **alguna (O)**.

| Grupo | Operadores |
|---|---|
| Sí / No | es verdadero, es falso, tiene valor, no tiene valor |
| Igualdad | es igual a, es distinto de |
| Texto | contiene, no contiene, empieza por, termina en |
| Números | mayor que, menor que, mayor o igual, menor o igual |
| Existencia | está vacío, no está vacío, existe, no existe |

Abajo verás el **Resultado actual** con los datos de ejemplo y si cada regla se cumple.

> **Nota:** Si la condición no tiene rama «No» y no se cumple, el flujo se detiene ahí. En Ejecuciones aparece como «Detenido: la condición no se cumple».

## Herramienta

Llama a una acción de una API que hayas conectado al agente en la pestaña **Herramientas**. Elige la **Conexión API**, el **Endpoint**, rellena los **Parámetros** y, si hace falta, el **Body JSON**. Con **«Probar acción»** ves la respuesta real, y el **Alias de salida** te permite usarla en los pasos siguientes, por ejemplo `{{cliente.data.0.nombre}}`.

Depende de tu plan: si no lo incluye, verás «Tu plan no incluye las herramientas de API».

## Derivar

Pasa la conversación a una persona del negocio y le avisa.

| Campo | Qué hace |
|---|---|
| **Avisar al humano por** | Notificación en la app (por defecto), WhatsApp o email. |
| **Teléfono del humano que atenderá** | La conversación se marca como atendida por ese número y el agente deja de responder automáticamente. |
| **Teléfono** o **Email del aviso** | A dónde se envía el aviso, según el medio elegido. |
| **Título** y **Mensaje del aviso** | El texto del aviso. Por defecto, «Derivación a humano solicitada». |

El aviso por WhatsApp necesita el canal de WhatsApp configurado en el agente, y el aviso por email, el correo saliente (SMTP) del agente.

## Llamar a otro flujo

Ejecuta otro flujo del mismo agente y le pasa datos. Así puedes reutilizar un flujo desde varios sitios.

1. Elige el **Flujo destino**. Verás el esquema de datos que espera (sus [entradas](https://agentclic.com/docs/flujos/editor-de-flujos#entradas-del-flujo)).
2. En **«Datos JSON a enviar»**, pulsa **«Rellenar desde esquema»** y completa los valores con variables.

Un flujo no puede llamarse a sí mismo, y las llamadas encadenadas tienen un máximo de **3 niveles**. Si el flujo llamado falla, el que lo llamó también se detiene. Si el flujo destino está desactivado, no se ejecuta.

## Enviar plantilla WhatsApp

Envía una plantilla de WhatsApp aprobada por Meta. Es la forma de escribir primero a alguien o de responder pasadas 24 horas.

1. Escribe el **Número de teléfono destinatario** en formato internacional, por ejemplo `+34600111222` o una variable como `{{input.telefono}}`.
2. Elige la **Plantilla**. Solo se pueden enviar las que tienen estado aprobado; las demás aparecen con su estado entre paréntesis.
3. Rellena cada variable de la plantilla (`{{1}}`, `{{2}}`…) y revisa la **Vista previa del mensaje**.

> **Importante:** Para enviar a números reales, la cuenta de WhatsApp necesita un método de pago activo en Meta. Si el número está en modo desarrollo, Meta solo entrega las plantillas a los números de prueba registrados, aunque responda «enviado».

## Calendario

Trabaja con el calendario del cliente asignado al agente. Elige la **Operación**:

| Operación | Qué hace |
|---|---|
| **Crear evento** | Crea una cita con título, invitado (nombre, email y teléfono), inicio y fin. |
| **Actualizar evento** | Cambia una cita existente. |
| **Eliminar evento (por ID)** | Borra una cita por su identificador. |
| **Cancelar cita por email o teléfono del invitado** | Busca la cita de esa persona y la cancela. |
| **Obtener un evento** | Lee los datos de una cita. |
| **Listar eventos en rango** | Lista las citas entre dos fechas. |
| **Buscar franjas ocupadas** | Devuelve los tramos ocupados. |
| **Buscar huecos libres** | Devuelve los huecos disponibles para reservar. |
| **Lista de espera · Apuntar a una persona** | Apunta a alguien que no encuentra hueco para avisarle cuando se libere uno. |
| **Lista de espera · Confirmar el hueco ofrecido** | Reserva el hueco que se le ofreció a esa persona. |
| **Lista de espera · Dar de baja** | Quita a la persona de la lista de espera. |

- Las fechas se escriben en formato ISO 8601, por ejemplo `2026-11-20T10:00:00+01:00`. En las operaciones de rango, **Desde** vacío significa «ahora» y **Hasta** vacío, «dentro de 7 días».
- Para **Buscar huecos libres**, el horario y los días disponibles se configuran al editar el calendario en la sección Calendario del cliente. Ver [Calendarios y disponibilidad](https://agentclic.com/docs/calendario/calendarios#definir-el-horario-disponible).
- **Cancelar por invitado** busca desde ahora hasta dentro de 60 días. Si no encuentra ninguna cita, o encuentra varias, no borra nada y el paso termina con error, así que el flujo se detiene ahí.

### Operaciones de lista de espera

Las tres operaciones identifican a la persona con **Nombre del contacto**, **Email del contacto** y **Teléfono del contacto** (hace falta el email o el teléfono). Además:

| Operación | Campos propios |
|---|---|
| **Apuntar a una persona** | **Duración de la cita (minutos)** (por defecto, 30), **Servicio**, **Mensaje de aviso** (admite `{{fecha}}`, `{{hora}}`, `{{servicio}}` y `{{nombre}}`) y la franja que le interesa en **Desde** y **Hasta**. |
| **Confirmar el hueco ofrecido** | **Inicio concreto (opcional)**: vacío reserva el hueco que se le ofreció. **Título de la cita**. Si otra persona lo ha cogido antes, no crea nada y la persona sigue en la lista. |
| **Dar de baja** | Ninguno más. |

Cómo funciona la lista y cómo se avisa a cada persona: [Lista de espera](https://agentclic.com/docs/calendario/lista-de-espera).

La salida se usa con el alias del paso (por defecto `calendar_result`), por ejemplo `{{calendar_result.slots}}` o `{{calendar_result.count}}`. Depende de tu plan: si no lo incluye, verás «Tu plan no incluye el calendario».

## Problemas frecuentes

### El paso Mensaje no envía nada en un flujo programado

Indica el canal (WhatsApp) y el teléfono del destinatario en el propio paso. Sin conversación en curso, el mensaje no sabe a quién ir.

### La plantilla de WhatsApp no aparece en la lista

Las plantillas se crean y sincronizan desde la configuración de WhatsApp del agente. Si existe pero no está aprobada, aparece con su estado y no se puede enviar.

### Buscar huecos libres no devuelve nada

Revisa el horario, la duración y los días laborables del calendario del cliente, y el rango de fechas del paso.