Disparar un workflow desde un agente de IA (herramienta trigger_workflow)
Un agente de IA puede activar un workflow existente en medio de la conversación usando la herramienta "Activar flujos de trabajo".
Mira este paso en el video · Agentes de IA y flujos, juntos
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 tú ya construiste y dejaste activos.
Requisitos
- El workflow que quieres 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
- Construye y activa el workflow en Workflows (asígnale un nombre claro; el slug en kebab-case se genera solo, ej.
bienvenida-vip). - Anota el slug del workflow (aparece en la lista de "Workflows disponibles" del panel de la herramienta).
- En Configuración → Agentes IA, abre el agente, ve a la pestaña Herramientas y activa "Activar flujos de trabajo".
- En las instrucciones del agente, indica cuándo debe usarla y con qué workflow, referenciando el slug (ej. "si el cliente pregunta por renovación, activa 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
- Prefiere siempre
workflow_slug(identificador legible) por sobreworkflow_id(numérico, legado). - Puedes pasar
variables(pares clave-valor) que el workflow recibe como variables de entrada. - Las ejecuciones disparadas por IA quedan marcadas como tipo
ai_agenten el historial de ejecuciones, para diferenciarlas de las manuales.
Solución de problemas
- "workflow not found": revisa que el slug esté bien escrito y que el workflow pertenezca al workspace del agente.
- "workflow is not active": activa el workflow desde la lista de Workflows antes de que el agente pueda dispararlo.
- Si el agente nunca llama a la herramienta, confirma que esté habilitada en Herramientas y que las instrucciones mencionen explícitamente el slug correcto.
Artículos relacionados
-
Catálogo de disparadores (triggers) de los workflows
Conoce los eventos que pueden iniciar un workflow automáticamente en Omnifox.
-
Crear tu primera automatizacion (workflow)
Los workflows de Omnifox automatizan tu operacion: un disparador inicia la automatizacion y los nodos de accion hacen el trabajo. Crea un mensaje de bienvenida en minutos.
-
Guía completa de los flujos de trabajo (Workflows)
Los Workflows a fondo, en 54 capítulos: disparadores, nodos, variables, probar, historial, plantillas, importar y exportar, con cada opción explicada y un flujo real de punta a punta.
-
Nodos de acción disponibles en los workflows
Descubre las acciones que un workflow puede ejecutar de forma automática.
-
Condiciones y ramificaciones (si/entonces) en un workflow
Haz que tus flujos tomen decisiones y sigan caminos distintos según los datos de cada contacto.