Meta Tech Provider

「Your app is missing required Graph API permissions for Cloud API companion pairing」

このメッセージは、サインアップを開始したプラットフォームが、WhatsApp Business アプリの電話番号を Cloud API に接続するために Meta が求める WhatsApp 権限を、求められるアクセスレベルで持っていないことを示します。Meta では、プラットフォームが Advanced access を持つ権限しか企業は付与できません。企業側では解決できず、プラットフォーム側で対処する必要があります。

Advanced access

パートナーのクライアントが Embedded Signup で権限を付与できるようにするために、各権限で必要になる条件。

200

アプリが所有していないアカウントに対して、Advanced access なしで whatsapp_business_management を使った場合に API 呼び出しが返すエラー。

2 permissions

whatsapp_business_management と whatsapp_business_messaging。Meta が WhatsApp 連携で一般的に必要になるとしている 2 つの権限です。

Tech Provider

Meta は、ビジネスアプリのユーザーをオンボードするプラットフォームに、Solution Partner または Tech Provider であることを求めています。

このメッセージは何を意味しますか？

全文は次のとおりです。「Your app is missing required Graph API permissions for Cloud API companion pairing. Please verify advanced WhatsApp Business permissions are granted, then try again.」Meta が公開しているエラーリファレンスにこの文言そのものは載っていませんが、各部分は Meta の公開ドキュメントにある内容に対応しています。

「Your app」とは、サインアップを実行しているプラットフォームの Meta アプリを指し、スマートフォン上の WhatsApp Business アプリではありません。companion pairing について Meta は公開で定義していませんが、文脈から読むと、WhatsApp Business アプリに登録されたままの番号に Cloud API が加わる仕組み、つまり Coexistence の構成を指しています。また「advanced」な WhatsApp Business 権限とは、Meta が App Review を通じて付与する Advanced access のことです。

どの権限が関係していますか？

Meta の権限ドキュメントでは、WhatsApp 連携で一般的に必要になる権限として 2 つが挙げられています。whatsapp_business_management は、アカウントのメタデータ、テンプレート、電話番号、分析、アカウントの Webhook を扱います。whatsapp_business_messaging は、メッセージの送信と、メッセージおよびステータスの Webhook の受信を扱います。

クライアントが自社のアプリを使うパートナーの場合、Meta はアプリに必要なすべての権限について App Review と Advanced access を求めます。Meta は結果も明示しています。ある権限の Advanced access がなければ、クライアントは Embedded Signup を通じてその権限をアプリに付与できません。Advanced access なしで、アプリが所有していないアカウントに whatsapp_business_management で呼び出しを行うと、エラー 200 が返ります。

企業が実際に何を付与したかは、Meta の debug_token エンドポイントでトークンを調べると確認できます。付与済みの権限は scopes に一覧表示されます。

企業側でできることはありますか？

企業側でできることはほとんどなく、このエラーを解消しようとして Meta の設定を変更するべきでもありません。対処はプラットフォーム側にあります。プラットフォームは Tech Provider または Solution Partner である必要があり、これは Meta が WhatsApp Business アプリのユーザーをオンボードする条件として挙げています。さらに、WhatsApp 権限について Advanced access の承認を受ける必要があります。

企業ができるのは、表示されたメッセージをそのままプラットフォームに伝えることです。そのうえで、プラットフォームがアクセスを確認してから再試行するか、すでにその資格を持つプラットフォームを利用してください。それまでに同じプラットフォームで同じ手順を繰り返しても、結果は変わりません。スマートフォン上の WhatsApp Business アプリにも影響はありません。

よくある間違い

企業自身の Meta 設定で権限を追加付与しようとすること。不足しているアクセスは、プラットフォームのアプリ側にあります。
App Review を受けずに、開発者アプリ上でツールを自社運用すること。Advanced access がなければ、企業は必要な権限を付与できません。
同じプラットフォームで何度も再試行すること。結果が変わるのは、そのプラットフォームのアクセスが変わったときだけです。

EasyCoexistence で実現する

EasyCoexistence は独立した Meta Tech Provider で、独自の Meta アプリを持ち、Coexistence 向けに Embedded Signup v4 を運用しています。そのため企業は、Meta が求めるアクセスをすでに備えたプラットフォームを通じて番号を接続できます。

よくある質問

WhatsApp Business アプリに問題があるのでしょうか？

いいえ。このメッセージが指しているのはプラットフォームの Meta アプリであり、お使いのスマートフォンのアプリではありません。スマートフォンのアプリはそのまま使えます。

自分で権限を付与できますか？

付与の対象として表示されるのは、プラットフォームが Advanced access を持つ権限だけです。不足しているアクセスは、まずプラットフォームに対して承認される必要があります。

プラットフォームはどうすれば Advanced access を取得できますか？

クライアントが自社のアプリを使うパートナーとして、アプリに必要な権限ごとに Meta の App Review を受けます。

企業にも App Review は必要ですか？

いいえ。Meta によれば、自社のビジネスデータにのみアクセスする直接の開発者には、App Review も Advanced access も不要です。

続きを読む

"This authorization code has expired" after Coexistence signupWhy a platform reports that the authorization code has expired after Meta's signup popup finishes, the 30 second limit behind it, and how to complete the connection."Connect your existing WhatsApp Business app" option not showingWhy Meta's Embedded Signup does not offer to connect an existing WhatsApp Business app account, who controls that option, and what to check before retrying.Coexistence QR code scan fails in the WhatsApp Business appWhy the phone step of Coexistence signup fails when you scan the code in the WhatsApp Business app, what Meta requires on the phone, and how to retry it cleanly.What being a Meta Tech Provider means, and why it mattersA Tech Provider connects other businesses' WhatsApp numbers through its own Meta app. What the status requires, and what it changes for the client.Meta Business Portfolio, and what sits inside itThe company level container in Meta Business Manager. What it holds, why it matters for a client's number, and how it differs from a WABA.WhatsApp Cloud API error codesEvery WhatsApp Cloud API error code in one table: what each one means, whether retrying helps, and the page that covers it in full.

始める準備はできましたか？

WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。

無料トライアルを始める

確認日 2026-10-11