Tovább a tartalomhoz
Wink

Webhook integráció

A webhookok lehetővé teszik, hogy rendszereid valós idejű értesítéseket kapjanak, amikor események történnek a Wink fiókodban — új foglalások, lemondások, fizetésfrissítések és még sok más. Ez az útmutató végigvezet a beállításon és a legjobb gyakorlatokon.

Célközönség

Szekció neve “Célközönség”

Ez az útmutató fejlesztőknek szól, akik a Wink-et külső rendszerekkel, például ingatlankezelő rendszerekkel (PMS), csatornakezelőkkel, CRM-ekkel vagy egyedi irányítópultokkal integrálják.

Hogyan működnek a webhookok

Szekció neve “Hogyan működnek a webhookok”
  1. Regisztrálsz egy webhook URL-t a Wink-en.
  2. Amikor egy esemény bekövetkezik (pl. új foglalás), a Wink HTTP POST kérést küld az URL-edre.
  3. A szervered feldolgozza a payloadot, és 200 OK választ ad.

Webhook beállítása

Szekció neve “Webhook beállítása”
  1. Jelentkezz be a fiókodba (Extranet, Studio vagy TripPay — mind támogatja a webhookokat).
  2. Navigálj az Applications menüponthoz, majd a Webhooks-hoz. Lásd: Webhooks.
  3. Kattints a Create webhook gombra.
  4. Add meg a nevet (pl. “PMS Foglalás szinkron”).
  5. Írd be a webhook URL-t — a szervered HTTPS végpontját.
  6. Válaszd ki az eseményeket — Válassz ki konkrét eseményeket, vagy hagyd üresen, hogy az összes eseményt megkapd.
  7. Kapcsold be az Enabled opciót.
  8. Kattints a Save gombra.

Eseménytípusok

Szekció neve “Eseménytípusok”

A Wink több mint 64 webhook eseménytípust támogat különböző kategóriákban, beleértve a fiókkezelést, foglalási szerződéseket, fizetéseket, csatornakezelő frissítéseket és entitáskezelést. Gyakori események:

KategóriaPéldák
Foglalásbooking.create, booking.cancelled
Foglalási szerződésbooking.contract.created, booking.contract.processing, booking.contract.cancelled
Fizetésinternal.payment.succeeded, internal.payment.failed
Visszatérítésekbooking.contract.refund.partial, booking.contract.refund.full
Csatornakezelőchannel-manager.update.rate, channel-manager.update.availability
Fiókaccount.create, account.status.updated

A teljes eseménytípus-listát leírásokkal a Webhook Események Katalógusában találod.

Az összes 64+ eseménytípus megtekintése

Legjobb gyakorlatok

Szekció neve “Legjobb gyakorlatok”
  • Használj HTTPS-t — a Wink csak HTTPS végpontokra küldi a payloadokat.
  • Válaszolj gyorsan — küldj 200 OK választ, amint megkapod a payloadot. A nehéz feldolgozást végezd aszinkron módon.
  • Idempotencia — a kezelőd legyen idempotens. A Wink újrapróbálhatja a kézbesítést, ha nem kap 200 választ.
  • Forrás ellenőrzése — ellenőrizd, hogy a bejövő kérések valóban a Wink-től származnak, mielőtt feldolgozod őket.
  • Naplózás — naplózz minden webhook payloadot, amit kapsz. Ez megkönnyíti az integrációs hibák hibakeresését.

Szüneteltetés és törlés

Szekció neve “Szüneteltetés és törlés”

Egy webhookot letilthatsz anélkül, hogy törölnéd. Ez szünetelteti a kézbesítést, így hibakeresés közben nem veszíted el a beállításokat. Ha készen állsz, kapcsold vissza.

A webhook törlése véglegesen eltávolítja azt. Az az integráció, amely erre a webhookra támaszkodik, nem fog több értesítést kapni.

További olvasnivaló

Szekció neve “További olvasnivaló”