このドキュメントが更新されました。
日本語への翻訳がまだ完了していません。

英語の最終更新: 11月20日

クラウドAPIエラーコード

クラウドAPIはグラフAPIをベースに構築されています。グラフAPIエラー応答の処理に精通していない場合は、グラフAPIのエラーの処理に関するドキュメントをご覧ください。

一般に、code値とdetailsペイロードのプロパティに基づいてアプリのエラー処理ロジックを構築することをおすすめします。これらのプロパティとその値は、根本的なエラーを示します。

コードタイトルにAPIエラー応答ペイロード専用のプロパティはなく、コードタイトルはmessage値の一部に含まれています。ただし、タイトルは最終的に廃止されるため、タイトルに頼ったエラー処理ロジックにはしないことをおすすめします。

エラーの受信: 同期と非同期

クラウドAPIエラーは、グラフAPI応答として同期的に返されるか、Webhook経由で非同期的に返されます。また、両方の方法で返される場合もあります。

クラウドAPIで作業する際には、Graph API応答とmessages Webhookの両方でエラー処理をモニタリングするのが良い方法です。messages Webhookフィールドをサブスクリプション登録している場合は、サポートされている非同期エラータイプのエラーが発生したときに通知を受け取ります。

エラー応答Webhooksと構文

クラウドAPIのエラーは、以下のWebhooksオブジェクトで見られます。

クラウドAPI

entry.changes.value.errors
entry.changes.value.messages.errors

オンプレミスAPI

errors

エラー応答の構文

{ "error": { "message": "<MESSAGE>", "type": "<TYPE>", "code": <CODE>, "error_data": { "messaging_product": "whatsapp", "details": "<DETAILS>" }, "error_subcode": <ERROR_SUBCODE> "fbtrace_id": "<FBTRACE_ID>" } }

エラー応答の内容

プロパティ	値の型	説明
`code`	整数	エラーコード。アプリのエラー処理は、サブコードやHTTP応答ステータスコードではなく、エラーコードに基づいて構築することをおすすめします。
`details`	文字列	エラーの説明と、考えられるエラーの原因の説明。エラーの対処方法に関する情報(無効なパラメーターや、受け入れ可能な値など)が含まれている場合もあります。
`error_subcode`	整数	廃止されました。v16.0以降では返されません。グラフAPIサブコード。すべての応答にサブコードが含まれるわけではないため、代わりに、`code`プロパティと`details`プロパティに基づいてエラー処理ロジックを構築することをおすすめします。
`fbtrace_id`	文字列	ダイレクトサポートに問い合わせる場合に含めることのできるトレースID。このIDは、エラーのデバッグに役立つ場合があります。
`message`	文字列	エラーコードとタイトルの組み合わせ。例: `(#130429) Rate limit hit`
`messaging_product`	文字列	メッセージに使用した製品。クラウドAPI応答では常に、`whatsapp`という文字列になります。
`type`	文字列	エラータイプ。

応答の例

{
  "error": {
    "message": "(#130429) Rate limit hit",
    "type": "OAuthException",
    "code": 130429,
    "error_data": {
        "messaging_product": "whatsapp", 
        "details": "Cloud API message throughput has been reached."
    },
    "error_subcode": 2494055,
    "fbtrace_id": "Az8or2yhqkZfEZ-_4Qn_Bam"
  }
}

エラーコード

認証エラー

コード	詳細	考えられる原因と解決策	HTTPステータスコード
`0` AuthException (認証例外)	アプリユーザーを認証できませんでした。	このエラーは通常、指定されたアクセストークンが期限切れか無効である、またはアプリユーザーが行った設定変更によってすべてのアプリがデータにアクセスできなくなったということを意味します。新しいアクセストークンを取得することをおすすめします。	`401` Unauthorized (未承認)
`3` APIメソッド	機能またはアクセス許可の問題です。	アクセストークンデバッガを使用して、エンドポイントで求められるアクセス許可がアプリに付与されているか確認します。トラブルシューティングをご覧ください。	`500` Internal Server Error (内部サーバーエラー)
`10` アクセス許可が拒否されました	アクセス許可が付与されていないか、削除されています。	アクセストークンデバッガを使用して、エンドポイントで求められるアクセス許可がアプリに付与されていることを確認します。アクセストークンのトラブルシューティングをご覧ください。エンドポイントがあるWhatsApp Flowsの場合 - ビジネスの公開鍵の設定に使用される電話番号が許可リストにあることを確認してください。アクセスしようとしているAPIの利用要件を確認してください。エンドポイントへのアクセス権がない場合、このエラーコードが表示されます。	`403` Forbidden (禁止)
`190` アクセストークンが期限切れになっています	アクセストークンの期限が切れています。	新しいアクセストークンを取得してください。	`401` Unauthorized (未承認)
`200-299` APIアクセス許可	アクセス許可が付与されていないか、削除されています。	アクセストークンデバッガを使用して、エンドポイントで求められるアクセス許可がアプリに付与されていることを確認します。トラブルシューティングをご覧ください。	`403` Forbidden (禁止)

整合性のエラー

コード詳細考えられる原因と解決策 HTTPステータスコード

