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 は関連していますか？
はい。低い品質評価によって制限が始まると、番号が返し始めるエラーです。
続きを読む
始める準備はできましたか？
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日