Eventos de webhook

El evento decision.completed del documento OpenAPI, con la solicitud enviada a los destinos webhook, sus headers, cada campo del evento y las respuestas que Dcision espera.

POST <your webhook URL>

Dcision envía un evento decision.completed a cada destino webhook que se dispara. El evento forma parte del documento OpenAPI, servido sin autenticación en https://api.dcision.io/openapi.json, bajo webhooks → decision.completed.

Headers de la solicitud

HeaderObligatorioDescripción
Dcision-SignatureSít=<unix seconds>,v1=<hex>: el HMAC-SHA256 de <t>.<raw body> con tu secreto de firma; dos entradas v1 durante las 24 horas posteriores a una rotación. Consulta Verifica la firma.
Dcision-DeliverySíEl ID de la entrega, dlv_…, el mismo en cada intento.
Dcision-AttemptSíDe 1 a 6.
Dcision-EventSídecision.completed.
Content-TypeSíapplication/json.
User-AgentSíDcision-Destinations/1.0 (+https://docs.dcision.io/destinations).

Cuerpo

{
  "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" }
  }
}
CampoTipoDescripción
idstringEl ID de la entrega, dlv_…, el mismo en cada intento: deduplica con él.
typestringdecision.completed. Compruébalo: pueden agregarse más tipos de evento.
createdintegerCuándo se ejecutó la decisión, en segundos Unix.
livemodebooleanfalse para ejecuciones con una clave de prueba (dcs_test_…) y desde el Playground.
destinationstringLa clave del destino que envió el evento.
data.decisionstringEl slug de la decisión.
data.decision_idstringEl ID de la decisión, dec_….
data.versioninteger o nullLa versión que respondió; null desde el Playground, que ejecuta el borrador.
data.execution_idstringEl ID de la ejecución, exec_…: el execution_id de la respuesta de la API.
data.resultobjectLas respuestas, indexadas por pregunta. Vacío tras un fallback por error del motor.
data.confidenceobjectLa confianza de cada respuesta, de 0 a 1.
data.scoresobjectEl nivel ponderado de cada pregunta score; {} cuando no hay ninguna.
data.compositesobjectEl valor de cada compuesto; {} cuando no hay ninguno.
data.actionstringcontinue, block, escalate o fallback.
data.action_reasonobjectPor qué se eligió la acción; consulta action_reason.
data.paramsobjectLos params mapeados en el destino. El estado en sí nunca se envía.

Respuestas

Tu respuestaQué hace Dcision
Cualquier 2xx en 10 segundosLa entrega tuvo éxito.
408, 425, 429, 5xx, un timeout o un error de redReintenta: seis intentos en unas siete horas, respetando Retry-After en 429 y 503.
Cualquier otro 4xx, o una redirecciónLa entrega falla de inmediato; se puede reenviar desde la app.

Consulta Entrega y reintentos.

Otros destinos

Las solicitudes a APIs, los workflows y los agentes llevan los mismos headers Dcision-* y la misma firma —Dcision-Event también es decision.completed para ellos— más un Idempotency-Key igual al ID de la entrega. Sus cuerpos son distintos: verifícalos con verifySignature / verify_signature, que no esperan un evento.

En esta página