Skip to content
Wink

Integracija Webhook-a

Webhook-ovi omogućavaju vašim sistemima da primaju obaveštenja u realnom vremenu kada se dogode događaji na vašem Wink nalogu — nove rezervacije, otkazivanja, ažuriranja plaćanja i još mnogo toga. Ovaj vodič vas vodi kroz postavljanje i najbolje prakse.

Publika

Section titled “Publika”

Ovaj vodič je namenjen programerima koji integrišu Wink sa eksternim sistemima kao što su sistemi za upravljanje nekretninama (PMS), channel manager-i, CRM-ovi ili prilagođene kontrolne table.

Kako webhook-ovi funkcionišu

Section titled “Kako webhook-ovi funkcionišu”
  1. Registrujete webhook URL 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 sa 200 OK.

Postavljanje webhook-a

Section titled “Postavljanje webhook-a”
  1. Prijavite se na svoj nalog (Extranet, Studio ili TripPay — svi podržavaju webhook-ove).
  2. Idite na Applications, zatim Webhooks. Pogledajte Webhooks.
  3. Kliknite na Create webhook.
  4. Unesite ime (npr. “PMS Booking Sync”).
  5. Unesite svoj webhook URL — HTTPS endpoint na vašem serveru.
  6. Izaberite događaje — Odaberite specifične događaje na koje želite da se pretplatite, ili ostavite prazno da primate sve događaje.
  7. Uključite Enabled.
  8. Kliknite na Save.

Tipovi događaja

Section titled “Tipovi događaja”

Wink podržava 64+ tipova webhook događaja u kategorijama kao što su upravljanje nalogom, ugovori o rezervacijama, plaćanja, ažuriranja channel manager-a i upravljanje entitetima. Uobičajeni događaji uključuju:

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

Za kompletan spisak svih tipova događaja sa opisima, pogledajte Katalog Webhook Događaja.

Pogledajte svih 64+ tipova događaja

Najbolje prakse

Section titled “Najbolje prakse”
  • Koristite HTTPS — Wink šalje podatke samo na HTTPS endpoint-e.
  • Odgovarajte brzo — Vratite 200 OK čim primite podatke. Sve zahtevnije obrade radite asinhrono.
  • Idempotentnost — Vaš handler treba da bude idempotentan. Wink može pokušati ponovnu isporuku ako ne dobije 200 odgovor.
  • Validirajte izvor — Proverite da su dolazni zahtevi zaista sa Wink-a pre obrade.
  • Logovanje — Beležite svaki webhook payload koji primite. Ovo znatno olakšava rešavanje problema sa integracijom.

Pauziranje i brisanje

Section titled “Pauziranje i brisanje”

Možete onemogućiti webhook bez brisanja. Ovo pauzira isporuku da biste mogli da rešavate probleme bez gubitka konfiguracije. Kada budete spremni, ponovo ga uključite.

Brisanje webhook-a trajno ga uklanja. Svaka integracija koja zavisi od tog webhook-a prestaje da prima obaveštenja.

Dalje čitanje

Section titled “Dalje čitanje”