コード	詳細	考えられる原因と解決策	HTTPステータスコード
`368` ポリシー違反のため一時的にブロックされています	アプリに関連付けられているWhatsApp Businessアカウントは、プラットフォームポリシーに違反したため、制限されているか停止されています。	ポリシーの施行に関するドキュメントを確認して、ポリシー違反とその解決策について調べてください。	`403` Forbidden (禁止)
`130497` ビジネスアカウントがこの国のユーザーにメッセージを送信することは制限されています。	このWhatsApp Businessアカウントは、特定の国のユーザーにメッセージを送信することが制限されています。	自分のビジネスカテゴリでメッセージの送信が許可されている国について詳しくは、WhatsApp Businessメッセージポリシーをご覧ください。	`403` Forbidden (禁止)
`131031` アカウントがロックされました	アプリに関連付けられているWhatsApp Businessアカウントは、プラットフォームポリシーに違反しているため、制限または停止されています。あるいは、WhatsApp Businessアカウントに設定されたデータに対するリクエストに含まれるデータを認証できませんでした(リクエストに含まれる2段階PINが間違っている場合など)。	ポリシーの施行に関するドキュメントを確認して、ポリシー違反とその解決策について調べてください。ヘルスステータスAPIを使用することもできます。これにより、アカウントロックの理由をさらに詳しく知ることができる場合があります。	`403` Forbidden (禁止)

368

ポリシー違反のため一時的にブロックされています

アプリに関連付けられているWhatsApp Businessアカウントは、プラットフォームポリシーに違反したため、制限されているか停止されています。

ポリシーの施行に関するドキュメントを確認して、ポリシー違反とその解決策について調べてください。

403

Forbidden (禁止)

130497

ビジネスアカウントがこの国のユーザーにメッセージを送信することは制限されています。

このWhatsApp Businessアカウントは、特定の国のユーザーにメッセージを送信することが制限されています。

自分のビジネスカテゴリでメッセージの送信が許可されている国について詳しくは、WhatsApp Businessメッセージポリシーをご覧ください。

403

Forbidden (禁止)

131031

アカウントがロックされました

アプリに関連付けられているWhatsApp Businessアカウントは、プラットフォームポリシーに違反しているため、制限または停止されています。あるいは、WhatsApp Businessアカウントに設定されたデータに対するリクエストに含まれるデータを認証できませんでした(リクエストに含まれる2段階PINが間違っている場合など)。

ポリシーの施行に関するドキュメントを確認して、ポリシー違反とその解決策について調べてください。

ヘルスステータスAPIを使用することもできます。これにより、アカウントロックの理由をさらに詳しく知ることができる場合があります。

403

Forbidden (禁止)

テンプレート作成エラー

エラー	説明	考えられる解決策
`2388040` - 文字数制限を超えています	テンプレート内のフィールドが許可された最大文字数を超えています。	影響を受けたフィールドと対応する文字数制限についての詳細については、エラーメッセージを参照してください。
`2388047` - メッセージヘッダーのフォーマットが正しくありません	メッセージヘッダーに無効なフォーマットが含まれています。	有効なフォーマットの詳細については、エラーメッセージを参照してください。
`2388072` - メッセージ本文のフォーマットが正しくありません	メッセージ本文に無効なフォーマットが含まれています。	有効なフォーマットの詳細については、エラーメッセージを参照してください。
`2388073` - メッセージフッターのフォーマットが正しくありません	メッセージフッターに無効なフォーマットが含まれています。	有効なフォーマットの詳細については、エラーメッセージを参照してください。
`2388293` - パラメーターの単語比率が上限を超えています	このテンプレートの長さに対して変数が多すぎます。変数の数を減らすか、メッセージの長さを増やしてください。	有効なフォーマットの詳細については、エラーメッセージを参照してください。
`2388299` - 先頭または末尾のパラメーターが許可されていません	変数をテンプレートの先頭または末尾に配置することはできません。	有効なフォーマットの詳細については、エラーメッセージを参照してください。

メッセージテンプレートのエラー

エラー	説明	考えられる解決策
`2388019` - メッセージテンプレートの上限を超えています	このWhatsApp Businessアカウントで設定できるメッセージテンプレートの最大数を超えました。	1つのWhatsApp Businessアカウントで設定できるメッセージテンプレートは最大250件です。詳しくはこちらをご覧ください。

電話番号の移行エラー

Error	Description	Possible Solution
`2388001` - Please confirm ownership of this phone number.	Certificate can be downloaded only after confirming ownership of a phone number that is being migrated.	In order to download the certificate and proceed with registration, register and and verify the number.
`2388001` - Please ensure two-step authentication is disabled.	Two-step authentication must be disabled for this phone number.	In your WhatsApp Business Manager Settings, turn off two-step verification.
`2388012` - This phone number already exists in your list of phone numbers.	The phone number you are trying to migrate is already present in your WhatsApp account.	Try again with a phone number that is not already present in your WhatsApp account.
`2388091`, `2388093` - This phone number isn’t eligible to receive/verify a registration code since it is not being migrated.	Phone ownership verification APIs are not available for this use case.	Register and verify the number.
`2388103` - Cannot migrate phone number.	Webhooks have not been set up for the destination WhatsApp Business account.	Subscribe your app to webhooks on the destination WhatsApp Business account.
`2388103` - Please add this phone number in your WhatsApp account	This phone number is eligible to be added directly, and does not need to use phone migration APIs.	Register and verify the number.
`2388103` - Registered name should be present and approved.	The business phone number must have an approved display name (`name_status` is `APPROVED`) and cannot have any associated pending display name change requests.	Get your business phone number's display name approved.
`2388103` - The WhatsApp account that this phone number is registered with is not set up correctly.	The source WhatsApp Business Account must be approved, and its "messaging on behalf of" must be approved.	The WhatsApp Business Account may be using the now deprecated On-Behalf-Of ownership model. Contact support.
`2388103` - Your WhatsApp account does not have a payment account.	Your WhatsApp account must have an active credit line in order to send messages after migration.	Set up a credit line and share it with the business customer.
`2388103` - There was an error migrating this phone number.	Something went wrong when trying to migrate your phone number.	Try again after some time. If that doesn’t work, contact support.
`2388103` - This phone number belongs to a different Business Manager account.	The source and destination WABAs must represent the same business.	Migrate the phone number into a WhatsApp Business Account that is messaging for the same business as the source WhatsApp Business Account.
`2388103` - Your WhatsApp account must be approved	The destination WhatsApp Business Account must be approved before you can migrate phone numbers.	Ensure business verification is completed, and the WhatsApp Business Account review status is approved.
`2388103` - Your WhatsApp account’s "Messaging For" request must be approved	The destination WhatsApp Business Account "Messaging For" request must be approved by the client.	Ask your client to accept your "Messaging For" request in the Meta Business Suite.
`2494100` - Account is in maintenance mode.	The business phone number is in maintenance mode.	Try again in a few minutes.

