WhatsApp エラーコード一覧 - EngageLab | WhatsApp REST API 日本語

このページでは、WhatsApp メッセージの送信および配信の過程で発生する可能性のあるエラーコードと、その意味および対処方法を説明します。

エラーコードには 2 つの提供元があります。まずどちらに該当するかを確認してから、対応するセクションを参照してください。

提供元	コード体系
Meta 公式エラーコード	Meta 公式と完全に同一
EngageLab プラットフォームエラーコード	EngageLab が定義

対象範囲：このページはメッセージの送信および配信に関するエラーコードのみを扱います。API リクエストレベルのエラーコードについては、メッセージ送信 API およびテンプレート管理 API のドキュメントにある「エラーコード」セクションをご参照ください。

Meta 公式エラーコード

以下のエラーコードはすべて Meta が定義するもので、コード番号は Meta 公式と同一です。詳細は Meta 公式ドキュメントをご参照ください。

レート制限・スループット制限

これらのエラーは、送信レートまたは送信量の上限に達したことを示します。メッセージ自体に問題はなく、時間をおいて再試行すれば送信を再開できます。

コード	内容	説明	対処方法
4	API 呼び出し上限に到達	アプリの API 呼び出しレートが上限に達しています。	呼び出し頻度を下げるか、しばらくしてから再試行してください。
80007	アカウントの送信レート上限に到達	WhatsApp ビジネスアカウント（WABA）の送信レートが上限に達しています。	送信ペースを落とし、しばらくしてから再送してください。一斉配信の場合は、均等なペースで分割送信することを推奨します。
130429	メッセージスループット上限に到達	単位時間あたりに送信できるメッセージ数の上限に達しています。	同時送信数を減らして再試行してください。より高いスループットが必要な場合は、EngageLab テクニカルサポートにアップグレードをご相談ください。
131048	スパム率が上限に到達	この送信番号から送られた最近のメッセージが、多数ブロックまたはスパムとして報告されたため、送信制限が発生しています。	WhatsApp Manager で番号の品質評価を確認し、コンテンツとターゲット精度を改善してから送信してください。
131056	同一受信者へのメッセージ送信が多すぎます	短時間に同じ受信者へ多数のメッセージを送信しました。	同一ユーザーへの送信間隔を空けてください。他の受信者への送信には影響しません。
131064	メッセージ送信上限に到達（テンプレートカテゴリ違反）	テンプレートのカテゴリ（マーケティング / ユーティリティ / 認証）の使用が適切でないため、アカウントが送信上限に達しています。テンプレートメッセージと通常メッセージの両方が影響を受けます。	テンプレートのカテゴリが実際の用途と一致しているか確認してください。制限期間の終了後、自動的に解除されます。

アカウント・権限

これらのエラーはアカウントの状態、接続設定、またはポリシー違反による措置に関するもので、再試行しても解決しません。

コード	内容	説明	対処方法
0	認証失敗	Meta への接続に使用するアクセストークンが無効になっています。	プラットフォーム接続側の問題です。EngageLab テクニカルサポートにお問い合わせください。
3	機能または権限の不足	このエンドポイントに必要な機能または権限がありません。	EngageLab テクニカルサポートに連絡し、必要な権限の付与をご依頼ください。
10	権限が拒否されました	権限が付与されていないか、削除されています。	EngageLab テクニカルサポートに連絡し、権限をご確認ください。
190	アクセストークンの期限切れ	Meta への接続に使用するアクセストークンの有効期限が切れています。	プラットフォーム接続側の問題です。EngageLab テクニカルサポートに連絡し、更新をご依頼ください。
200	アクセストークンが提供されていません	リクエストに有効なアクセストークンが含まれていません。	プラットフォームの接続設定に関する問題です。EngageLab テクニカルサポートにお問い合わせください。
368	ポリシー違反により一時的にブロック	プラットフォームポリシー違反により、WhatsApp ビジネスアカウントが制限または無効化されています。	最近の送信内容とテンプレートがポリシーに準拠しているか確認してください。Meta ビジネスマネージャで措置の詳細を確認し、異議申し立てができます。制限期間の終了後、自動的に解除されます。
130497	特定の国のユーザーへの送信が制限されています	WhatsApp ビジネスアカウントが、特定の国または地域のユーザーへのメッセージ送信を制限されています。	宛先番号の国・地域が許可範囲に含まれるか確認してください。詳細は WhatsApp ビジネスメッセージポリシーをご参照ください。
131005	アクセス拒否	このエンドポイントに必要な権限が付与されていないか、削除されています。	EngageLab テクニカルサポートに連絡し、権限をご確認ください。
131031	アカウントのロック	プラットフォームポリシー違反により、ビジネスアカウントが制限または無効化されています。	EngageLab テクニカルサポートに連絡し、アカウントの状態をご確認ください。Meta ビジネスマネージャでアカウントの健全性ステータスを確認することもできます。
131042	支払いに関する問題	支払い方法または与信枠に問題があります。たとえば、支払いアカウントが紐付けられていない、与信枠が上限を超えているか有効になっていない、タイムゾーンや通貨が設定されていない、などです。	Meta ビジネスマネージャで、支払いアカウント、与信枠、タイムゾーン、通貨の設定が正しく完了しているか確認してください。
131057	ビジネスアカウントがメンテナンスモードです	WhatsApp ビジネスアカウントがメンテナンスまたはアップグレード中です。	しばらくしてから再試行してください。
131063	Cloud API でマーケティングテンプレートが無効です	テンプレートがマーケティングカテゴリですが、アカウントの Cloud API 設定でマーケティングテンプレートの送信が無効になっています。	アカウントのマーケティングメッセージ設定を再度有効にするか、ユーティリティまたは認証カテゴリのテンプレートをご利用ください。
134011	WhatsApp Payments 利用規約が未承諾	WhatsApp ビジネスアカウントが WhatsApp Payments の利用規約にまだ同意していません。	エラーメッセージ内のリンクから利用規約に同意したうえで、再試行してください。

