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