Skip to content
Wink

Integracija Webhooka

Webhookovi omogućuju vašim sustavima primanje obavijesti u stvarnom vremenu kada se dogode događaji na vašem Wink računu — nove rezervacije, otkazivanja, ažuriranja plaćanja i još mnogo toga. Ovaj vodič vodi vas kroz postavljanje i najbolje prakse.

Publika

Section titled “Publika”

Ovaj vodič je namijenjen developerima koji integriraju Wink s vanjskim sustavima poput sustava za upravljanje nekretninama (PMS), channel managera, CRM-ova ili prilagođenih nadzornih ploča.

Kako webhookovi rade

Section titled “Kako webhookovi rade”
  1. Registrirate URL webhooka na Wink-u.
  2. Kada se dogodi događaj (npr. nova rezervacija), Wink šalje HTTP POST na vaš URL.
  3. Vaš server obrađuje podatke i odgovara s 200 OK.

Postavljanje webhooka

Section titled “Postavljanje webhooka”
  1. Prijavite se na svoj račun (Extranet, Studio ili TripPay — svi podržavaju webhookove).
  2. Idite na Applications pa zatim Webhooks. Pogledajte Webhooks.
  3. Kliknite Create webhook.
  4. Unesite ime (npr. “PMS Booking Sync”).
  5. Unesite svoj webhook URL — HTTPS endpoint na vašem serveru.
  6. Odaberite događaje — Odaberite specifične događaje na koje se želite pretplatiti ili ostavite prazno za primanje svih događaja.
  7. Uključite Enabled.
  8. Kliknite Save.

Vrste događaja

Section titled “Vrste događaja”

Wink podržava 64+ vrsta webhook događaja u kategorijama uključujući upravljanje računom, ugovore o rezervacijama, plaćanja, ažuriranja channel managera i upravljanje entitetima. Uobičajeni događaji uključuju:

KategorijaPrimjeri
Rezervacijabooking.create, booking.cancelled
Ugovor o rezervacijibooking.contract.created, booking.contract.processing, booking.contract.cancelled
Plaćanjeinternal.payment.succeeded, internal.payment.failed
Povratibooking.contract.refund.partial, booking.contract.refund.full
Channel managerchannel-manager.update.rate, channel-manager.update.availability
Računaccount.create, account.status.updated

Za potpuni popis svih vrsta događaja s opisima, pogledajte Katalog Webhook Događaja.

Pogledajte svih 64+ vrsta događaja

Najbolje prakse

Section titled “Najbolje prakse”
  • Koristite HTTPS — Wink šalje podatke samo na HTTPS endpointove.
  • Odgovarajte brzo — Vratite 200 OK čim primite podatke. Teže obrade radite asinhrono.
  • Idempotentnost — Vaš handler treba biti idempotentan. Wink može pokušati ponovo poslati ako ne primi 200 odgovor.
  • Provjerite izvor — Potvrdite da dolazni zahtjevi dolaze od Winka prije obrade.
  • Evidencija — Zabilježite svaki webhook payload koji primite. To znatno olakšava otklanjanje problema s integracijom.

Pauziranje i brisanje

Section titled “Pauziranje i brisanje”

Možete onemogućiti webhook bez brisanja. Time se pauzira dostava kako biste mogli rješavati probleme bez gubitka konfiguracije. Kad ste spremni, ponovno ga uključite.

Brisanje webhooka trajno ga uklanja. Svaka integracija koja se oslanja na taj webhook prestat će primati obavijesti.

Dodatno čitanje

Section titled “Dodatno čitanje”