テンプレートインサイトエラー

エラー	説明	考えられる解決策
`200005` - テンプレートインサイトを利用不可できません	このWhatsApp Businessアカウントでは、テンプレートインサイトをまだ利用できません。	現在、このWhatsApp Businessアカウントのテンプレートインサイトを有効にすることはできません。
`200006` - テンプレートインサイトは無効にできません	無効な操作です。テンプレートインサイトを一度有効にすると、無効にすることはできません。	WhatsApp Businessアカウントでテンプレートインサイトを一度有効にすると、無効にすることはできません。
`200007` - テンプレートインサイトが有効になっていません	このWhatsApp Businessアカウントではテンプレートインサイトが有効になっていません	テンプレートインサイトを有効にするには、テンプレート分析をご覧ください。

WhatsApp Businessアカウントのエラー

エラー説明考えられる解決策

エラー	説明	考えられる解決策
`2593079` テンプレートインサイトを利用できない	このWABAは、別のソリューションIDに移行するためにマーク済みです	移行プロセスの次のステップに進みます。WABAの所有権の譲渡についてはこちらをご覧ください。
`2593085` WhatsApp BusinessアカウントのOBOモビリティが無効です	このWABAはOBO所有権移転の対象外です。考えられる原因は次のとおりです。そのWABAはすでにビジネス顧客に所有されている(つまり、すでにWABA共有モデルを使用している)。ビジネス顧客がビジネスマネージャでOBOリクエストをまだ承認していない。	OBOモデルを使用するWABAをターゲットにするか、ビジネスマネージャでOBOリクエストを承認するよう顧客に依頼してから、所有権の譲渡を再度試みてください。

2593079

テンプレートインサイトを利用できない

このWABAは、別のソリューションIDに移行するためにマーク済みです

移行プロセスの次のステップに進みます。WABAの所有権の譲渡についてはこちらをご覧ください。

2593085

WhatsApp BusinessアカウントのOBOモビリティが無効です

このWABAはOBO所有権移転の対象外です。考えられる原因は次のとおりです。

そのWABAはすでにビジネス顧客に所有されている(つまり、すでにWABA共有モデルを使用している)。
ビジネス顧客がビジネスマネージャでOBOリクエストをまだ承認していない。

OBOモデルを使用するWABAをターゲットにするか、ビジネスマネージャでOBOリクエストを承認するよう顧客に依頼してから、所有権の譲渡を再度試みてください。

その他のエラー

コード詳細考えられる原因と解決策 HTTPステータスコード

