Workflows (automatizaciones)
Un workflow automatiza qué hace tu negocio cuando pasa algo: cuando un lead se escala, avisa al equipo y muévelo 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
Sección titulada «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
Sección titulada «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
Sección titulada «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
Sección titulada «Tipos de paso»action— ejecuta una acción. En suconfig, la claveactionindica 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 (“espera 1 día, después envía…”).branch— bifurca según una condición: continúa poron_true_refo poron_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
Sección titulada «El flujo: crear → activar → correr»crear_workflow / crear_workflow_desde_texto → queda en BORRADOR ↓ (revisas 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ónUn workflow nace en borrador y no corre hasta que lo activas — así puedes revisarlo antes.
Estructurado
Sección titulada «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
Sección titulada «Por lenguaje natural»La forma más rápida: describes lo que quieres y el motor lo compila a pasos.
// crear_workflow_desde_texto{ "descripcion": "Cuando un lead se escala, avisa al equipo y muévelo a SALES_READY", "confirmar": true }// → crea el workflow (en borrador) con los pasos notify_team + set_funnel_stageRevisa el resultado con listar_workflows y actívalo cuando estés conforme.
Herramientas MCP
Sección titulada «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 o pausado. | ✍️ Escritura |
editar_pasos_workflow | Reemplaza los pasos de un workflow existente; las ejecuciones en curso terminan con los pasos anteriores. | ✍️ Escritura |
pausar_workflow | Pausa un workflow activo: no toma casos nuevos; las ejecuciones en curso terminan. | ✍️ Escritura |
borrar_workflow | Borra un workflow con sus pasos y ejecuciones. Irreversible. | ✍️ Escritura |
ver_horario_laboral · configurar_horario_laboral | Horario laboral del tenant: fuera de él, los mensajes de los workflows se difieren al próximo inicio hábil. | Lectura / ✍️ |