Назначить администратора группового чата или канала

POST/chats/{chatId}/members/admins

Выдаёт пользователям и ботам, которые являются участникам чата или подписчикам канала, права администратора

Бот, чей токен access_token используется для авторизации, должен быть администратором этого чата или канала с соответствующим правом add_admins. Чтобы получить информацию о правах бота, используйте GET /chats/-chatId-/members/admins

Права, которые можно назначить, зависят от того, где (канал или чат) и кому (пользователь или бот) выданы

Список прав передаётся в теле запроса в массиве admins.permissions. Если вы хотите изменить назначенные права, вызовите повторно текущий метод: в теле запроса передайте обновлённый список прав. При повторном вызове логика работы метода соответствует PUT: права администратора будут обновлены полностью в соответствии с переданными в запросе

Пример запроса:

BASH

Скопировать

curl -X POST "https://platform-api.max.ru/chats/{chatId}/members/admins" \
  -H "Authorization: {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
  "admins": [
    {
      "user_id": "{user_id}",
      "permissions": [
        "read_all_messages",
        "add_remove_members",
        "add_admins",
        "change_chat_info",
        "pin_message",
        "write"
      ],
      "alias": "администраторам"
    }
  ]
}'

Доступные права администратора

read_all_messages — читать все сообщения в канале или групповом чате. Право можно назначить пользователям и ботам. Без этого права не получится управлять сообщениями: закреплять (pin_message), редактировать и удалять посты в каналах (edit и delete) и групповых чатах (write). Также это право важно при назначении ботов: без него тот не будет получать обновления через Webhook. Управление read_all_messages в интерфейсе мессенджера доступно только для ботов в групповых чатах
edit — редактировать посты в каналах (для групповых чатов недоступно). Право можно назначить пользователям и ботам, только если уже есть право read_all_messages или вместе с ним — иначе вернётся ошибка. Ранее вместо edit в API использовалось edit_message — в ответе могут возвращаться оба значения, однако при назначении новых прав администраторов используйте edit. Управление edit также дублируется в интерфейсе мессенджера
delete — удалять посты (для групповых чатов недоступно). Право можно назначить пользователям и ботам, только если уже есть право read_all_messages или вместе с ним — иначе вернётся ошибка. Ранее вместо delete в API использовалось delete_message — в ответе могут возвращаться оба значения, однако при назначении новых прав администраторов используйте delete. Управление delete также дублируется в интерфейсе мессенджера
write — редактировать и удалять сообщения в групповых чатах, а также писать посты в каналах. Право можно назначить пользователям и ботам, только если уже есть право read_all_messages или вместе с ним — иначе вернётся ошибка. Ранее вместо write в API использовалось post_edit_delete_message — в ответе могут возвращаться оба значения, однако при назначении новых прав администраторам используйте write. Управление write также дублируется в интерфейсе мессенджера
pin_message — закреплять сообщение. Право можно назначить пользователям и ботам, только если уже есть право read_all_messages или вместе с ним — иначе вернётся ошибка
change_chat_info — изменять информацию о канале или групповом чате. Право доступно для пользователей и ботов
add_remove_members — добавлять и удалять участников группового чата или подписчиков канала. Право доступно для пользователей и ботов. Управление add_remove_members также дублируется в интерфейсе мессенджера
add_admins — добавлять и удалять администраторов группового чата или канала. Право доступно для пользователей и ботов. Управление add_admins дублируется в интерфейсе мессенджера
edit_link — изменять ссылку на групповой чат (для каналов недоступно). Право есть для пользователей и ботов. Управление edit_link также дублируется в интерфейсе мессенджера
can_call — звонить в групповом чате (для каналов недоступно). Право есть у пользователей и ботов — проставляется автоматически при назначении администратором. Управление can_call в интерфейсе мессенджера не дублируется
view_stats — право на просмотр статистики каналов (для групповых чатов недоступно). Назначается по умолчанию владельцам каналов. Для других пользователей-администраторов канала и ботов недоступно. Управление view_stats в интерфейсе мессенджера не дублируется

Авторизация

access_token
apiKey

Передача токена через query-параметры больше не поддерживается — используйте заголовок Authorization: <token>

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на платформе в разделе Чат-боты → Перейти → Расширенные настройки → Настроить

Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом. Токен может быть отозван за нарушение Правил платформы

Параметры

chatId
integer <int64>
\-?\d+

ID группового чата или канала

Тело запроса

admins
ChatAdmin[]

Список пользователей и ботов, которые получат права администратора группового чата или канала

marker
integer <int64> Nullable optional

Указатель на следующую страницу данных

Результат

success
boolean

true, если запрос был успешным, false — в противном случае

message
string optional

Объяснительное сообщение, если результат не был успешным