Автоматизируем модерацию в Telegram: Функция #482 и её боевое применение

Разберем мощный инструмент для автоматической чистки чатов и каналов — Функцию #482 (telegram_bot_moderator_v3). Расскажем не только о том, как она работает, но и о реальном кейсе её использования, который экономит деньги и нервы модераторов.

🤖 Что это за функция?

Это готовое решение для модерации, которое позволяет вашему боту:

*   Массово удалять сообщения по списку ID.

*   Блокировать пользователей на заданное время (или навсегда).

*   Автоматически удалять свои же уведомления о блокировке, чтобы не засорять чат.

*   Гибко настраивать фильтры: пропускать сообщения от админов, ботов и системных аккаунтов.

Обязательные параметры для запуска:

*   tg_bot_token — токен вашего бота.

*   tg_chat_id — ID чата или канала.

Что делаем? Удаляем сообщения ИЛИ блокируем пользователя.

*   Для удаления: обязателен параметр messages_id (список ID сообщений через запятую).

*   Для блокировки: обязательны tg_user_id и mute_duration (длительность в минутах; 0 = навсегда).

Ключевые опции для тонкой настройки:

*   auto_delete_seconds — через сколько секунд самоуничтожится уведомление от бота (чтобы чат был чистым).

*   skip_admins / skip_bots — не трогать сообщения администраторов и ботов (по умолчанию true).

*   message_authors — словарь {message_id: user_id}. Критически важен для корректной работы!

*   batch_size и request_delay — для обхода ограничений API Telegram при массовом удалении.

> ⚠️ Важно: Бот должен быть администратором чата с правами на удаление сообщений и блокировку участников.

💡 Кейс: Экономный и молчаливый модератор

Одна из главных проблем классических модераторов — они любят поговорить. На каждое удаление они могут отвечать развернуто: *«Ваше сообщение удалено по причине нарушения правила 4, пункт Б…»*.

В чем проблема?

1.  Тратит токены. Каждый такой ответ — это запрос к API, который стоит денег (особенно если используем GPT).

2.  Засоряет чат. Чат превращается в поток уведомлений от бота, который раздражает пользователей.

3.  Провоцирует споры. На такое сообщение прибегут жаловаться, спорить и устраивать холивары, которые тоже надо модерировать.

Наше решение:

Наш бот-модератор на основе Function #482 работает по принципу «Молчаливый санитар».

*   Нашел нарушение → мгновенно удалил → в ответ отправил лишь один символ: «🛑».

*   Никаких пояснений в чате. Это drastically снижает трафик и поддерживает чистоту.

Но мы добавили и временные правила: если пользователь спамит много сообщений подряд, он может получить и временный бан через параметр mute_duration.

 🧠 Как заставить ИИ не забывать о функции?

Частая беда AI-ассистентов — они «забывают» о своих функциях после обработки нескольких сообщений. Спамеры этим пользуются, закидывая чат десятком сообщений подряд.

Решение — Приоритетная инструкция в промпте:

> «При каждом сообщении пользователя анализируй его содержание. Если есть запрещенный контент, запусти функцию 482 для удаления сообщения. Если запрещенный контент отсутствует, отправь текст «🛑». Запускай функцию 482 вне зависимости от того, сколько раз ты ее запускал до этого.»

Эта инструкция зацикливает логику ассистента на основном действии — модерации, не давая ему отвлечься.

Что ищем и удаляем (кратко по промпту):

*   Мат (включая замены символами и эвфемизмы).

*   Оскорбления и хейтспич (унижения, угрозы, травля).

*   Любая реклама (прямая, скрытая, рефералки, предложения работы).

*   Важное исключение: Не трогаем конструктивную критику и цитаты в нейтральном контексте.

📥 Промпт образец: https://disk.yandex.ru/d/NFiy1Qun0Cpdfg