Disparar um workflow a partir de um agente de IA (ferramenta trigger_workflow)

A ferramenta Acionar workflows (trigger_workflow) permite que um agente de IA dispare, no meio de uma conversa, qualquer workflow que você já tenha montado no seu workspace: enviar um modelo de WhatsApp, transferir a conversa, adicionar o contato a uma campanha, etc. O agente não cria workflows novos — ele só aciona os que você já construiu e deixou ativos.

Requisitos

• O workflow desejado precisa existir em Workflows e estar Ativo (se estiver inativo, a ferramenta rejeita a chamada).
• O workflow e o agente precisam pertencer ao mesmo workspace (o agente nunca aciona workflows de outro workspace, mesmo que descubra o ID).
• A ferramenta precisa estar habilitada na aba Ferramentas do editor do agente.

Passos

1. Monte e ative o workflow em Workflows (dê um nome claro; o slug em kebab-case, ex. boas-vindas-vip, é gerado automaticamente).
2. Anote o slug do workflow (ele aparece na lista de "Workflows disponíveis" do painel da ferramenta).
3. Em Configurações → Agentes de IA, abra o agente, vá até a aba Ferramentas e ative "Acionar workflows".
4. Nas instruções do agente, descreva quando usá-la e qual workflow, referenciando o slug (ex. "se o cliente perguntar sobre renovação, acione o workflow lembrete-renovacao").

Exemplo

Um cliente escreve para o bot: "quero renovar meu plano". O agente detecta a intenção, chama trigger_workflow com workflow_slug: "lembrete-renovacao", e o workflow assume — envia o modelo de renovação e etiqueta o contato — sem intervenção humana.

Dicas

• Prefira sempre workflow_slug (identificador legível) em vez de workflow_id (numérico, legado).
• Você pode passar variables (pares chave-valor) que o workflow recebe como variáveis de entrada.
• Execuções disparadas por IA aparecem marcadas como tipo ai_agent no histórico de execuções, para diferenciá-las das manuais.

Solução de problemas

• "workflow not found": confira se o slug está correto e se o workflow pertence ao workspace do agente.
• "workflow is not active": ative o workflow na lista de Workflows antes que o agente possa acioná-lo.
• Se o agente nunca chama a ferramenta, confirme que ela está habilitada em Ferramentas e que as instruções mencionam explicitamente o slug certo.