Integraciones: automatizaciones, eventos y webhooks de follow-up

Conversa Labs

Conversa Labs

Última actualización el Jul 19, 2026

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