ログイン無料トライアルを開始
Meta Tech Provider

WhatsApp エラー 4：アプリが API 呼び出しのレート制限に達しました

エラーコード 4 は、アプリが API 呼び出しのレート制限に達したことを意味します。Meta の説明は「The app has reached its API call rate limit.」です。数えられるのは番号から送信したメッセージ数ではなく、アプリが直近 1 時間（ローリング）に行った呼び出し数です。App Dashboard で使用状況を確認し、しばらく待ってから、アプリが API を呼び出す頻度を減らしてください。

4

Meta が「The app has reached its API call rate limit.」に割り当てているコードです。

200 x users

Graph API Platform Rate Limits に基づき、アプリが 1 時間に行える呼び出し数です。

API Too Many Calls

Graph API のエラー処理ガイドがコード 4 に付けている名称です。

WhatsApp のエラーコード 4 は何を意味しますか？

現在のウィンドウ内でアプリの API 呼び出しが多すぎるため、カウントが下がるまで以降の呼び出しが拒否されている状態です。

Meta はコード 4 をスロットリングエラーに分類し、詳細テキストは「The app has reached its API call rate limit.」です。Graph API のエラー処理ガイドでは API Too Many Calls と呼び、一時的なスロットリングの問題としています。

混同しやすい別のスロットリングコードが 2 つあります。80007 は WhatsApp Business アカウントがレート制限に達した場合、130429 は Cloud API のメッセージスループットです。コード 4 はどちらでもなく、アプリ自体の呼び出し枠に関するものです。

アプリの呼び出し上限はどのように計算されますか？

アプリのアクセストークンで行うリクエストについて、Meta の Graph API レート制限ガイドには計算式があります。1 時間あたりの呼び出し数は、200 にユーザー数を掛けた値です。

ユーザー数は、アプリの一意な日次アクティブユーザー数が基準です。日次の利用が落ち込むときは、週次や月次の数値が使われます。上限はユーザーごとではなくアプリ全体に適用されるため、少数のアクティブなユーザーがほとんどを使い切ることもあります。

ガイドによると、使用状況は App Dashboard に表示され、十分な数の呼び出しが行われるとレスポンスの X-App-Usage ヘッダーにも含まれます。このヘッダーを見れば、エラー 4 が出る前に上限への接近に気づけます。

エラー 4 が出たらどうすればよいですか？

しばらく呼び出しを止め、その後は呼び出しを減らしてください。

前半について、Meta のレート制限ガイドは明確です。上限に達したら API 呼び出しを止めてください。続けると呼び出し数が増え、再び成功するまでの時間が長くなるためです。

後半は設計の問題です。リクエストはバーストさせず均等に分散し、レスポンスは必要な情報が 1 回で返るように絞り込み、重複するデータを取得する呼び出しは避けます。原因として多いのはポーリングです。同じアカウントの状態を数秒おきに問い合わせる連携は、すでに持っている答えのために枠を使ってしまいます。

よくある間違い

  • ループで再試行する。追加の呼び出しのたびにカウントが増え、回復がさらに遠のきます。
  • 送信制限だと思い込む。コード 4 はアプリの呼び出しを数えるもので、メッセージのスループットは 130429 です。
  • ステータス用エンドポイントを短い間隔でポーリングする。変わらないデータを繰り返し読むと、1 時間の枠を消費します。
EasyCoexistence で実現する

EasyCoexistence は接続済みの各番号を 24 時間 365 日、自社側で監視します。そのため、接続状態の確認をアプリの呼び出し枠を使うポーリングとして実装する必要はありません。

よくある質問

エラー 4 とエラー 130429 は同じですか？

いいえ。130429 は番号のメッセージスループットです。エラー 4 は、アプリが行った API 呼び出しの数に関するものです。

エラー 4 はどのくらい続きますか？

ローリング 1 時間のウィンドウ内の呼び出し数が上限を下回るまで続きます。その間に呼び出すと、さらに延びます。

アプリが上限にどれだけ近いかはどこで確認できますか？

App Dashboard の Application Rate Limit セクションと、レスポンスで返される X-App-Usage ヘッダーで確認できます。

エラー 4 とエラー 80007 は同じですか？

いいえ。80007 は WhatsApp Business アカウントがレート制限に達したときに Meta が使うコードで、エラー 4 はアプリ自身の呼び出しを数えます。

続きを読む

WhatsApp error 130429: throughput limit reachedError 130429 means the messaging throughput limit was reached. What sets the cap, why it is temporary, and why Coexistence numbers hit it sooner.Rate limits and messaging throughputThe four separate WhatsApp Cloud API limits: messaging tier, throughput, per-recipient pairing and management calls.WhatsApp error 131057: business account in maintenance modeError 131057 means the WhatsApp Business Account is in maintenance mode. Why a throughput upgrade triggers it, how long it lasts, and what to do.WhatsApp error 133004: server temporarily unavailableError 133004 means a Meta server was temporarily unavailable. Where to check platform status, what the details value tells you, and when to retry.WhatsApp Cloud API error codesEvery WhatsApp Cloud API error code in one table: what each one means, whether retrying helps, and the page that covers it in full.

始める準備はできましたか？

WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。

無料トライアルを始める

確認日

WhatsApp エラー 4 の意味と対処法