События вебхуков
Событие 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" }
}
}| Поле | Тип | Описание |
|---|---|---|
id | string | ID доставки, dlv_…, одинаковый во всех попытках — дедуплицируйте по нему. |
type | string | decision.completed. Проверяйте его: могут появиться новые типы событий. |
created | integer | Когда выполнилось решение, в секундах Unix. |
livemode | boolean | false для запусков с тестовым ключом (dcs_test_…) и из Playground. |
destination | string | Ключ назначения, отправившего событие. |
data.decision | string | Slug решения. |
data.decision_id | string | ID решения, dec_…. |
data.version | integer или null | Версия, которая ответила; null из Playground, который запускает черновик. |
data.execution_id | string | ID запуска, exec_… — execution_id из ответа API. |
data.result | object | Ответы с ключами по вопросам. Пусто после fallback из-за ошибки движка. |
data.confidence | object | Уверенность каждого ответа, от 0 до 1. |
data.scores | object | Взвешенный уровень каждого вопроса score; {}, если их нет. |
data.composites | object | Значение каждого composite; {}, если их нет. |
data.action | string | continue, block, escalate или fallback. |
data.action_reason | object | Почему выбрано действие — см. action_reason. |
data.params | object | Параметры, сопоставленные в назначении. Само 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, которые не ожидают события.
Входящий вебхук
POST /v1/hooks/{token} — запуск опубликованного решения по секретному URL без API-ключа из форм, CRM, Zapier, n8n, Make или любого бэкенда, по желанию с подписью секретом whsec_.
Ошибки
Формат ошибок и все коды ошибок с HTTP-статусом, значением и тем, что делать, — а также какие ошибки можно безопасно повторять.