PromoteChatMember

PromoteChatMember — назначает пользователя администратором чата или изменяет его права.

📝 Назначение

Используется для управления администраторами групп и супергрупп. Позволяет:

• Назначить нового администратора
• Изменить права существующего администратора
• Лишить прав администратора (сняв все права)

💡 Совет: Чтобы лишить пользователя прав администратора, вызовите реакцию со всеми правами, установленными в false (или просто не передавайте их).

⚙️ Параметры

Основные права

Права на информацию и приглашения

Права на сообщения (только для каналов)

Права на управление контентом

🔐 Права бота

⚠️ Важно: Бот не может назначить администратора с правами, которых нет у самого бота. Например, если бот не может банить пользователей (can_restrict_members = false), он не сможет выдать это право другому администратору.

🧪 Примеры использования

Пример 1: Назначение нового администратора

Задача: Назначить пользователя администратором с базовыми правами.

Параметры PromoteChatMember:

• chat_id: ${chat.id}
• user_id: ${user.id}
• can_delete_messages: true
• can_restrict_members: true
• can_change_info: true
• can_invite_users: true

Пример 2: Назначение с полными правами (кроме назначения других)

Задача: Назначить администратора со всеми правами, кроме возможности назначать других.

Параметры PromoteChatMember:

• chat_id: ${chat.id}
• user_id: ${user.id}
• can_manage_chat: true
• can_delete_messages: true
• can_restrict_members: true
• can_change_info: true
• can_invite_users: true
• can_pin_messages: true
• can_promote_members: false

Пример 3: Лишение прав администратора

Задача: Снять с пользователя все права администратора (он становится обычным участником).

Параметры PromoteChatMember:

• chat_id: ${chat.id}
• user_id: ${user.id}
• (все права не указаны или указаны как false)

💡 Совет: Для снятия прав достаточно вызвать реакцию без указания каких-либо прав. Пользователь останется в чате, но потеряет администраторские привилегии.

Пример 4: Анонимный администратор

Задача: Назначить администратора, который будет скрыт от участников (его действия будут видны как «анонимный администратор»).

Параметры PromoteChatMember:

• chat_id: ${chat.id}
• user_id: ${user.id}
• is_anonymous: true
• can_delete_messages: true
• can_restrict_members: true

Пример 5: Назначение с правом назначать других

Задача: Назначить главного администратора, который может назначать других администраторов.

Параметры PromoteChatMember:

• chat_id: ${chat.id}
• user_id: ${user.id}
• can_promote_members: true
• (остальные права по необходимости)

⚠️ Важно: Бот должен сам иметь право can_promote_members, чтобы назначать администратора с этим правом.

📊 Иерархия прав

Некоторые права требуют наличия других прав:

💡 Совет: Для упрощения можно использовать can_manage_chat = true, что даёт большинство базовых прав.

🔄 Особенности поведения

🔗 Связанные реакции

🔗 Связанные разделы

🔗 Быстрая навигация

• Вверх
• Параметры
• Права бота
• Примеры
• Иерархия прав
• Особенности

🔗 Ссылка на официальную документацию

promoteChatMember — Telegram Bot API