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

WhatsApp Cloud API のエラーコード

文書化している WhatsApp Cloud API の全エラーコードを、意味と再試行の効果とともに 1 つの表にまとめています。ほとんどは再試行しても解決しません。決定論的なエラーのため、同じリクエストは同じように失敗し、再試行ループによって不正なリクエストがレート制限を招きます。

EasyCoexistence は接続を継続的に監視し、Meta のアカウントと品質に関するイベントを接続タイムラインに記録します。

デフォルトでメッセージを保存しませんBusiness アプリ + Cloud APIClaude と ChatGPT 用 MCP2 分で利用開始

リクエスト

コード意味再試行
100パラメーターがサポートされていないか、綴りや形式が誤っています。いいえ
131008必須のパラメーターがまったく含まれていません。いいえ
131009パラメーターはありますが、その値がエンドポイントに拒否されています。いいえ
131021送信者と受信者が同じ電話番号です。いいえ
131051このメッセージタイプはサポートされていません。多くは Coexistence の制限です。いいえ
131052顧客が送信したメディアを Meta がダウンロードできませんでした。いいえ
131053送信したメディアを Meta がアップロードできませんでした。サイズ、形式、またはアクセス可否が原因です。いいえ

テンプレート

コード意味再試行
132000パラメーターの数がテンプレートと一致しません。いいえ
132001その名前と言語の組み合わせのテンプレートは存在しません。いいえ
132007テンプレートがメッセージングポリシーに違反しています。書き直して再申請してください。いいえ
132012パラメーターの形式がテンプレートの定義と一致しません。いいえ
132015品質の低下によりテンプレートが一時停止されています。一時的な状態です。待機
132016テンプレートは完全に無効化されており、復活しません。いいえ

ウィンドウと受信者

コード意味再試行
13104724 時間のカスタマーサービスウィンドウが終了しています。テンプレートを送信してください。いいえ
131026受信者はこのメッセージをまったく受信できません。いいえ
131050相手がオプトアウトしています。回避策は意図的に用意されていません。いいえ
130497お使いのアカウントでは、その国へのメッセージ送信が制限されています。いいえ

登録と PIN

コード意味再試行
131045この番号は Cloud API のメッセージング用に登録されたことがありません。いいえ
133010この番号は登録されていません。登録を完了する必要があります。いいえ
133006登録する前に番号を認証する必要があります。いいえ
1330052 段階認証の PIN が誤っています。推測を続けないでください。いいえ
133008PIN の試行回数が多すぎます。登録が一定期間ロックされています。待機

アクセスとアカウント

コード意味再試行
190アクセストークンの有効期限が切れたか、無効化されました。いいえ
368ポリシー違反によりアカウントが制限されています。いいえ
131031アカウントが制限されているか、そのデータが Meta の記録と一致しません。いいえ
131042ビジネスアカウントの支払いの問題により送信できません。いいえ
131049エコシステムの健全性を守るため、Meta がメッセージをブロックしました。いいえ

レート制限

コード意味再試行
130429アカウントのメッセージングのスループット上限に達しました。待機
131048スパムのレート制限に達しました。原因は量ではなく品質です。いいえ
131056お使いの番号と 1 人の受信者の間のメッセージが多すぎます。いいえ
80007アカウントが管理系呼び出しの上限に達しました。多くはポーリングが原因です。待機

一時的なエラー

コード意味再試行
131016Meta のサービスが一時的に利用できません。はい
131000分類されていない障害です。1 回だけ再試行し、その後 trace id を添えてエスカレーションしてください。はい

Coexistence の同期

コード意味再試行
2593107チャット履歴の同期の上限を超えました。いいえ
259310824 時間の同期ウィンドウの外で同期が試行されました。いいえ

再試行の列の読み方

この列には 3 つの値があり、選択を誤ると、このリファレンス全体で最も大きな損失につながります。

No は失敗が決定論的であることを示します。失敗したのはリクエスト、テンプレート、または受信者の状態であり、同じリクエストを再送しても同じエラーが発生します。そのうえ、後で必要になるスループットを消費します。はい は Meta 側の障害であり、バックオフによって実際に解消できます。待機 は状態が実在するものの一時的であることを示します。制限やロックが自然に解除されるため、解除前に再試行しても何も起こらず、状態が長引く可能性があります。

これらの多くが再試行できない理由

