RestrictChatMember

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

Назначение

Позволяет временно или постоянно ограничить возможности участника: запретить отправку определённых типов сообщений, приглашение новых участников, изменение информации о чате и т.д.

Параметры

Права (разрешения)

Все параметры прав имеют тип Boolean и являются опциональными.

Отправка сообщений

Управление чатом

⚠️ Важно: Если параметр не указан, он считается запрещённым (false). Чтобы разрешить действие, установите параметр в true.

Параметр use_independent_chat_permissions

Передайте значение true, если разрешения чата установлены независимо. В противном случае разрешения can_send_other_messages и can_add_web_page_previews будут подразумевать разрешения:

• can_send_messages
• can_send_audios
• can_send_documents
• can_send_photos
• can_send_videos
• can_send_video_notes
• can_send_voice_notes

Разрешение can_send_polls будет подразумевать разрешение can_send_messages.

📅 Формат until_date

Параметр until_date принимает Unix timestamp (количество секунд с 1 января 1970 года).

Как получить значение:

💡 Совет: Если until_date меньше текущего времени или равен 0, ограничение считается бессрочным.

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

⚠️ Важно: Без права can_restrict_members реакция вызовет ошибку.

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

Пример 1: Бессрочное ограничение (только текст)

Задача: Разрешить пользователю отправлять только текстовые сообщения, запретить всё остальное.

Параметры RestrictChatMember:

• chat_id: ${chat.id}
• user_id: ${user.id}
• can_send_messages: true
• (остальные права не указаны — false по умолчанию)

Пример 2: Временное ограничение на 1 час

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

Параметры RestrictChatMember:

• chat_id: ${chat.id}
• user_id: ${user.id}
• until_date: !{time|value:now; plus:1h; output_format:unix}
• can_send_photos: false
• can_send_videos: false
• can_send_audios: false
• can_send_documents: false
• can_send_voice_notes: false
• can_send_video_notes: false

Пример 3: Полная блокировка отправки сообщений (только чтение)

Задача: Запретить пользователю отправлять любые сообщения на 7 дней.

Параметры RestrictChatMember:

• chat_id: ${chat.id}
• user_id: ${user.id}
• until_date: !{time|value:now; plus:7d; output_format:unix}
• can_send_messages: false
• can_send_other_messages: false

Пример 4: Разрешить только текстовые сообщения и ссылки

Задача: Пользователь может писать текст и вставлять ссылки, но не может отправлять медиа.

Параметры RestrictChatMember:

• chat_id: ${chat.id}
• user_id: ${user.id}
• can_send_messages: true
• can_add_web_page_previews: true
• can_send_photos: false
• can_send_videos: false
• can_send_audios: false
• can_send_documents: false
• can_send_voice_notes: false
• can_send_video_notes: false

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

⚠️ Частые ошибки и их решение

Ошибка 1: Ограничение не применяется

Причина: Бот не является администратором чата или у него нет права can_restrict_members.

Решение: Добавьте бота в администраторы чата и убедитесь, что у него есть право ограничивать участников.

Ошибка 2: Неверный формат until_date

Причина: Вместо Unix timestamp передана строка или дата в другом формате.

Решение: Используйте макрос !{time} с output_format: unix для получения правильного формата.

Ошибка 3: Ограничения снимаются слишком рано

Причина: until_date был установлен в прошлом или указано неверное значение.

Решение: Проверьте, что until_date больше текущего времени. Используйте макрос !{time} для вычисления.

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

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

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

restrictChatMember — Telegram Bot API