Skip to content
Wink

Integrasyon ng Webhook

Pinapayagan ng mga webhook ang iyong mga sistema na makatanggap ng real-time na mga notification kapag may mga kaganapan sa iyong Wink account — mga bagong booking, pagkansela, mga update sa bayad, at iba pa. Ginagabayan ka ng gabay na ito sa pag-setup at mga pinakamahusay na kasanayan.

Audience

Section titled “Audience”

Ang gabay na ito ay para sa mga developer na nag-iintegrate ng Wink sa mga panlabas na sistema tulad ng property management systems (PMS), channel managers, CRMs, o mga custom dashboard.

Paano gumagana ang mga webhook

Section titled “Paano gumagana ang mga webhook”
  1. Magrehistro ka ng webhook URL sa Wink.
  2. Kapag may nangyaring kaganapan (hal., bagong booking), magpapadala ang Wink ng HTTP POST sa iyong URL.
  3. Pinoproseso ng iyong server ang payload at sumasagot ng 200 OK.

Pag-set up ng webhook

Section titled “Pag-set up ng webhook”
  1. Mag-log in sa iyong account (Extranet, Studio, o TripPay — lahat ay sumusuporta sa mga webhook).
  2. Pumunta sa Applications at pagkatapos ay Webhooks. Tingnan ang Webhooks.
  3. I-click ang Create webhook.
  4. Ilagay ang isang pangalan (hal., “PMS Booking Sync”).
  5. Ilagay ang iyong webhook URL — ang HTTPS endpoint sa iyong server.
  6. Pumili ng mga kaganapan — Piliin ang mga partikular na kaganapan na nais mong subaybayan, o iwanang blangko upang makatanggap ng lahat ng kaganapan.
  7. I-toggle ang Enabled sa on.
  8. I-click ang Save.

Mga uri ng kaganapan

Section titled “Mga uri ng kaganapan”

Sinusuportahan ng Wink ang 64+ na uri ng webhook event sa iba’t ibang kategorya kabilang ang pamamahala ng account, booking contracts, mga bayad, mga update sa channel manager, at pamamahala ng entity administration. Kabilang sa mga karaniwang kaganapan ang:

KategoryaMga Halimbawa
Bookingbooking.create, booking.cancelled
Booking contractbooking.contract.created, booking.contract.processing, booking.contract.cancelled
Paymentinternal.payment.succeeded, internal.payment.failed
Refundsbooking.contract.refund.partial, booking.contract.refund.full
Channel managerchannel-manager.update.rate, channel-manager.update.availability
Accountaccount.create, account.status.updated

Para sa kumpletong listahan ng bawat uri ng kaganapan kasama ang mga paglalarawan, tingnan ang Webhook Events Catalog.

Tingnan ang lahat ng 64+ na uri ng kaganapan

Mga pinakamahusay na kasanayan

Section titled “Mga pinakamahusay na kasanayan”
  • Gumamit ng HTTPS — Nagpapadala lamang ang Wink ng mga payload sa mga HTTPS endpoint.
  • Mabilis na tugon — Ibalik agad ang 200 OK kapag natanggap mo ang payload. Gawin ang mabibigat na proseso nang asynchronous.
  • Idempotency — Dapat ay idempotent ang iyong handler. Maaaring subukang muli ng Wink ang paghahatid kung hindi makatanggap ng 200 na tugon.
  • I-validate ang pinagmulan — Siguraduhing ang mga papasok na request ay mula sa Wink bago iproseso.
  • Pag-log — I-log ang bawat webhook payload na natatanggap mo. Pinapadali nito ang pag-debug ng mga isyu sa integrasyon.

Pansamantalang paghinto at pagtanggal

Section titled “Pansamantalang paghinto at pagtanggal”

Maaari mong i-disable ang isang webhook nang hindi ito tinatanggal. Pinapahinto nito ang paghahatid upang makapag-troubleshoot ka nang hindi nawawala ang iyong configuration. Kapag handa ka na, i-toggle ito pabalik sa on.

Ang pagtanggal ng webhook ay permanente itong tinatanggal. Anumang integrasyon na umaasa sa webhook na iyon ay titigil sa pagtanggap ng mga notification.

Karagdagang babasahin

Section titled “Karagdagang babasahin”