Ir al contenido

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.

  1. Trigger (evento): algo ocurre en tu tenant (un lead cambia de etapa, se crea un ticket, vence un recordatorio…).
  2. 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.
  3. 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.

TriggerSe dispara cuando…
lead.createdse crea un lead
lead.stage_changedun lead cambia de etapa del funnel
lead.escalatedun lead se escala a humano (lead listo)
handoff.requestedse pide un handoff a una persona
ticket.createdse crea un ticket de soporte
ticket.state_changedun ticket cambia de estado
ticket.resolvedun ticket se resuelve / cierra
campaign.convertedhay una conversión de campaña
followup.duevence un follow-up programado
booking.reminder_duevence el recordatorio de una reserva/cita
conversation.auto_closeduna conversación se cierra por inactividad
sla.breachedse incumple el SLA de respuesta
AcciónQué haceParámetros clave
send_messageEnvía un mensaje al contacto (respeta anti-ban).text
set_funnel_stageMueve el lead a otra etapa del funnel.stage
set_tagsAgrega o setea etiquetas en el lead o contacto.tags, target (lead|contact), mode (set|add)
schedule_followupPrograma un seguimiento a futuro.delay_hours (o target_datetime), message
notify_teamAvisa al equipo (notificación interna).message, title
create_ticketCrea un ticket de soporte.description, category, urgency
handoffDeriva la conversación a una persona.message
cancel_followupCancela un seguimiento pendiente.—
  • 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 (“espera 1 día, después envía…”).
  • 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).

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ón

Un workflow nace en borrador y no corre hasta que lo activas — así puedes revisarlo antes.

// 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.

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_stage

Revisa el resultado con listar_workflows y actívalo cuando estés conforme.

HerramientaQué hace
listar_workflowsTus workflows y su estado (borrador / activo / pausado).Lectura
ver_instancias_workflowEjecuciones de un workflow (activas, completadas, con error).Lectura
crear_workflowCrea un workflow estructurado (borrador).✍️ Escritura
crear_workflow_desde_textoCrea un workflow describiéndolo en español (borrador).✍️ Escritura
activar_workflowActiva un workflow en borrador o pausado.✍️ Escritura
editar_pasos_workflowReemplaza los pasos de un workflow existente; las ejecuciones en curso terminan con los pasos anteriores.✍️ Escritura
pausar_workflowPausa un workflow activo: no toma casos nuevos; las ejecuciones en curso terminan.✍️ Escritura
borrar_workflowBorra un workflow con sus pasos y ejecuciones. Irreversible.✍️ Escritura
ver_horario_laboral · configurar_horario_laboralHorario laboral del tenant: fuera de él, los mensajes de los workflows se difieren al próximo inicio hábil.Lectura / ✍️