送信・受信者

これらのエラーは、今回のリクエスト内容、受信者の状態、またはメッセージングウィンドウに関するものです。

コード	内容	説明	対処方法
1	無効なリクエストまたはサーバーエラー	リクエスト形式に誤りがあるか、Meta 側でサーバーエラーが発生しています。	API ドキュメントと照合してリクエスト形式を確認してください。形式に問題がない場合は、しばらくしてから再試行してください。
2	一時的な停止または過負荷	停止または過負荷により、Meta のサービスに一時的な問題が発生しています。	しばらくしてから再試行してください。
100	無効またはスペルミスのあるパラメータ	リクエストに、サポートされていない、スペルミスのある、または長さ制限を超えたパラメータが含まれています。	API ドキュメントと照合して、パラメータ名、値、長さ制限を確認してください。
130403	ビジネスが WhatsApp 上でユーザーをブロックしています	あなたのビジネス番号が WhatsApp 上でこの受信者をブロックしています。	再試行しないでください。まず WhatsApp Manager でこのユーザーのブロックを解除してから、再送してください。
130472	実験によりメッセージが送信されませんでした	受信者が Meta のマーケティングメッセージ実験（対照群）に含まれているため、実験ルールに従って送信されませんでした。	対応は不要です。メッセージやアカウントに問題があることを示すものではありません。
131000	不明なエラー	不明な原因によりメッセージの送信に失敗しました。	しばらくしてから再試行してください。失敗が続く場合は、EngageLab テクニカルサポートにお問い合わせください。
131008	必須パラメータが不足しています	リクエストに必須パラメータが含まれていません。	API ドキュメントを参照して必須パラメータを補い、再送してください。
131009	パラメータ値が無効です	1 つ以上のパラメータの値が無効です。	API ドキュメントで各パラメータの有効な値と形式を確認してください。
131016	サービス一時利用不可	Meta 側の一部サービスが一時的に利用できません。	しばらくしてから再試行してください。
131021	送信者と受信者が同一です	受信者番号と送信番号が同じです。	別の受信者番号に変更して再送してください。
131026	受信者にメッセージを配信できません	受信者が WhatsApp ユーザーでない、最新の利用規約に同意していない、またはクライアントのバージョンが古い可能性があります。	番号が WhatsApp に登録されているか確認してください。別の手段で受信者に連絡し、最新の利用規約への同意と WhatsApp の更新を依頼してください。
131037	承認済みの表示名がありません	送信番号に承認済みの表示名が設定されていません。	先に表示名の承認を完了してから送信してください。
131045	電話番号の登録エラー	送信番号の登録に問題があるため、メッセージの送信に失敗しました。	送信番号の登録が完了しているか確認してください。問題がある場合は、番号を再登録してください。
131047	24 時間メッセージングウィンドウ外	受信者が最後に返信してから 24 時間以上が経過しているため、自由形式のメッセージは送信できません。	承認済みのテンプレートメッセージをご利用ください。ユーザーが返信すると、24 時間ウィンドウが再度開きます。
131049	健全なエコシステムのエンゲージメント維持のためメッセージが配信されませんでした	一定期間内に受信者が受け取れるマーケティングテンプレートメッセージの上限に達しています。	24 時間以上おいてから再送し、マーケティングメッセージの頻度と内容の関連性を調整してください。
131050	ユーザーがマーケティングをオプトアウトしています	受信者があなたのビジネスからのマーケティングメッセージの受信を停止しています。	再試行しないでください。このユーザーをマーケティングリストから除外し、必要なユーティリティメッセージのみを送信してください。
131051	サポートされていないメッセージタイプ	サポートされていないメッセージタイプが使用されました。	メッセージ送信 API のドキュメントを参照し、サポートされているメッセージタイプをご利用ください。
131052	メディアのダウンロード失敗	ユーザーが送信したメディアコンテンツをダウンロードできません。	別の手段でファイルを提供してもらうよう、ユーザーに依頼してください。
131053	メディアのアップロード失敗	メッセージ内のメディアファイルをアップロードできません。	メディアファイルの形式とサイズが要件を満たしているか確認してから再試行してください。

