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
| Header | Obligatorio | Descripción |
|---|---|---|
Dcision-Signature | Sí | 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-Delivery | Sí | El ID de la entrega, dlv_…, el mismo en cada intento. |
Dcision-Attempt | Sí | De 1 a 6. |
Dcision-Event | Sí | decision.completed. |
Content-Type | Sí | application/json. |
User-Agent | Sí | 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" }
}
}| Campo | Tipo | Descripción |
|---|---|---|
id | string | El ID de la entrega, dlv_…, el mismo en cada intento: deduplica con él. |
type | string | decision.completed. Compruébalo: pueden agregarse más tipos de evento. |
created | integer | Cuándo se ejecutó la decisión, en segundos Unix. |
livemode | boolean | false para ejecuciones con una clave de prueba (dcs_test_…) y desde el Playground. |
destination | string | La clave del destino que envió el evento. |
data.decision | string | El slug de la decisión. |
data.decision_id | string | El ID de la decisión, dec_…. |
data.version | integer o null | La versión que respondió; null desde el Playground, que ejecuta el borrador. |
data.execution_id | string | El ID de la ejecución, exec_…: el execution_id de la respuesta de la API. |
data.result | object | Las respuestas, indexadas por pregunta. Vacío tras un fallback por error del motor. |
data.confidence | object | La confianza de cada respuesta, de 0 a 1. |
data.scores | object | El nivel ponderado de cada pregunta score; {} cuando no hay ninguna. |
data.composites | object | El valor de cada compuesto; {} cuando no hay ninguno. |
data.action | string | continue, block, escalate o fallback. |
data.action_reason | object | Por qué se eligió la acción; consulta action_reason. |
data.params | object | Los params mapeados en el destino. El estado en sí nunca se envía. |
Respuestas
| Tu respuesta | Qué hace Dcision |
|---|---|
Cualquier 2xx en 10 segundos | La entrega tuvo éxito. |
408, 425, 429, 5xx, un timeout o un error de red | Reintenta: seis intentos en unas siete horas, respetando Retry-After en 429 y 503. |
Cualquier otro 4xx, o una redirección | La 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.
Webhook de entrada
POST /v1/hooks/{token} — ejecuta una decisión desplegada desde una URL secreta sin clave de API, desde formularios, CRM, Zapier, n8n, Make o cualquier backend, con firma opcional mediante un secreto whsec_.
Errores
El formato de los errores y cada código de error con su estado HTTP, qué significa y qué hacer al respecto — además de qué errores se pueden reintentar con seguridad.