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

SetChatAdmins#

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

Запрос#

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

GolangPythonTypeScript

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

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

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

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

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

const request: SetChatAdminsReq = {
    chat_id: 123456789,
    admins: {
        {
            user_id: 55555,
            permissions: ["read_all_messages", "write"]
        },
                    {
            user_id: 77777,
            permissions: ["read_all_messages", "post_edit_delete_message"]
        }
    }
}
const response = await bot.chats.setChatAdmins(request)

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

Поле	Тип	Обязательный	Описание
`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	Нет	Заголовок, который будет показан на клиенте. Если пользователь администратор или владелец и ему не установлено это название, то поле не передаётся, клиенты на своей стороне подменят на "владелец" или "админ"

Ответ#

Поля ответа#

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

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

{
    "success": true
}