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), menadžeri kanala, CRM-ovi ili prilagođene kontrolne table.

Kako webhook-ovi funkcionišu

Section titled “Kako webhook-ovi funkcionišu”
  1. Registrujete URL webhook-a 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 krajnju tačku 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 menadžera kanala 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
Povraćaji novcabooking.contract.refund.partial, booking.contract.refund.full
Menadžer kanalachannel-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 krajnje tačke.
  • Odgovarajte brzo — Vratite 200 OK čim primite podatke. Sve zahtevnije obrade radite asinhrono.
  • Idempotentnost — Vaš handler treba da bude idempotentan. Wink može ponovo pokušati isporuku ako ne dobije 200 odgovor.
  • Proverite izvor — Verifikujte da su dolazni zahtevi sa Wink-a pre obrade.
  • Logovanje — Beležite svaki webhook payload koji primite. Ovo 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”