Meta Tech Provider

webhook phone_number_quality_update

phone_number_quality_update melaporkan perubahan throughput dan had mesej bagi sesuatu nombor. Setakat 2026, webhook ini tidak membawa penarafan kualiti hijau, kuning atau merah walaupun namanya begitu. Penarafan itu perlu dibaca terus daripada nombor telefon melalui polling.

2026

Tahun kandungan field ini berubah dan tidak lagi membawa penarafan warna.

Penarafan kualiti yang boleh dimiliki nombor: hijau, kuning dan merah. Tiada satu pun dihantar di sini.

131048

Ralat yang dipulangkan nombor apabila had kualiti mula berkuat kuasa.

Apakah kandungan sebenar webhook ini?

Maklumat throughput dan had mesej, dihantar sebagai nilai event bersama field yang membawa had semasa.

Kandungan praktikalnya ialah kapasiti nombor telah berubah: nombor itu berpindah ke peringkat mesej yang lain, atau tahap throughputnya dilaraskan. Perubahan ini berguna untuk direkodkan kerana ia mengubah perkara yang boleh dilakukan oleh integrasi, dan penurunan peringkat ialah isyarat awal.

Apa yang tiada di dalamnya, walaupun berdasarkan nama field, ialah penarafan kualiti. Pengendali yang ditulis berdasarkan dokumentasi lama akan mencari GREEN, YELLOW atau RED di sini tetapi tidak menemui apa-apa, lalu menyimpulkan bahawa kualiti tidak pernah berubah.

Jadi, dari manakah penarafan warna datang?

Daripada pembacaan terus pada nombor telefon mengikut jadual.

Field quality_rating berada pada objek nombor telefon dalam Graph API, dan nilainya perlu dibaca melalui polling, bukan ditunggu. Sebab itu pemantauan sambungan yang betul memerlukan proses polling serta penerima webhook: kedua-duanya membawa perkara berbeza dan tiada satu pun mencukupi sendirian.

Sebab itu juga penurunan kualiti tidak kelihatan kepada kebanyakan integrasi. Tiada apa-apa yang menolaknya, aplikasi WhatsApp Business tidak memaparkan tandanya, dan apabila nombor mula menghasilkan ralat 131048, mesej yang terjejas sudah pun gagal dihantar.

Kesilapan biasa

Mencari GREEN, YELLOW atau RED dalam payload ini. Setakat 2026, ia tiada di sini.
Membina pemantauan berdasarkan webhook sahaja. Penarafan kualiti perlu dibaca melalui polling.
Mengabaikan perubahan peringkat yang menurun. Biasanya itulah tanda pertama masalah yang kelihatan.

Menggunakan EasyCoexistence untuk ini

EasyCoexistence membuat polling penarafan kualiti, peringkat mesej dan tahap throughput pada setiap nombor yang disambungkan serta merekodkan setiap semakan, supaya penurunan kelihatan sebelum menyebabkan send gagal.

Soalan lazim

Mengapa field ini dinamakan sempena kualiti?

Nama itu wujud sebelum perubahan tersebut. Namanya kekal walaupun kandungannya berubah, sebab itu perkara ini mengelirukan ramai orang.

Berapa kerap penarafan perlu dibaca melalui polling?

Cukup kerap untuk mengesan penurunan sebelum menjadi had. Kami membuat polling mengikut jadual, bukan apabila diminta.

Adakah aplikasi memaparkan penarafan itu?

Tidak. Aplikasi WhatsApp Business pada telefon tidak memaparkan apa-apa tentangnya.

Adakah 131048 berkaitan?

Ya. Itulah ralat yang mula dipulangkan oleh nombor apabila penarafan rendah menyebabkan had dikenakan.

Teruskan membaca

The phone_number_name_update webhookMeta reports display name approvals and rejections here. It is the only place the decision appears, and nothing shows it in the app.The message_template_status_update webhookMeta reports template approvals, rejections and disabling here. What each status means and why it removes the need to poll.WhatsApp error 131048: spam rate limit hitError 131048 means the number's quality has dropped far enough that Meta is limiting sends. What causes the drop and how a number recovers.A number stopped working: how to find out whyA checklist in the order these failures actually happen: token, webhook override, inactivity disconnection, quality, and account restriction.

Sedia untuk bermula?

Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.

Mulakan Percubaan Percuma

Disahkan pada 2026-09-22