テンプレート・Flow

これらのエラーは、テンプレート自体の状態、内容、またはパラメータの指定に関するものです。

コード	内容	説明	対処方法
132000	テンプレートのパラメータ数が一致しません	指定した変数の数が、テンプレートで定義された変数の数と一致していません。	テンプレートの実際の変数の数に合わせてパラメータを追加または削除し、再送してください。
132001	テンプレートが存在しないか未承認です	指定した言語でテンプレートが存在しないか、まだ承認されていません。	テンプレート名と言語コードが完全に一致していること（大文字小文字とアンダースコアを含む）、およびテンプレートのステータスが「承認済み」であることを確認してください。
132005	翻訳テキストが長すぎます	当該言語のテンプレート翻訳が長さ制限を超えています。	該当言語のテンプレート文言を短くしてください。
132007	テンプレート内容がポリシーに違反しています	テンプレートの内容が WhatsApp のポリシーに違反しています。	テンプレート審査ガイドラインに従って内容を修正し、再審査に提出してください。
132012	テンプレートのパラメータ形式が無効です	変数値の形式が、テンプレートで定義された形式と一致していません。	テンプレートで定義された形式に従って変数を指定してください。
132015	品質低下によりテンプレートが一時停止されています	品質評価が低いためテンプレートが一時停止され、送信できません。	テンプレートを編集して品質を改善し、再承認後にご利用ください。それまでは別の承認済みテンプレートをご利用ください。
132016	テンプレートが永久に無効化されています（品質低下）	品質低下による一時停止が繰り返されたため、テンプレートが永久に無効化されています。	このテンプレートは復元できません。別の内容で新しいテンプレートを作成してください。
132018	テンプレートの検証エラー	テンプレート内のパラメータが検証に通りませんでした。	エラーメッセージに従ってパラメータ設定を修正し、再送してください。
132068	Flow がブロックされています	使用している Flow がブロック状態です。	Flow の設定を確認・修正するか、別の方法でユーザーにアプローチしてください。
132069	Flow が制限されています	この Flow で直近 1 時間に 10 件のメッセージが送信され、送信制限が発生しています。	制限期間の終了を待ってから送信してください。

電話番号の登録・認証

コード	内容	説明	対処方法
133000	登録解除が完了していません	以前の登録解除が完了しなかったため、再登録できません。	登録解除をやり直し、完了してから登録してください。
133004	サーバーが一時的に利用できません	Meta のサーバーが一時的に利用できません。	しばらくしてから再試行してください。
133005	2 段階認証の PIN コードが正しくありません	リクエストに含まれる 2 段階認証の PIN コードが正しくありません。	PIN コードを確認してください。忘れた場合は、2 段階認証を無効にしてから新しい PIN コードを設定してください。
133006	電話番号の再認証が必要です	登録の前に番号の認証を完了する必要があります。	先に番号の認証を完了してから、登録を実行してください。
133008	PIN コードの試行回数が多すぎます	PIN コードの入力誤りが多すぎたため、一時的にロックされています。	ロックが解除されるまで待ってから再試行してください。
133009	PIN コードの入力が速すぎます	PIN コードの送信が頻繁すぎます。	しばらくしてから再試行してください。
133010	電話番号が未登録です	この番号は WhatsApp ビジネスプラットフォームに登録されていません。	先に番号の登録を完了してから送信してください。
135000	リクエストパラメータの不明なエラー	リクエストパラメータに不明なエラーがあります。	API ドキュメントと照合してリクエストの構文とパラメータを確認してください。継続する場合は、EngageLab テクニカルサポートにお問い合わせください。

送信番号のステータス

コード	内容	説明	対処方法
33	ビジネス用電話番号が削除されています	送信に使用するビジネス用電話番号が削除されています。	送信番号が正しいか確認してください。すでに削除されている場合は、別の有効な送信番号を使用するか、再登録してください。
133015	電話番号は最近削除され、削除処理が未完了です	この番号は最近削除され、削除処理がまだ完了していません。	約 5 分待ってから再試行してください。
133016	登録／登録解除の試行が多すぎ、番号が一時的にブロックされています	短時間にこの番号の登録・登録解除を試行しすぎたため、番号が一時的にブロックされています。	ブロックが解除されるまで待ってから再試行し、その間は繰り返し試行しないでください。

EngageLab プラットフォームエラーコード

コード	内容	説明	対処方法
1	無効な受信者番号	受信者番号の形式が不正で、検証に通りませんでした。	番号が数字のみで、国番号を含み、`+`・スペース・ハイフンを含まないことを確認し、修正して再送してください。
5000	送信タイムアウト	Meta へのメッセージ送信時にタイムアウトが発生し、このメッセージは送信されませんでした。	しばらくしてから再試行してください。
5001	残高不足によりメッセージは送信されませんでした	アカウント残高が不足しているため、メッセージは送信されませんでした。	コンソールでチャージしてから再送してください。残高アラートの設定を推奨します。