«Your app is missing required Graph API permissions for Cloud API companion pairing»
Это сообщение означает, что у платформы, запустившей подключение, нет разрешений WhatsApp, которые требует Meta, на том уровне доступа, который требует Meta, чтобы подключить номер приложения WhatsApp Business к Cloud API. Meta позволяет бизнесу выдать только те разрешения, для которых у платформы есть Advanced access. Бизнес исправить это не может, это должна сделать платформа.
Что нужно партнёру для каждого разрешения, чтобы его клиенты могли выдать его через Embedded Signup.
Ошибка, которую возвращают запросы API, если whatsapp_business_management используется без Advanced access в аккаунтах, которыми приложение не владеет.
whatsapp_business_management и whatsapp_business_messaging: два разрешения, которые, по словам Meta, обычно нужны интеграциям WhatsApp.
Meta требует, чтобы платформа уже была Solution Partner или Tech Provider, чтобы подключать пользователей приложения WhatsApp Business.
Что означает это сообщение?
Полный текст звучит так: «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 на телефоне. Meta не определяет companion pairing публично. По контексту это описание ситуации, когда Cloud API подключается к номеру, который остаётся зарегистрированным в приложении WhatsApp Business, то есть схема Coexistence. А «advanced» WhatsApp Business permissions указывает на Advanced access (расширенный доступ), уровень, который Meta выдаёт по итогам App Review.
Какие разрешения затронуты?
В документации Meta по разрешениям названы два, которые обычно нужны интеграциям WhatsApp. whatsapp_business_management охватывает метаданные аккаунта, шаблоны, номера телефонов, аналитику и вебхуки аккаунта. whatsapp_business_messaging охватывает отправку сообщений и получение вебхуков о сообщениях и статусах.
Если партнёр даёт своё приложение клиентам, Meta требует пройти App Review и получить Advanced access для каждого разрешения, которое нужно приложению. Следствие Meta формулирует прямо: без Advanced access для разрешения клиенты не могут выдать его приложению через Embedded Signup. Запросы с whatsapp_business_management к аккаунтам, которыми приложение не владеет, без Advanced access возвращают ошибку 200.
Платформа может проверить, что бизнес выдал на самом деле, изучив токен через эндпоинт Meta debug_token: выданные разрешения перечислены в поле scopes.
Что может сделать бизнес?
На своей стороне очень немногое, и менять настройки Meta, чтобы убрать ошибку, не стоит. Исправление находится у платформы: она должна быть Tech Provider или Solution Partner, что Meta называет условием для подключения пользователей приложения WhatsApp Business, и ей нужно получить одобренный Advanced access для разрешений WhatsApp.
Бизнес может сообщить платформе точный текст сообщения, повторить попытку, когда платформа подтвердит свой доступ, или воспользоваться платформой, у которой такой статус уже есть. Повтор того же процесса на той же платформе до этого даёт тот же результат и не влияет на приложение WhatsApp Business на телефоне.
Распространённые ошибки
- Выдавать больше разрешений в собственных настройках Meta бизнеса. Недостающий доступ относится к приложению платформы.
- Развернуть инструмент самостоятельно на приложении разработчика без App Review. Без Advanced access бизнес не может выдать нужные разрешения.
- Многократно повторять попытку на той же платформе. Результат меняется только тогда, когда меняется доступ этой платформы.
EasyCoexistence является независимым Meta Tech Provider со своим приложением Meta и запускает Embedded Signup v4 для Coexistence, поэтому бизнес подключает номер через платформу, у которой уже есть доступ, требуемый Meta.
Часто задаваемые вопросы
Что-то не так с моим приложением WhatsApp Business?
Нет. Сообщение относится к приложению Meta платформы, а не к приложению на вашем телефоне, которое продолжает работать.
Могу ли я выдать разрешение сам?
Вам показываются для выдачи только те разрешения, для которых у платформы есть Advanced access. Недостающий доступ сначала должен быть одобрен для платформы.
Как платформа получает Advanced access?
Через Meta App Review для каждого разрешения, которое нужно её приложению, как партнёру, чьи клиенты пользуются этим приложением.
Нужен ли бизнесу App Review?
Нет. Meta указывает, что разработчику, который напрямую работает только с данными собственного бизнеса, не нужны ни App Review, ни Advanced access.
Читайте дальше
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на