Trigger: Chat (`chat_trigger`)¶

Este trigger inicia una automatización cuando un usuario envía un mensaje a través de una interfaz de chat web generada por el nodo. Al configurarlo, el sistema genera una URL única que se puede compartir con operadores, guardias u otros usuarios para que interactúen con el flujo de automatización en tiempo real a través de una conversación.

¿Cuándo usarlo?¶

Cuando querés crear un asistente conversacional para que los operadores consulten el estado de sensores, cámaras o alarmas sin necesidad de navegar por el dashboard.
Cuando necesitás un bot de atención para el centro de seguridad que responda preguntas frecuentes o guíe al personal en procedimientos de emergencia.
Cuando querés que los guardias reporten novedades escribiendo en una interfaz simple desde su celular o PC, disparando un flujo de registro o notificación.
Cuando necesitás una interfaz de consulta conversacional conectada a un modelo de IA para analizar eventos, logs o estados del sistema.
Cuando querés crear un canal de comunicación bidireccional entre un operador y un flujo automatizado (ej: confirmar una alarma, solicitar un reporte).

Si lo que necesitás es disparar una automatización desde un sistema externo mediante HTTP, usá Trigger: Webhook.
Si lo que necesitás es reaccionar a eventos del sistema (sensores, cambios de estado), usá Trigger: Event o Trigger: State Change.

Cómo configurarlo¶

Paso 0) Abrir la parametrización¶

En el canvas de automatizaciones, hacé doble click sobre el nodo Chat.
Se abre un modal con dos pestañas: Form y JSON Editor. Quedate en Form.

Paso 1) Obtener la Chat URL¶

Al abrir el formulario, verás el campo Chat URL con la dirección web generada automáticamente para este nodo.

https://tu-instancia.netsocs.com/chat/{id-del-nodo}

Esta URL es única por nodo. Cada nodo Chat tiene su propia URL.
Hacé click en la URL o en el ícono de copiar para copiarla al portapapeles.
La URL abre directamente en una nueva pestaña para que puedas probarla.
Compartí esta URL con los usuarios (operadores, guardias, supervisores) que van a usar el chat.

No hay nada que configurar en este campo — es informativo y se genera sola.

Paso 2) Configurar el historial del chat¶

El historial permite que los nodos posteriores del flujo (especialmente modelos de IA) tengan contexto de la conversación, no solo el último mensaje enviado.

Include History (Incluir historial)¶

Estado	Comportamiento
Activado (defecto)	El flujo recibe el mensaje actual más los mensajes anteriores de la conversación
Desactivado	El flujo recibe únicamente el mensaje más reciente, sin contexto previo

Activalo si el flujo conecta con un agente de IA que necesita entender el contexto de la conversación.
Desactivalo si solo necesitás procesar mensajes individuales sin necesidad de contexto.

History Count (Cantidad de mensajes del historial)¶

Define cuántos mensajes previos se incluyen en el historial enviado al flujo.
Valor por defecto: 20
Rango válido: 1 a 100
Valores más altos dan más contexto pero aumentan el tamaño del payload procesado.

Caso de uso	Valor recomendado
Chat simple de consulta rápida	5 – 10
Asistente conversacional con contexto	20 – 30
Análisis de conversaciones largas	50 – 100

Paso 3) (Opcional) Sesiones activas¶

Si hay sesiones de chat en curso vinculadas a este nodo, aparecerán listadas como etiquetas debajo del formulario. Cada etiqueta muestra el ID de la sesión y puede cerrarse individualmente para desvincularse.

En la mayoría de los casos no es necesario gestionar esto manualmente — las sesiones se crean automáticamente cuando un usuario abre la Chat URL.

Buenas prácticas¶

Combiná siempre con un nodo de agente IA (como Agent Model): el trigger Chat por sí solo recibe el mensaje; el valor real está en conectarlo a un modelo que procese y responda.
Usá un historial de 10-20 mensajes para la mayoría de los casos de asistencia operativa. Valores muy altos pueden ralentizar el procesamiento si el modelo de IA cobra por tokens.
No compartas la Chat URL públicamente a menos que sea intencional — cualquier persona con la URL puede enviar mensajes y disparar el flujo.
Probá la URL antes de distribuirla: abrila en una pestaña nueva y enviá un mensaje de prueba para verificar que el flujo responde correctamente.
Usá "Include History = No" si el flujo ejecuta operaciones discretas (ej: registrar un evento, consultar el estado de un sensor puntual) donde el contexto previo no importa.
Uno por función: si tenés usos distintos (asistente de alarmas, asistente de accesos), creá un nodo Chat separado por cada uno para mantener URLs y flujos independientes.

Troubleshooting (problemas comunes)¶

