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

Інтеграція Webhook

Webhook дозволяють вашим системам отримувати сповіщення в реальному часі, коли на вашому акаунті Wink відбуваються події — нові бронювання, скасування, оновлення платежів та інше. Цей посібник проведе вас через налаштування та найкращі практики.

Аудиторія

Section titled “Аудиторія”

Цей посібник призначений для розробників, які інтегрують Wink з зовнішніми системами, такими як системи управління нерухомістю (PMS), менеджери каналів, CRM або кастомні панелі керування.

Як працюють webhook

Section titled “Як працюють webhook”
  1. Ви реєструєте URL webhook у Wink.
  2. Коли відбувається подія (наприклад, нове бронювання), Wink надсилає HTTP POST на ваш URL.
  3. Ваш сервер обробляє отримані дані та відповідає 200 OK.

Налаштування webhook

Section titled “Налаштування webhook”
  1. Увійдіть у свій акаунт (Extranet, Studio або TripPay — всі підтримують webhook).
  2. Перейдіть до Applications, а потім Webhooks. Див. Webhooks.
  3. Натисніть Create webhook.
  4. Введіть назву (наприклад, “PMS Booking Sync”).
  5. Введіть свій URL webhook — HTTPS-ендпоінт на вашому сервері.
  6. Виберіть події — Оберіть конкретні події для підписки або залиште порожнім, щоб отримувати всі події.
  7. Увімкніть перемикач Enabled.
  8. Натисніть Save.

Типи подій

Section titled “Типи подій”

Wink підтримує 64+ типів подій webhook у таких категоріях, як управління акаунтом, контракти бронювання, платежі, оновлення менеджера каналів та адміністрування сутностей. Поширені події включають:

КатегоріяПриклади
Бронюванняbooking.create, booking.cancelled
Контракт бронюванняbooking.contract.created, booking.contract.processing, booking.contract.cancelled
Платіжinternal.payment.succeeded, internal.payment.failed
Повернення коштівbooking.contract.refund.partial, booking.contract.refund.full
Менеджер каналівchannel-manager.update.rate, channel-manager.update.availability
Акаунтaccount.create, account.status.updated

Для повного списку всіх типів подій з описами дивіться Каталог подій Webhook.

Переглянути всі 64+ типи подій

Найкращі практики

Section titled “Найкращі практики”
  • Використовуйте HTTPS — Wink надсилає дані лише на HTTPS-ендпоінти.
  • Відповідайте швидко — Поверніть 200 OK одразу після отримання даних. Важку обробку виконуйте асинхронно.
  • Ідемпотентність — Ваш обробник має бути ідемпотентним. Wink може повторно надсилати дані, якщо не отримає відповідь 200.
  • Перевірка джерела — Переконайтеся, що вхідні запити надходять від Wink перед обробкою.
  • Логування — Логуйте кожен отриманий webhook. Це значно полегшує налагодження інтеграції.

Призупинення та видалення

Section titled “Призупинення та видалення”

Ви можете відключити webhook без його видалення. Це призупиняє доставку, щоб ви могли усунути неполадки, не втрачаючи налаштувань. Коли будете готові, увімкніть його знову.

Видалення webhook назавжди його видаляє. Будь-яка інтеграція, що покладається на цей webhook, припинить отримувати сповіщення.

Додаткова інформація

Section titled “Додаткова інформація”