エラーメッセージとステータスメッセージ

このドキュメントは、次のエラーとステータスのメッセージの詳細を示すものです。

WhatsApp Business APIクライアントのエラーコード
HTTPステータスコード

埋め込み登録のトラブルシューティングについては、「埋め込み登録フローのエラー」をご覧ください。

WhatsApp Business APIクライアントのエラーコード

エラーコード	説明
`400` - メディアダウンロードエラー	送信者からのメディアをダウンロードできませんでした。
`402` - ビジネス資格情報 — 支払いに問題があります	支払い方法に関連するエラーが1つ以上あったため、メッセージを送信できませんでした。 WhatsAppアカウントに支払いアカウントが登録されていませんクレジットラインが限度額を超えています融資限度額(支払いアカウント)が設定されていないか、アクティブになっていません WhatsApp Businessアカウントが削除されています Facebookによりアカウントが停止されていますタイムゾーンが設定されていません通貨が設定されていません MessagingForリクエスト(代理(OBO))が保留中であるか、却下されています有効な支払い方法が指定されておらず、スレッド無料利用枠のしきい値を超えました。(このエラータイプは2022年2月1日から有効)。 WhatsAppマネージャで支払い設定を確認して、もう一度お試しください。
`408` - メッセージが無効です	保留時間が長すぎた(1日を超えた)ため、メッセージを送信できませんでした。WhatsApp Business APIクライアントが1日以上ダウンしてから再起動されたと考えられます。メッセージを再送信してください。
`410` - メッセージの期限が切れました	有効期間(TTL)内にメッセージを送信できませんでした。
`429` - レート制限に達しました	送信メッセージの場合: この電話番号から短期間で大量のメッセージが送信されたため、メッセージを送信できませんでした。送信できなかったメッセージを再送信してください。受信メッセージの場合: レート制限のため、メディアを正常にダウンロードできませんでした。送信者にメッセージの再送信を依頼してください。
`430` - 証明書に署名がありません	証明書に関連したエラーのため、メッセージを送信できませんでした。 WhatsAppマネージャから新しい証明書をダウンロードして、再登録してください。
`432` - 証明書IDが一致しません	証明書に関連したエラーのため、メッセージを送信できませんでした。 WhatsAppマネージャから新しい証明書をダウンロードして、再登録してください。
`433` - 証明書の署名が無効です	このエラーは、送信されたメッセージに含まれるビジネスクライアントの証明書がクライアントのIDキーで正しく署名されていない場合に発生します。クライアントが新しいIDキーで再登録した後、証明書作成フローを完了していない可能性があります。
`470` - 再エンゲージメントメッセージ	顧客がこの番号に最後に返信してから24時間以上経過したため、メッセージを送信できませんでした。メッセージテンプレートを使用して返信してください。
`471` - スパムレート制限に達しました	この電話番号から送信できるメッセージ数が制限されているため、メッセージを送信できませんでした。ブロックされたメッセージや、スパムとしてフラグされたメッセージが多すぎることが考えられます。 WhatsAppマネージャで品質ステータスを確認してください。詳しくは、品質ベースのレート制限に関するドキュメントをご覧ください。
`472` - ユーザーの番号がテストの一部となっています	このユーザーの電話番号がテストの一部となっているため、メッセージを送信できませんでした。このユーザーへのメッセージの送信をスキップしてください。
`480` - ユーザーが変更された可能性があります	この電話番号のユーザーが変更された可能性があるため、メッセージを送信できませんでした。
`500` - 一般的なエラー	不明なエラーのため、メッセージを送信できませんでした。後でもう一度お試しください。
`501` - メッセージタイプが現在サポートされていません。	キャプション付きのドキュメントメッセージは現在サポートされていません。
`1000` - 一般的なエラー
`1001` - メッセージが長すぎます	メッセージの長さが4096文字を超えています。
`1002` - 受信者タイプが無効です	有効な受信者タイプは次のとおりです。 `individual`
`1004` - リソースがすでに存在します	メディアアップロードリクエストのUUIDが競合しているか、当該UUIDを持つメディアがすでに存在しています。
`1005` - アクセスが拒否されました	オンプレミスAPIで使用するビジネス電話番号を登録しようとしていますが、この作業は許可されなくなりました。オンプレミスAPIの廃止をご覧ください。メディアディレクトリが書き込み不可です(アップロードリクエストの場合)。または認証情報が無効です。または証明書に誤りがあります。またはアプリが期限切れで、バージョンのアップグレードが必要です。または `button` このアカウントでメッセージが無効になっています。または番号がすでにWhatsAppに登録されています(電話番号をWhatsAppからWhatsApp Business APIに移行する方法については、電話番号の移行をご覧ください)。またはインドでコマースメッセージを送信するビジネスの場合、すべての必須のビジネスプロフィールおよび商品アイテムフィールドが設定されていることを確認してください。詳しくは、https://www.facebook.com/business/help/1104628230079278をご覧ください。
`1006` - リソースが見つかりません	ファイルまたはリソースが見つかりません。
`1007` - 受信者がメッセージの受信をブロックしました(廃止済み)	受信者が許可リストに登録されていません。
`1008` - 必須パラメーターが入力されていません	必須パラメーターが入力されていません。リストメッセージを送信しようとしている場合は、`section`オブジェクトの`title`部分、または`rows`の`ID`を入力していない可能性があります。単一商品メッセージまたは複数商品メッセージを送信しようとしている場合、`catalog_id`または`product_retailer_id`が欠落している可能性があります。このメッセージタイプでは、どちらのフィールドも必須です。
`1009` - パラメーター値が無効です	パラメーターに入力された値の型が誤っているか、その他の問題があります。リストメッセージを送信しようとしている場合は、各行のIDが一意かどうかを確認してください。単一商品メッセージを送信しようとしている場合、間違った`catalog_id`を送信した可能性があります。コマースマネージャに戻って、再確認してください。複数商品メッセージを送信しようとしている場合、`product_retailer_id`がセクションごとに一意になっているか確認してください。また、`header`オブジェクトと`body`オブジェクトが存在していて、値が割り当てられていることも確認してください。
`1010` - パラメーターは不要です	不要なパラメーターが含まれています。
`1011` - サービスの準備ができていません
`1013` - ユーザーが無効です
`1014` - 内部エラー	不正な画像(正しくアップロードされていない画像)のアップロードが失敗したか、エンドポイントが見つかりませんでした。指定したハッシュがユーザーの最新のハッシュと一致しません。
`1015` - リクエストが多すぎます	クライアント側のレート制限に達しました。
`1016` - システムが過負荷状態です	システムが過負荷状態の場合、システムを過負荷状態からリカバリできるように、このエラーが返されます。
`1017` - プライマリマスターではありません	このエラーは、設定値の設定と取得、インポート、エクスポート、コードリクエスト、登録など、マスター専用のリクエストがプライマリマスターではないノードに送信された場合に発生します。これは、WhatsApp Business APIクライアントの不適切な設定や内部エラーによって発生することがあります。このエラーは、リクエストを再試行すると解消されます。再試行してもエラーが解消されない場合は、サポートにお問い合わせください。
`1018` - プライマリCoreappではありません	このエラーは、シャードオーナーでないCoreappノード、またはシャードオーナーになろうとしているCoreappノードにリクエストが送信された場合に発生します。このエラーは、マルチコネクト設定でシャードのフェイルオーバーが実行されているときに発生することがあります。ほとんどの場合、このエラーはリクエストを再試行すると解消されます。エラーが解消されない場合は、サポートにお問い合わせください。
`1021` - ユーザーが不正です	このエラーは、自分宛てにメッセージを送信した場合に発生します。エラーを解消するには、自分の番号以外の番号宛てにメッセージを送信してください。
`1022` - Webhooks URLが構成されていません	このエラーは、REST API Webhooksフォーマットが構成されていない場合に発生します。
`1023` - データベースエラーが発生しました
`1024` - パスワードの変更が必要です	パスワードを変更する必要があります。
`1025` - リクエストが無効です	リクエストが有効ではありません。
`1026` - 受信者が受信できません	メッセージを配信できませんでした。「配信率が100%にならないのはなぜですか？」をご覧ください。よくある質問。
`1028` - `user_identity_changed`システム通知に確認応答が必要です	メッセージの送信先のWhatsAppユーザーが変更された可能性があります。`user_identity_changed`システム通知が送信され、確認応答待ちになっています。
`1031` - 送信者アカウントがロックされています	統合ポリシー違反のため、アカウントがロックされていてメッセージを送信できません。詳しくは、WhatsApp Businessプラットフォームポリシーの実施をご覧ください。
`2000` - テンプレートのパラメーター数が一致しません	指定されたパラメーターの数が期待されるパラメーターの数と一致しません。
`2001` - テンプレートがありません	テンプレートのステータスがアクティブではないか、指定された言語とロケールのテンプレートが存在しません。
`2002` - テンプレートを取得できませんでした	受信者がテンプレートをダウンロードできませんでした。
`2003` - テンプレートパックがありません	特定の言語と地域に対応するテンプレートが存在しません。
`2004` - テンプレートのパラメーターが長すぎます	パラメーターが長すぎます。
`2005` - テンプレートのハイドレートテキストが長すぎます	変換されたテキストが長すぎます。
`2006` - テンプレートの空白文字ポリシーに対する違反があります	空白文字ポリシーに対する違反があります。
`2007` - テンプレートの文字形式ポリシーに対する違反があります	文字形式ポリシーに対する違反があります。
`2008` - テンプレートのメディア形式がサポートされていません	使用されているメディア形式がサポートされていません。
`2009` - テンプレートの必須コンポーネントがありません	テンプレートに必須コンポーネントが含まれていません。
`2010` - テンプレートのハイドレートURLが無効です	ボタンコンポーネントのURLが無効です。
`2011` - テンプレートの電話番号が無効です	ボタンコンポーネントの電話番号が無効です。
`2012` - テンプレートのパラメーター形式が一致しません	パラメーターの形式が、作成されたテンプレート内の形式と一致しません。
`2013` - テンプレートのボタンがサポートされていません	受信者側でボタンがサポートされていません。
`2014` - 期待されているネームスペースが空です	このエラーは、テンプレートメッセージ言語パックがまだダウンロードされていない場合に発生します。
`2015` - セクション数が無効です	メッセージリクエストに含まれるセクションの数が最小数を下回っているか、最大数を超えています。詳しくは、`section`オブジェクトをご覧ください。 `section`オブジェクトは少なくとも1個必要で、10個まで許容されます。
`2016` - 行数が無効です	行数が無効です。リストメッセージの場合は、`section`ごとに少なくとも1個の`rows`オブジェクトが必要です。
`2017` - 文字ポリシーに対する違反があります	文字形式ポリシーに対する違反があります。
`2023` - 行数が無効です	sectionオブジェクトに商品がないか、商品合計数が可能な最大数を超えています。
`2024` - カタログIDが見つかりません	指定したカタログIDが存在しないか、WhatsApp Businessアカウント(WABA)に属していません。
`2025` - カタログIDがAPI番号にリンクしていません	指定したカタログIDは、メッセージ送信のために使用している電話番号にリンクされていません。
`2026` - 商品がありません	リクエストに指定された商品の一部がカタログに見つかりませんでした。
`2027` - 商品が見つかりません	指定したカタログに商品が見つかりませんでした。
`2028` - コンプライアンス失敗の全商品のリスト	インド内のビジネスでのみ利用可能。このエラーは、ビジネスが単一商品メッセージを送信する際に、eコマースコンプライアンス情報が欠落していて不完全である場合に返されます。
`2029` - コンプライアンス失敗の一部商品のリスト	インド内のビジネスでのみ利用可能。このエラーは、ビジネスが複数商品メッセージを送信する際に、eコマースコンプライアンス情報が欠落していて不完全である場合に返されます。
`2030` - 無効な商品とコンプライアンス失敗の商品のリスト	インド内のビジネスでのみ利用可能。このエラーは、ビジネスが複数商品メッセージを送信する際に、無効な商品とコンプライアンス情報の欠落した商品が混在する場合に返されます。
`2036` - ヘッダー構造が無効です	このエラーは、`header`オブジェクトの構造が無効な場合に返されます。
`2050` - コンプライアンス情報がありません	インド内のビジネスでのみ利用可能。このエラーは、ビジネスがコンプライアンス情報を提供しなかった場合に返されます。ビジネスコンプライアンスエンドポイントをご覧ください。
`2062` - テンプレートが却下されました	テンプレートのステータスが`REJECTED`になっているため、送信できません。
`2061` - テンプレートが一時停止しています	テンプレートのステータスが`PAUSED`になっているため、送信できません。
`2062` - テンプレートが無効になっています	テンプレートのステータスが`DISABLED`になっているため送信できません。
`2064` - 無効なFlow ID	指定したFlow IDが存在しない、WhatsApp Businessアカウント(WABA)に属していない、または無効な状態です。
`2065` - 無効なFlowメッセージバージョン	Flowメッセージバージョンが無効です。現在サポートされているメッセージのバージョンについては、Flowsの更新履歴をご覧ください
`2066` - 無効なFlowモード	`DRAFT`状態のFlowがドラフトモードを指定して送信される場合、または`PUBLISHED` Flowがドラフトモードで送信される場合に返されます。
`2067` - Flow DRAFTモードを使用できません	`DRAFT` Flow を送信できません。対応中の問題については、ステータスのページをご覧ください。また、問題が解決しない場合は、サポートまでお問い合わせください。
`2068` - Flowがブロックされている	フローがブロックされた状態です。このエラーは、フローがエンドポイントを使用していて、必要な設定が完了していない場合(公開鍵がアップロードされていないか、無効になっているなど)にも返されることがあります。フローのエンドポイントの実装をご覧ください。
`2069` - フローがスロットルされています	Flowはスロットル状態で、このFlowを使ったメッセージが過去1時間に10件送信されました。
`2070` - 無効なFlowバージョン	Flowバージョンが無効または期限切れです。現在サポートされているバージョンについては、Flowsの更新履歴をご覧ください

インドのビジネスに固有のコマースマネージャエラーコードについては、ビジネスヘルプセンターをご覧ください。

HTTPステータスコード

WhatsApp Business APIクライアントで使用できるHTTPステータスコードは次のとおりです。

HTTPコード	説明
`2xx`	成功
`200`	成功(OK)
`201`	作成に成功しました(POSTリクエストの場合)
`302`	見つかりました
`4xx`	クライアントエラー
`400`	無効なリクエストでした
`401`	未承認
`403`	禁止
`404`	Not found (未検出)
`405`	許可されていないメソッドです。
`412`	前提条件失敗
`420`	メッセージがレート制限されています
`429`	リクエストが多すぎます
`5xx`	サーバーエラー
`500`	内部サーバーエラー
`504`	タイムアウト

WhatsApp Businessプラットフォーム | クラウドAPI | オンプレミスAPI | ビジネス管理API