プラットフォームが曖昧なエラーではなく、具体的なコードを返すためです。不正なパラメーター、存在しないテンプレート、終了したメッセージングウィンドウ、オプトアウトした受信者は、レスポンスの時点で原因を特定できます。そのため Meta は曖昧に失敗させず、原因をコードで示します。

  • リクエストの問題は、2 回目の試行で正しくなりません。
  • テンプレートの問題はテンプレート内にあり、リクエストでは変更できません。
  • ウィンドウやオプトアウトの問題は、あなたではなく受信者の状態に関するものです。
  • アカウント制限は決定であり、再試行しても異議申し立てにはなりません。

このエラーが届いたときに記録する内容

再現せずに診断できるだけの情報です。これが 5 分で直せるか、推測に 1 日かかるかの違いになります。

  • trace id を含む完全なエラーレスポンス。Meta サポートが求める情報です。
  • 意図した内容ではなく、送信したままのリクエスト本文。両者の差が通常はバグです。
  • phone number id。1 つの番号だけの問題か、アカウント全体の問題かを区別できます。
  • タイムスタンプ。その時点の接続状態と照合できます。

Coexistence にのみ存在するコード

2 つあります。通常の送信失敗に見えるため、混乱を招きます。2593107 と 2593108 はどちらもチャット履歴の同期に関するコードです。これは、番号を初めて接続したときに WhatsApp Business アプリから最近の会話をコピーする処理です。

これらはメッセージングエラーではなく、接続の失敗を意味しません。同期が制限を超えた場合や、許可された時間帯の外で実行された場合も、番号は接続されたまま通常どおり送信できます。ただし、コピーされる履歴は想定より少なくなります。これを接続障害と解釈して切断し、最初からやり直すと、履歴を復旧するどころか、さらに失うことになります。

よくある質問

どのエラーは再試行すべきですか?

131016 と 131000 です。指数バックオフを使用してください。130429、132015、133008 は待つと自然に解消します。それ以外はすべて決定論的です。

エラーコードは番号が切断されたことを意味しますか?

通常は意味しません。これらの多くはリクエスト、テンプレート、受信者に関するものです。接続の問題は送信エラーではなく、アカウントや品質の Webhook として現れます。

trace id とは何ですか?

Meta サポートが特定のリクエストを見つけるための、エラーレスポンス内の識別子です。すべての失敗で記録してください。これがないと問い合わせに対応できません。

これらのコードはどのプロバイダーでも同じですか?

はい。Meta の Cloud API が返すコードなので、どのプロバイダーで番号を接続しても同じです。プロバイダーが変えられるのは、コードがどれだけ明確に届くかだけです。

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

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

無料トライアルを始める3 日間は料金なし。いつでもキャンセルできます。

続きを読む

リファレンスWhatsApp エラー 131047:再エンゲージメントメッセージエラー 131047 は、顧客の最終メッセージから 24 時間を超えたことを示します。顧客対応ウィンドウが閉じているため、フリーテキストは配信されません。会話を再開できるのは、Meta が事前承認したメッセージテンプレートだけです。リファレンスWhatsApp エラー 100:パラメータが無効ですエラー 100 は、Meta が受け付けないパラメータをリクエストに含めたことを示します。未対応、誤記、またはそのエンドポイントに合わない形式が原因です。決定論的なエラーのため、同じリクエストは毎回同じように失敗し、再試行しても解決しません。リファレンスWhatsApp エラー 131016:サービスを利用できませんエラー 131016 は、Meta 側のサービスが一時的に利用できないことを示します。本当に一過性のプラットフォームエラーの一つなので、調査ではなく指数バックオフによる再試行が適切です。リファレンス番号が使えなくなった場合の原因の調べ方接続済みの番号が使えなくなったとき、原因がコードであることはほとんどありません。発生頻度の高い順に、期限切れのトークン、再接続で失われた Webhook オーバーライド、14 日間の非アクティブによる切断、品質低下、アカウント制限を確認してください。リファレンスWhatsApp Webhook フィールドと送信先WhatsApp Business アカウントは、名前付きフィールドとしてイベントを送信します。2 つは会話内容を運び、エンドポイントにルーティングされます。6 つは運用状態を運び、監視の基盤になります。どのフィールドかを把握することが、アーキテクチャを決めます。ガイドWhatsApp Coexistence:1つの番号でアプリと API を併用Coexistence は、1つの番号で WhatsApp Business アプリと Cloud API を同時に使う Meta 公式のモードです。チームは同じ電話から、同じチャットと履歴を使って回答を続けられ、その間ソフトウェアは同じ番号で送受信できます。移行は発生せず、番号も変わりません。