Перейти к содержимому
TicketingHub Help

Как настроить вебхуки

Вебхуки отправляют выбранные события TicketingHub в другую систему сразу после их возникновения.

Перед началом работы

  • Вебхуки должны быть включены для вашей учётной записи TicketingHub. Обратитесь в TicketingHub, если раздел «Вебхуки» отсутствует.
  • Вам необходим доступ администратора или менеджера.
  • Принимающая система должна предоставлять общедоступный URL HTTPS.

Добавление вебхука

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

Если вы добавите секретный ключ, TicketingHub будет подписывать каждый запрос и отправлять подпись в заголовке X-TicketingHub-Signature-256. Ваш разработчик должен проверять эту подпись до принятия данных.

Поддержание активности вебхука

Принимающая система должна оперативно отвечать успешным статусом 2xx. TicketingHub повторяет попытки доставки, если истекает время ожидания или система возвращает неуспешный ответ. Конечная точка, которая продолжает возвращать ошибки, автоматически отключается. Исправьте проблему в принимающей системе, затем снова откройте страницу «Вебхуки» и включите её.

TicketingHub отправляет события только на общедоступные адреса. Если URL-адрес указывает на адрес в частной сети, например на сервер внутри вашей собственной сети, TicketingHub не отправляет событие и сразу отключает вебхук. На странице «Вебхуки» отображается сообщение «URL-адрес указывает на адрес в частной сети», а администраторы вашей учетной записи получают электронное письмо. Измените URL-адрес на общедоступный адрес HTTPS, затем снова включите вебхук.

Выбирайте только необходимые события и не используйте тестовый URL в рабочей учётной записи. Чтобы отправлять события в Zapier без создания собственного обработчика, ознакомьтесь со статьёй Как подключить TicketingHub к Zapier. Чтобы создать интеграцию, которая также запрашивает данные из TicketingHub, ознакомьтесь со статьёй Как создать и использовать токен API.