クラウドAPIのエラーコード

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

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

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

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

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

Cloud 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`	文字列	メッセージに使用した製品。Cloud API応答では常に、`whatsapp`という文字列になります。
`type`	文字列	エラータイプ。

応答の例

{
  "error": {
    "message": "(#130429) Rate limit hit",
    "type": "OAuthException",
    "code": 130429,
    "error_data": {
        "messaging_product": "whatsapp", 
        "details": "Message failed to send because there were too many messages sent from this phone number in a short period of time"
    },
    "error_subcode": 2494055,
    "fbtrace_id": "Az8or2yhqkZfEZ-_4Qn_Bam"
  }
}

エラーコード

認証エラー

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

スロットリングエラー

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

整合性エラー

コード説明考えられる解決策 HTTPステータスコード

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

368

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

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

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

403

禁止

130497

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

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

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

403

禁止

131031

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

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

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

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

403

禁止

その他のエラー

コード説明考えられる解決策 HTTPステータスコード

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

1

不明なAPI

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

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

400

間違ったリクエスト

2

APIサービス

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

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

503

サービス利用不可

33

無効なパラメーター値

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

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

400

間違ったリクエスト

100

無効なパラメーター

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

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

ビジネス公開鍵を設定する際には、PEM形式の有効な2048-bit RSA公開鍵であることを確認してください。

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

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

400

間違ったリクエスト

130472

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

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

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

400

間違ったリクエスト

131000

Something went wrong (不具合が発生しました)

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

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

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

500

内部サーバーエラー

131005

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

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

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

403

禁止

131008

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

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

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

400

間違ったリクエスト

131009

無効なパラメーター値

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

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

400

間違ったリクエスト

131016

サービス利用不可

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

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

500

内部サーバーエラー

131021

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

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

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

400

間違ったリクエスト

131026

メッセージ配信不可

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

受信者の電話番号がWhatsAppの電話番号ではない。
国別通話コードが+91 (インド)のWhatsAppユーザーに認証テンプレートを送信している。現在、インドの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

間違ったリクエスト

131042

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

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

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

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

WhatsApp Businessアカウントに支払いアカウントが登録されていません
融資限度額を超えています
融資限度額(支払いアカウント)が設定されていないか、アクティブになっていません
WhatsAppビジネスアカウントが削除されています
WhatsAppビジネスアカウントが一時停止されています
タイムゾーンが設定されていません
通貨が設定されていません
MessagingForリクエスト(代理)が保留中であるか、却下されています
スレッド無料利用枠のしきい値を超えましたが、有効な支払い方法が指定されていません

400

間違ったリクエスト

131045

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

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

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

500

内部サーバーエラー

131047

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

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

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

400

間違ったリクエスト

131049

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

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

このエラーコードが表示される原因がこの制限のためだと思われる場合は、すぐに再試行しないでください。代わりに、最終的にメッセージが配信されるまで、間隔を徐々に長くしながら再送を試みてください。制限が有効になる期間はそれぞれ異なる場合があるからです。

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

400

間違ったリクエスト

131051

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

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

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

400

間違ったリクエスト

131052

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

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

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

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

400

間違ったリクエスト

131053

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

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

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

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

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

file -I rejected-file.mov

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

400

間違ったリクエスト

131057

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

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

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

500

間違ったリクエスト

132000

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

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

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

400

間違ったリクエスト

132001

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

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

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

404

見つかりません

132005

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

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

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

400

間違ったリクエスト

132007

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

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

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

400

間違ったリクエスト

132012

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

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

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

400

間違ったリクエスト

132015

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

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

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

400

間違ったリクエスト

132016

テンプレートが無効

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

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

400

間違ったリクエスト

132068

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

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

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

400

間違ったリクエスト

132069

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

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

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

400

間違ったリクエスト

133000

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

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

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

500

内部サーバーエラー

133004

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

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

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

503

サービス利用不可

133005

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

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

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

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

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

400

間違ったリクエスト

133006

電話番号の再認証が必要

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

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

400

間違ったリクエスト

133008

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

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

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

400

間違ったリクエスト

133009

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

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

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

400

間違ったリクエスト

133010

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

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

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

400

間違ったリクエスト

133015

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

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

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

400

間違ったリクエスト

135000

一般的なユーザーエラー

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

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

400

間違ったリクエスト