Webhooks de workflows

Dispara uma execução de workflow a partir de uma requisição HTTP. Use o nó Webhook no editor; o backend aceita qualquer método HTTP (GET, POST, …).

​

Endpoints

Produção:

ALL /api/automations/webhooks/:workflowId
ALL /api/automations/webhooks/:workflowId/:nodeId
ALL /api/automations/webhooks/:workflowId/flow/:flowId

Teste (não conta como produção):

ALL /api/automations/webhooks/test/:workflowId
ALL /api/automations/webhooks/test/:workflowId/:nodeId
ALL /api/automations/webhooks/test/:workflowId/flow/:flowId

• :workflowId — ID do fluxo (row), não do cluster.
• :nodeId — quando há mais de um webhook no grafo ou webhookPath custom.
• /flow/:flowId — variante legada / multi-flow; preferir o modelo 1 gatilho por fluxo.

​

Exemplo

curl -X POST {{BASE_URL}}/api/automations/webhooks/uuid-do-fluxo \
  -H "Content-Type: application/json" \
  -d '{
    "orderId": "12345",
    "status": "paid"
  }'

No runtime, o body tipicamente aparece em $input.body para os nós seguintes.

​

Comportamento

• O fluxo precisa estar publicado e ativo para ingress de produção.
• Soft-delete do fluxo impede novos disparos; runs antigos permanecem.
• Resposta imediata confirma o aceite do webhook; acompanhe a execução em /automations/[clusterId]/runs.

​

Erros