Eventos de webhook
O evento decision.completed do documento OpenAPI — a requisição enviada aos destinos de webhook, os headers, cada campo do evento e as respostas que a Dcision espera.
POST <your webhook URL>A Dcision envia um evento decision.completed para cada destino de webhook que dispara. O evento faz parte do documento OpenAPI, servido sem autenticação em https://api.dcision.io/openapi.json, em webhooks → decision.completed.
Headers da requisição
| Header | Obrigatório | Descrição |
|---|---|---|
Dcision-Signature | Sim | t=<unix seconds>,v1=<hex> — o HMAC-SHA256 de <t>.<raw body> com o seu signing secret; duas entradas v1 durante as 24 horas depois de uma rotação. Veja Verificar a assinatura. |
Dcision-Delivery | Sim | O ID da entrega, dlv_… — o mesmo em toda tentativa. |
Dcision-Attempt | Sim | 1 a 6. |
Dcision-Event | Sim | decision.completed. |
Content-Type | Sim | application/json. |
User-Agent | Sim | Dcision-Destinations/1.0 (+https://docs.dcision.io/destinations). |
Body
{
"id": "dlv_8kJx2mQp4LzN7vR1tY6w",
"type": "decision.completed",
"created": 1759658400,
"livemode": true,
"destination": "notify_sales",
"data": {
"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 },
"scores": { "priority": 2.81 },
"composites": { "lead_score": 0.8414 },
"action": "continue",
"action_reason": { "type": "default" },
"params": { "message": "We need pricing for 500 users and want to start next month.", "team": "inbound" }
}
}| Campo | Tipo | Descrição |
|---|---|---|
id | string | O ID da entrega, dlv_…, o mesmo em toda tentativa — deduplique por ele. |
type | string | decision.completed. Confira: mais tipos de evento podem ser adicionados. |
created | integer | Quando a decisão rodou, em segundos Unix. |
livemode | boolean | false para execuções com uma chave de teste (dcs_test_…) e pelo Playground. |
destination | string | A chave do destino que enviou o evento. |
data.decision | string | O slug da decisão. |
data.decision_id | string | O ID da decisão, dec_…. |
data.version | integer or null | A versão que respondeu; null pelo Playground, que roda o rascunho. |
data.execution_id | string | O ID da execução, exec_… — o execution_id da resposta da API. |
data.result | object | As respostas, indexadas por pergunta. Vazio depois de um fallback por erro de engine. |
data.confidence | object | A confiança de cada resposta, de 0 a 1. |
data.scores | object | O nível ponderado de cada pergunta de nota; {} quando não há nenhuma. |
data.composites | object | O valor de cada composite; {} quando não há nenhum. |
data.action | string | continue, block, escalate ou fallback. |
data.action_reason | object | Por que a ação foi escolhida — veja action_reason. |
data.params | object | Os params mapeados no destino. O estado em si nunca é enviado. |
Respostas
| A sua resposta | O que a Dcision faz |
|---|---|
Qualquer 2xx em até 10 segundos | A entrega teve sucesso. |
408, 425, 429, 5xx, um timeout ou um erro de rede | Novas tentativas — seis tentativas em cerca de sete horas, respeitando o Retry-After em 429 e 503. |
Qualquer outro 4xx, ou um redirecionamento | A entrega falha na hora; ela pode ser reenviada pelo app. |
Veja Entrega e retries.
Outros destinos
Requisições de API, workflows e agentes levam os mesmos headers Dcision-* e a mesma assinatura — o Dcision-Event também é decision.completed para eles — mais um Idempotency-Key igual ao ID da entrega. Os bodies deles são diferentes: verifique-os com verifySignature / verify_signature, que não esperam um evento.
Webhook de entrada
POST /v1/hooks/{token} — rode uma decisão publicada a partir de uma URL secreta, sem API key, de formulários, CRMs, Zapier, n8n, Make ou qualquer backend, opcionalmente assinada com um segredo whsec_.
Erros
O formato de erro e todos os códigos de erro com o status HTTP, o que significam e o que fazer — além de quais erros podem ser repetidos com segurança.