События вебхуков

Событие decision.completed из документа OpenAPI — запрос, отправляемый назначениям-вебхукам, его заголовки, каждое поле события и ответы, которых ожидает Dcision.

POST <your webhook URL>

Dcision отправляет событие decision.completed каждому сработавшему назначению-вебхуку. Событие входит в документ OpenAPI, доступный без аутентификации по адресу https://api.dcision.io/openapi.json, в разделе webhooks → decision.completed.

Заголовки запроса

ЗаголовокОбязательныйОписание
Dcision-SignatureДаt=<unix seconds>,v1=<hex> — HMAC-SHA256 от <t>.<raw body> с вашим секретом подписи; в течение 24 часов после ротации — две записи v1. См. Проверка подписи.
Dcision-DeliveryДаID доставки, dlv_… — одинаковый во всех попытках.
Dcision-AttemptДаОт 1 до 6.
Dcision-EventДаdecision.completed.
Content-TypeДаapplication/json.
User-AgentДаDcision-Destinations/1.0 (+https://docs.dcision.io/destinations).

Тело

{
  "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" }
  }
}
ПолеТипОписание
idstringID доставки, dlv_…, одинаковый во всех попытках — дедуплицируйте по нему.
typestringdecision.completed. Проверяйте его: могут появиться новые типы событий.
createdintegerКогда выполнилось решение, в секундах Unix.
livemodebooleanfalse для запусков с тестовым ключом (dcs_test_…) и из Playground.
destinationstringКлюч назначения, отправившего событие.
data.decisionstringSlug решения.
data.decision_idstringID решения, dec_….
data.versioninteger или nullВерсия, которая ответила; null из Playground, который запускает черновик.
data.execution_idstringID запуска, exec_… — execution_id из ответа API.
data.resultobjectОтветы с ключами по вопросам. Пусто после fallback из-за ошибки движка.
data.confidenceobjectУверенность каждого ответа, от 0 до 1.
data.scoresobjectВзвешенный уровень каждого вопроса score; {}, если их нет.
data.compositesobjectЗначение каждого composite; {}, если их нет.
data.actionstringcontinue, block, escalate или fallback.
data.action_reasonobjectПочему выбрано действие — см. action_reason.
data.paramsobjectПараметры, сопоставленные в назначении. Само state никогда не отправляется.

Ответы

Ваш ответЧто делает Dcision
Любой 2xx в течение 10 секундДоставка успешна.
408, 425, 429, 5xx, тайм-аут или сетевая ошибкаПовторяет — шесть попыток примерно за семь часов, с учётом Retry-After при 429 и 503.
Любой другой 4xx или редиректДоставка сразу завершается ошибкой; её можно отправить повторно из приложения.

См. Доставка и повторные попытки.

Другие назначения

API-запросы, workflows и агенты несут те же заголовки Dcision-* и подпись — Dcision-Event для них тоже decision.completed — плюс Idempotency-Key, равный ID доставки. Их тела отличаются: проверяйте их через verifySignature / verify_signature, которые не ожидают события.

На этой странице