Перейти к содержанию

SetChatAdmins#

Метод предназначен для назначения или обновления прав администраторов в группе.

Запрос#

Поля запроса#

Поле	Тип	Обязательный	Описание
`chat_id`	integer	Да	ID чата
`admins`	array	Да	Массив администраторов для назначения
`marker`	integer	Нет	Маркер пагинации (если требуется API)

Поля объекта `ChatAdmin`#

Поле	Тип	Обязательный	Описание
`user_id`	integer	Да	Идентификатор пользователя-участника чата, который назначается администратором Максимум — 50 администраторов в чате
`permissions`	array	Да	Перечень прав доступа пользователя. Возможные значения:
			`read_all_messages` - Читать все сообщения. Это право важно при назначении ботов: без него бот не будет получать апдейты (вебхуки) в групповом чате
			`add_remove_members` - Добавлять/удалять участников
			`add_admins` - Добавлять администраторов
			`change_chat_info` - Изменять информацию о чате
			`pin_message` - Закреплять сообщения
			`write` - Писать сообщения
			`can_call` - Совершать звонки
			`edit_link` - Изменять ссылку на чат
			`post_edit_delete_message` - Публиковать, редактировать и удалять сообщения
			`edit_message` - Редактировать сообщения
			`delete_message` - Удалять сообщения
`alias`	string	Нет	Заголовок, который будет показан на клиенте. Если пользователь администратор или владелец и ему не установлено это название, то поле не передаётся, клиенты на своей стороне подменят на "владелец" или "админ"

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

GolangPython

response, err := bot.Chats.SetChatAdmins(ctx, &models.SetChatAdminsReq{
    ChatID: 123456789,
    Admins: []models.ChatAdmin{
        {
            UserID: 55555, 
            Permissions: "read_all_messages", "write"
        },
        {
            UserID: 66666, 
            Permissions: "read_all_messages", "post_edit_delete_message"
        },
    },
})

Синхронный метод:

bot.chats.SetChatAdmins(SetChatAdminsReq(
    chat_id=123456789,
    admins={
        {
            user_id=55555, 
            permissions=["read_all_messages", "write"]
        },
        {
            user_id=66666, 
            permissions=["read_all_messages", "post_edit_delete_message"]
        },
    },
))

Асинхронный метод:

await bot.chats.SetChatAdminsAsync(SetChatAdminsReq(
    chat_id=123456789,
    admins={
        {
            user_id=55555, 
            permissions=["read_all_messages", "write"]
        },
        {
            user_id=66666, 
            permissions=["read_all_messages", "post_edit_delete_message"]
        },
    },
))

Ответ#

Поля ответа#

Поле	Тип	Описание
`success`	boolean	Флаг успешного выполнения операции
`message`	string	Объяснительное сообщение, если результат не был успешным

Пример тела ответа#

{
    "success": true
}