Enviar Seguimiento

Descripcion

Este modulo genera y prepara mensajes de seguimiento (follow-up) para enviar al usuario cuando este no ha respondido. Soporta tres modos de generacion de mensaje:

IA (ai): Genera el mensaje automaticamente usando un LLM. El prompt del sistema instruye a la IA para crear mensajes cortos, naturales y no invasivos, adaptados al numero de seguimiento. Puede reutilizar el cerebro configurado en el agente de la sesion o usar uno propio.
Plantilla (template): Usa un mensaje predefinido con variables dinamicas como {{nombre}}, {{ultimo_tema}}, {{follow_up_number}}, etc. Las variables se reemplazan con datos de la sesion y entidades extraidas.
Dinamico (dynamic): Toma el mensaje directamente de los datos de entrada (message, text o content).

El modulo opcionalmente:

Agrega el mensaje de seguimiento al historial de la sesion.
Actualiza contadores y timestamps de la sesion en base de datos.

Si la generacion por IA falla, se utiliza un mensaje fallback predefinido segun el numero de seguimiento.

Configuracion

Parametro	Tipo	Requerido	Descripcion
message_mode	select	Si	Como se genera el mensaje de seguimiento. Opciones: ai, template, dynamic. Default: ai.
template_message	textarea	No	Mensaje plantilla. Soporta variables como {{nombre}}, {{ultimo_tema}}, etc. Visible en modo template.
ai_prompt	textarea	No	Instrucciones para la IA sobre como generar el mensaje de seguimiento. Visible en modo ai.
use_session_brain	boolean	No	Usar la misma IA configurada en el agente de la sesion. Default: true. Visible en modo ai.
brain_provider	select	No	Proveedor de IA para generar el mensaje. Visible si use_session_brain es false.
brain_model	aiModelSelector	No	Modelo de IA a utilizar. Default: gpt-4o.
credentials_key	credentials	No	Credenciales del proveedor de IA. Visible si use_session_brain es false.
max_tokens	number	No	Limite de tokens para el mensaje generado. Min: 50, Max: 1000. Default: 200. Visible en modo ai.
temperature	number	No	Creatividad del mensaje (0.8 recomendado para follow-ups). Default: 0.8. Visible en modo ai.
include_context	boolean	No	Incluir contexto de la conversacion para generar mensaje mas relevante. Default: true.
update_session	boolean	No	Agregar el mensaje enviado al historial de la sesion. Default: true.

Credenciales

Opcionales. Si use_session_brain es true, se reutilizan las credenciales del agente. De lo contrario, se requiere configurar credentials_key.

Salida

{
  "success": true,
  "message": "Hola! Vi que estabamos conversando. Hay algo en lo que pueda ayudarte?",
  "session_id": "uuid-sesion",
  "channel": "whatsapp",
  "external_id": "5491112345678",
  "follow_up_number": 1,
  "message_mode": "ai",
  "generated_at": "2026-03-23T10:00:00.000Z"
}

Ejemplo de Uso

Caso basico

{
  "message_mode": "template",
  "template_message": "Hola {{nombre}}, queria retomar nuestra conversacion sobre {{ultimo_tema}}. Puedo ayudarte en algo mas?",
  "include_context": true,
  "update_session": true
}

Datos de entrada esperados

session_id: ID de la sesion del agente.
last_topic: Ultimo tema de la conversacion.
last_user_message: Ultimo mensaje del usuario.
memory: Memoria de la sesion.
entities: Entidades extraidas (nombre, email, etc.).
follow_up_number: Numero de seguimiento (1, 2, 3…).
channel: Canal de comunicacion.
external_id: ID externo del usuario.

API Utilizada

En modo IA, se llama a la API del proveedor configurado (OpenAI, Anthropic, Google, etc.) para generar el mensaje de seguimiento.

Notas

Los mensajes fallback predefinidos son: (1) “Hola! Vi que estabamos conversando…”, (2) “Solo queria verificar si tienes alguna pregunta pendiente…”, (3) “Espero que todo este bien…”.
En modo plantilla, las variables no reemplazadas se eliminan del mensaje final.
Se recomienda usar temperatura 0.8 para follow-ups, ya que genera mensajes mas variados y naturales.
El modulo no envia el mensaje directamente; genera el texto para que un nodo posterior (ej. Telegram, WhatsApp) lo envie.

Nodos Relacionados

Agent - Agente IA
AgentDecision - Decision del Agente