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

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

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

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

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

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

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

GET https://graph.facebook.com/ ​/debug_token ? 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 отображаются первыми, поэтому для  whatsapp_business_management  target_ids .
Получить список общих WABA
 client_whatsapp_business_accounts получает список всех учетных записей WABA, назначенных вашей учетной записи Business Manager или предоставленных ей .
Вы можете периодически использовать эту конечную точку для отслеживания отправленных вам WABA-токенов. Таким образом, вы сможете увидеть разницу и найти те, которые были отправлены вам недавно, в качестве запасного варианта к использованию конечной точки Debug-Token, описанной в руководстве по управлению бизнес-аккаунтом WhatsApp .
Список полей WABA, которые можно запросить через эту конечную точку, можно найти в справочнике по бизнес-аккаунту WhatsApp .
Синтаксис запроса
GET https://graph.facebook.com/ ​/ /client_whatsapp_business_accounts
Образец запроса
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, принадлежащих вашей компании. Для запроса используйте токен доступа системного пользователя.
      Синтаксис запроса
      GET https://graph.facebook.com/ ​/ /owned_whatsapp_business_accounts
      Образец запроса
      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 по времени их создания. Для запроса используйте параметры, перечисленные ниже.
      Синтаксис запроса
      GET https://graph.facebook.com/ ​/ /owned_whatsapp_business_accounts ? filtering =< FILTERING >
       значения для фильтрации может выступать массив, содержащий один объект, включающий следующие свойства:
      Фильтрация свойств объекта
      
Имя

Описание

      поле
      Содержит поле, используемое для фильтрации. Установите значение 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 в зависимости от времени их создания.
        Синтаксис запроса
        GET https://graph.facebook.com/ ​/ /owned_whatsapp_business_accounts ? sort =< SORT >
        В качестве параметра сортировки может использоваться значение 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 .
        Синтаксис запроса
        GET https://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
          
    
                  
          
    
          

            
          
        
          
    
          

    
          

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