Meta Tech Provider
phone_number_quality_update Webhook
phone_number_quality_update 會回報號碼的吞吐量及訊息上限變更。截至 2026 年，儘管名稱如此，它不會承載綠色、黃色或紅色品質評級，該評級必須直接從電話號碼輪詢。
此 Webhook 實際包含甚麼？
吞吐量及訊息上限資料，會以事件值及承載目前上限的欄位傳送。
實際內容是號碼容量有所變更：轉移至不同的訊息層級，或調整了吞吐量級別。這些資料值得記錄，因為它們會改變整合可執行的操作，而層級下降亦是早期訊號。
儘管欄位名稱如此，當中並不包含品質評級。根據舊文件編寫的處理程式會在此尋找 GREEN、YELLOW 或 RED，卻一無所獲，繼而以為品質從未變更。
那麼色彩評級從何而來？
定期直接讀取電話號碼的資料。
quality_rating 欄位位於 Graph API 的電話號碼物件上，必須輪詢，而不是等待推送。這就是妥善監察連接需要輪詢器及 Webhook 接收器的原因：兩者承載不同資料，單靠任何一方都不足夠。
這亦解釋了為何大部分整合都察覺不到品質下降。系統不會推送相關變更，WhatsApp Business 應用程式在手機上亦沒有顯示，而當它產生錯誤 131048 時，受影響的訊息傳送早已失敗。
常見錯誤
- 在此負載中尋找 GREEN、YELLOW 或 RED。截至 2026 年，當中並沒有這些值。
- 只依靠 Webhook 建立監察。品質評級必須輪詢。
- 忽略層級下降。這通常是問題最早可見的訊號。
使用 EasyCoexistence 完成這項設定
EasyCoexistence 會輪詢每個已連接號碼的品質評級、訊息層級及吞吐量級別，並記錄每次檢查，讓您在一次訊息傳送受阻前看見下降。
常見問題
為甚麼欄位以品質命名？
這個名稱早於變更。內容改變後名稱仍然保留，所以容易令人誤解。
應多久輪詢一次評級？
頻率應足以在下降演變成限制前察覺。我們按時間表輪詢，而不是按需要執行。
應用程式會顯示評級嗎？
不會。手機上的 WhatsApp Business 應用程式不會顯示任何相關資料。
131048 是否相關？
是。當低評級導致限制後，號碼便會開始回傳此錯誤。
繼續閱讀
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.
準備開始嗎？
幾分鐘內設定 WhatsApp Coexistence，而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期