Disparar un workflow desde un agente de IA (herramienta trigger_workflow)

La herramienta Activar flujos de trabajo (trigger_workflow) le permite a un agente de IA disparar, en medio de una conversación, cualquier workflow que ya tengas armado en tu workspace: enviar una plantilla de WhatsApp, transferir la conversación, sumar el contacto a una campaña, etc. El agente no crea workflows nuevos — solo activa los que vos ya construiste y dejaste activos.

Requisitos

• El workflow que querés disparar debe existir en Workflows y estar Activo (si está inactivo, la herramienta lo rechaza).
• El workflow y el agente deben pertenecer al mismo workspace (el agente nunca puede disparar workflows de otro workspace, aunque conozca el ID).
• La herramienta debe estar habilitada en la pestaña Herramientas del editor del agente.

Pasos

1. Construí y activá el workflow en Workflows (asignale un nombre claro; el slug en kebab-case se genera solo, ej. bienvenida-vip).
2. Anotá el slug del workflow (aparece en la lista de "Workflows disponibles" del panel de la herramienta).
3. En Configuración → Agentes IA, abrí el agente, andá a la pestaña Herramientas y activá "Activar flujos de trabajo".
4. En las instrucciones del agente, indicá cuándo debe usarla y con qué workflow, referenciando el slug (ej. "si el cliente pregunta por renovación, activá el workflow renovaciones-recordatorio").

Ejemplo

Un cliente le escribe al bot: "quiero renovar mi plan". El agente detecta la intención, llama a trigger_workflow con workflow_slug: "renovaciones-recordatorio", y el workflow sigue enviando la plantilla de renovación y etiquetando al contacto — sin que un humano tenga que intervenir.

Consejos

• Preferí siempre workflow_slug (identificador legible) por sobre workflow_id (numérico, legado).
• Podés pasar variables (pares clave-valor) que el workflow recibe como variables de entrada.
• Las ejecuciones disparadas por IA quedan marcadas como tipo ai_agent en el historial de ejecuciones, para diferenciarlas de las manuales.

Solución de problemas

• "workflow not found": revisá que el slug esté bien escrito y que el workflow pertenezca al workspace del agente.
• "workflow is not active": activá el workflow desde la lista de Workflows antes de que el agente pueda dispararlo.
• Si el agente nunca llama a la herramienta, confirmá que esté habilitada en Herramientas y que las instrucciones mencionen explícitamente el slug correcto.