Preskočiť na obsah
Wink

Integrácia Webhookov

Webhooky umožňujú vašim systémom prijímať notifikácie v reálnom čase, keď sa na vašom účte Wink vyskytnú udalosti — nové rezervácie, zrušenia, aktualizácie platieb a ďalšie. Tento návod vás prevedie nastavením a najlepšími praktikami.

Publikum

Section titled “Publikum”

Tento návod je určený pre vývojárov integrujúcich Wink s externými systémami, ako sú systémy správy nehnuteľností (PMS), manažéri kanálov, CRM alebo vlastné dashboardy.

Ako webhooky fungujú

Section titled “Ako webhooky fungujú”
  1. Zaregistrujete URL webhooku vo Winku.
  2. Keď nastane udalosť (napr. nová rezervácia), Wink pošle HTTP POST na vašu URL.
  3. Váš server spracuje payload a odpovie s 200 OK.

Nastavenie webhooku

Section titled “Nastavenie webhooku”
  1. Prihláste sa do svojho účtu (Extranet, Studio alebo TripPay — všetky podporujú webhooky).
  2. Prejdite do Applications a potom Webhooks. Pozrite si Webhooks.
  3. Kliknite na Create webhook.
  4. Zadajte názov (napr. “PMS Synchronizácia rezervácií”).
  5. Zadajte svoju webhook URL — HTTPS endpoint na vašom serveri.
  6. Vyberte udalosti — Vyberte konkrétne udalosti, na ktoré sa chcete prihlásiť, alebo nechajte prázdne, aby ste dostávali všetky udalosti.
  7. Prepnite Enabled na zapnuté.
  8. Kliknite na Save.

Typy udalostí

Section titled “Typy udalostí”

Wink podporuje viac ako 64 typov webhook udalostí v kategóriách vrátane správy účtu, zmlúv o rezerváciách, platieb, aktualizácií manažéra kanálov a správy entít. Bežné udalosti zahŕňajú:

KategóriaPríklady
Rezerváciabooking.create, booking.cancelled
Zmluva o rezerváciibooking.contract.created, booking.contract.processing, booking.contract.cancelled
Platbainternal.payment.succeeded, internal.payment.failed
Refundáciebooking.contract.refund.partial, booking.contract.refund.full
Manažér kanálovchannel-manager.update.rate, channel-manager.update.availability
Účetaccount.create, account.status.updated

Pre kompletný zoznam všetkých typov udalostí s popismi si pozrite Katalóg webhook udalostí.

Zobraziť všetkých viac ako 64 typov udalostí

Najlepšie praktiky

Section titled “Najlepšie praktiky”
  • Používajte HTTPS — Wink posiela payloady iba na HTTPS endpointy.
  • Reagujte rýchlo — Vráťte 200 OK hneď, ako prijmete payload. Všetky náročné spracovania robte asynchrónne.
  • Idempotentnosť — Váš handler by mal byť idempotentný. Wink môže opakovane posielať doručenie, ak nedostane odpoveď 200.
  • Overte zdroj — Pred spracovaním overte, že prichádzajúce požiadavky sú od Winku.
  • Logovanie — Logujte každý prijatý webhook payload. To výrazne uľahčuje ladenie problémov s integráciou.

Pozastavenie a vymazanie

Section titled “Pozastavenie a vymazanie”

Webhook môžete zakázať bez jeho vymazania. Tým pozastavíte doručovanie, aby ste mohli riešiť problémy bez straty konfigurácie. Keď budete pripravení, opäť ho zapnite.

Vymazanie webhooku ho trvalo odstráni. Akákoľvek integrácia, ktorá na ňom závisí, prestane prijímať notifikácie.

Ďalšie čítanie

Section titled “Ďalšie čítanie”