Документация / HowTo / инструкция по настройке антиспама
Техническая документация

Настройка антиспама Telegram: ссылки, флад, медиа и новички

Используйте эту инструкцию, чтобы настроить антиспам VibeGuard.bot для Telegram-группы: проверить права бота, включить режим аудита, добавить фильтры ссылок, флуда, медиа, стикеров, первых сообщений новичков, edit abuse и channel-sender abuse. Сначала смотрите, что правило поймало бы, и только потом включайте удаления, варны, муты или баны.

Перед началом

Для настройки антиспама нужен владелец группы или админ, который может управлять правами бота и настройками безопасности.

VibeGuard лучше настраивать после того, как бот уже добавлен в группу и сделан администратором. Для удаления спама нужны права на удаление сообщений. Для мутов, банов и киков — права на ограничение участников. Для проверки заявок и newcomer flow — права на join requests.

Не выдавайте все права просто «на всякий случай». Начните с того, что реально нужно вашей группе: фильтр ссылок, антифлуд, медиа-правила, проверка новичков или только режим аудита.

Шаг 1. Откройте Центр безопасности

Откройте Центр безопасности в Telegram и проверьте активную группу. VibeGuard работает по конкретному чату: у каждой Telegram-группы свои правила, события аудита, модерационное состояние, профили, AI usage и Mini App-контекст.

В разделе Anti-Spam / Safety setup проверьте:

Что проверитьЗачем это нужно
Активная группаЧтобы не менять правила не того чата.
Права ботаЧтобы понять, может ли VibeGuard удалять, мутить, банить или обрабатывать заявки.
Режим аудитаЧтобы тестировать антиспам без удаления сообщений.
Текущие правилаЧтобы видеть, какие фильтры уже включены.
Audit eventsЧтобы понять, что уже попадает под правила.
Missing permissionsЧтобы не гадать, почему действие не сработало.

Если Центр безопасности показывает missing permissions, сначала разберите права, а уже потом включайте enforcement.

Шаг 2. Начните с режима аудита

Режим аудита показывает, какие сообщения VibeGuard отметил бы как спам, но не удаляет их и не наказывает участников без разрешения админов.

Включите аудит для первых правил:

  • подозрительные ссылки;
  • repeated link drops;
  • флад и одинаковые сообщения;
  • подозрительные медиа и подписи;
  • стикер-спам;
  • первые сообщения новичков;
  • сообщения, отредактированные в ссылку;
  • сообщения от имени каналов;
  • bot-command noise.

Дайте группе поработать в audit mode достаточно долго, чтобы увидеть реальные срабатывания. Если нормальные сообщения часто попадают в аудит, смягчите правило до удаления или мута.

Шаг 3. Выберите спам-паттерны, которые видит ваша группа

Антиспам не должен быть одинаковым для всех групп. Публичка, crypto/Web3-чат, маркетплейс, фан-сообщество и приватный клуб ловят разные типы спама.

Начните с 3–5 паттернов:

ПаттернЧто он помогает ловить
Link spamСкам-ссылки, referral spam, repeated URLs, подозрительные домены.
FloodsОдинаковые сообщения, быстрый постинг, copy-paste реклама, caps/emoji walls.
Media & StickersМедиа-флуд, подозрительные подписи, sticker bursts, повторяющиеся файлы.
NewcomersРискованные первые сообщения, ссылки сразу после входа, подозрительный join timing.
Edited messagesСообщение выглядело нормальным, а позже стало ссылкой или рекламой.
Channel senderСообщения от имени каналов и sender-chat abuse.
Bot-command noiseМассовые команды, которые засоряют чат и мешают обсуждению.

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

Шаг 4. Настройте фильтр ссылок

Фильтр ссылок — обычно первый антиспам-блок для публичных групп, crypto/Web3-чатов, маркетплейсов и вакансий.

Начните с audit-only правил для:

  • подозрительных доменов;
  • повторяющихся URL;
  • Telegram-инвайтов;
  • bot links;
  • referral links;
  • ссылок от новичков;
  • ссылок в подписи к медиа;
  • сообщений, которые после редактирования получают ссылку.

Для каждой группы настройка будет разной. В фан-чате можно разрешить больше ссылок от старых участников. В маркетплейсе — строже проверять объявления и повторные публикации. В crypto/Web3-группе — внимательнее смотреть airdrop, fake support и фишинговые паттерны.

Сначала оставьте действие Audit. После review можно включить удаление, варн, мут или кейс для тех правил, которым команда доверяет.

Шаг 5. Настройте антифлуд, медиа и стикеры

Флад часто выглядит не как одна плохая ссылка, а как шум: одинаковые сообщения, быстрый постинг, стены эмодзи, капс, стикеры, повторные медиа или однотипные объявления.

Настройте правила для:

БлокЧто проверить
АнтифлудЧастота сообщений, повторы, copy-paste, mass mentions, caps/emoji-noise.
МедиаПодозрительные подписи, повторяющиеся вложения, медиа-спам от новичков.
СтикерыSticker bursts, однотипный sticker spam, флуд в активных темах.
КомандыBot-command abuse и шум от команд, если он мешает чату.

Не делайте антифлуд слишком строгим для живых групп. Во время анонса, стрима, конкурса или горячего обсуждения нормальная активность может выглядеть как всплеск. Для таких случаев полезнее audit-first настройка и ручной review.

