Bisnis dapat berintegrasi dengan Webhooks untuk mendapatkan notifikasi realtime tentang perubahan pada Akun WhatsApp Business (WABA), termasuk saat bisnis telah melanggar kebijakan WhatsApp. Panduan ini mengajarkan Anda cara menyiapkan Webhooks untuk menerima notifikasi tersebut sehingga bisnis dapat dengan cepat menyesuaikan perilaku agar terhindar dari peringatan dan/atau tindakan penegakan tambahan.
Untuk menyelesaikan panduan ini, Anda harus mendaftar sebagai Developer Meta. Setelah terdaftar, Anda perlu menyiapkan akun Pengelola Bisnis dan Aplikasi Meta untuk Developer.
Saat membuat aplikasi Meta, pastikan Anda memilih jenis "Bisnis" dan menautkan aplikasi baru Anda dengan Pengelola Bisnis.
Setelah Anda membuat aplikasi, tambahkan WhatsApp sebagai produk ke aplikasi Anda. Untuk melakukannya:
Selain itu, pastikan aplikasi Anda telah menyelesaikan Tinjauan Aplikasi dan meminta izin whatsapp_business_management
.
Ikuti panduan Mulai Menggunakan Webhooks kami untuk membuat endpoint dan mengonfigurasi Webhooks Anda.
Anda perlu membuat aplikasi Anda berlangganan notifikasi Webhooks untuk Akun WhatsApp Business. Ada dua cara yang berbeda untuk berlangganan:
Setelah aplikasi Anda telah mendaftar untuk menerima Webhooks yang terkait dengan WABA, Anda dapat menyaring jenis pembaruan yang ingin diterima. Untuk melacak status WABA, Anda harus memilih opsi account_update. Dengan cara ini, Anda akan diberi tahu jika ada WABA yang melanggar kebijakan WhatsApp.
Untuk memilih opsi ini, buka Dasbor Aplikasi Anda dan cari opsi Pengaturan. Anda akan melihat bagian Webhooks dengan semua informasi yang Anda berikan pada langkah sebelumnya. Cari kolom Webhooks, dan klik Kelola. Kotak dialog akan muncul dengan semua kolom yang Anda bisa berlangganan. Klik Berlangganan untuk account_update.
Sekarang, setiap kali WABA Anda melanggar suatu kebijakan, Anda akan mendapatkan notifikasi seperti ini:
{ "object": "whatsapp_business_account", "entry": [ { "id": "whatsapp-business-account-id", "time": 1604703058, "changes": [ { "field": "account_update", "value": { "phone_number": "16505551111", "event": "ACCOUNT_VIOLATION", "violation_info": { "violation_type": "ALCOHOL", } } } ] } ] }
Semua pelanggaran kebijakan dapat ditemukan di sini.
Anda harus mengawasi Webhooks Anda untuk memeriksa apakah WABA Anda telah dibatasi karena pelanggaran kebijakan. Jika pembatasan telah diberlakukan, Anda mendapatkan Webhooks yang menyertakan kolom restriction_info
, di dalam objek nilai. Kolom restriction_info
memberikan daftar semua batasan yang dikenakan pada akun Anda dan kapan batasan tersebut kedaluwarsa.
WABA Anda mungkin menerima satu atau beberapa batasan karena pelanggaran kebijakan. Dalam contoh berikut, Webhooks melaporkan bahwa WABA telah dibatasi untuk menambahkan nomor telepon baru:
{ "field": "account_update", "value": { "phone_number": "PHONE_NUMBER", "event": "ACCOUNT_RESTRICTION", "restriction_info": [ { "restriction_type": "RESTRICTION_ON_ADD_PHONE_NUMBER_ACTION", "expiration": TIMESTAMP }, ] } }
Di sini, Anda melihat WABA yang tidak lagi diizinkan mengirimkan pesan yang diinisiasi oleh pelaku bisnis:
{ "field": "account_update", "value": { "phone_number": "PHONE_NUMBER", "event": "ACCOUNT_RESTRICTION", "restriction_info": [ { "restriction_type": "RESTRICTED_BIZ_INITIATED_MESSAGING", "expiration": TIMESTAMP }, ] } }
Akhirnya, Anda melihat WABA yang tidak lagi diizinkan untuk menanggapi pesan yang diinisiasi oleh pengguna:
{ "field": "account_update", "value": { "phone_number": "PHONE_NUMBER", "event": "ACCOUNT_RESTRICTION", "restriction_info": [{ "restriction_type": "RESTRICTED_CUSTOMER_INITIATED_MESSAGING", "expiration": TIMESTAMP } ] } }