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

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

Управление пользователями системы

Обновлено: 14 ноября 2025 г
Добавление системного пользователя к общим бизнес-аккаунтам WhatsApp позволяет программно управлять этими аккаунтами. В этом руководстве мы рассмотрим действия, которые могут потребоваться поставщикам бизнес-услуг для управления системными пользователями.
    Для получения помощи по созданию системного пользователя см. раздел «Системные пользователи», «Создание, получение и обновление системного пользователя» .Для получения помощи в создании токена доступа системного пользователя см. разделы «Системные пользователи», «Установка приложений» и «Создание токенов» .

    Получение идентификаторов системных пользователей

    Вы можете сохранить идентификаторы системных пользователей в кэше для дальнейшего использования.

    Запрос

    curl
    -i -X ​​GET "https://graph.facebook.com/ / P_BUSINESS_ACCOUNT_ID>/system_users ?access_token= "
    Чтобы найти идентификатор компании, перейдите в «Управление бизнесом» > « Настройки бизнеса» > «Информация о бизнесе» . Там вы увидите информацию о компании, включая её идентификатор.

    Ответ

    {
    "data"
    : [ {
    "id"
    : "1972555232742222" , "name"
    : "My System User" , "role"
    : "EMPLOYEE" }
    ]
    }

    Добавление системных пользователей в бизнес-аккаунт WhatsApp

    Для выполнения этого вызова API необходимо использовать токен доступа системного пользователя с правами администратора .

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

    В следующем примере используйте идентификатор назначенного WABA.
    curl -i -X ​​POST "https://graph.facebook.com/
    < API_VERSION > / < WHATSAPP_BUSINESS_ACCOUNT_ID > /assigned_users ?user=
    < ASSIGNED_USER_ID > &tasks=['
    < ASSIGNED_USERS_TASKS_AND_PERMISSIONS > '] &access_token=
    < SYSTEM_USER_ACCESS_TOKEN > "
    Чтобы найти идентификатор бизнес-аккаунта WhatsApp, перейдите в «Диспетчер бизнеса » > «Настройки бизнеса» > «Аккаунты» > «Бизнес-аккаунты WhatsApp» . Найдите нужный аккаунт и нажмите на него. Откроется панель с информацией об аккаунте, включая его идентификатор.
    Для Используйте идентификатор системного пользователя, полученный из вашего / /system_users call .

    Разрешения

    Имя Описание
    УПРАВЛЯТЬ
    Предоставляет административный доступ.
    Пользователи могут иметь административный доступ к бизнес-аккаунту WhatsApp, предоставленный с правами администратора.
    Примечание: Если вы являетесь партнером по решениям и пытаетесь добавить пользователя в бизнес-аккаунт WhatsApp, предоставленный вам через многопартнерское решение , вам необходимо учесть следующие сценарии:
      Если вам не предоставлено на отправку сообщений в рамках решения, вам необходимо определить, какие именно задачи вам нужны при добавлении пользователя в общий бизнес-аккаунт WhatsApp: DEVELOP , MANAGE_TEMPLATES , MANAGE_PHONE , VIEW_COST , MANAGE_EXTENSIONS , VIEW_PHONE_ASSETS , MANAGE_PHONE_ASSETS , VIEW_TEMPLATES , VIEW_INSIGHTS , MANAGE_USERS , MANAGE_BILLING .В подобной ситуации также следует отметить, что параметр MANAGE_BILLING необходим для распределения кредитной линии.Функция «Управление» будет работать только при наличии полного доступа к решению, включая функцию обмена сообщениями .
      РАЗВИВАТЬ
      Предоставляет доступ для разработчиков. Пользователи могут получить доступ для разработчиков к бизнес-аккаунту WhatsApp, который имеет стандартные права доступа.

      Ответ

      {
      "success"
      : true }

      Получить назначенных пользователей

      Вы можете получить список пользователей, добавленных в бизнес-аккаунт WhatsApp, чтобы убедиться, что пользователь был добавлен. Это необязательный шаг, но он помогает в проверке.

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

      В следующем примере используйте идентификатор назначенного WABA.
      curl -i -X ​​GET "https://graph.facebook.com/
      < API_VERSION > / < WHATSAPP_BUSINESS_ACCOUNT_ID > /assigned_users ?business=
      < WHATSAPP_BUSINESS_ACCOUNT_ID > &access_token=
      < SYSTEM_USER_ACCESS_TOKEN > "

      Ответ

      {
      "data"
      : [ {
      "id"
      : "1972385232742142" , "name"
      : "Anna Flex" , "tasks"
      : [ "MANAGE"
      ]
      },
      {
      "id"
      : "1972385232752545" , "name"
      : "Jasper Brown" , "tasks"
      : [ "DEVELOP"
      ]
      }
      ]
      }

      См. также

        Ссылка: Бизнес-аккаунт WhatsApp