Agent Follow-Up Trigger

Descripción

El modulo AgentFollowUpTrigger es un trigger que inicia workflows de seguimiento automático cuando un usuario deja de interactuar con un agente. El servicio agentFollowUpService detecta la inactividad del usuario y lanza este trigger según la configuración. Soporta hasta 3 etapas de seguimiento (slots), cada una con su propio tiempo de espera, condición de activación y limites de ejecución. Al ejecutarse, proporciona al workflow toda la información de la sesión, el contexto de la conversación, la memoria del agente y los datos del follow-up. También incluye hooks onSave y onDelete que registran y desactivan automáticamente el flujo en la base de datos.

Configuración

Parámetros

Parámetro	Tipo	Requerido	Descripción
agent_id	agentSelector	Si	Selecciona el agente al que pertenece este follow-up.
slot_number	select	Si	Número de seguimiento en la secuencia: 1er, 2do o 3er seguimiento. Por defecto: 1.
trigger_after_minutes	number	Si	Minutos de inactividad antes de activar este follow-up. Min: 1, Max: 10080 (1 semana). Por defecto: 30.
trigger_condition	select	Si	Condición de activación: sin respuesta, sin acción completada, carrito abandonado, programado o personalizado. Por defecto: no_response.
max_executions	number	No	Cuantas veces puede ejecutarse este follow-up por sesión. Min: 1, Max: 10. Por defecto: 1.
cooldown_minutes	number	No	Minutos minimos entre ejecuciones si max_executions > 1. Min: 0, Max: 1440. Por defecto: 60.
flow_id	hidden	No	ID interno del flujo registrado. Se genera automáticamente al guardar.

Salida

{
  "session_id": "ses_abc123",
  "session_status": "active",
  "channel": "whatsapp",
  "external_id": "+34600123456",
  "last_topic": "consulta_producto",
  "messages_count": 5,
  "last_user_message": "Me interesa el producto X",
  "last_agent_response": "El producto X tiene las siguientes caracteristicas...",
  "minutes_since_last_message": 35,
  "memory": {},
  "entities": {},
  "facts": [],
  "preferences": {},
  "follow_up_number": 1,
  "follow_up_type": "no_response",
  "previous_follow_ups": 0,
  "triggered_at": "2026-03-23T10:30:00.000Z",
  "success": true
}

Ejemplo de Uso

Caso básico

{
  "label": "Agent Follow-Up Trigger",
  "agent_id": "agente_ventas",
  "slot_number": 1,
  "trigger_after_minutes": 30,
  "trigger_condition": "no_response",
  "max_executions": 1,
  "cooldown_minutes": 60
}

Notas

• Soporta hasta 3 slots (etapas de seguimiento) por agente.
• El flujo se registra automáticamente en la tabla agent_follow_up_flows al guardar el workflow.
• Al eliminar el workflow, el flujo se desactiva automáticamente (no se borra).
• Las condiciones disponibles son: no_response, no_action, cart_abandoned, scheduled, custom.
• El tiempo máximo de inactividad configurable es de 10080 minutos (1 semana).
• El cooldown solo aplica si max_executions es mayor a 1.
• Proporciona contexto completo: sesión, conversación, memoria del agente y entidades extraidas.

Nodos Relacionados

• telegramReceive (trigger de mensajes Telegram)
• Webhook (trigger genérico)
• decision (para evaluar condiciones del follow-up)