WhatsApp エラー 131056:1 人の受信者へのメッセージが多すぎます
エラー 131056 は、短時間に企業の電話番号から 1 人の受信者へメッセージを送りすぎたことを示します。これはアカウント全体のスループットとは別の、ペア単位のレート制限です。通常は、自動化処理が同じ動作を繰り返していることを意味します。
短時間に 1 組の間でメッセージを送りすぎた場合の Meta のコードです。
アカウント全体のレート制限に関する関連コードです。
サービスが一時的に利用できない場合のコードです。
なぜペア単位なのですか
防ぐ対象は全体的な送信量ではなく、1 人の相手にメッセージが集中することだからです。アカウントが全体のスループットの範囲内でも、1 分間に 1 人へ 30 件のメッセージを送ることはできます。その場合、アカウント全体の量に関係なく、相手にはスパムとして届きます。
そのため、この制限はアカウントではなくペアに適用されます。全体のレート制限に近づいたことがない、利用量の少ない番号でも発生するのはこのためです。
通常は何が原因ですか
ほとんどの場合、人が入力したものではなく自動処理が原因です。
- 配信失敗を送信失敗と判断し、再送するリトライループ
- 返信を送信する Webhook ハンドラーが、同じイベントに対して複数回呼び出される
- チャットボットが 1 つの返信を短いメッセージに分割し、短時間に続けて送信する
- 開発中に同じ番号へ繰り返し送信するテストスクリプト
どうすれば防げますか
アカウント単位だけでなく、会話単位でスロットリングします。送信前に受信者ごとの 1 分あたりのメッセージ数を制限すれば、ほとんどコストをかけずに、このエラーとその背後にある顧客体験の問題を防げます。
メッセージの重複排除も同じくらい重要です。Webhook イベントは複数回配信されることがあり、処理済みの message id かどうかを確認せずに返信を送るハンドラーは、負荷が高い状況でまさにこのパターンを引き起こします。
よくある間違い
- リトライして、すでにメッセージが集中している受信者へさらに送信する
- アカウント単位だけでスロットリングする。この制限は受信者単位です
- message id による重複排除なしで Webhook イベントを処理する
EasyCoexistence は各メッセージイベントを message id 付きのまま自社のエンドポイントへ届けるため、こちらで形を変えたコピーではなく、Meta が送信したデータ上で重複排除できます。
よくある質問
これはアカウントのレート制限ですか?
いいえ。アカウントの制限は 130429 です。こちらは受信者単位です。
利用量の少ない番号でなぜ発生しますか?
制限はアカウント全体ではなく、ペアに適用されるためです。
どうすれば止められますか?
会話単位でスロットリングし、message id によって Webhook イベントを重複排除します。
リトライすべきですか?
いいえ。同じ受信者へ別のメッセージを送ることになります。
続きを読む
始める準備はできましたか?
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日