Антиспам-бот для чата MAX: фильтры, удаление сообщений и бан

Антиспам-бот для чата MAX должен удалять очевидный мусор и не ломать нормальную переписку. Задание «Охранник чата» в MAXorg объединяет AI-инструкцию, ключевые слова, проверку имени, запрет ссылок или медиа и поиск повторов. Оно работает с группами, а не с каналами.

Боту нужны права администратора на удаление сообщений, а для бана ещё и управление участниками. Начинайте в закрытой тестовой группе и только с удаления. Бан подключайте после проверки ложных срабатываний на реальных примерах.

Что подготовить для теста

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

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

• бот удаляет сообщения и при необходимости банит;
• подготовлены примеры спама и нормальной речи;
• назначен человек для просмотра журнала;
• есть способ восстановить ошибочно заблокированного участника.

Как выбрать фильтры

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

Добавляйте в список слов однозначные маркеры конкретной атаки: домен, название казино, телефон или устойчивую фразу. Не используйте короткие общие слова вроде «цена» и «работа». Фильтр ссылок реагирует на HTTP-адреса, t.me, max.ru и ссылки в разметке, включая полезные инструкции, карты и оплату.

• смысловая реклама: AI-критерий;
• известный домен или фраза: точный список;
• реклама в отображаемом имени: фильтр имени;
• массовый повтор: контроль дублей;
• медиа-атака: временный запрет конкретного типа.

Примеры публичных групп можно найти в каталоге, а настройка доступна после регистрации MAXorg. Не переносите чужой стоп-лист без проверки: правила чата поддержки и районного сообщества различаются.

Как написать AI-промпт

Опишите наблюдаемые признаки и исключения. Рабочая формулировка: «Считать спамом коммерческое предложение без связи с текущим обсуждением; не считать спамом контакт мастера в прямом ответе на просьбу участника». Фраза «удалять всё подозрительное» не задаёт проверяемого правила.

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

1. Сформулируйте запрет и допустимое исключение.
2. Добавьте два-три характерных примера.
3. Запустите только удаление в тестовой группе.
4. Проверьте десять нарушений и десять нормальных сообщений.
5. Исправьте критерий до переноса в основной чат.

Как настроить дубли и действия

Порог дублей задаётся от 2 до 10 повторов подряд, стандартно 3. Сравнение нормализует регистр и скрытые символы. При достижении порога охранник удаляет все доступные сообщения пользователя в текущем окне до 50 сообщений и повторно проверяет остаток. Поэтому значение 2 опасно для активной группы, где участник мог законно повторить напоминание.

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

MAXorg хранит активные баны и позволяет разблокировать участника в статистике. Назначьте способ апелляции до запуска. Служебные события входа и выхода удалить через API нельзя, потому что они приходят без идентификатора сообщения; не обещайте автоматическую очистку этих уведомлений.

Запуск и контроль первых дней

Выберите группы, критерии и действие, затем нажмите «Сохранить и запустить». Можно настроить расписание, дату окончания и разрешённые часы. Если ночью задание выключено, чат остаётся без этой защиты, поэтому нужен другой процесс модерации.

При первом проходе охранник запоминает до 50 существующих сообщений и не модерирует историю. Проверка начинается с новых сообщений в следующих чтениях API. В активном чате между опросами может появиться больше материалов, чем входит в окно, поэтому первые два дня регулярно смотрите журнал.

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

Как проверить безопасность настройки

В тестовой группе отправьте обычный вопрос, разрешённую ссылку, запрещённый домен, фото, файл и три одинаковых сообщения. Убедитесь, что бот реагирует только на включённые критерии. Затем временно включите бан и проверьте его отдельным тестовым аккаунтом, а после разблокируйте участника.

1. Нормальная беседа остаётся доступной.
2. Точное стоп-слово удаляет ожидаемое сообщение.
3. Порог дублей срабатывает на нужном повторе.
4. Журнал показывает причину, чат и пользователя.
5. Разблокировка возвращает тестовый аккаунт.

Что делать при ошибке

Если бот ничего не удаляет, проверьте статус задания, цель и право удаления. Если не работает бан, отдельно проверьте управление участниками. Массовые ложные удаления требуют немедленной паузы, отключения широкого слова или медиа-фильтра и разбора журнала. Не расширяйте AI-промпт, пока не найден конкретный источник ошибки.

Если спам проходит, воспроизведите один пример в тестовой группе и выберите самый узкий сигнал. Спамер меняет символы в дублях, значит нужен смысловой критерий; повторяет домен, значит достаточно точного слова. Другие сценарии для ботов и модерации собраны в блоге MAXorg.