Перейти до вмісту
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 підтримує різні типи подій. Поширені події включають:

  • Booking created — Підтверджено нове бронювання.
  • Booking cancelled — Бронювання скасовано.
  • Payment completed — Платіж оброблено.
  • Booking updated — Змінено деталі бронювання.

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

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

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

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

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

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

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

Section titled “Додаткова інформація”
  • Webhooks — Повний довідник з керування webhook.
  • Applications — Керуйте своїми API-ключами.
  • Developers > APIs — Повна документація API.