Використання вебхуків дозволяє отримувати інформацію про бронювання у реальному часі. На кожну подію, що відстежується, ми створюємо вебхук, без необхідності періодично опитувати систему.
Управління webhook
Ви можете налаштувати до п'яти перехоплювачів на сторінці Webhooks у розділі Налаштування – Для розробників.
На сторінці представлені вже раніше створені webhook, їх статус, відсоток неуспішних надсилань та невеликий наочний графік статистики надсилань за останні 7 днів:
Якщо на сторінці ще нічого немає, потрібно створити новий webhook, натисніть кнопку +Додати. Введіть параметри перехоплювача:
- Метод: POST (при настанні події буде відправлено повний payload) або GET (буде відправлено коротке повідомлення без сегмента Body).
- URL: адреса, за якою ваша система прийматиме webhook.
- Коди відповіді: HTTP-коди, які будуть вважатися успішним результатом відправки. Декілька кодів поділяються комою.
- Опис: текстове поле з описом. Відображається в описі webhook для зручності, не надсилається.
У правій частині сторінки виберіть тип події, що відстежується: один з п'яти, кілька або всі доступні тригери, після яких повинен спрацювати webhook.
Нижче можна налаштувати сповіщення про автоматичне відключення webhook при помилках надсилання:
- Вкажіть кількість спроб надсилання та інтервал між ними.
- Активуйте або вимкніть відключення. Вкажіть адресу для надсилання листа про відключенні webhook або кілька адрес, розділених комою.
Нижче міститься блок додавання кастомних параметрів. Наприклад, якщо для вашої системи важлива наявність блоку авторизації в webhook, що надсилаються, ви можете додати ці параметри до надсилань.
Історія надсилань
По кожному webhook ведеться докладна історія надсилання. Зайдіть в Налаштування – Для розробників – Webhooks, виберіть у списку потрібний та клацніть по ньому.
На сторінці, що відкрилася, ви побачите коротку інформацію по webhook у верхній частині і докладний лог відправок в нижній. Доступна фільтрація за датою, успішністю або типом події.
Виберіть будь-який із записів, щоб переглянути подробиці надісланих даних. Для всіх спроб доступна кнопка Повторне надсилання.
Надані дані
Опис змінних міститься в цій статті.
Особливі налаштування
Якщо потрібно створити нестандартний webhook або більше, ніж 5 вебхуків, зверніться в підтримку та вкажіть:
- URL-адресу, на яку хочете приймати сповіщення про зміни в системі.
- Про які події надсилати повідомлення: наприклад, створення, скасування, зміна запису.
- Які дані цікавлять: вся доступна видача (весь payload) чи вибірковий набір.
- Задайте метод POST (відправляти повний payload) або GET (повідомлення без сегмента Body), параметри успішного відправлення, події, що відстежуються, і, при необхідності, кастомні атрибути.
Вебхуки доступні лише на PRO тарифі.