WhatsApp エラー 131005:アクセス拒否、権限不足
エラー 131005 は、アクセストークンに WhatsApp エンドポイントが必要とする権限がないことを示します。権限が一度も付与されていないか、後から削除されたことが原因です。Meta の説明は「権限が付与されていないか、削除されています」という内容です。対処は、アクセストークンデバッガーでトークンを確認し、不足している権限を付与するか、その権限を持つトークンに切り替えることです。
「権限が付与されていないか、削除されています」を示す Meta のエラーコード。
WhatsApp ユーザーにあらゆる種類のメッセージを送信するために必要な権限。
business_management、whatsapp_business_management、whatsapp_business_messaging。システムユーザーのトークンを生成するときに割り当てます。
WhatsApp エラー 131005 とは何を意味しますか?
トークン自体は正規のものとして受理されていますが、エンドポイントが確認する権限を持っていない、という意味です。
Meta の Cloud API リファレンスでは、131005 の詳細テキストは「権限が付与されていないか、削除されています」と記載されています。Graph API のエラー 10 にもまったく同じ文が使われています。違いはコードの範囲だけです。10 は汎用的な Graph API のコードで、131005 は 131 で始まる WhatsApp 用のコードに含まれます。
文言が同じなので、診断も同じです。どちらの場合も Meta が示す対処は、アクセストークンデバッガーを使い、エンドポイントが要求する権限をアプリが持っているかを確認することです。
通常、どの権限が不足していますか?
多くの場合、2 つの WhatsApp 権限のどちらかです。どちらかは、呼び出しの内容によって決まります。
Meta の権限ガイドでは、用途ごとに分かれています。whatsapp_business_messaging は、あらゆる種類のメッセージの送信と、メッセージおよびステータスの Webhook の受信に必要です。whatsapp_business_management は、アカウントのメタデータ、メッセージテンプレートの管理、電話番号の一覧取得、分析、アカウントの Webhook に必要です。
管理用の権限だけで生成したトークンは、アカウントの読み取りやテンプレートの一覧取得はできますが、送信しようとした途端に失敗します。システムユーザーのトークンを生成するときは、Meta のアクセストークンガイドに従い、business_management、whatsapp_business_management、whatsapp_business_messaging をまとめて割り当ててください。
エラー 131005 はどのように修正しますか?
まずトークンを確認し、不足している部分だけを変更します。
debug_token エンドポイントを呼び出すか、トークンをアクセストークンデバッガーに貼り付けてください。scopes プロパティに、付与されているすべての権限が表示されます。これを、失敗したエンドポイントのリファレンスページと照らし合わせます。
権限が足りない場合は、その権限を含む新しいトークンを生成してください。トークンがパートナー経由のフローで発行されたものであれば、企業の所有者に権限をもう一度付与してもらいます。すべての権限が揃っているのにエラーが続く場合は、トークンの元になっているシステムユーザーに、対象の WhatsApp Business アカウントへのアクセスが付与されているかを確認してください。スコープがすべて揃っていても、そのアセットに割り当てられていないトークンはあり得ます。
よくある間違い
- トークンの期限切れと決めつけること。期限切れでは 190 または 0 が返ります。このコードは、トークンは有効だが権限が足りない場合に返ります。
- 管理用の権限だけでトークンを生成し、そのまま送信に使うこと。送信には whatsapp_business_messaging が必要です。
- スコープだけを確認して終わりにすること。システムユーザーには、その WhatsApp Business アカウントへのアクセス付与も必要です。
EasyCoexistence は、Meta の Embedded Signup で各番号を接続します。この中で企業がアプリに権限を付与します。また MCP コネクタが番号の接続状態を報告するため、アシスタントが送信前に確認できます。
よくある質問
131005 はエラー 10 と同じものですか?
Meta のリファレンスでは同じ説明文です。131005 は WhatsApp 用の範囲、10 は Graph API 用の範囲に属します。
設定後に権限が削除されることはありますか?
あります。Meta の説明には、一度も付与されていない権限だけでなく、削除された権限も明記されています。
エラー 131005 は、スマートフォンの WhatsApp Business アプリにも影響しますか?
いいえ。影響するのは API のトークンだけです。スマートフォンのアプリはこれまでどおり使えます。
エラー 131005 のあとは再試行すべきですか?
いいえ。同じトークンで再試行しても同じ結果になります。先に権限を修正してください。
続きを読む
始める準備はできましたか?
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日