Přeskočit na obsah
Wink

Integrace webhooků

Webhooky umožňují vašim systémům přijímat oznámení v reálném čase, když se na vašem účtu Wink stane nějaká událost — nové rezervace, zrušení, aktualizace plateb a další. Tento průvodce vás provede nastavením a nejlepšími postupy.

Publikum

Section titled “Publikum”

Tento průvodce je určen vývojářům integrujícím Wink s externími systémy, jako jsou systémy pro správu nemovitostí (PMS), channel manageři, CRM nebo vlastní dashboardy.

Jak webhooky fungují

Section titled “Jak webhooky fungují”
  1. Zaregistrujete URL webhooku ve Wink.
  2. Když nastane událost (např. nová rezervace), Wink odešle HTTP POST na vaši URL.
  3. Váš server zpracuje data a odpoví s 200 OK.

Nastavení webhooku

Section titled “Nastavení webhooku”
  1. Přihlaste se do svého účtu (Extranet, Studio nebo TripPay — všechny podporují webhooky).
  2. Přejděte do Applications a poté Webhooks. Viz Webhooks.
  3. Klikněte na Create webhook.
  4. Zadejte název (např. “PMS synchronizace rezervací”).
  5. Zadejte svou webhook URL — HTTPS endpoint na vašem serveru.
  6. Vyberte události — Zvolte konkrétní události, na které se chcete přihlásit, nebo nechte prázdné pro příjem všech událostí.
  7. Přepněte Enabled na zapnuto.
  8. Klikněte na Save.

Typy událostí

Section titled “Typy událostí”

Wink podporuje 64+ typů webhook událostí v kategoriích jako správa účtu, smlouvy o rezervacích, platby, aktualizace channel managera a správa entit. Běžné události zahrnují:

KategoriePříklady
Rezervacebooking.create, booking.cancelled
Smlouva o rezervacibooking.contract.created, booking.contract.processing, booking.contract.cancelled
Platbainternal.payment.succeeded, internal.payment.failed
Vrácení penězbooking.contract.refund.partial, booking.contract.refund.full
Channel managerchannel-manager.update.rate, channel-manager.update.availability
Účetaccount.create, account.status.updated

Pro úplný seznam všech typů událostí s popisy viz Katalog webhook událostí.

Zobrazit všech 64+ typů událostí

Nejlepší postupy

Section titled “Nejlepší postupy”
  • Používejte HTTPS — Wink odesílá data pouze na HTTPS endpointy.
  • Odpovídejte rychle — Vraťte 200 OK hned po přijetí dat. Náročné zpracování provádějte asynchronně.
  • Idempotentnost — Váš handler by měl být idempotentní. Wink může opakovat doručení, pokud neobdrží odpověď 200.
  • Ověřte zdroj — Před zpracováním ověřte, že příchozí požadavky jsou od Wink.
  • Logování — Logujte každý přijatý webhook payload. Usnadní to ladění integrace.

Pozastavení a mazání

Section titled “Pozastavení a mazání”

Webhook můžete zakázat bez jeho smazání. Tím pozastavíte doručování, abyste mohli řešit problémy, aniž byste přišli o konfiguraci. Až budete připraveni, opět jej zapněte.

Smazání webhooku jej trvale odstraní. Jakákoli integrace, která na něj spoléhá, přestane dostávat oznámení.

Další čtení

Section titled “Další čtení”