Перейти до вмісту
Sursa Developers

Події · Запитання й відповіді

gap.detected

Виявлено прогалину в знаннях

Знайдено прогалину в знаннях: схожі запитання лишаються без відповіді.

Тип об’єкта
gap
Кому доставляється
Вебхукам, яким видно об’єкт: за роллю, профілем доступу та колекціями

Вміст події

Об’єкт: EventGapDetected

  • idstringобов’язково

    ID події (evt_…), також надсилається в заголовку webhook-id. За ним відкидайте дублікати доставок.

  • typestringобов’язково

    Допустимі значення: gap.detected

  • created_atstring (date-time)обов’язково

    Коли сталася зміна (UTC).

  • org_idintegerобов’язково
  • api_versionstringобов’язково

    Версія договору для схеми data.

  • sequenceinteger

    Порядковий номер доставки в межах вебхука (немає для тестової події).

  • objectWebhookEventObjectобов’язково
  • payloadstringобов’язково

    thin означає, що data немає: читайте об’єкт через API.

    Допустимі значення: fullthin

  • dataobject
    Поля
  • testbooleanобов’язково

    Тестова подія, надіслана через POST /v1/webhooks/{webhook_id}/test.

Приклад доставки

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "gap.detected",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "gap",
    "id": "3051"
  },
  "payload": "full",
  "data": {
    "gap": {
      "question_id": 3051,
      "representative": "How do I request a refund?",
      "count": 6,
      "first_at": "2026-10-17T08:12:00Z",
      "last_at": "2026-10-24T09:40:00Z",
      "collection_ids": [
        3
      ],
      "days": 7
    }
  },
  "test": false
}

Отримання подій

Кожна доставка — це запит POST із таким тілом JSON на адресу вашого вебхука. Перш ніж довіряти тілу, перевірте заголовок webhook-signature (Standard Webhooks), відповідайте статусом 2xx протягом кількох секунд, а саму роботу виконуйте вже після відповіді. Доставки на один вебхук зберігають порядок подій; невдала доставка повторюється зі зростаючими паузами.

Нові типи подій і нові поля можуть з’явитися будь-коли: пропускайте типи й поля, яких ви не знаєте.

Ті самі події 30 днів зберігаються в стрічці подій →