## Visión general

Los follow-ups no viven aislados: se conectan **de forma nativa** con el resto de la plataforma. Una
cadencia puede **inscribirse, pausarse, reanudarse, saltarse o cancelarse** mediante una regla de
**Automatización**, mediante una **Macro** que el agente ejecuta en la conversación o mediante un nodo
del **Flow Builder**. A medida que la cadencia avanza, la plataforma **emite eventos** que disparan
otras automatizaciones y se entregan a tus **webhooks** de integración. Y, cuando el **Maestro** está
activo, puede leer y operar follow-ups mediante **herramientas** propias.

En resumen: un follow-up es, a la vez, una **acción** (algo que otras reglas ejecutan) y una **fuente
de eventos** (algo a lo que otras reglas y sistemas reaccionan).

## Requisitos previos

- El módulo de Follow-ups disponible en la cuenta (la capacidad `follow_ups` habilitada).
- Para inscribir/operar vía automatización, macro o flujo: el módulo de **Automatización/Flow** disponible.
- Para notificar a sistemas externos: un **endpoint de webhook** configurado en la cuenta, ya suscrito a
  los eventos deseados.
- Para las herramientas de IA: el **Maestro** activo en la cuenta.

## Paso a paso

1. Crea una **regla de automatización** (o edita una existente).
2. Define el **evento disparador** de la regla (por ejemplo, un cobro que venció o un negocio que se detuvo).
3. En **acciones**, elige **Inscribir en follow-up** (`enroll_in_follow_up`) y selecciona la secuencia.
4. Opcionalmente, agrega **condiciones** por `follow_up_status` para actuar solo sobre contactos que ya
   están (o aún no están) en una cadencia.
5. Guarda y activa la regla. A partir de ahí, cada vez que ocurre el evento, la acción se ejecuta
   automáticamente.

## Configuración y opciones

### Las cinco acciones de follow-up (automatización, macro y flujo)

Las mismas cinco acciones están disponibles en **Automatización**, **Macros** y el **Flow Builder**, y
se ejecutan de forma idéntica en los tres lugares:

| Acción | Qué hace |
|--------|----------|
| `enroll_in_follow_up` | Inscribe al objetivo (contacto/conversación) en una secuencia. |
| `cancel_follow_up` | Cancela la inscripción activa. |
| `pause_follow_up` | Pausa la inscripción (no se envían los siguientes pasos). |
| `resume_follow_up` | Reanuda una inscripción pausada. |
| `skip_follow_up_step` | Salta el paso actual y avanza al siguiente. |

> Estas acciones se **agregan** al conjunto que la automatización ya tenía — ninguna regla existente se
> ve afectada por ellas.

### Los tres campos de condición

En una regla disparada por un evento de follow-up, puedes condicionar por estos campos:

| Campo | Para qué sirve |
|-------|----------------|
| `follow_up_status` | El estado de la inscripción (activa, pausada, completada, salida, fallida). |
| `follow_up_sequence_id` | La secuencia específica en la que el contacto está inscrito. |
| `follow_up_enrolled_via` | Cómo se inscribió el contacto (manual, automatización, evento, inactividad, IA, API). |

### Eventos y webhooks

A medida que la cadencia corre, la plataforma emite eventos que sirven tanto para **disparar
automatizaciones** como para **alimentar** los **webhooks** de la cuenta:

| Evento | Cuándo ocurre |
|--------|---------------|
| `follow_up_enrollment.created` | Se creó una inscripción. |
| `follow_up_enrollment.paused` | La inscripción se pausó. |
| `follow_up_enrollment.resumed` | La inscripción se reanudó. |
| `follow_up_enrollment.exited` | La inscripción salió por una regla de salida (p. ej., el contacto respondió). |
| `follow_up_enrollment.completed` | La inscripción llegó al final de la secuencia. |
| `follow_up_enrollment.failed` | La inscripción falló. |
| `follow_up_step.sent` | Se envió un paso. |
| `follow_up_step.replied` | El contacto respondió a un paso. |
| `follow_up_step.skipped` | Se saltó un paso. |
| `follow_up_step.failed` | El envío de un paso falló. |

Los **payloads** de estos webhooks llevan el **mínimo de datos personales** (identificadores de cuenta,
inscripción, secuencia y paso, más el estado) — sirven para sincronizar paneles y sistemas, no para
transportar el contenido de los mensajes. Cuando un paso de IA espera aprobación humana, además hay una
notificación interna de borrador pendiente.

### Herramientas de follow-up del Maestro

Con el Maestro activo, el asistente puede **leer y operar** follow-ups mediante herramientas propias,
siempre con un token del usuario y respetando la capacidad habilitada y los permisos:

- **Listar** secuencias e inscripciones.
- **Inscribir** un contacto en una secuencia.
- **Pausar** y **reanudar** una inscripción.
- **Saltar** el paso actual.
- **Aprobar** un borrador de IA (HITL).
- **Cancelar** una inscripción.

## Casos de uso

- **Negocio ganado en el CRM** → una automatización ejecuta `cancel_follow_up` para terminar cualquier
  cadencia activa de ese contacto (nadie quiere que le cobren después de cerrar).
- **Cobro vencido** → una automatización ejecuta `enroll_in_follow_up` en la secuencia de "Cobranza".
- **Dashboards de integrador** → un sistema externo se suscribe a `follow_up_enrollment.*` y
  `follow_up_step.*` por webhook y arma sus propios informes casi en tiempo real.

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

- Combina las acciones de follow-up con el evento correcto: `cancel_follow_up` en eventos de conversión,
  y `enroll_in_follow_up` en eventos de riesgo (cobro vencido, negocio detenido, ausencia en una cita).
- Usa `follow_up_status` como condición para evitar inscribir dos veces o actuar sobre quien ya salió.
- Trata los webhooks como **solo lectura de estado**: el contenido de los mensajes no viaja en el payload.
- La misma acción corre igual en automatización, macro y flujo — elige el punto de partida por el
  recorrido, no por la capacidad.

## Solución de problemas

- **La acción no se disparó**: confirma que la regla esté **activa**, que el **evento disparador** haya
  ocurrido realmente y que las **condiciones** (incluido `follow_up_status`) coincidan; verifica también
  que la capacidad de follow-ups esté habilitada en la cuenta.
- **El webhook no llegó**: revisa que el **endpoint** esté configurado y accesible y que los **eventos**
  de follow-up estén realmente **suscritos** en ese webhook.
- **Una herramienta del Maestro fue denegada**: verifica que la capacidad esté habilitada, que el token
  del usuario sea válido y que el usuario tenga **permiso** para operar follow-ups.

## Ver también

- [Inscripción: manual, automatización, evento e inactividad](/hc/ajuda/articles/follow-ups-inscricao-es)
- [Embudo de la cadencia y reglas de salida](/hc/ajuda/articles/follow-ups-funil-e-saida-es)
- [Visión general de Follow-ups y cadencias](/hc/ajuda/articles/follow-ups-overview-es)