Шаг 6. Настройте новичков, edit abuse и sender-chat правила

Спам часто приходит от новых аккаунтов. Поэтому антиспам лучше работает вместе с проверкой новичков.

Для newcomers настройте:

  • отдельные правила для первых сообщений;
  • stricter link policy для новых участников;
  • review для сообщений сразу после входа;
  • учёт invite context, если он доступен;
  • переход к капче, заявкам или join gate при повышенном риске.

Для edit abuse включите правило, которое ловит сообщения, изменённые после публикации: например, когда обычный текст позже превращается в ссылку, рекламу или скам.

Для channel-sender abuse настройте review сообщений от имени каналов и странных sender identities. Такие сообщения могут выглядеть «официальнее», чем обычный аккаунт, поэтому их лучше сначала проверять в аудите.

Шаг 7. Проверьте события и включайте действия постепенно

После нескольких часов или дней в audit mode откройте Audit Events в Центре безопасности.

У каждого события проверьте:

  • какое правило сработало;
  • почему оно сработало;
  • тип сообщения: текст, ссылка, медиа, стикер, edit, sender-chat;
  • контекст участника: новичок, старый участник, повторное нарушение;
  • какое действие VibeGuard применил бы;
  • не хватает ли Telegram-прав;
  • нужен ли override или исключение.

После review можно включать действия:

ДействиеКогда подходит
Оставить в аудитеПравило ещё нужно тестировать.
Удалить сообщениеHigh-confidence спам или очевидная скам-ссылка.
Варн / предупреждениеПервый шаг для повторяющихся нарушений.
МутФлад, повторный шум, spam bursts.
Кик или банЯвный спам-аккаунт, рейдер или грубое нарушение.
Открыть кейсНужен разбор админом, апелляция или контекст.

VibeGuard может выполнить только те действия, которые разрешили админы и которые поддерживаются выданными Telegram-правами.

Быстрая проверка после настройки

ПроверкаЧто должно быть понятно
Антиспам включён в нужной группеПравила относятся к правильному Telegram-чату.
Права бота провереныПонятно, может ли бот удалять, мутить и обрабатывать заявки.
Режим аудита активенПервые срабатывания видны без жёстких действий.
Фильтр ссылок настроенСсылки, домены, повторы и newcomer links уходят в audit/review.
Антифлуд не слишком строгийНормальная активность не превращается в массовые false positives.
Newcomer rules включены осознанноНовички проверяются строже, но не блокируются без причины.
Audit events разобраныАдмины понимают, какие действия можно включать.

Если что-то не работает

VibeGuard видит спам, но не удаляет его. Проверьте, не осталось ли правило в режиме аудита. Также убедитесь, что у бота есть право на удаление сообщений.

Фильтр ссылок ловит нормальные ссылки. Снизьте строгость правила, добавьте исключение или оставьте rule в audit mode до большего количества примеров.

Антифлуд ловит нормальную активность. Увеличьте лимиты, настройте cooldown или применяйте правило только к новичкам и повторяющимся сообщениям.

Стикеры и медиа не обрабатываются. Проверьте, включены ли media/sticker rules и есть ли у VibeGuard права на удаление сообщений.

Новички попадают в review слишком часто. Смягчите first-message policy, проверьте invite context и разделите правила для ссылок, флуда и обычных сообщений.

Сообщения от имени каналов проходят мимо. Проверьте, включён ли channel-sender / sender-chat rule и не работает ли он только в audit mode.

Центр безопасности показывает missing permissions. Откройте права бота в Telegram и добавьте только те права, которые нужны выбранному действию.

FAQ

Что такое настройка антиспама Telegram?

Это настройка правил, которые помогают админам находить и обрабатывать спам-ссылки, флад, suspicious media, стикеры, первые сообщения новичков, edit abuse и channel-sender abuse в Telegram-группе.

Можно ли тестировать антиспам без удаления сообщений?

Да. Начните с режима аудита: VibeGuard покажет, какие сообщения попали бы под правила, но не будет удалять их или наказывать участников, пока админы не включат enforcement.

Какие права нужны VibeGuard для антиспама?

Для удаления спама нужны права на удаление сообщений. Для мутов, банов и киков — права ограничения участников. Для проверки заявок и join gate — права на join requests. Доступные действия зависят от Telegram-прав бота.

Что лучше включить первым?

Чаще всего — фильтр ссылок и аудит новичков. Если проблема в шуме, начните с антифлуда. Если спам приходит через медиа или стикеры, включите media/sticker rules в audit mode.

Что делать с false positives?

Откройте audit event, посмотрите правило и причину, добавьте исключение, измените порог или оставьте правило в аудите. Если ограничение уже применялось, используйте кейс, апелляцию или rollback там, где это технически возможно.

Антиспам бесплатный?

У VibeGuard есть бесплатная версия навсегда для каждой группы. Каждый участник группы может использовать до 10 бесплатных AI help/prompts. Платное расширение нужно только сверх бесплатного использования или когда группе требуется больше AI-внимания, продвинутые правила безопасности, автоматизация или управление сеткой чатов.

Настройте антиспам спокойно: проверьте права, включите аудит, настройте правила под реальный спам вашей группы и только потом включайте действия.