Webhook phone_number_quality_update
phone_number_quality_update melaporkan perubahan throughput dan batas pesan untuk suatu nomor. Pada 2026, webhook ini tidak membawa peringkat kualitas hijau, kuning, atau merah meskipun namanya demikian. Peringkat tersebut harus dibaca langsung dari nomor telepon melalui polling.
Tahun ketika isi field ini berubah dan tidak lagi memuat peringkat warna.
Peringkat kualitas yang dapat dimiliki nomor: hijau, kuning, dan merah, tetapi tidak ada yang dikirim di sini.
Kesalahan yang dikembalikan nomor setelah pembatasan kualitas berlaku.
Apa sebenarnya isi webhook ini?
Informasi throughput dan batas pesan, yang dikirim sebagai nilai event beserta field yang memuat batas saat ini.
Isi praktisnya adalah kapasitas suatu nomor berubah: nomor tersebut berpindah ke tingkat pesan lain, atau tingkat throughput-nya disesuaikan. Hal ini berguna untuk dicatat karena memengaruhi kemampuan integrasi, dan penurunan tingkat menjadi sinyal awal.
Yang tidak ada di dalamnya, meskipun tercermin dari nama field, adalah peringkat kualitas. Penanganan yang dibuat berdasarkan dokumentasi lama akan mencari GREEN, YELLOW, atau RED di sini, tetapi tidak menemukannya, lalu menyimpulkan bahwa kualitas tidak pernah berubah.
Lalu, dari mana peringkat warna berasal?
Peringkat tersebut dibaca langsung dari nomor telepon berdasarkan jadwal.
Field quality_rating berada pada objek nomor telepon di Graph API dan harus dibaca melalui polling, bukan ditunggu. Karena itu, pemantauan koneksi yang benar memerlukan proses polling sekaligus penerima webhook: keduanya membawa informasi berbeda dan tidak ada yang cukup jika digunakan sendiri.
Itulah sebabnya penurunan kualitas tidak terlihat pada sebagian besar integrasi. Tidak ada mekanisme yang mengirimkannya, aplikasi WhatsApp Business tidak menampilkannya, dan saat menghasilkan kesalahan 131048, pengiriman yang terdampak sudah gagal.
Kesalahan umum
- Mencari GREEN, YELLOW, atau RED di payload ini. Pada 2026, semua itu tidak ada di sini.
- Membangun pemantauan hanya dari webhook. Peringkat kualitas harus dibaca melalui polling.
- Mengabaikan penurunan tingkat. Biasanya ini adalah tanda masalah yang terlihat paling awal.
EasyCoexistence membaca peringkat kualitas, tingkat pesan, dan tingkat throughput melalui polling pada setiap nomor yang terhubung serta mencatat setiap pemeriksaan, sehingga penurunan terlihat sebelum menyebabkan pengiriman gagal.
Pertanyaan yang sering diajukan
Mengapa field ini dinamai berdasarkan kualitas?
Nama tersebut sudah ada sebelum perubahan. Namanya tetap, sementara isinya berubah, sehingga banyak orang keliru.
Seberapa sering peringkat harus dibaca melalui polling?
Cukup sering untuk menangkap penurunan sebelum menjadi pembatasan. Kami melakukan polling berdasarkan jadwal, bukan sesuai permintaan.
Apakah aplikasi menampilkan peringkat tersebut?
Tidak. Informasi itu tidak terlihat di aplikasi WhatsApp Business pada ponsel.
Apakah 131048 berkaitan?
Ya. Itulah kesalahan yang mulai dikembalikan nomor setelah peringkat rendah menyebabkan pembatasan.
Lanjut membaca
Siap memulai?
Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.
Mulai uji coba gratisDiverifikasi pada