BanChatMember

BanChatMember — блокирует пользователя в чате/канале.

📝 Назначение

Используется для модерации: блокировка нарушителей, автоматические баны по условиям, временная изоляция пользователя.

Эффект от блокировки:

• Пользователь не может отправлять сообщения
• Пользователь не может просматривать историю чата (если настроено соответствующим образом)
• При указании revoke_messages — история переписки группы будет скрыта для пользователя при повторном вступлении.

💡 Совет: Для снятия блокировки используйте реакцию UnBanChatMember.

⚙️ Параметры

📅 Формат until_date

Параметр принимает срок в том же формате, что «Динамическая отсрочка» отложенных действий. Макрос для этого не нужен — достаточно написать срок прямо в поле.

Единицы относительного срока: s — секунды, m — минуты, h — часы, d — дни. Можно и кириллицей: с, м, ч, д — например 1ч30м.

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

⚠️ Важно: Срок в прошлом реакция не примет — она завершится ошибкой, которая видна в логах бота.

⚠️ Ограничение Telegram: Срок короче 30 секунд или длиннее 366 дней Telegram считает блокировкой навсегда. Ошибки при этом не будет.

Если срок вычисляется макросом времени, подойдёт !{time|value:now; plus:1D; output_format:unix}. Учтите, что макрос при ошибке возвращает пустую строку, а пустой until_date означает блокировку навсегда.

🔐 Требуемые права бота

💡 Совет: Проверить права бота можно через реакцию GetChatMember для самого бота или в разделе /adm → Чаты/Каналы.

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

Пример 1: Бессрочная блокировка с удалением сообщений

Задача: Забанить пользователя навсегда и удалить все его сообщения.

Параметры BanChatMember:

• chat_id: ${chat.id}
• user_id: ${user.id}
• revoke_messages: true

Пример 2: Временная блокировка на 1 час

Задача: Забанить пользователя на 1 час без удаления сообщений.

Параметры BanChatMember:

• chat_id: ${chat.id}
• user_id: ${user.id}
• until_date: 1h

Пример 3: Блокировка на 7 дней с удалением сообщений

Задача: Забанить пользователя на неделю и удалить все его сообщения.

Параметры BanChatMember:

• chat_id: ${chat.id}
• user_id: ${user.id}
• until_date: 7d
• revoke_messages: true

Пример 4: Блокировка другого пользователя (администратор)

Задача: Администратор наказывает пользователя по команде /ban @username 2h.

Параметры BanChatMember:

• chat_id: ${chat.id}
• user_id: ${target_user.id} (извлечён из команды через TakeUser)
• until_date: 2h

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

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

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

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

banChatMember — Telegram Bot API