コード	詳細	考えられる原因と解決策	HTTPステータスコード
`1` 不明なAPI	無効なリクエストまたはサーバーエラーの可能性。	WhatsApp Businessプラットフォームステータスのページで、APIステータスに関する情報をご確認ください。サーバーの障害がない場合は、エンドポイントリファレンスをチェックし、リクエストが適切にフォーマットされており、エンドポイントのすべての要件を満たしていることを確認してください。	`400` Bad Request (間違ったリクエスト)
`2` APIサービス	ダウンタイムや過負荷による、一時的なエラー。	WhatsApp Businessプラットフォームステータスのページで、APIステータスに関する情報を確認してから再試行してください。	`503` Service Unavailable (サービス利用不可)
`33` 無効なパラメーター値	ビジネスの電話番号が削除されました。	ビジネスの電話番号が正しいか確認してください。	`400` Bad Request (間違ったリクエスト)
`100` 無効なパラメーター	リクエストに含まれている1つ以上のパラメーターがサポートされていないか、スペルが正しくありません。	エンドポイントのリファレンスで、サポート対象のパラメーターや正しいスペルを確認してください。エンドポイントがあるWhatsApp Flowsの場合、ビジネス公開鍵を設定する際には、PEM形式の有効な2048-bit RSA公開鍵であることを確認してください。登録しようとしている電話番号IDと保存されている電話番号IDが完全に一致していることを確認してください。パラメーターが型の制限に従っていることを確認してください。	`400` Bad Request (間違ったリクエスト)
`130472` ユーザーの番号がテストの一部となっています	メッセージはテストの一部として送信されませんでした。	マーケティングメッセージのテストを参照してください。	`400` Bad Request (間違ったリクエスト)
`131000` 不具合が発生しました	不明なエラーのため、メッセージを送信できませんでした。	もう一度お試しください。エラーが解決しない場合は、ダイレクトサポートチケットをオープンしてください。エンドポイントがあるWhatsApp Flowsの場合 - ビジネス公開鍵を設定する際に、署名の計算またはGraphQLエンドポイントの呼び出しに失敗したか、GraphQLエンドポイントによってエラーが返されました。	`500` Internal Server Error (内部サーバーエラー)
`131005` アクセスが拒否されました	アクセス許可が付与されていないか、削除されています。	アクセストークンデバッガを使用して、エンドポイントで求められるアクセス許可がアプリに付与されていることを確認します。トラブルシューティングをご覧ください。	`403` Forbidden (禁止)
`131008` 必須パラメーターが入力されていません	リクエストに必須パラメーターがありません。	エンドポイントのリファレンスで、必須のパラメーターを確認してください。	`400` Bad Request (間違ったリクエスト)
`131009` 無効なパラメーター値	1つ以上のパラメーターの値が無効です。	エンドポイントのリファレンスを調べ、各パラメーターでサポートされている値を確認してください。また、電話番号を参照して、電話番号をWhatsApp Businessアカウントに追加する方法を確認してください。	`400` Bad Request (間違ったリクエスト)
`131016` サービスを利用できません	サービスを一時的に利用できません。	WhatsApp Businessプラットフォームステータスのページで、APIステータスの情報をチェックしてから再試行してください。	`500` Internal Server Error (内部サーバーエラー)
`131021` 受信者は送信者になれません	送信者と受信者の電話番号が同じです。	送信者とは異なる電話番号にメッセージを送信してください。	`400` Bad Request (間違ったリクエスト)
`131026` メッセージ配信不可	メッセージを配信できませんでした。次のような理由が考えられます。受信者の電話番号がWhatsAppの電話番号ではない。受信者がMetaの新しい利用規約とプライバシーポリシーに同意していない。受信者が古いバージョンのWhatsAppを使用している(次のバージョン以上を使用しなければならない)。 Android: 2.21.15.15 SMBA: 2.21.15.15 iOS: 2.21.170.4 SMBI: 2.21.170.4 KaiOS: 2.2130.10 Web: 2.2132.6	WhatsApp以外の通信手段を利用して、WhatsAppユーザーに次のことを依頼してください。あなたのWhatsAppビジネス電話番号にメッセージを送信できることを確認する。最新の利用規約に同意したことを確認する([設定] > [ヘルプ]、または[設定] > [アプリケーション情報]にアクセスすると、まだ同意していない場合は最新の利用規約/ポリシーに同意するよう求められます)。 WhatsAppクライアントの最新バージョンにアップデートする。	`400` Bad Request (間違ったリクエスト)
`131037` WhatsAppで提供された番号では、メッセージを送信する前に表示名の承認が必要です。	リクエストの送信に使用された555で始まるビジネス電話番号には、承認された表示名がありません。	555で始まるビジネス電話番号の表示名を変更してください。その方法については、ヘルプセンターの記事WhatsApp Businessの表示名を変更する方法をご覧ください。	`400` Bad Request (間違ったリクエスト)
`131042` ビジネス資格情報の支払いの問題	支払い方法にエラーが発生しました。	WhatsApp Businessアカウントの請求についてを参照して、請求が正しく設定されていることを確認してください。次のような一般的な問題があります。 WhatsApp Businessアカウントに支払いアカウントが登録されていません融資限度額を超えています融資限度額(支払いアカウント)が設定されていないか、アクティブになっていません WhatsAppビジネスアカウントが削除されています WhatsAppビジネスアカウントが一時停止されていますタイムゾーンが設定されていません通貨が設定されていません MessagingForリクエスト(代理)が保留中であるか、却下されています	`400` Bad Request (間違ったリクエスト)
`131045` 証明書が正しくありません	電話番号の登録エラーのため、メッセージを送信できませんでした。	電話番号を登録してから再試行してください。	`500` Internal Server Error (内部サーバーエラー)
`131047` 再エンゲージメントメッセージ	受信者が送信者の番号に前回応答してから24時間以上経過しました。	代わりにメッセージテンプレートを使って、ビジネスによって開始されたメッセージを受信者に送信してください。	`400` Bad Request (間違ったリクエスト)
`131049` Metaは配信しないことにしました。	健全なエコシステムのエンゲージメントを維持するため、このメッセージは配信されませんでした。	このエラーコードを受け取り、その原因が制限によるものと思われる場合、少なくとも24時間待ってからテンプレートメッセージを再送してください。異なる複数の期間に制限が適用される可能性があるため、すぐに再送してもまたエラーが返されるだけです。詳しくは、ユーザーごとのマーケティングテンプレートメッセージの制限をご覧ください。	`400` Bad Request (間違ったリクエスト)
`131050` ユーザーがマーケティングメッセージの受信を停止しました。	メッセージを配信できません。この受信者は、WhatsAppであなたのビジネスからマーケティングメッセージを受信することを停止しました。	このユーザーにメッセージを送信しても受信されないので、送信を再試行しないようにします。あなたのビジネスからのマーケティングテンプレートメッセージの配信をWhatsAppユーザーが停止したり再開したりした場合にその通知を受け取るようにするには、user_preferences Webhookをサブスクリプション登録してください。	`400` Bad Request (間違ったリクエスト)
`131051` メッセージタイプがサポートされていません	メッセージタイプがサポートされていません。	メッセージを参照してサポート対象のメッセージタイプについて確認し、サポートされているメッセージタイプで再試行してください。	`400` Bad Request (間違ったリクエスト)
`131052` メディアダウンロードエラー	ユーザーが送信したメディアをダウンロードできませんでした。	WhatsAppユーザーのメッセージに含まれるメディアをダウンロードできませんでした。詳しくは、このメッセージの受信時にトリガーされたmessages Webhooksの`error.error_data.details`値をご覧ください。 WhatsApp以外の方法でメディアファイルを送信するようWhatsAppユーザーに依頼してください。	`400` Bad Request (間違ったリクエスト)
`131053` メディアアップロードエラー	メッセージで使われているメディアをアップロードできませんでした。	メディアタイプがサポートされていないなど、1つ以上の理由のため、メディアをアップロードできませんでした。詳しくは、このメッセージの送信失敗時にトリガーされたmessages Webhooksの`error.error_data.details`値をご覧ください。エラーの原因となっているメディアファイルを検査し、実際にサポートされていることを確認してください。例えば、UNIXでは、コマンドライン経由でファイル検査を実施して、そのMIMEタイプを判断できます。 `file -I rejected-file.mov` その後、MIMEタイプがサポートされているかどうかを確認することができます。サポートされるメディアタイプをご覧ください。	`400` Bad Request (間違ったリクエスト)
`131057` メンテナンスモードのアカウント	ビジネスアカウントはメンテナンスモードです	WhatsAppビジネスアカウントはメンテナンスモードです。この理由の1つとして、アカウントでスループットのアップグレードが行われていることが考えられます。	`500` Bad Request (間違ったリクエスト)
`132000` テンプレートのパラメーター数が一致しません	リクエストに含まれている変数パラメーター値の数が、テンプレートで定義されている変数パラメーターの数と一致していません。	メッセージテンプレートガイドラインを確認し、テンプレートで定義されているすべての変数パラメーター値がリクエストに確実に含まれるようにしてください。	`400` Bad Request (間違ったリクエスト)
`132001` テンプレートが存在しません	指定された言語ではテンプレートが存在しないか、テンプレートが承認されていません。	使用するテンプレートが承認済みで、テンプレート名と言語ロケールが正しいことを確認してください。メッセージテンプレートガイドラインに確実に準拠してください。	`404` Not Found (未検出)
`132005` テンプレートのハイドレートテキストが長すぎます	変換されたテキストが長すぎます。	WhatsAppマネージャをチェックして、テンプレートが翻訳されていることを確認してください。品質評価とテンプレートステータスをご覧ください。	`400` Bad Request (間違ったリクエスト)
`132007` テンプレートフォーマットに文字ポリシーの違反があります	テンプレートの内容がWhatsAppポリシーに違反しています。	却下の理由を参照して、考えられる違反の理由を確認してください。	`400` Bad Request (間違ったリクエスト)
`132012` テンプレートのパラメーターフォーマットが一致しません	変数パラメーターの値が正しくフォーマットされていません。	リクエストに含まれる変数パラメーターの値は、テンプレートで指定されたフォーマットを使用していません。メッセージテンプレートのガイドラインをご覧ください。	`400` Bad Request (間違ったリクエスト)
`132015` テンプレートが一時停止中	テンプレートが低品質のため一時停止しており、テンプレートメッセージで送信できません。	テンプレートを編集して質を改善し、承認を受けてから再試行してください。	`400` Bad Request (間違ったリクエスト)
`132016` テンプレートが無効	テンプレートが低品質のために一時停止された回数が多すぎるので、恒久的に無効化されています。	異なるコンテンツの新しいテンプレートを作成してください。	`400` Bad Request (間違ったリクエスト)
`132068` フローがブロックされている	フローがブロックされた状態です。	フローを修正してください	`400` Bad Request (間違ったリクエスト)
`132069` フローがスロットルされている	フローはスロットル状態であり、このフローを使った10件のメッセージが過去1時間以内にすでに送信されました。	フローを修正してください	`400` Bad Request (間違ったリクエスト)
`133000` 登録解除が完了していません	以前の登録解除の試みが失敗しています。	該当する番号をもう一度登録解除してから、再登録してください。	`500` Internal Server Error (内部サーバーエラー)
`133004` サーバーは一時的に利用できません	サーバーは一時的に利用できません。	WhatsApp BusinessプラットフォームステータスのページでAPIステータスの情報をチェックし、応答の`details`値をチェックしてから再試行してください。	`503` Service Unavailable (サービス利用不可)
`133005` 二段階認証PINが一致しません	二段階認証PINが正しくありません。	リクエストに含まれる二段階認証PINが正しいか確認してください。二段階認証PINをリセットするには、次のようにします。二段階認証を無効にします。新しいPINを含むPOSTリクエストを電話番号エンドポイントに送信します。	`400` Bad Request (間違ったリクエスト)
`133006` 電話番号の再認証が必要	電話番号を登録する前に、認証する必要があります。	電話番号を認証してから登録してください。	`400` Bad Request (間違ったリクエスト)
`133008` 二段階認証PINの推測が多すぎます	この電話番号の二段階認証PINの推測が多すぎます。	`details`応答値で指定された時間が経過した後、再試行してください。	`400` Bad Request (間違ったリクエスト)
`133009` 二段階認証PINの推測が早すぎます	二段階認証PINの入力が早すぎました。	`details`応答値をチェックしてから再試行してください。	`400` Bad Request (間違ったリクエスト)
`133010` 電話番号が登録されていません	電話番号がWhatsApp Businessプラットフォームに登録されていません。	電話番号を登録してから再試行してください。	`400` Bad Request (間違ったリクエスト)
`133015` 数分待ってから、この電話番号を登録してください	登録しようとしている電話番号は最近削除されましたが、削除処理がまだ完了していません。	5分待ってからリクエストを再試行してください。	`400` Bad Request (間違ったリクエスト)
`134011` WhatsApp支払い利用規約に同意していません	このWhatsApp Businessアカウントでは、WhatsApp支払い利用規約の同意が保留になっているため、メッセージを送信できませんでした。	エラーメッセージに記載されているリンクからWhatsApp支払い利用規約に同意の上、もう一度お試しください。	`400` Bad Request (間違ったリクエスト)
`135000` 一般的なユーザーエラー	リクエストパラメーターに関する不明なエラーのため、メッセージを送信できませんでした。	エンドポイントのリファレンスを参照して、正しい構文を使ってエンドポイントをクエリしているか確認してください。応答でこのエラーコードが継続して送信される場合は、カスタマーサポートに連絡してください。	`400` Bad Request (間違ったリクエスト)

