WhatsApp エラー 3: 機能または権限の問題

WhatsApp のエラーコード 3 は何を意味しますか？

リクエストの認証は通ったものの、アプリが要求した操作を行う許可がないことを意味します。

Meta は Cloud API リファレンスの認可エラーの一覧にコード 3 を載せ、詳細テキストを「Capability or permissions issue」としています。Cloud API が引き継いでいる Graph API のエラー処理ガイドでは、同じコードを API Method と呼び、呼び出しに必要な機能や権限がアプリにあるかを確認するよう案内しています。

つまり、トークンは機能しています。本人確認の問題ではないため、この点がコード 0 や 190 との違いです。問題になっているのは、トークンがどこまで操作を許可されているかです。

トークンにどの権限があるかを確認するには？

アクセストークンデバッガーを使うか、同じ情報を返す debug_token エンドポイントを使います。

レスポンスの scopes プロパティに、付与済みの権限が一覧で表示されます。この一覧を、失敗したエンドポイントのリファレンスページと照らし合わせてください。各リファレンスには、必要な権限が明記されています。

WhatsApp では、2 つの権限でほぼすべてをカバーできます。whatsapp_business_management は、アカウントのメタデータ、テンプレート、電話番号の一覧、分析、アカウントの Webhook に必要です。whatsapp_business_messaging は、あらゆるメッセージの送信と、メッセージおよびステータスの Webhook の受信に必要です。どちらか一方しか持たないトークンは、もう一方が必要な呼び出しで失敗します。

直接開発する場合は出ないのに、パートナーのアプリでエラー 3 が出るのはなぜですか？

他社向けにサービスを提供するパートナーには、追加の関門があるためです。

Meta の権限ガイドによると、顧客企業がアプリを通じて自社データにアクセスするパートナーは、アプリレビューを通過し、アプリが必要とするすべての権限について Advanced access を持つ必要があります。自社のビジネスデータだけを扱う直接の開発者には、アプリレビューも Advanced access も必要ありません。

そのため、同じコードが開発者自身のアカウントでは問題なく動き、顧客のアカウントでは失敗することがあります。このパターンに当てはまる場合、確認すべきなのはトークンにどの権限が欠けているかではなく、自社が所有しないアセットに対してその権限を使うことがアプリに承認されているかどうかです。

よくある間違い

• 同じスコープで新しいトークンを発行する。同じ権限の新しいトークンでも、同じ箇所で失敗します。
• 権限の名前をトークンではなくアプリの設定で確認する。重要なのは、トークンに実際に付与された内容です。
• 自分のアカウントだけでテストする。パートナーのアプリは、顧客のアカウントが呼び出しを受け付ける前に Advanced access が必要です。

よくある質問

続きを読む