El chat no responde cuando envío un mensaje
Verificá que la automatización esté activa y publicada.
Comprobá que los nodos posteriores al Chat trigger estén correctamente configurados (especialmente el nodo de agente o acción que genera la respuesta).
Revisá que la URL que estás usando corresponde al nodo correcto de la automatización activa.
No veo la Chat URL en el formulario
La URL se genera a partir del ID interno del nodo. Si el nodo fue recién creado y no se guardó la automatización, puede no estar disponible aún. Guardá el flujo y volvé a abrir el nodo.
El historial de la conversación no se mantiene entre sesiones
El historial es por sesión de chat. Si el usuario abre una nueva pestaña o una nueva URL de sesión, comienza una conversación nueva.
Verificá que "Include History" esté activado.
El modelo de IA responde sin contexto aunque Include History está activado
Verificá que el nodo de IA posterior esté configurado para leer el historial del mensaje entrante.
Revisá que "History Count" sea mayor a 1.
El chat muestra estado "Offline" o "Reconnecting"
Es un problema de conectividad WebSocket entre el navegador y el servidor.
El sistema intentará reconectarse automáticamente. Si persiste, recargá la página.
En instalaciones con conexiones inestables, el chat puede tener demoras en la reconexión.

Configuración avanzada (JSON Editor) — solo usuarios expertos¶

La pestaña JSON Editor te permite ver y editar directamente la estructura interna del nodo. Es útil para copiar configuraciones entre flujos o instancias.

Estructura del `input`¶

{
  "ruleSet": {
    "session_ids": [],
    "include_history": true,
    "history_count": 20
  },
  "config": {}
}

Tabla de campos¶

Campo	Tipo	Requerido	Defecto	Descripción
`ruleSet.session_ids`	`string[]`	No	`[]`	IDs de sesiones de chat vinculadas. Vacío = sin restricción de sesión.
`ruleSet.include_history`	`boolean`	No	`true`	Si se incluye el historial de mensajes previos en el payload del trigger.
`ruleSet.history_count`	`number` (1-100)	No	`20`	Cantidad de mensajes del historial a incluir cuando `include_history` es `true`.
`config`	`{}`	No	`{}`	Siempre vacío (reservado para uso futuro).

Ejemplos JSON por caso de uso¶

Asistente conversacional con historial estándar (configuración típica)¶

{
  "ruleSet": {
    "session_ids": [],
    "include_history": true,
    "history_count": 20
  },
  "config": {}
}

Procesamiento de mensajes individuales sin contexto¶

{
  "ruleSet": {
    "session_ids": [],
    "include_history": false,
    "history_count": 20
  },
  "config": {}
}

Asistente con contexto extendido (conversaciones largas)¶

{
  "ruleSet": {
    "session_ids": [],
    "include_history": true,
    "history_count": 50
  },
  "config": {}
}

Guías rápidas (recetas)¶

Receta A — "Asistente de consulta para operadores de seguridad"¶

Include History: Activado
History Count: 20
Nodo siguiente: Agent Model (Claude o similar)
Prompt del agente: contexto de la instalación, acceso a estados de objetos
Acción: el asistente responde preguntas sobre el estado de cámaras, alarmas y sensores
Distribuir: Chat URL al equipo de operadores del turno

Receta B — "Bot de reporte de novedades para guardias"¶

Include History: Desactivado (cada mensaje es un reporte independiente)
History Count: 1
Nodo siguiente: Action (escribir en Google Sheets o enviar a canal de Telegram)
Flujo: el guardia escribe "Novedad: puerta norte abierta" → se registra automáticamente
Distribuir: Chat URL en el celular de cada guardia de ronda

Receta C — "Asistente de emergencias con contexto extendido"¶

Include History: Activado
History Count: 50
Nodo siguiente: Agent Model con instrucciones de protocolo de emergencias
Flujo: el operador describe la situación por etapas → el agente guía el procedimiento
Distribuir: Chat URL en la pantalla de puesto de control

Receta D — "Consulta de estado de dispositivos en lenguaje natural"¶

Include History: Activado
History Count: 10
Nodo siguiente: Agent Model con acceso a herramientas de consulta de objetos NetSocs
Flujo: el usuario escribe "¿Está activa la cámara 3?" → el agente consulta el estado y responde
Distribuir: Chat URL integrada en el dashboard como widget

Receta E — "Canal de confirmación de alarmas"¶

Include History: Desactivado
History Count: 20
Nodo siguiente: Condition (evaluar si el mensaje es "CONFIRMAR" o "CANCELAR") → Action
Flujo: se envía la URL al operador cuando se activa una alarma; el operador escribe la acción a tomar
Distribuir: URL enviada dinámicamente por otro nodo del flujo (ej: Telegram con el link)

Referencias internas (para ubicarlo en el editor)¶

Key del nodo: chat_trigger
Clase: trigger
Campos requeridos: ninguno (todos tienen valores por defecto)
URL del chat: {origin}/chat/{node-id} — única por nodo, generada automáticamente
Comunicación: WebSocket en tiempo real con reconexión automática
Integración típica: conectar con nodos de agente IA (Agent Model) para flujos conversacionales

Trigger: Chat (chat_trigger)¶