Управление пользователями системы | Документация для разработчиков
Управление пользователями системы
Обновлено: 14 ноября 2025 г
Добавление системного пользователя к общим бизнес-аккаунтам WhatsApp позволяет программно управлять этими аккаунтами. В этом руководстве мы рассмотрим действия, которые могут потребоваться поставщикам бизнес-услуг для управления системными пользователями.
Получение идентификаторов системных пользователей
Вы можете сохранить идентификаторы системных пользователей в кэше для дальнейшего использования.
Запрос
curl-i-XGET"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». Найдите нужный аккаунт и нажмите на него. Откроется панель с информацией об аккаунте, включая его идентификатор.
Для
<ASSIGNED_USER_ID>Используйте идентификатор системного пользователя, полученный из вашего / вызов.Разрешения
| Имя | Описание |
|---|---|
УПРАВЛЯТЬ | Предоставляет административный доступ. Пользователи могут иметь административный доступ к бизнес-аккаунту 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"
]
}
]
}