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

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

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

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

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

После завершения компанией встроенного процесса регистрации вы можете получить общий идентификатор WABA, используя возвращенный результат accessToken с Отладочный токен конечная точка. Укажите ваш Токен доступа системного пользователя в заголовке запроса, которому предшествует Авторизация: Предъявитель для этого вызова API.

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

ПОЛУЧИТЬ https://graph.facebook.com/<API_VERSION> /debug_token?входной_токен=<TOKEN_RETURNED_FROM_SIGNUP_FLOW>

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

curl \
'https://graph.facebook.com/v25.0/debug_token?input_token=EAAFl...' \
-ЧАС «Авторизация: Предъявитель 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" } }
Каждый объект в гранулярные_прицелы Массив содержит идентификаторы всех WABA, предоставивших вашему приложению определенное разрешениеобъемИдентификаторы недавно подключенных WABA отображаются первыми, поэтому зафиксируйте первый идентификатор в списке target_ids массив для whatsapp_business_management объем.
Получить список общих WABA
Он клиентские бизнес-аккаунты WhatsApp После завершения процесса регистрации конечная точка получает список всех устройств WABA, назначенных вашей учетной записи Business Manager или используемых совместно с ней.
Вы можете периодически использовать этот конечный пункт для отслеживания отправленных вам файлов WABA. Таким образом, вы сможете увидеть разницу и найти те, которые были отправлены вам недавно, в качестве резервного варианта Конечная точка Debug-Token подход, описанный в Руководство по управлению бизнес-аккаунтом WhatsApp.
Список полей WABA, которые можно запросить через эту конечную точку, можно найти в Ссылка на бизнес-аккаунт WhatsApp.
Синтаксис запроса
ПОЛУЧИТЬ https://graph.facebook.com/<API_VERSION> /<BUSINESS_MANAGER_ACCOUNT_ID> /client_whatsapp_business_accounts
Образец запроса
curl \
'https://graph.facebook.com/v25.0/805021500648488/client_whatsapp_business_accounts/' \
-ЧАС «Авторизация: Предъявитель 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 ПартнерПартнерs Разрешения⁠? для получения дополнительной информации.
    

    

    

    

    Уведомления
    

    Партнеры по решениям получают соответствующие уведомления через веб-хуки и через Business Manager. Уведомления отправляются в следующих случаях:
    

      Компания владеет акциями WABA.Ограничения на количество сообщений или изменения в оценке качества для клиентклиентс WABA.Когда имя, отображаемое в номере телефона, или шаблон утверждены.

      Если компания прервет процесс регистрации в рамках встроенной системы до его успешного завершения, она может поделиться ссылкой WABA, но при этом сохранить номер телефона число'число'Сертификат может быть не готов, что означает, что номер не может быть зарегистрирован для использования API. В этом случае, пожалуйста, свяжитесь с компанией, чтобы помочь им завершить встроенный процесс регистрации.
      

      

      

      Получать
Список принадлежащих мне бизнес-аккаунтов WhatsApp
      Используйте собственные бизнес-аккаунты WhatsApp Эталонная точка для получения списка WABA-серверов, принадлежащих вашей компании. Для запроса используйте токен доступа системного пользователя.
      Синтаксис запроса
      ПОЛУЧИТЬ https://graph.facebook.com/<API_VERSION> /<BUSINESS_MANAGER_ACCOUNT_ID> /owned_whatsapp_business_accounts
      Образец запроса
      curl \
'https://graph.facebook.com/v25.0/805021500648488/owned_whatsapp_business_accounts/' \
-ЧАС «Авторизация: Предъявитель 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 по времени их создания. Для запроса используйте параметры, перечисленные ниже.
      Синтаксис запроса
      ПОЛУЧИТЬ https://graph.facebook.com/<API_VERSION> /<BUSINESS_MANAGER_ACCOUNT_ID> /owned_whatsapp_business_accounts?фильтрация=<ФИЛЬТРАЦИЯ>
      Он фильтрация Значение может представлять собой массив, содержащий один объект, состоящий из следующих свойств:
      Фильтрация свойств объекта
      
Имя

Описание

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

        МЕНЬШЕ, ЧЕМБОЛЬШЕ_ЧЕМ
        ценить
        Временная метка UNIX, которая будет использоваться при фильтрации.
        Пример объекта
        [ { "field" : "creation_time", "operator" : "GREATER_THAN", "value" : "1604962813" } ]
        Образец запроса
        curl \
'https://graph.facebook.com/v25.0/805021500648488/owned_whatsapp_business_accounts' \
-ЧАС «Авторизация: Предъявитель EAAJi...» \
-ЧАС 'Content-Type: application/json' \
-д '[{"field":"creation_time","operator":"GREATER_THAN","value":"1604962813"}]'
        Пример ответа
        {"данные":[{"идентификатор":“12312321312”,"имя":"тест","валюта":"ДОЛЛАР США","timezone_id":"1","message_template_namespace":"46fe_814"}],"пейджинг":{"курсоры":{"до":"QVFIUm9","после":"QVFIUklX"},"следующий":"https://graph.facebook.com/v25.0/“
  }
}
        Сортировать файлы WABA по времени создания
        Вы можете сортировать общие и собственные бизнес-аккаунты WhatsApp в зависимости от времени их создания.
        Синтаксис запроса
        ПОЛУЧИТЬ https://graph.facebook.com/<API_VERSION> /<BUSINESS_MANAGER_ACCOUNT_ID> /owned_whatsapp_business_accounts?сортировка=<СОРТИРОВАТЬ>
        Он сортировка значение может быть creation_time_ascending или creation_time_descending.
        Образец запроса
        curl \
'https://graph.facebook.com/v25.0/805021500648488/owned_whatsapp_business_accounts?sort=creation_time_ascending' \
-ЧАС «Авторизация: Предъявитель 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, отправив соответствующий запрос статус_отзыва_аккаунта поле.
        Синтаксис запроса
        ПОЛУЧИТЬ https://graph.facebook.com/<API_VERSION> /<WABA_ID>?поля=статус_отзыва_аккаунта
        Образец запроса
        curl \
'https://graph.facebook.com/v25.0/106526625562206?fields=account_review_status' \
-ЧАС «Авторизация: Предъявитель EAAJi...» \
        Пример ответа
        { "account_review_status": "APPROVED", "id": "1111111111111" }
        Он статус_отзыва_аккаунта Свойство может принимать одно из следующих значений: В ОЖИДАНИИ, ОДОБРЕННЫЙ, и ОТКЛОНЕННЫЙ.
        См. также
        

          API для управления бизнесом через WhatsAppСсылка: БизнесСсылка: Бизнес-аккаунт WhatsApp
          
    
                  
          
    
          

            
          
        
          
    
          

    
          

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