Workflows (automatizaciones)

Un workflow automatiza qué hace tu negocio cuando pasa algo: cuando un lead se escala, avisá al equipo y movelo a SALES_READY. Es el modelo evento → condición → acciones, y corre solo en segundo plano — sin que nadie tenga que estar mirando.

Cómo funciona

Trigger (evento): algo ocurre en tu tenant (un lead cambia de etapa, se crea un ticket, vence un recordatorio…).
Condición de entrada (opcional): un filtro sobre el lead/contacto (ej. sólo si la etapa es SALES_READY). Si no matchea, no se inscribe.
Pasos (acciones): se ejecutan en orden (enviar un mensaje, etiquetar, mover de etapa, avisar al equipo…).

Cada vez que un evento matchea un workflow activo, se crea una instancia (una ejecución) que el motor va avanzando hasta completarla.

Triggers disponibles

Trigger	Se dispara cuando…
`lead.created`	se crea un lead
`lead.stage_changed`	un lead cambia de etapa del funnel
`lead.escalated`	un lead se escala a humano (lead listo)
`handoff.requested`	se pide un handoff a una persona
`ticket.created`	se crea un ticket de soporte
`ticket.state_changed`	un ticket cambia de estado
`ticket.resolved`	un ticket se resuelve / cierra
`campaign.converted`	hay una conversión de campaña
`followup.due`	vence un follow-up programado
`booking.reminder_due`	vence el recordatorio de una reserva/cita
`conversation.auto_closed`	una conversación se cierra por inactividad
`sla.breached`	se incumple el SLA de respuesta

Acciones disponibles

Acción	Qué hace	Parámetros clave
`send_message`	Envía un mensaje al contacto (respeta anti-ban).	`text`
`set_funnel_stage`	Mueve el lead a otra etapa del funnel.	`stage`
`set_tags`	Agrega o setea etiquetas en el lead o contacto.	`tags`, `target` (`lead`\|`contact`), `mode` (`set`\|`add`)
`schedule_followup`	Programa un seguimiento a futuro.	`delay_hours` (o `target_datetime`), `message`
`notify_team`	Avisa al equipo (notificación interna).	`message`, `title`
`create_ticket`	Crea un ticket de soporte.	`description`, `category`, `urgency`
`handoff`	Deriva la conversación a una persona.	`message`
`cancel_followup`	Cancela un seguimiento pendiente.	—

Tipos de paso

action — ejecuta una acción. En su config, la clave action indica cuál, y el resto son sus parámetros.
wait — espera (una duración o hasta un momento) antes del paso siguiente. Ideal para secuencias (“esperá 1 día, después mandá…”).
branch — bifurca según una condición: continúa por on_true_ref o por on_false_ref.

Los pasos se encadenan por referencia (ref): cada paso apunta al siguiente con next_ref (o on_true_ref/on_false_ref en un branch).

El flujo: crear → activar → correr

crear_workflow / crear_workflow_desde_texto   →  queda en BORRADOR
        ↓  (revisás con listar_workflows)
activar_workflow                              →  pasa a ACTIVO
        ↓  (ocurre el evento → se crea una instancia)
el runner ejecuta los pasos                   →  instancia COMPLETED
        ↓
ver_instancias_workflow                       →  ves cada ejecución

Un workflow nace en borrador y no corre hasta que lo activás — así podés revisarlo antes.

Estructurado

// crear_workflow
{
  "nombre": "Lead escalado → priorizar",
  "trigger_type": "lead.escalated",
  "pasos": [
    { "ref": "s1", "step_type": "action",
      "config": { "action": "set_tags", "tags": ["caliente"], "target": "lead", "mode": "add" },
      "next_ref": "s2" },
    { "ref": "s2", "step_type": "action",
      "config": { "action": "set_funnel_stage", "stage": "SALES_READY" } }
  ],
  "confirmar": true
}
// → { "ejecutado": true, "workflow_id": "…", "status": "draft" }

Después: activar_workflow(workflow_id, confirmar=true) y ya corre ante cada lead.escalated.

Por lenguaje natural

La forma más rápida: describís lo que querés y el motor lo compila a pasos.

// crear_workflow_desde_texto
{ "descripcion": "Cuando un lead se escala, avisá al equipo y movelo a SALES_READY",
  "confirmar": true }
// → crea el workflow (en borrador) con los pasos notify_team + set_funnel_stage

Revisá el resultado con listar_workflows y activalo cuando estés conforme.

Herramientas MCP

Herramienta	Qué hace
`listar_workflows`	Tus workflows y su estado (borrador / activo / pausado).	Lectura
`ver_instancias_workflow`	Ejecuciones de un workflow (activas, completadas, con error).	Lectura
`crear_workflow`	Crea un workflow estructurado (borrador).	✍️ Escritura
`crear_workflow_desde_texto`	Crea un workflow describiéndolo en español (borrador).	✍️ Escritura
`activar_workflow`	Activa un workflow en borrador.	✍️ Escritura