Penggunaan Webhook
Webhook adalah mekanisme di mana Whapi secara otomatis mengirim data ke server penerima setiap kali ada aktivitas di nomor WhatsApp yang terhubung. Data dikirim dalam format JSON melalui HTTP POST ke URL endpoint yang sudah dikonfigurasi.
Panduan cara mengaktifkan dan mengkonfigurasi webhook tersedia di Integrasi Notifikasi Webhook
Prasyarat:
- Webhook sudah dikonfigurasi di dashboard.
- Server atau endpoint publik sudah berjalan dan bisa menerima HTTP POST request.
13 Tipe Notifikasi Webhook
| Tipe | Keterangan |
|---|---|
| ready | Perangkat berhasil terhubung dan siap digunakan |
| change_state | Status koneksi perangkat berubah |
| disconnected | Perangkat terputus dari sistem |
| message | Pesan masuk diterima : teks, reply, atau reaction |
| message_ack | Status pengiriman pesan berubah di perangkat |
| message_ack_browser | Status pengiriman pesan berubah di WhatsApp Web |
| media | File media diterima: gambar, video, dokumen, atau audio |
| stories | Story dari kontak masuk |
| poll_update | Ada perubahan hasil voting pada polling di grup |
| group_join | Anggota baru bergabung ke grup |
| group_leave | Anggota keluar dari grup |
| group_update | Informasi grup berubah : nama, foto, atau deskripsi |
| schedule | Pesan terjadwal berhasil terkirim |
Setiap tipe notifikasi bisa diaktifkan atau dinonaktifkan secara individual melalui menu Kustomisasi Webhook di dashboard.
Catatan Teknis
- Server endpoint harus selalu mengembalikan HTTP 200 setelah menerima data
- Semua payload webhook dikirim dalam format JSON melalui HTTP POST
- Device harus aktif agar webhook bisa dikirim ke endpoint
- Jika endpoint tidak merespons HTTP 200, Whapi mencatat kegagalan di log error webhook
:::info Info Untuk memulai, pastikan endpoint Anda bisa menerima POST JSON dan mengembalikan HTTP 200. :::
Panduan Per Tipe Event
Webhook status koneksi perangkat
Webhook status koneksi perangkat mengirimkan notifikasi otomatis saat status koneksi berubah (ready, change_state, disconnected).
Webhook pesan, dan status pesan
Webhook pesan dan status pesan untuk menerima notifikasi pesan masuk, reaction, reply, dan perubahan status pengiriman secara real-time.
Webhook media, dan story
Panduan Webhook media dan story WHAPI — struktur payload, contoh event media/stories, cara decode base64 (PHP/Python/Node.js), dan langkah selanjutnya.
Webhook grup
Panduan webhook grup WHAPI — event group_join, group_leave, group_update beserta contoh payload dan penjelasan field penting.
Webhook Polling Grup
Panduan Webhook Polling Grup WHAPI — event poll_update, contoh payload, dan penjelasan field untuk menindaklanjuti hasil polling.