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" }
}| Campo | Tipo | Padrão | Descrição |
|---|---|---|---|
platform | string | custom | n8n, make, zapier, pipedream ou custom. Rotula o destino e sugere o formato da URL no editor; a requisição é a mesma para todos. |
url | string | — | A URL de gatilho do workflow: https://…, ou {{secrets.NAME}} contendo a URL inteira. Até 2.048 caracteres, com variáveis. |
name | string | — | Opcional, até 120 caracteres. Enviado como dcision.workflow. |
No editor, os params de um workflow se chamam Variáveis do workflow.
| Plataforma | Gatilho a criar |
|---|---|
| n8n | Um nó Webhook, método POST; use a URL de produção dele. |
| Make | Um módulo Custom webhook. |
| Zapier | Um gatilho Webhooks by Zapier → Catch Hook. |
| Pipedream | Um gatilho HTTP / Webhook. |
| Custom | Qualquer 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
{
"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 chamadodcisionseria substituído por esse objeto — escolha outro nome. dcision.workflowé onamedo destino (nullsem um),dcision.versionénullno Playground, edcision.livemodeéfalsepara 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.
Agentes
Entregue um resultado ao endpoint do seu próprio agente com as instruções e ferramentas da rota — aguarde a resposta dele na resposta, ou repasse em segundo plano com novas tentativas.
Webhooks
Receba o evento assinado decision.completed na sua URL — o envelope, os headers, como verificar Dcision-Signature com e sem os SDKs, raw bodies em Express e Next.js, troca de segredo e deduplicação.