Научитесь правильно использовать функцию:

Описание

Модерация Telegram чата: удаление сообщений, блокировка пользователей, автоматическое удаление уведомлений. Функция позволяет осуществлять модерацию в Telegram чатах и каналах: массовое удаление сообщений и блокировка пользователей с различными настройками.

Параметры функции

Параметры, которые можно передать в функцию telegram_bot_moderator_v3:
tg_bot_token - Токен Telegram бота для доступа к API. Обязательный параметр для авторизации.
tg_chat_id - ID чата/канала где производится модерация. Может быть числовым ID или @username. Обязательный параметр.
messages_id - Список ID сообщений для удаления, разделенных запятыми (например: '123,456,789'). Обязателен если не указан tg_user_id + mute_duration.
tg_user_id - ID пользователя для блокировки. Обязателен вместе с mute_duration если не указан messages_id.
mute_duration - Длительность блокировки в минутах. Обязателен вместе с tg_user_id. 0 = навсегда, максимальное значение 525600 минут.
message_authors - Словарь ID сообщений и ID их авторов: {message_id: user_id} или {'message_id': user_id}.
auto_delete_seconds - Автоудаление уведомления о блокировке через N секунд (от 1 до 3600).
skip_system_messages - Пропускать системные сообщения Telegram, по умолчанию true.
system_user_ids - ID системных пользователей для пропуска, по умолчанию [777000, 136817688].
skip_admins - Пропускать сообщения администраторов, по умолчанию true.
skip_bots - Пропускать сообщения от ботов, по умолчанию true.
reason - Причина блокировки, по умолчанию 'Нарушение правил', максимальная длина 200 символов.
notification_message - Кастомное уведомление о блокировке, максимальная длина 4096 символов.
batch_size - Размер пакета для обработки сообщений, по умолчанию 10 (от 1 до 50).
request_delay - Задержка между запросами к API в секундах, по умолчанию 0.1 (от 0.05 до 5.0).
max_retries - Максимум повторных попыток при ошибках API, по умолчанию 3 (от 0 до 10).

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

"Удали сообщения с ID 123,456,789 в чате @my_chat используя токен бота 123456:ABCdef"
"Заблокируй пользователя с ID 987654321 в канале -100123456789 на 60 минут за спам"
"Очисти чат от сообщений пользователя 555666777, пропуская системные сообщения и администраторов"
"Удали пакет сообщений с задержкой 0.2 секунды между запросами и размером пакета 15 сообщений"

Кейсы