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

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

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

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

    Забрать Идентификаторы системных пользователей

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

    Запрос

    локон-XПОЛУЧАТЬ"https://graph.facebook.com/<API_VERSION> /P_BUSINESS_ACCOUNT_ID>/system_users
      ?access_token=<SYSTEM_USER_ACCESS_TOKEN> "
    Чтобы найти идентификационный номер компании, перейдите по ссылке: Менеджер по бизнесу > Настройки бизнеса > Информация о бизнесеТам вы найдете информацию о компании, включая идентификационный номер.

    Ответ

    {
    "данные": [
        {
    "идентификатор""1972555232742222",
    "имя""Мой системный пользователь",
    "роль""СОТРУДНИК"
        }
      ]
    }

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

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

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

    В следующем примере используйте идентификатор назначенного WABA.
    curl -i -X ​​POST "https://graph.facebook.com/<API_VERSION>/<Идентификатор бизнес-аккаунта WhatsApp>/assigned_users
      ?user=<ASSIGNED_USER_ID>
      &tasks=['<НАЗНАЧЕННЫЕ_ПОЛЬЗОВАТЕЛЯМ_ЗАДАЧИ_И_РАЗРЕШЕНИЯ>']
      &access_token=<SYSTEM_USER_ACCESS_TOKEN>"
    Чтобы найти идентификатор бизнес-аккаунта WhatsApp, перейдите по ссылке: Менеджер по бизнесу > Настройки бизнеса > Счета > Бизнес-аккаунты WhatsAppНайдите нужную учетную запись и щелкните по ней. Откроется панель с информацией об учетной записи, включая ее идентификатор.
    Для <ASSIGNED_USER_ID>используйте идентификатор системного пользователя, полученный от твой /<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
      }

      Забрать назначенных пользователей

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

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

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

      Ответ

      {
      "данные": [
          {
      "идентификатор""1972385232742142",
      "имя""Анна Флекс",
      "задачи": [
      "УПРАВЛЯТЬ"
            ]
          },
          {
      "идентификатор""1972385232752545",
      "имя""Джаспер Браун",
      "задачи": [
      "РАЗВИВАТЬ"
            ]
          }
        ]
      }

      См. также

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