Перейти к основному содержимому

Управление бизнес-аккаунтами WhatsApp | Документация для разработчиков

Управление бизнес-аккаунтами WhatsApp

Обновлено: 27 февраля 2026 г
В этом документе описаны распространенные конечные точки, используемые для управления бизнес-аккаунтами WhatsApp для корпоративных клиентов.

Получите общий идентификатор WABA с токеном доступа

После завершения процесса регистрации в системе, вы можете получить общий идентификатор WABA, используя возвращенный accessToken через Debug Token добавьте свой токен доступа системного пользователя в заголовок запроса, предварительно указав Authorization: Bearer Для этого вызова API

Синтаксис запроса

GEThttps://graph.facebook.com/​?input_token=<TOKEN_RETURNED_FROM_SIGNUP_FLOW>

Образец запроса

curl \
'https://graph.facebook.com/v25.0/debug_token?input_token=EAAFl...' \
-H 'Авторизация: Bearer EAAJi...'

Пример ответа

{ "data" : { "app_id" : "670843887433847", "application" : "JaspersMarket", "data_access_expires_at" : 1672092840, "expires_at" : 1665090000, "granular_scopes" : [ { "scope" : "whatsapp_business_management", "target_ids" : [ "102289599326934", // ID новейшего WABA для предоставления приложению доступа whatsapp_business_management "101569239400667" ] }, { "scope" : "whatsapp_business_messaging", "target_ids" : [ "102289599326934", "101569239400667" ] } ], "is_valid" : true, "scopes" : [ "whatsapp_business_management", "whatsapp_business_messaging", "public_profile" ], "type" : "USER", "user_id" : "10222270944537964" } }
Каждый объект в granular_scopes идентифицирует идентификаторы всех WABA, предоставивших вашему приложению определенное разрешение (область действия). Идентификаторы последних подключенных WABA отображаются первыми, поэтому target_ids для whatsapp_business_management .
Получить список общих WABA
client_whatsapp_business_accounts . получает список всех учетных записей WABA, назначенных вашей учетной записи Business Manager или предоставленных ей
Вы можете периодически использовать эту конечную точку для отслеживания отправленных вам WABA-токенов. Таким образом, вы сможете увидеть разницу и найти те, которые были отправлены вам недавно, в качестве запасного варианта к использованию конечной точки Debug-Token, описанной в руководстве по управлению бизнес-аккаунтом WhatsApp.
Список полей WABA, которые можно запросить через эту конечную точку, можно найти в справочнике по бизнес-аккаунту WhatsApp.
Синтаксис запроса
GEThttps://graph.facebook.com/​
Образец запроса
curl \
'https://graph.facebook.com/v25.0/805021500648488/client_whatsapp_business_accounts/' \
-H 'Авторизация: Bearer EAAJi...'
Пример ответа
{ "data": [ { "id": 1906385232743451, "name": "Мой бизнес-аккаунт WhatsApp", "currency": "USD", "timezone_id": "1", "message_template_namespace": "abcdefghijk_12lmnop" }, { "id": 1972385232742141, "name": "Мой региональный аккаунт", "currency": "INR", "timezone_id": "5", "message_template_namespace": "12abcdefghijk_34lmnop" }, ], "paging": { "cursors": { "before": "abcdefghij", "after": "klmnopqr" } } }
Понимание общих WABAs
Разрешения
Партнер по решениям имеет следующие права доступа в общей WABA-памяти:
    Добавить номера телефоновСоздать шаблоныОтправляйте сообщения клиентамНазначьте пользователей учетной записиПоказатели доступаПросмотреть информацию об оплате
    Со своей стороны, компании, осуществляющие регистрацию через встроенную систему регистрации, могут видеть и/или делать следующее:
    
Категория

Что могут увидеть предприятия?

    Аналитические выводы
    Изменения в состоянии обмена сообщениями, стоимости и качества.
    Качество
    Статусы и рейтинги качества.
    
Категория

Что могут сделать предприятия?

    Ресурсы
    Добавляйте и управляйте номерами телефонов и шаблонами.
    Управление WABA
    Отмените доступ к WABA для партнера по решениям, удалите WABA и измените настройки.
    Интеграция с другими продуктами Meta
    Интегрируйте с рекламой, которая переходит по ссылкам в WhatsApp.
    Партнеры по решениям не могут отключить доступ компаний к информации, которую они могут видеть или выполнять, а также настроить параметры отображения этой информации.
    компании могут ознакомиться Управление разрешениями вашего партнера по решениям WhatsApp»« Для получения более подробной информации
    Уведомления
    Партнеры по решениям получают соответствующие уведомления через веб-хуки и через Business Manager. Уведомления отправляются в следующих случаях:
      Компания владеет акциями WABA.Ограничения на количество сообщений или изменения в рейтинге качества для WABA клиента.Когда имя, отображаемое в номере телефона, или шаблон утверждены.
      Если компания прервет процесс регистрации в рамках встроенной системы до его успешного завершения, возможно, она предоставила WABA-сертификат, но сертификат телефонного номера может быть не готов, что означает невозможность регистрации номера для использования API. В этом случае, пожалуйста, свяжитесь с компанией, чтобы помочь ей завершить процесс регистрации в рамках встроенной системы.
      Получите список принадлежащих вам бизнес-аккаунтов WhatsApp
      Используйте owned_whatsapp_business_accounts , чтобы получить список учетных записей WABA, принадлежащих вашей компании. Для запроса используйте токен доступа системного пользователя.
      Синтаксис запроса
      GEThttps://graph.facebook.com/​
      Образец запроса
      curl \
'https://graph.facebook.com/v25.0/805021500648488/owned_whatsapp_business_accounts/' \
-H 'Авторизация: Bearer EAAJi...'
      Пример ответа
      { "data": [ { "id": 1906385232743451, "name": "Мой бизнес-аккаунт WhatsApp", "currency": "USD", "timezone_id": "1", "message_template_namespace": "abcdefghijk_12lmnop" }, { "id": 1972385232742141, "name": "Мой региональный аккаунт", "currency": "INR", "timezone_id": "5", "message_template_namespace": "12abcdefghijk_34lmnop" }, ], "paging": { "cursors": { "before": "abcdefghij", "after": "klmnopqr" } } }
      Фильтрация WABA-файлов по времени создания
      Вы можете фильтровать личные и собственные бизнес-аккаунты WhatsApp по времени их создания. Для запроса используйте параметры, перечисленные ниже.
      Синтаксис запроса
      GEThttps://graph.facebook.com/​?фильтрация=<ФИЛЬТРАЦИЯ>
      значения для фильтрации может выступать массив, содержащий один объект, включающий следующие свойства:
      Фильтрация свойств объекта
      
Имя

Описание

      поле
      Содержит поле, используемое для фильтрации. Установите значение creation_time.
      оператор
      Указывает, как вы хотите отфильтровать учетные записи. Поддерживаемые значения:

        МЕНЬШЕ, ЧЕМБОЛЬШЕ_ЧЕМ
        ценить
        Временная метка UNIX, которая будет использоваться при фильтрации.
        Пример объекта
        [ { "field" : "creation_time", "operator" : "GREATER_THAN", "value" : "1604962813" } ]
        Образец запроса
        curl \
'https://graph.facebook.com/v25.0/805021500648488/owned_whatsapp_business_accounts' \
-H 'Авторизация: Bearer EAAJi...' \
-H 'Тип содержимого: application/json' \
-d '[{"field":"creation_time","operator":"GREATER_THAN","value":"1604962813"}]'
        Пример ответа
        {"data":[{"id":“12312321312”,"name":"test","currency":"USD","timezone_id":"1","message_template_namespace":"46fe_814"}],"paging":{"cursors":{"before":"QVFIUm9","after":"QVFIUklX"},"next":"https://graph.facebook.com/v25.0/" } }
        Сортировать файлы WABA по времени создания
        Вы можете сортировать общие и собственные бизнес-аккаунты WhatsApp в зависимости от времени их создания.
        Синтаксис запроса
        GEThttps://graph.facebook.com/​?сортировка=<СОРТИРОВКА>
        В качестве параметра сортировки может использоваться значение creation_time_ascending или creation_time_descending.
        Образец запроса
        curl \
'https://graph.facebook.com/v25.0/805021500648488/owned_whatsapp_business_accounts?sort=creation_time_ascending' \
-H 'Авторизация: Bearer EAAJi...'
        Пример ответа
        { "data": [ { "id": 1906385232743451, "name": "Мой бизнес-аккаунт WhatsApp", "currency": "USD", "timezone_id": "1", "message_template_namespace": "abcdefghijk_12lmnop" }, { "id": 1972385232742141, "name": "Мой региональный аккаунт", "currency": "INR", "timezone_id": "5", "message_template_namespace": "12abcdefghijk_34lmnop" }, ], "paging": { "cursors": { "before": "abcdefghij" "after": "klmnopqr" } } }
        Узнать статус проверки WABA
        Чтобы узнать статус проверки аккаунта WhatsApp Business, запросите account_review_status .
        Синтаксис запроса
        GEThttps://graph.facebook.com/​?fields=account_review_status
        Образец запроса
        curl \
'https://graph.facebook.com/v25.0/106526625562206?fields=account_review_status' \
-H 'Авторизация: Bearer EAAJi...' \
        Пример ответа
        { "account_review_status": "APPROVED", "id": "1111111111111" }
        Свойство account_review_status может принимать одно из следующих значений: PENDING, APPROVEDи REJECTED.
        См. также
          API для управления бизнесом через WhatsAppСсылка: БизнесСсылка: Бизнес-аккаунт WhatsApp
          
    
                  
          
    
          

            
          
        
          
    
          

    
          

    
    
          
        
          
             Вернуться наверх