Skip to content
Wink

Integrasi Webhook

Webhook membolehkan sistem anda menerima pemberitahuan masa nyata apabila acara berlaku pada akaun Wink anda — tempahan baru, pembatalan, kemas kini pembayaran, dan banyak lagi. Panduan ini membimbing anda melalui penyediaan dan amalan terbaik.

Audiens

Section titled “Audiens”

Panduan ini untuk pembangun yang mengintegrasikan Wink dengan sistem luaran seperti sistem pengurusan hartanah (PMS), pengurus saluran, CRM, atau papan pemuka tersuai.

Cara webhook berfungsi

Section titled “Cara webhook berfungsi”
  1. Anda mendaftar URL webhook pada Wink.
  2. Apabila acara berlaku (contohnya, tempahan baru), Wink menghantar HTTP POST ke URL anda.
  3. Pelayan anda memproses muatan dan membalas dengan 200 OK.

Menyediakan webhook

Section titled “Menyediakan webhook”
  1. Log masuk ke akaun anda (Extranet, Studio, atau TripPay — semua menyokong webhook).
  2. Navigasi ke Applications kemudian Webhooks. Lihat Webhooks.
  3. Klik Create webhook.
  4. Masukkan nama (contoh, “PMS Booking Sync”).
  5. Masukkan URL webhook anda — titik akhir HTTPS pada pelayan anda.
  6. Pilih acara — Pilih acara tertentu untuk dilanggan, atau biarkan kosong untuk menerima semua acara.
  7. Togol Enabled ke aktif.
  8. Klik Save.

Jenis acara

Section titled “Jenis acara”

Wink menyokong 64+ jenis acara webhook merangkumi kategori termasuk pengurusan akaun, kontrak tempahan, pembayaran, kemas kini pengurus saluran, dan pentadbiran entiti pengurusan. Acara biasa termasuk:

KategoriContoh
Tempahanbooking.create, booking.cancelled
Kontrak tempahanbooking.contract.created, booking.contract.processing, booking.contract.cancelled
Pembayaraninternal.payment.succeeded, internal.payment.failed
Bayaran balikbooking.contract.refund.partial, booking.contract.refund.full
Pengurus saluranchannel-manager.update.rate, channel-manager.update.availability
Akaunaccount.create, account.status.updated

Untuk senarai lengkap setiap jenis acara dengan penerangan, lihat Katalog Acara Webhook.

Lihat semua 64+ jenis acara

Amalan terbaik

Section titled “Amalan terbaik”
  • Gunakan HTTPS — Wink hanya menghantar muatan ke titik akhir HTTPS.
  • Balas dengan cepat — Pulangkan 200 OK sebaik sahaja anda menerima muatan. Lakukan pemprosesan berat secara tak segerak.
  • Idempotensi — Pengendali anda harus idempotent. Wink mungkin cuba semula penghantaran jika tidak menerima balasan 200.
  • Sahkan sumber — Sahkan bahawa permintaan masuk adalah dari Wink sebelum memproses.
  • Log — Log setiap muatan webhook yang anda terima. Ini memudahkan penyahpepijatan isu integrasi.

Menjeda dan memadam

Section titled “Menjeda dan memadam”

Anda boleh nyahaktifkan webhook tanpa memadamnya. Ini menjeda penghantaran supaya anda boleh menyelesaikan masalah tanpa kehilangan konfigurasi. Apabila bersedia, togol semula ke aktif.

Memadam webhook akan menghapuskannya secara kekal. Sebarang integrasi yang bergantung pada webhook itu akan berhenti menerima pemberitahuan.

Bacaan lanjut

Section titled “Bacaan lanjut”