Skip to main content

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:

ObjectDeskripsi
typeMenentukan jenis webhook, yaitu poll_update
apiKeyAPI Key dari perangkat yang terhubung
pollIdID unik polling yang digunakan untuk membedakan satu polling dengan lainnya
pollContentBerisi daftar semua opsi jawaban dalam polling
senderNomor WhatsApp pembuat polling
votedBerisi 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.