Agent Follow-Up Trigger

Descripcion

El modulo AgentFollowUpTrigger es un trigger que inicia workflows de seguimiento automatico cuando un usuario deja de interactuar con un agente. El servicio agentFollowUpService detecta la inactividad del usuario y lanza este trigger segun la configuracion. Soporta hasta 3 etapas de seguimiento (slots), cada una con su propio tiempo de espera, condicion de activacion y limites de ejecucion. Al ejecutarse, proporciona al workflow toda la informacion de la sesion, el contexto de la conversacion, la memoria del agente y los datos del follow-up. Tambien incluye hooks onSave y onDelete que registran y desactivan automaticamente el flujo en la base de datos.

Configuracion

Parametros

Parametro	Tipo	Requerido	Descripcion
agent_id	agentSelector	Si	Selecciona el agente al que pertenece este follow-up.
slot_number	select	Si	Numero 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	Condicion de activacion: sin respuesta, sin accion completada, carrito abandonado, programado o personalizado. Por defecto: no_response.
max_executions	number	No	Cuantas veces puede ejecutarse este follow-up por sesion. 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 automaticamente 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 basico

{
  "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 automaticamente en la tabla agent_follow_up_flows al guardar el workflow.
• Al eliminar el workflow, el flujo se desactiva automaticamente (no se borra).
• Las condiciones disponibles son: no_response, no_action, cart_abandoned, scheduled, custom.
• El tiempo maximo de inactividad configurable es de 10080 minutos (1 semana).
• El cooldown solo aplica si max_executions es mayor a 1.
• Proporciona contexto completo: sesion, conversacion, memoria del agente y entidades extraidas.

Nodos Relacionados

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