Webhook Polling Grup
Webhook ini digunakan untuk menerima notifikasi setiap kali terjadi perubahan pada hasil polling di grup WhatsApp. Dengan webhook ini, aplikasi dapat mendeteksi secara real-time ketika anggota grup memberikan suara pada salah satu pilihan yang tersedia di polling.
Kategori Webhook
Webhook yang digunakan untuk polling memiliki tipe poll_update, yang menandakan adanya pembaruan hasil voting pada sebuah polling di grup.
Poll Update
Webhook akan mengirim data setiap kali ada anggota grup yang memberikan atau mengubah suaranya pada polling.
{
"type": "poll_update", // Tipe webhook yang dikirim
"results": { // Kumpulan object dari event poll_update
"apiKey": "xxxxx", // API Key dari perangkat pengirim
"pollId": "WHPI9F58CFB782BAC905AA", // ID unik dari polling
"pollContent": [ // Daftar semua opsi yang tersedia dalam polling
"pilihan satu",
"pilihan 2"
],
"sender": "[email protected]", // Nomor pengirim (yang membuat polling)
"voted": [ // Pilihan yang dipilih oleh anggota yang melakukan vote
"pilihan 2"
]
}
}
Webhook di atas akan dikirim saat seorang anggota grup memilih atau mengubah pilihannya pada polling. Object voted akan berisi daftar opsi yang dipilih oleh pengguna, sedangkan pollContent menampilkan seluruh opsi yang tersedia di polling.
Penjelasan Object
Berikut penjelasan dari masing-masing object di dalam webhook poll_update
:
Object | Deskripsi |
---|---|
type | Menentukan jenis webhook, yaitu poll_update |
apiKey | API Key dari perangkat yang terhubung |
pollId | ID unik polling yang digunakan untuk membedakan satu polling dengan lainnya |
pollContent | Berisi daftar semua opsi jawaban dalam polling |
sender | Nomor WhatsApp pembuat polling |
voted | Berisi opsi yang dipilih oleh anggota yang baru saja melakukan vote |
Use Case
- Memonitor hasil polling grup secara otomatis
- Menyimpan riwayat voting anggota ke dalam sistem backend
- Menjalankan aksi otomatis berdasarkan hasil polling terbaru (misalnya, mengumumkan hasil sementara di grup)
Catatan Teknis
- Endpoint webhook harus dapat menerima request POST dengan payload JSON
- Pastikan API Key yang digunakan valid dan perangkat aktif
- Gunakan
pollId
untuk mengelompokkan hasil voting dari polling yang sama - Setiap perubahan vote akan memicu webhook baru dengan data pembaruan
Kesimpulan
Webhook Polling Grup memungkinkan sistem untuk memantau hasil polling secara real-time. Dengan webhook ini, aplikasi dapat mengelola hasil voting, menampilkan statistik, atau memicu aksi otomatis berdasarkan pilihan anggota grup dengan cepat dan akurat.