Антиспам бот

momai

Ещё один?

Надоели боты-загадки, где для понимания назначения нужен медиум, а для настройки — лётная лицензия. Поэтому тут всё прозрачно: расписал каждый алгоритм — что происходит, почему и как это видят админы и пользователи. Настройка? Добавить в группу и дать админку.

Основная фишка — сделать борьбу со спамом максимально безболезненной и прозрачной.

⚙️ Как подключить

Добавьте бота в группу. Ссылка на бота.
Назначьте его администратором.
Всё. Бот уже на страже.

🔐 Что умеет

✅ 1. Тихий бан

Этап входа пользователя в чат.

Бот проверяет новых участников через архив спамеров lols.bot — если аккаунт есть в списке, он автоматически блокируется на 4 часа.
Бот блокирует на 4 часа пользователей, имя которых превышает 75 символов.
Бот блокирует участников зашедших в чат через папку*
Всё происходит в тихом режиме: без уведомлений, без капчи, без сообщений о входе в чат. Это позволяет не засорять ленту группы.
Важно понимать: если Telegram-аккаунт попал в такой список, им уже невозможно пользоваться по назначению — ни один уважающий себя чат не пустит его дальше порога.

* В Telegram есть функция - по одной ссылке можно вступить сразу в несколько чатов (папка). Для личных и рабочих групп это нормально, но в публичных чатах таким способом заходят спамеры.

✅ 2. Капча при входе в группу

Этап входа пользователя в чат.

Простая капча с эмодзи, которая показывается при входе нового участника в группу (если это канал с обсуждением то капча пропускается и происходит llm анализ профиля).
Время на решение — 60 секунд
Не справился — временный бан на 20 минут.
После успешного прохождения капчи, показывается приветственное сообщение с просьбой воздержаться от сложных комментариев с медиа и множеством эмодзи в первых трех сообщениях. Через минуту приветствие удаляется.
Капча и приветственное сообщение может сопровождаться короткой рекламой, в бесплатных планах.

✅ 3. Умный антиспам

Этап ожидания первых сообщений и их проверка.

Начинается проверка первых сообщений пользователя. Надо набрать три хороших сообщения.

Проверка пользователя на нахождение в блэклисте.
Анализ текста сообщений и поиск спам-паттернов
Выявление маскировки через похожие символы
Детект рекламы, подозрительных ссылок.
Удаление сообщений с перебором эмодзи
Показ оповещения для пользователя, с просьбой воздержаться от сложных первых трех комментариев.

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

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

✅ 4. LLM анализ

Этап ожидания первых сообщений и их проверка.

В каналах с обсуждениями капча не показывается, чтобы не путать и не раздражать пользователей. Вместо неё при первом комментарии анализируются профиль и фото с помощью LLM Gemini 2.5 Flash.
По результату: пользователь либо допускается, либо получает read-only на 10 минут, а его сообщение удаляется. Разработчику приходит уведомление для ручной проверки. Система настроена так, что удаляются только сообщения от профилей с явно продажным содержанием спорного характера (эротика, запрещенные вещества, казино и т.п.), а остальные проходят ручной анализ.
📌 Полноценная работа этой функции доступна в платных планах — подробности тут.
В бесплатном режиме функция ограничена и может временно отключаться при высоком потоке новых участников.

✅ 5. Система доверия

Этап добавления пользователя в список доверенных.

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

📌 Группы с объявлениями

Если у вас группа с объявлениями — бот тоже подойдёт. Он сам определит тип группы в течение суток и настроит нужную роль.
В этом режиме бот не будет удалять сообщения новичков с эмодзи, фото или ссылками — если они выглядят как обычные объявления.
Но имей в виду: спамеры часто притворяются «объявлениями», поэтому могут быть редкие ложные срабатывания — фильтры там работают мягче.

📌 Ручная модерация позволяет держать фильтры актуальными: паттерны спама со временем меняются, и автоматические алгоритмы не всегда подхватывают новые. Быстрая разметка удалённых сообщений помогает вовремя адаптировать правила. Занимает это буквально пару минут — по ощущению, как короткая сессия «три в ряд», только с пользой. В премиум-версии админы получают отдельный чат с уведомлениями и статистикой работы бота — удобно отслеживать, что происходит, не отвлекаясь от основного общения.

🧪 Опыт использования

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

Но это временно. Как только участники группы напишут по 3 обычных сообщения, бот поместит их в список доверенных, и фильтрация для них прекратится. Это сильно снижает количество ложных срабатываний.

Также важно понимать:

❗️Бот не банит пользователей за сообщения. Он только удаляет подозрительные посты и уведомляет разработчика о возможном спаме.
📬 Ложные срабатывания отслеживаются, и если сообщение удалено ошибочно — пользователь будет добавлен в доверенные вручную, разработчиком бота.
🧠 Алгоритмы регулярно обновляются, и бот постепенно становится умнее и мягче.
🚫 Пользователи из блэклистов банятся автоматически, но остальные — только вручную. Разработчик бота вручную просматривает удалённые сообщения несколько раз в день и принимает решение о временной блокировке, если поведение кажется подозрительным.

Рекомендации для группы:

Объясните участникам, что бот "немного строгий к новичкам", но это всего на пару сообщений.
Попросите новых пользователей написать сначала 3 простых сообщения — без ссылок, без картинок, без перебора эмодзи.
После этого бот начнёт их игнорировать и не будет мешать.

Взамен вы получаете чистый, спокойный чат без спама, рекламы, порно-ботов и другой мусорной активности.

👀 Финт для осторожных админов

Если боитесь, что бот будет мешать старожилам — добавьте его в группу, но не давайте сразу права админа. Через 3–4 дня, когда он соберёт базу проверенных участников, просто сделайте его админом. Бот сразу начнёт работать, но уже не будет трогать активных пользователей.

Это форк оригинального антиспам бота ClubDoorman, адаптированный для нужд открытых, общественных чатов. Изначально создавался для местных сообществ, но теперь активно используется и в других типах групп.

🔗 Ссылки на исходный код:

Оригинал: github.com/TiraelSedai/ClubDoorman
Форк GateTroitsBot: github.com/momai/ClubDoorman
Отключение рекламы и другие планы https://momai.dev/antispambot