Lewati ke konten
Wink

Integrasi Webhook

Webhook memungkinkan sistem Anda menerima notifikasi waktu nyata saat terjadi acara di akun Wink Anda — pemesanan baru, pembatalan, pembaruan pembayaran, dan lainnya. Panduan ini memandu Anda melalui pengaturan dan praktik terbaik.

Audiens

Section titled “Audiens”

Panduan ini ditujukan untuk pengembang yang mengintegrasikan Wink dengan sistem eksternal seperti sistem manajemen properti (PMS), manajer saluran, CRM, atau dasbor kustom.

Cara kerja webhook

Section titled “Cara kerja webhook”
  1. Anda mendaftarkan URL webhook di Wink.
  2. Saat terjadi sebuah acara (misalnya, pemesanan baru), Wink mengirimkan HTTP POST ke URL Anda.
  3. Server Anda memproses payload dan merespons dengan 200 OK.

Mengatur webhook

Section titled “Mengatur webhook”
  1. Masuk ke akun Anda (Extranet, Studio, atau TripPay — semuanya mendukung webhook).
  2. Arahkan ke Applications lalu Webhooks. Lihat Webhooks.
  3. Klik Create webhook.
  4. Masukkan nama (misalnya, “Sinkronisasi Pemesanan PMS”).
  5. Masukkan URL webhook Anda — endpoint HTTPS di server Anda.
  6. Pilih acara — Pilih acara spesifik untuk berlangganan, atau biarkan kosong untuk menerima semua acara.
  7. Aktifkan Enabled.
  8. Klik Save.

Jenis acara

Section titled “Jenis acara”

Wink mendukung berbagai jenis acara. Acara umum meliputi:

  • Pemesanan dibuat — Pemesanan baru telah dikonfirmasi.
  • Pemesanan dibatalkan — Pemesanan telah dibatalkan.
  • Pembayaran selesai — Pembayaran telah diproses.
  • Pemesanan diperbarui — Detail pemesanan telah berubah.

Praktik terbaik

Section titled “Praktik terbaik”
  • Gunakan HTTPS — Wink hanya mengirim payload ke endpoint HTTPS.
  • Respon cepat — Kembalikan 200 OK segera setelah menerima payload. Lakukan pemrosesan berat secara asinkron.
  • Idempoten — Handler Anda harus idempoten. Wink mungkin mencoba ulang pengiriman jika tidak menerima respons 200.
  • Validasi sumber — Verifikasi bahwa permintaan masuk berasal dari Wink sebelum memproses.
  • Logging — Catat setiap payload webhook yang Anda terima. Ini memudahkan debugging masalah integrasi.

Menjeda dan menghapus

Section titled “Menjeda dan menghapus”

Anda dapat menonaktifkan webhook tanpa menghapusnya. Ini menjeda pengiriman sehingga Anda dapat memecahkan masalah tanpa kehilangan konfigurasi. Saat siap, aktifkan kembali.

Menghapus webhook akan menghapusnya secara permanen. Integrasi yang bergantung pada webhook tersebut akan berhenti menerima notifikasi.

Bacaan lebih lanjut

Section titled “Bacaan lebih lanjut”