Ошибка WhatsApp 131005: доступ запрещён, нет разрешения
Ошибка 131005 означает, что у токена доступа нет разрешения, которого требует эндпоинт WhatsApp: его не выдавали или позже отозвали. Описание Meta: «Permission is either not granted or has been removed.» Проверьте токен в отладчике токенов доступа, затем выдайте недостающее разрешение или возьмите токен, у которого оно есть.
Код Meta для описания «Permission is either not granted or has been removed.»
Разрешение, необходимое для отправки сообщений любого типа пользователям WhatsApp.
business_management, whatsapp_business_management и whatsapp_business_messaging, которые назначают при создании токена системного пользователя.
Что означает ошибка WhatsApp 131005?
Токен признан подлинным, но у него нет разрешения, которое проверяет эндпоинт.
В справочнике Meta по Cloud API код 131005 указан с текстом «Permission is either not granted or has been removed.» Ошибка 10 в Graph API содержит ту же фразу. Различие только в диапазоне: 10 является общим кодом Graph API, а 131005 входит в коды WhatsApp, которые начинаются с 131.
Раз формулировка одинакова, диагностика тоже одинакова. Для обеих ошибок Meta советует открыть отладчик токенов доступа и убедиться, что у приложения есть разрешения, которых требует эндпоинт.
Какого разрешения обычно не хватает?
Чаще всего одного из двух разрешений WhatsApp, и какого именно, зависит от того, что делает запрос.
Руководство Meta по разрешениям делит их по задачам. whatsapp_business_messaging нужно, чтобы отправлять сообщения любого типа и получать вебхуки о сообщениях и статусах. whatsapp_business_management нужно для метаданных аккаунта, управления шаблонами, списка номеров, аналитики и вебхуков аккаунта.
Токен, созданный только с разрешением management, умеет читать аккаунт и выводить список шаблонов, но сразу падает при попытке отправки. Руководство Meta по токенам доступа предлагает при создании токена системного пользователя назначить вместе business_management, whatsapp_business_management и whatsapp_business_messaging.
Как исправить ошибку 131005?
Сначала прочитайте токен, затем измените только то, чего не хватает.
Вызовите эндпоинт debug_token или вставьте токен в отладчик токенов доступа. Свойство scopes перечисляет все выданные разрешения. Сравните его со справочной страницей эндпоинта, на котором произошла ошибка.
Если разрешения нет, создайте новый токен, который его включает, а если токен получен через партнёрский процесс, попросите владельца бизнеса выдать его заново. Если все разрешения на месте, а ошибка остаётся, проверьте, что системному пользователю, которому принадлежит токен, выдан доступ именно к нужному WhatsApp Business Account: токен может иметь все scopes и всё равно не быть привязан к этому ресурсу.
Распространённые ошибки
- Считать, что токен истёк. Истечение срока даёт 190 или 0. Этот код означает, что токен работает, но разрешения не хватает.
- Создать токен только с разрешением management и использовать его для отправки. Для отправки нужно whatsapp_business_messaging.
- Проверить scopes и на этом остановиться. Системному пользователю также нужен доступ к конкретному WhatsApp Business Account.
EasyCoexistence подключает каждый номер через Embedded Signup от Meta: бизнес сам выдаёт приложению разрешения. Коннектор MCP сообщает о состоянии номера, поэтому ассистент может проверить его перед отправкой.
Часто задаваемые вопросы
131005 и 10 это одна и та же ошибка?
В справочнике Meta у них одинаковое описание. 131005 относится к диапазону WhatsApp, а 10 к диапазону Graph API.
Можно ли потерять разрешение после настройки?
Да. Описание Meta прямо охватывает отозванные разрешения, а не только те, что никогда не выдавались.
Влияет ли ошибка 131005 на приложение WhatsApp Business на телефоне?
Нет. Она касается токена API. Приложение на телефоне работает как раньше.
Нужно ли повторять запрос после ошибки 131005?
Нет. Повтор с тем же токеном даст тот же результат. Сначала исправьте разрешение.
Читайте дальше
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на