1

不明なAPI

無効なリクエストまたはサーバーエラーの可能性。

WhatsApp Businessプラットフォームステータスのページで、APIステータスに関する情報をご確認ください。サーバーの障害がない場合は、エンドポイントリファレンスをチェックし、リクエストが適切にフォーマットされており、エンドポイントのすべての要件を満たしていることを確認してください。

400

Bad Request (間違ったリクエスト)

2

APIサービス

ダウンタイムや過負荷による、一時的なエラー。

WhatsApp Businessプラットフォームステータスのページで、APIステータスに関する情報を確認してから再試行してください。

503

Service Unavailable (サービス利用不可)

33

無効なパラメーター値

ビジネスの電話番号が削除されました。

ビジネスの電話番号が正しいか確認してください。

400

Bad Request (間違ったリクエスト)

100

無効なパラメーター

リクエストに含まれている1つ以上のパラメーターがサポートされていないか、スペルが正しくありません。

エンドポイントのリファレンスで、サポート対象のパラメーターや正しいスペルを確認してください。

エンドポイントがあるWhatsApp Flowsの場合、ビジネス公開鍵を設定する際には、PEM形式の有効な2048-bit RSA公開鍵であることを確認してください。

登録しようとしている電話番号IDと保存されている電話番号IDが完全に一致していることを確認してください。

