Reglas if/then

Las automatizaciones son reglas cuando X sucede, si se cumple Y, entonces hacé Z. Sentik ejecuta esto por vos sin tocar código:

• Trigger — el evento que dispara la regla (conversación cerrada, tag agregado, etc).
• Condiciones — filtros opcionales que deciden si la regla aplica a este caso concreto. Se evalúan en AND (todas deben cumplirse).
• Acciones — qué hacer cuando match. Se ejecutan en orden. Si una falla, las siguientes corren igual.

Cada trigger se dispara desde un punto específico del sistema. Si un código path no está wireado, el trigger nunca llega — abajo te aclaro de dónde sale cada uno.

{
  "minutes_idle": 1440,        // 24h sin actualización
  "only_status": "bot"          // opcional: bot | open | assigned
}

Cuando un trigger dispara, el engine arma un snapshot del estado actual de la conversación + lead y lo usa para evaluar las condiciones y dárselo a las acciones. El snapshot tiene estos campos:

Cada condición tiene la forma field + op + value. El builder visual solo muestra los operadores válidos para el tipo del campo.

Cada acción tiene un type y un objeto params con los datos que necesita. Las acciones son idempotentes donde se puede (por ejemplo, agregar un tag que ya existe no falla, solo no hace nada).

{
  "trigger": "conversation.closed",
  "rule_id": "...",
  "rule_name": "Notificar cierres de Pagos",
  "tenant_id": "...",
  "conversation_id": "...",
  "lead_id": "...",
  "snapshot": {
    "department_id": "...",
    "channel": "whatsapp",
    "sentiment_rolling": -0.45,
    "lead_score": 65,
    "lead_stage": "nurturing",
    "tags": ["reembolso"],
    ...
  },
  "fired_at": "2025-..."
}

{
  "text": "🚨 Lead en riesgo: score {{snapshot.lead_score}}, sentiment {{snapshot.sentiment_rolling}}",
  "conversation_url": "https://sentik.io/agent?conv={{conversationId}}"
}

Las podés armar desde el editor visual en /admin/automations o decírselas al copilot en lenguaje natural.

El copilot puede armar las reglas por vos. Solo describí qué querés:

Crea una regla:
"Cuando una conversación se cierra y el sentiment es menor a -0.3,
taguéala como 'cliente-perdido' y agregale nota interna 'revisar feedback'".

El copilot va a llamar la tool create_automation_rule con el JSON estructurado y te devuelve confirmación con el id de la regla creada.

Cada vez que un trigger se evalúa contra una regla, el engine inserta un row en automation_runs con el resultado. La columna derecha de /admin/automations muestra los últimos 30 con icono verde (matched) o gris (no match), el nombre de la regla, la cantidad de acciones corridas, y errores si hubo.

Si una regla NO está disparando cuando esperabas:

• Confirmá que está activada. El toggle a la izquierda de la fila tiene que estar verde.
• Confirmá que el trigger es el correcto. Por ejemplo, tag.added solo dispara cuando el tag se agrega desde la UI o el bot — no dispara para tags creados en el setup.
• Revisá el log de Actividad reciente. Si ves la fila con icono gris (no match), una de las condiciones falló. El snapshot del contexto está guardado en la columna context de automation_runs.
• Si la fila tiene error rojo, una de las acciones falló — el mensaje está visible al hacer hover en el log.

• Las reglas se cargan ordenadas por priority ASC. Default 100. Menor número = se evalúa primero.
• Todas las reglas que matchean corren — no hay early-exit. Si dos reglas dicen add_tag con tags distintos al mismo trigger, ambos tags se agregan.
• Las acciones dentro de una regla corren en el orden declarado. Si la regla tiene set_department seguida de add_internal_note que menciona el dept, el nuevo dept ya está aplicado cuando la nota corre.
• Si una acción falla, las siguientes corren igual. El error queda registrado en automation_runs.actions_run.

• Fire-and-forget: ningún trigger bloquea la acción que lo disparó. El cliente que cierra una conversación no espera a las reglas.
• Cero loops infinitos por diseño: los triggers de cambio (tag.added en particular) podrían crear un ciclo si una regla agrega un tag que dispara otra regla que agrega otro tag, y así. El engine corta esto porque la acción add_tag es idempotente — re-agregar el mismo tag no re-dispara el trigger.
• Sin rate limit por regla. Si tenés una conversación ruidosa que dispara 100 veces el mismo trigger, las reglas también corren 100 veces. Para evitar spam, agregá condiciones (ej: message_count gt 3 para ignorar el primer turno).
• Log retention: los runs viven indefinidamente. Si crece mucho, podés purgar la tabla automation_runs mensualmente desde Supabase.