Automações

Como funcionam os triggers de workflow: Webhook, Schedule, Manual e eventos da plataforma.

Triggers

Triggers definem como um workflow inicia. Ficam no topo da paleta no grupo Triggers — todo workflow precisa de pelo menos um nó de trigger conectado ao restante do fluxo.

Abra Automações para adicionar e configurar triggers no canvas.

Workflows > editor > Triggers palette Figura 1: Seção Triggers na paleta do editor de workflows

Nós de trigger na paleta

Nó	Type ID	Inicia quando…
Webhook	`webhook_trigger`	Um sistema externo envia HTTP para `/wf/{workflow_id}`
Schedule	`schedule_trigger`	Cron ou data/hora única é atingida (UI: Agendamento)
Manual	`manual_trigger`	Você executa o fluxo pelo editor ou botão play

Cada nó tem um guia dedicado com passos de configuração, FAQ, exemplos e referências técnicas:

Como os triggers funcionam

Somente entrada — nós de trigger não enviam mensagens nem chamam APIs; iniciam a execução e expõem dados iniciais (context.trigger).
Multi-trigger — um workflow pode incluir Webhook, Schedule e Manual juntos. Ao salvar, define flags triggers_enabled para cada um.
Tag de execução — cada run registra trigger_source (webhook, cron, manual, crm, inbound) no histórico.
Workflows ativos — triggers automatizados (webhook, schedule) só disparam quando o workflow está ativado.

Escolhendo um trigger

Se você precisa…	Use
Reagir a eventos de site, ERP, Zapier ou API customizada	Webhook
Executar em horários fixos (diário, semanal, uma vez)	Schedule
Testar o fluxo ou executar sob demanda	Manual

Abordagem prática: comece com Manual durante a construção; adicione Webhook ou Schedule antes de ativar em produção. Mantenha Manual para QA se for útil.

Triggers da plataforma (fora da paleta)

Estes iniciam workflows sem arrastar um nó da paleta:

Mecanismo	`trigger_source`	Configuração
Eventos do board CRM	`crm`	Board CRM → Events → vincular workflow a movimentações de coluna, comentários, etc.
Respostas a botões WhatsApp	`inbound`	`inbound_trigger` interno em fluxos avançados (botões interativos)

Veja Automatizar CRM com workflows para eventos de CRM. Roteamento inbound/botões é gerenciado pela plataforma para templates interativos aprovados.

O tipo legado cron_trigger é alias de schedule_trigger em definições antigas.

Variáveis do trigger

Nós downstream leem o payload do trigger:

Variável	Origem típica
`{{trigger.body}}`	Body JSON do webhook
`{{trigger.body.field}}`	Campo aninhado do webhook
`{{trigger.query}}`	Parâmetros de query da URL
`{{trigger.method}}`	Método HTTP
`{{trigger.headers}}`	Headers da requisição (quando habilitado no Webhook)
`{{system.current_datetime}}`	Execuções agendadas — use o relógio do sistema

Referência completa: Variáveis no workflow.

Exemplo rápido — lembrete agendado

Adicione Schedule → recorrente, segundas 08:00.
Conecte Send message com texto do lembrete.
Salve e ative.

Na próxima segunda o fluxo roda automaticamente.