Lewati ke konten utama

Webhook Out

Webhook mengirim pemberitahuan otomatis dari Wavio ke server Anda setiap kali peristiwa tertentu terjadi. Ini cara menghubungkan Wavio ke sistem yang Anda bangun sendiri.

Membuat webhook​

  1. Buka menu Webhook Out.
  2. Isi Webhook URL, misalnya https://your-server.com/webhook.
  3. Pilih Events yang ingin diterima.
  4. Isi Secret (opsional) untuk verifikasi keaslian kiriman.
  5. Aktifkan.

Event yang tersedia​

Pesan masuk berdasarkan jenisnya:

message.received · message.text · message.image · message.video · message.audio · message.document · message.location · message.reaction · message.button · message.interactive

Status pesan keluar:

message.sent — diterima server WhatsApp message.delivered — sampai ke perangkat penerima message.read — dibaca penerima message.failed — gagal terkirim

Template:

template.approved — template disetujui Meta template.rejected — template ditolak

Nomor:

number.token_expired — token nomor kedaluwarsa

Event yang paling penting untuk dipantau

number.token_expired dan message.failed. Keduanya menandakan masalah yang menghentikan operasional Anda, dan sebaiknya memicu peringatan ke tim teknis.

Memilih event secukupnya​

Jangan berlangganan semua event kecuali Anda memang memprosesnya. Berlangganan message.text untuk nomor yang ramai berarti server Anda menerima kiriman terus-menerus.

Pilih yang benar-benar Anda butuhkan:

  • Ingin mencatat semua chat masuk ke database sendiri? message.received
  • Ingin memantau kegagalan? message.failed
  • Ingin tahu template disetujui? template.approved dan template.rejected

Webhook signing secret​

Secret dipakai untuk menandatangani setiap kiriman, sehingga server Anda bisa memastikan permintaan itu benar berasal dari Wavio dan bukan dari pihak lain yang menebak alamat endpoint Anda.

Selalu isi secret untuk webhook produksi, dan verifikasi tanda tangannya di sisi server sebelum memproses data.

Persyaratan endpoint Anda​

Harus HTTPS. Alamat http:// biasa tidak diterima.

Harus membalas cepat. Balas dengan status sukses segera setelah menerima, lalu proses datanya di belakang layar. Endpoint yang lambat akan dianggap gagal.

Harus tahan terhadap kiriman ganda. Kiriman bisa terjadi lebih dari sekali. Buat pemrosesan Anda idempoten — memproses pesan yang sama dua kali tidak boleh menghasilkan dua catatan.

Harus menerima bidang baru. Jangan menolak payload yang memuat bidang yang belum Anda kenal.

Mengelola webhook​

Kolom Status menunjukkan apakah webhook aktif. Nonaktifkan sementara saat server Anda sedang dipelihara, daripada membiarkan kiriman gagal terus-menerus.

Untuk menghapus, Wavio meminta konfirmasi Hapus webhook ini?

Menelusuri masalah​

Bila data tidak sampai, periksa berurutan:

  1. Apakah webhook berstatus aktif
  2. Apakah URL benar dan bisa diakses dari internet
  3. Apakah event yang Anda butuhkan memang dipilih
  4. Apakah server Anda membalas dengan status sukses
  5. Apakah ada pemblokiran di firewall server Anda

Webhook masuk versus webhook keluar​

Jangan tertukar. Webhook Out ini mengirim data dari Wavio ke server Anda. Sementara webhook yang dikonfigurasi di tab Pengaturan Lanjutan nomor WABA adalah jalur dari Meta ke Wavio — itu yang membuat pesan masuk muncul di Inbox, dan biasanya sudah diatur otomatis saat nomor dihubungkan.