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

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

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

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

    Забрать System User IDs

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

    Запрос

    локон-XПОЛУЧАТЬ"https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_ACCOUNT_ID>/system_users
      ?access_token=<SYSTEM_USER_ACCESS_TOKEN>"
    To find the ID of a business, go to Business Manager > Настройки бизнеса > Business Info. There, you will see information about the business, including the ID.

    Ответ

    {
    "данные": [
        {
    "идентификатор""1972555232742222",
    "имя""My System User",
    "role""EMPLOYEE"
        }
      ]
    }

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

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

    Запрос синтаксис

    В следующем примере используйте идентификатор назначенного WABA.
    curl -i -X POST "https://graph.facebook.com/<API_VERSION>/<Идентификатор бизнес-аккаунта WhatsApp>/assigned_users
      ?user=<ASSIGNED_USER_ID>
      &tasks=['<ASSIGNED_USERS_TASKS_AND_PERMISSIONS>']
      &access_token=<SYSTEM_USER_ACCESS_TOKEN>"
    To find the ID of a WhatsApp Business Account, go to Business Manager > Настройки бизнеса > Accounts > Бизнес-аккаунты WhatsApp. Find the account you want to use and click on it. A panel opens, with information about the account, including the ID.
    For the <ASSIGNED_USER_ID>, use the system user ID returned from your /<WHATSAPP_BUSINESS_ACCOUNT_ID>/system_users вызов.

    Разрешения

    Имя Описание
    УПРАВЛЯТЬ
    Предоставляет административный доступ.
    Пользователи могут иметь административный доступ к бизнес-аккаунту 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 }

      Забрать assigned users

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

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

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

      Ответ

      {
      "данные": [
          {
      "идентификатор""1972385232742142",
      "имя""Anna Flex",
      "tasks": [
      "УПРАВЛЯТЬ"
            ]
          },
          {
      "идентификатор""1972385232752545",
      "имя""Jasper Brown",
      "tasks": [
      "РАЗВИВАТЬ"
            ]
          }
        ]
      }

      См. также

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