パラメーターが型の制限に従っていることを確認してください。

400

Bad Request (間違ったリクエスト)

130472

ユーザーの番号がテストの一部となっています

メッセージはテストの一部として送信されませんでした。

マーケティングメッセージのテストを参照してください。

400

Bad Request (間違ったリクエスト)

131000

不具合が発生しました

不明なエラーのため、メッセージを送信できませんでした。

もう一度お試しください。エラーが解決しない場合は、ダイレクトサポートチケットをオープンしてください。

エンドポイントがあるWhatsApp Flowsの場合 - ビジネス公開鍵を設定する際に、署名の計算またはGraphQLエンドポイントの呼び出しに失敗したか、GraphQLエンドポイントによってエラーが返されました。

500

Internal Server Error (内部サーバーエラー)

131005

アクセスが拒否されました

アクセス許可が付与されていないか、削除されています。

アクセストークンデバッガを使用して、エンドポイントで求められるアクセス許可がアプリに付与されていることを確認します。トラブルシューティングをご覧ください。

403

Forbidden (禁止)

131008

必須パラメーターが入力されていません

リクエストに必須パラメーターがありません。

エンドポイントのリファレンスで、必須のパラメーターを確認してください。

400

Bad Request (間違ったリクエスト)

131009

無効なパラメーター値

1つ以上のパラメーターの値が無効です。

エンドポイントのリファレンスを調べ、各パラメーターでサポートされている値を確認してください。また、電話番号を参照して、電話番号をWhatsApp Businessアカウントに追加する方法を確認してください。

400

Bad Request (間違ったリクエスト)

131016

サービスを利用できません

サービスを一時的に利用できません。

WhatsApp Businessプラットフォームステータスのページで、APIステータスの情報をチェックしてから再試行してください。

500

Internal Server Error (内部サーバーエラー)

131021

受信者は送信者になれません

送信者と受信者の電話番号が同じです。

送信者とは異なる電話番号にメッセージを送信してください。

400

Bad Request (間違ったリクエスト)

131026

メッセージ配信不可

メッセージを配信できませんでした。次のような理由が考えられます。

受信者の電話番号がWhatsAppの電話番号ではない。
受信者がMetaの新しい利用規約とプライバシーポリシーに同意していない。
受信者が古いバージョンのWhatsAppを使用している(次のバージョン以上を使用しなければならない)。
- Android: 2.21.15.15
- SMBA: 2.21.15.15
- iOS: 2.21.170.4
- SMBI: 2.21.170.4
- KaiOS: 2.2130.10
- Web: 2.2132.6

WhatsApp以外の通信手段を利用して、WhatsAppユーザーに次のことを依頼してください。

あなたのWhatsAppビジネス電話番号にメッセージを送信できることを確認する。
最新の利用規約に同意したことを確認する([設定] > [ヘルプ]、または[設定] > [アプリケーション情報]にアクセスすると、まだ同意していない場合は最新の利用規約/ポリシーに同意するよう求められます)。
WhatsAppクライアントの最新バージョンにアップデートする。

400

Bad Request (間違ったリクエスト)

131037

WhatsAppで提供された番号では、メッセージを送信する前に表示名の承認が必要です。

リクエストの送信に使用された555で始まるビジネス電話番号には、承認された表示名がありません。

555で始まるビジネス電話番号の表示名を変更してください。その方法については、ヘルプセンターの記事WhatsApp Businessの表示名を変更する方法をご覧ください。

400

Bad Request (間違ったリクエスト)

131042

ビジネス資格情報の支払いの問題

支払い方法にエラーが発生しました。

WhatsApp Businessアカウントの請求についてを参照して、請求が正しく設定されていることを確認してください。

次のような一般的な問題があります。

WhatsApp Businessアカウントに支払いアカウントが登録されていません
融資限度額を超えています
融資限度額(支払いアカウント)が設定されていないか、アクティブになっていません
WhatsAppビジネスアカウントが削除されています
WhatsAppビジネスアカウントが一時停止されています
タイムゾーンが設定されていません
通貨が設定されていません
MessagingForリクエスト(代理)が保留中であるか、却下されています

400

Bad Request (間違ったリクエスト)

131045

証明書が正しくありません

電話番号の登録エラーのため、メッセージを送信できませんでした。

電話番号を登録してから再試行してください。

500

Internal Server Error (内部サーバーエラー)

131047

再エンゲージメントメッセージ

受信者が送信者の番号に前回応答してから24時間以上経過しました。

代わりにメッセージテンプレートを使って、ビジネスによって開始されたメッセージを受信者に送信してください。

400

Bad Request (間違ったリクエスト)

131049

Metaは配信しないことにしました。

健全なエコシステムのエンゲージメントを維持するため、このメッセージは配信されませんでした。

このエラーコードを受け取り、その原因が制限によるものと思われる場合、少なくとも24時間待ってからテンプレートメッセージを再送してください。異なる複数の期間に制限が適用される可能性があるため、すぐに再送してもまたエラーが返されるだけです。

