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

HeaderObrigatórioDescrição
Dcision-SignatureSimt=<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-DeliverySimO ID da entrega, dlv_… — o mesmo em toda tentativa.
Dcision-AttemptSim1 a 6.
Dcision-EventSimdecision.completed.
Content-TypeSimapplication/json.
User-AgentSimDcision-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" }
  }
}
CampoTipoDescrição
idstringO ID da entrega, dlv_…, o mesmo em toda tentativa — deduplique por ele.
typestringdecision.completed. Confira: mais tipos de evento podem ser adicionados.
createdintegerQuando a decisão rodou, em segundos Unix.
livemodebooleanfalse para execuções com uma chave de teste (dcs_test_…) e pelo Playground.
destinationstringA chave do destino que enviou o evento.
data.decisionstringO slug da decisão.
data.decision_idstringO ID da decisão, dec_….
data.versioninteger or nullA versão que respondeu; null pelo Playground, que roda o rascunho.
data.execution_idstringO ID da execução, exec_… — o execution_id da resposta da API.
data.resultobjectAs respostas, indexadas por pergunta. Vazio depois de um fallback por erro de engine.
data.confidenceobjectA confiança de cada resposta, de 0 a 1.
data.scoresobjectO nível ponderado de cada pergunta de nota; {} quando não há nenhuma.
data.compositesobjectO valor de cada composite; {} quando não há nenhum.
data.actionstringcontinue, block, escalate ou fallback.
data.action_reasonobjectPor que a ação foi escolhida — veja action_reason.
data.paramsobjectOs params mapeados no destino. O estado em si nunca é enviado.

Respostas

A sua respostaO que a Dcision faz
Qualquer 2xx em até 10 segundosA entrega teve sucesso.
408, 425, 429, 5xx, um timeout ou um erro de redeNovas tentativas — seis tentativas em cerca de sete horas, respeitando o Retry-After em 429 e 503.
Qualquer outro 4xx, ou um redirecionamentoA 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.

Nesta página