Перейти до вмісту
TicketingHub Help

Як налаштувати вебхуки

Вебхуки надсилають вибрані події TicketingHub до іншої системи одразу після їх виникнення.

Перш ніж почати

  • Вебхуки мають бути активовані для вашого облікового запису TicketingHub. Зверніться до TicketingHub, якщо розділ «Вебхуки» відсутній.
  • Вам потрібен доступ адміністратора або менеджера.
  • Система-одержувач має надати загальнодоступну HTTPS-адресу.

Додайте вебхук

  1. Перейдіть до Налаштування → Розширені.
  2. Знайдіть пункт Вебхуки і виберіть Редагувати.
  3. Виберіть Новий вебхук.
  4. Введіть HTTPS-адресу, на яку надходитимуть події.
  5. Виберіть типи подій для надсилання, наприклад підтверджене або скасоване бронювання.
  6. Необов’язково: введіть надійний секрет, щоб система-одержувач могла перевіряти кожен запит.
  7. Створіть вебхук, а потім виконайте одну з вибраних подій, щоб перевірити його роботу.

Якщо ви додасте секрет, TicketingHub підписуватиме кожен запит і надсилатиме підпис у заголовку X-TicketingHub-Signature-256. Ваш розробник має перевіряти цей підпис перед прийняттям даних.

Підтримуйте вебхук активним

Система-одержувач має своєчасно відповідати успішним статусом 2xx. TicketingHub повторно надсилає дані, якщо час очікування спливає або надходить неуспішна відповідь. Кінцева точка, яка продовжує повертати помилки, автоматично вимикається. Виправте систему-одержувач, потім поверніться на сторінку «Вебхуки» і знову активуйте її.

TicketingHub надсилає події лише на загальнодоступні адреси. Якщо URL-адреса вказує на адресу приватної мережі, наприклад на сервер у вашій локальній мережі, TicketingHub не надсилає подію та одразу вимикає вебхук. На сторінці «Вебхуки» відображається повідомлення «URL-адреса вказує на адресу приватної мережі», а адміністратори вашого облікового запису отримують електронний лист. Змініть URL-адресу на загальнодоступну адресу HTTPS, а потім знову ввімкніть вебхук.

Вибирайте лише потрібні події та не використовуйте тестову URL-адресу в робочому обліковому записі. Щоб надсилати події до Zapier без створення власного обробника, див. Як підключити TicketingHub до Zapier. Щоб створити інтеграцію, яка також запитує дані з TicketingHub, див. Як створити та використовувати токен API.