詳しくは、ユーザーごとのマーケティングテンプレートメッセージの制限をご覧ください。

400

Bad Request (間違ったリクエスト)

131050

ユーザーがマーケティングメッセージの受信を停止しました。

メッセージを配信できません。この受信者は、WhatsAppであなたのビジネスからマーケティングメッセージを受信することを停止しました。

このユーザーにメッセージを送信しても受信されないので、送信を再試行しないようにします。

あなたのビジネスからのマーケティングテンプレートメッセージの配信をWhatsAppユーザーが停止したり再開したりした場合にその通知を受け取るようにするには、user_preferences Webhookをサブスクリプション登録してください。

400

Bad Request (間違ったリクエスト)

131051

メッセージタイプがサポートされていません

メッセージタイプがサポートされていません。

メッセージを参照してサポート対象のメッセージタイプについて確認し、サポートされているメッセージタイプで再試行してください。

400

Bad Request (間違ったリクエスト)

131052

メディアダウンロードエラー

ユーザーが送信したメディアをダウンロードできませんでした。

WhatsAppユーザーのメッセージに含まれるメディアをダウンロードできませんでした。詳しくは、このメッセージの受信時にトリガーされたmessages Webhooksのerror.error_data.details値をご覧ください。

WhatsApp以外の方法でメディアファイルを送信するようWhatsAppユーザーに依頼してください。

400

Bad Request (間違ったリクエスト)

131053

メディアアップロードエラー

メッセージで使われているメディアをアップロードできませんでした。

メディアタイプがサポートされていないなど、1つ以上の理由のため、メディアをアップロードできませんでした。

詳しくは、このメッセージの送信失敗時にトリガーされたmessages Webhooksのerror.error_data.details値をご覧ください。

エラーの原因となっているメディアファイルを検査し、実際にサポートされていることを確認してください。例えば、UNIXでは、コマンドライン経由でファイル検査を実施して、そのMIMEタイプを判断できます。

file -I rejected-file.mov

その後、MIMEタイプがサポートされているかどうかを確認することができます。サポートされるメディアタイプをご覧ください。

400

Bad Request (間違ったリクエスト)

131057

メンテナンスモードのアカウント

ビジネスアカウントはメンテナンスモードです

WhatsAppビジネスアカウントはメンテナンスモードです。この理由の1つとして、アカウントでスループットのアップグレードが行われていることが考えられます。

500

Bad Request (間違ったリクエスト)

132000

テンプレートのパラメーター数が一致しません

リクエストに含まれている変数パラメーター値の数が、テンプレートで定義されている変数パラメーターの数と一致していません。

メッセージテンプレートガイドラインを確認し、テンプレートで定義されているすべての変数パラメーター値がリクエストに確実に含まれるようにしてください。

400

Bad Request (間違ったリクエスト)

132001

テンプレートが存在しません

指定された言語ではテンプレートが存在しないか、テンプレートが承認されていません。

使用するテンプレートが承認済みで、テンプレート名と言語ロケールが正しいことを確認してください。メッセージテンプレートガイドラインに確実に準拠してください。

404

Not Found (未検出)

132005

テンプレートのハイドレートテキストが長すぎます

変換されたテキストが長すぎます。

WhatsAppマネージャをチェックして、テンプレートが翻訳されていることを確認してください。品質評価とテンプレートステータスをご覧ください。

400

Bad Request (間違ったリクエスト)

132007

テンプレートフォーマットに文字ポリシーの違反があります

テンプレートの内容がWhatsAppポリシーに違反しています。

却下の理由を参照して、考えられる違反の理由を確認してください。

400

Bad Request (間違ったリクエスト)

132012

テンプレートのパラメーターフォーマットが一致しません

変数パラメーターの値が正しくフォーマットされていません。

リクエストに含まれる変数パラメーターの値は、テンプレートで指定されたフォーマットを使用していません。メッセージテンプレートのガイドラインをご覧ください。

400

Bad Request (間違ったリクエスト)

132015

テンプレートが一時停止中

テンプレートが低品質のため一時停止しており、テンプレートメッセージで送信できません。

テンプレートを編集して質を改善し、承認を受けてから再試行してください。

400

Bad Request (間違ったリクエスト)

132016

テンプレートが無効

テンプレートが低品質のために一時停止された回数が多すぎるので、恒久的に無効化されています。

異なるコンテンツの新しいテンプレートを作成してください。

400

Bad Request (間違ったリクエスト)

132068

フローがブロックされている

フローがブロックされた状態です。

フローを修正してください

400

Bad Request (間違ったリクエスト)

132069

フローがスロットルされている

フローはスロットル状態であり、このフローを使った10件のメッセージが過去1時間以内にすでに送信されました。

フローを修正してください

400

Bad Request (間違ったリクエスト)

133000

登録解除が完了していません

以前の登録解除の試みが失敗しています。

該当する番号をもう一度登録解除してから、再登録してください。

500

Internal Server Error (内部サーバーエラー)

133004

サーバーは一時的に利用できません

サーバーは一時的に利用できません。

WhatsApp BusinessプラットフォームステータスのページでAPIステータスの情報をチェックし、応答のdetails値をチェックしてから再試行してください。

503

Service Unavailable (サービス利用不可)

133005

二段階認証PINが一致しません

二段階認証PINが正しくありません。

リクエストに含まれる二段階認証PINが正しいか確認してください。

二段階認証PINをリセットするには、次のようにします。

二段階認証を無効にします。
新しいPINを含むPOSTリクエストを電話番号エンドポイントに送信します。

400

Bad Request (間違ったリクエスト)

133006

電話番号の再認証が必要

電話番号を登録する前に、認証する必要があります。

電話番号を認証してから登録してください。

400

Bad Request (間違ったリクエスト)

133008

二段階認証PINの推測が多すぎます

