Workflows

Dispare n8n, Make, Zapier, Pipedream ou qualquer URL de workflow com as variáveis da rota como campos JSON planos, mais a decisão em dcision — assinado e com novas tentativas em segundo plano.

Um destino de workflow inicia uma automação que você montou numa ferramenta no-code ou low-code. A Dcision faz POST das variáveis da rota para a URL de gatilho do workflow — como campos JSON planos, o formato que essas ferramentas mapeiam com um clique — e a entrega em segundo plano, com novas tentativas.

Configure-o

{
  "key": "sales_crm",
  "type": "workflow",
  "when": { "conditions": [{ "field": "route", "on": "output", "operator": "eq", "value": "sales" }] },
  "params": {
    "message": { "from": "state.message", "required": true },
    "company_size": { "from": "state.company_size" },
    "lead_score": { "from": "composites.lead_score" },
    "team": { "value": "inbound" }
  },
  "workflow": { "platform": "n8n", "url": "{{secrets.N8N_LEADS_WEBHOOK}}", "name": "New sales lead" }
}
CampoTipoPadrãoDescrição
platformstringcustomn8n, make, zapier, pipedream ou custom. Rotula o destino e sugere o formato da URL no editor; a requisição é a mesma para todos.
urlstring—A URL de gatilho do workflow: https://…, ou {{secrets.NAME}} contendo a URL inteira. Até 2.048 caracteres, com variáveis.
namestring—Opcional, até 120 caracteres. Enviado como dcision.workflow.

No editor, os params de um workflow se chamam Variáveis do workflow.

PlataformaGatilho a criar
n8nUm nó Webhook, método POST; use a URL de produção dele.
MakeUm módulo Custom webhook.
ZapierUm gatilho Webhooks by Zapier → Catch Hook.
PipedreamUm gatilho HTTP / Webhook.
CustomQualquer endpoint https que aceite um POST JSON.

Na prática, URLs de gatilho são segredos — quem tiver uma pode iniciar o seu workflow. Guarde-a como um segredo do workspace e use {{secrets.NAME}} como URL, como acima.

A requisição

Body do POST
{
  "message": "We need pricing for 500 users and want to start next month.",
  "company_size": 500,
  "lead_score": 0.8414,
  "team": "inbound",
  "dcision": {
    "decision": "lead-qualification",
    "decision_id": "dec_3fKq9ZtW1mXcV7bN2pLa",
    "version": 4,
    "execution_id": "exec_8HsT2kQw9ZyR4vMn1cXe",
    "result": { "purchase_intent": 0.9412, "priority": "high", "route": "sales" },
    "confidence": { "purchase_intent": 0.8824, "priority": 0.69, "route": 0.85 },
    "action": "continue",
    "action_reason": { "type": "default" },
    "destination": "sales_crm",
    "workflow": "New sales lead",
    "delivery_id": "dlv_8kJx2mQp4LzN7vR1tY6w",
    "livemode": true
  }
}
  • Cada param é um campo de nível superior; a decisão em si fica em dcision. Um param chamado dcision seria substituído por esse objeto — escolha outro nome.
  • dcision.workflow é o name do destino (null sem um), dcision.version é null no Playground, e dcision.livemode é false para chaves de teste e no Playground.
  • O estado nunca é enviado como tal — só os params que você mapear.

A requisição leva Content-Type: application/json, os headers da Dcision com o seu Dcision-Signature, e Idempotency-Key igual ao ID da entrega. A maioria dos gatilhos no-code não consegue verificar uma assinatura HMAC — em vez disso, mantenha a URL em segredo. Quando o seu workflow puder rodar código, verifique a assinatura como num webhook.

Entrega

Os workflows são entregues pelo menos uma vez, com seis tentativas ao longo de cerca de sete horas: responda 2xx rápido e deixe o workflow rodar de forma assíncrona. Uma execução iniciada duas vezes para a mesma entrega traz o mesmo dcision.delivery_id — deduplique por ele quando uma duplicata causar problemas, por exemplo antes de criar um registro no CRM.

Nesta página