この電話番号の二段階認証PINの推測が多すぎます。

details応答値で指定された時間が経過した後、再試行してください。

400

Bad Request (間違ったリクエスト)

133009

二段階認証PINの推測が早すぎます

二段階認証PINの入力が早すぎました。

details応答値をチェックしてから再試行してください。

400

Bad Request (間違ったリクエスト)

133010

電話番号が登録されていません

電話番号がWhatsApp Businessプラットフォームに登録されていません。

電話番号を登録してから再試行してください。

400

Bad Request (間違ったリクエスト)

133015

数分待ってから、この電話番号を登録してください

登録しようとしている電話番号は最近削除されましたが、削除処理がまだ完了していません。

5分待ってからリクエストを再試行してください。

400

Bad Request (間違ったリクエスト)

134011

WhatsApp支払い利用規約に同意していません

このWhatsApp Businessアカウントでは、WhatsApp支払い利用規約の同意が保留になっているため、メッセージを送信できませんでした。

エラーメッセージに記載されているリンクからWhatsApp支払い利用規約に同意の上、もう一度お試しください。

400

Bad Request (間違ったリクエスト)

135000

一般的なユーザーエラー

リクエストパラメーターに関する不明なエラーのため、メッセージを送信できませんでした。

エンドポイントのリファレンスを参照して、正しい構文を使ってエンドポイントをクエリしているか確認してください。応答でこのエラーコードが継続して送信される場合は、カスタマーサポートに連絡してください。

400

Bad Request (間違ったリクエスト)

同期エラー

コード詳細考えられる原因と解決策 HTTPステータスコード

コード	詳細	考えられる原因と解決策	HTTPステータスコード
`2593107` 同期リクエストの上限を超えました	この電話番号の同期API呼び出し回数上限を超えました。	このエンドポイントを呼び出すことができるのは、ビジネス電話番号の連絡先を同期するために1回と、メッセージ履歴を同期するために1回のみです。「Businessアプリユーザーのオンボーディング」をご覧ください。ビジネスカスタマーをオフボーディングし、再度オンボーディングします。	`400` Bad Request (間違ったリクエスト)
`2593108` 同期リクエストが許可された時間外に行われました	同期リクエストはオンボーディングから24時間以内にのみ行えます	WhatsApp Businessアプリのユーザーをオンボーディングしてから24時間以内に限り、そのユーザーとの連絡およびメッセージ履歴の同期を開始することができます。「Businessアプリユーザーのオンボーディング」をご覧ください。ユーザーをオフボーディングし、再度オンボーディングします。	`400` Bad Request (間違ったリクエスト)

2593107

同期リクエストの上限を超えました

この電話番号の同期API呼び出し回数上限を超えました。

このエンドポイントを呼び出すことができるのは、ビジネス電話番号の連絡先を同期するために1回と、メッセージ履歴を同期するために1回のみです。「Businessアプリユーザーのオンボーディング」をご覧ください。

ビジネスカスタマーをオフボーディングし、再度オンボーディングします。

400

Bad Request (間違ったリクエスト)

2593108

同期リクエストが許可された時間外に行われました

同期リクエストはオンボーディングから24時間以内にのみ行えます

WhatsApp Businessアプリのユーザーをオンボーディングしてから24時間以内に限り、そのユーザーとの連絡およびメッセージ履歴の同期を開始することができます。「Businessアプリユーザーのオンボーディング」をご覧ください。

ユーザーをオフボーディングし、再度オンボーディングします。

400

Bad Request (間違ったリクエスト)

スロットリングエラー

コード	詳細	考えられる原因と解決策	HTTPステータスコード
`4` APIの呼び出し回数が上限を超えました	アプリがAPI呼び出しレート制限に達しました。	アプリダッシュボードにアプリをロードし、アプリケーションレート制限セクションを参照して、アプリがレート制限に到達していないか確認してください。到達している場合は、後でもう一度試すか、アプリが行うAPI問い合わせの頻度や回数を減らしてください。	`400` Bad Request (間違ったリクエスト)
`80007` レート制限問題	WhatsApp Businessアカウントがレート制限に達しました。	WhatsApp Businessアカウントレート制限をご覧ください。後でもう一度試すか、アプリが行うAPI問い合わせの頻度や回数を減らしてください。	`400` Bad Request (間違ったリクエスト)
`130429` レート制限に達しました	クラウドAPIメッセージスループットに達しました。	アプリがAPIスループット制限に達しました。スループットをご覧ください。後でもう一度試すか、アプリがメッセージを送信する頻度を減らしてください。	`400` Bad Request (間違ったリクエスト)
`131048` スパムレート制限に達しました	この電話番号から送信できるメッセージ数が制限されているため、メッセージを送信できませんでした。ブロックされたメッセージや、スパムとしてフラグが付けられたメッセージが多すぎることが考えられます。	詳しくは、WhatsAppマネージャで品質のステータスをチェックし、品質ベースのレート制限に関するドキュメントをご覧ください。	`400` Bad Request (間違ったリクエスト)
`131056` (ビジネスアカウント、消費者アカウントの)ペアレート制限に達しました	短期間のうちに送信者の電話番号から同じ受信者の電話番号に送信されたメッセージが多すぎます。	同じ電話番号にメッセージを送信する場合は、しばらくしてから操作を再試行してください。別の電話番号へのメッセージはすぐに送信できます	`400` Bad Request (間違ったリクエスト)
`133016` アカウント登録の解除率の上限を超えました	短期間にこの電話番号に対する試行が多すぎたため、登録または登録解除に失敗しました	このビジネスの電話番号は、登録/登録の試行の上限に達したためブロックされています。番号のブロックが解除されてから、もう一度お試しください。登録ドキュメントの「制限」を参照してください。	`400` Bad Request (間違ったリクエスト)