Documentation

Документация

Руководство пользователя SpamAway

Начало работы

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

Подключение бота к чату

1
Добавьте бота в чат
Найдите бота @SpamAwayOnlineBot в Telegram и добавьте его в свой чат или канал. Бот должен быть добавлен как администратор.
2
Выдайте права администратора
Для корректной работы боту необходимо право на удаление сообщений.
3
Авторизуйтесь в личном кабинете
Откройте бота @SpamAwayOnlineBot в Telegram, нажмите Start и запустите привязанное к боту мини-приложение. В меню будет список чатов, где вы являетесь администратором и где добавлен бот.
4
Настройте правила
В меню выберите чат и настройте правила модерации под ваши нужды. При добавлении бота в чат автоматически активируется пробная подписка на 7 дней с доступом ко всем функциям. Для тестирования настроек без реального удаления сообщений используйте отладочный режим.
5
Настройте спам-корзину (рекомендуется)
Создайте отдельный чат (группу) для архива удалённых сообщений и добавьте туда бота как администратора. В настройках созданного чата включите переключатель "Это корзина". Укажите этот чат в настройках основного чата. Спам-корзина позволяет просматривать удалённые сообщения и восстанавливать ошибочно удалённые.
6
Добавьте бота в привязанный канал (если есть)
Если ваш чат является группой обсуждения канала, добавьте бота также в сам канал как администратора. Это позволит боту корректно обрабатывать сообщения от имени канала и комментарии к постам.
Совет
Рекомендуем начать с базовых настроек и постепенно добавлять более строгие правила, наблюдая за результатами модерации. Или используйте отладочный режим.

Личный кабинет

В личном кабинете вы можете:

  • Просматривать список подключённых чатов
  • Включать и выключать правила модерации
  • Настраивать параметры каждого правила
  • Добавлять собственные спам-фразы
  • Управлять подпиской
  • Просматривать статистику удалённых сообщений

Правила модерации

SpamAway использует систему правил для определения спам-сообщений. Правила делятся на два типа:

  • Разрешающие — если сообщение соответствует правилу, оно пропускается без проверки остальных правил
  • Запрещающие — если сообщение соответствует правилу, оно удаляется

Порядок проверки: сначала проверяются разрешающие правила (белый список), затем запрещающие.

Доступные правила

Разрешающее

Автор — администратор

Сообщения от администраторов чата всегда пропускаются без проверки.

Разрешающее

Автор — администратор привязанного к чату канала

Сообщения от администраторов привязанного к чату канала всегда пропускаются без проверки.

Запрещающее

Сообщение содержит ссылку

Удаляет сообщения, содержащие внешние ссылки (URL) или ссылки в тексте. Эффективно против спама с рекламой сайтов.

Запрещающее

Сообщение содержит упоминание

Удаляет сообщения с @упоминаниями пользователей или каналов. Помогает против массового тегирования и рекламы каналов.

Запрещающее

Сообщение похоже на спам-фразу (семантический поиск)

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

Запрещающее

Сообщение содержит слова из спам-фразы (точное совпадение)

Ищет точные совпадения ключевых слов из базы спам-фраз. Быстрый и точный метод для известных спам-паттернов.

Запрещающее

Сообщение содержит кнопки

Удаляет сообщения с inline-кнопками. Часто используется спамерами для привлечения внимания.

Запрещающее

Автор не является участником группы

Удаляет сообщения от пользователей, которые не состоят в группе.

Запрещающее

Автор не является подписчиком канала

Удаляет комментарии от пользователей, которые не подписаны на канал.

Запрещающее

Профиль автора содержит ссылку

Проверяет имя пользователя и биографию автора на наличие ссылок. Помогает против аккаунтов, созданных для рекламы.

Настройка правил

Для каждого правила можно:

  • Включить/выключить — активировать или деактивировать правило
  • Настроить параметры — текст и время автоудаления уведомления, а также у некоторых правил есть дополнительные настройки (например, порог чувствительности для семантического поиска настраивается на вкладке "Словарь")
Внимание
Некоторые правила доступны только на платных тарифах.

Спам-фразы

База спам-фраз — это ваш персональный словарь нежелательного контента. Бот использует эту базу для поиска спама двумя способами:

  • Точное совпадение — поиск по ключевым словам (должно быть включено правило "Сообщение содержит слова из считающейся спамом фразы")
  • Семантический поиск — поиск похожих по смыслу фраз с помощью ИИ (должно быть включено правило "Сообщение похоже на считающуюся спамом фразу")

Добавление спам-фраз

Способ 1: Через личный кабинет

  1. Перейдите в раздел «Спам-фразы» для нужного чата
  2. Нажмите «Добавить фразу»
  3. Введите текст спам-фразы
  4. Сохраните

Способ 2: Через бота в Telegram

  1. Перешлите спам-сообщение боту в личные сообщения
  2. Бот предложит добавить текст в базу спам-фраз
  3. Подтвердите добавление
Совет
Добавляйте характерные фразы спамеров, а не отдельные слова. Например, вместо слова «заработок» лучше добавить «заработок от 100к в день» — так будет меньше ложных срабатываний.

Настройка чувствительности

Для семантического поиска можно настроить порог схожести:

  • Высокий порог (0.96-1.00) — находит только очень похожие фразы, меньше ложных срабатываний
  • Средний порог (0.94-0.96) — баланс между точностью и полнотой
  • Низкий порог (0.92-0.94) — находит больше спама, но возможны ложные срабатывания

Проверка фраз

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

  1. Введите любой текст в поле проверки
  2. Система покажет, будет ли этот текст определён как спам
  3. Если найдено совпадение — отобразится похожая спам-фраза и степень схожести

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

Как удаляется спам

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

Этапы обработки сообщения

1
Получение сообщения
Когда кто-то пишет в вашем чате, Telegram отправляет уведомление боту. Бот получает текст сообщения, информацию об авторе и метаданные (ссылки, упоминания, кнопки и т.д.).
2
Проверка разрешающих правил (белый список)
Сначала бот проверяет, не попадает ли сообщение под разрешающие правила. Например, если автор — администратор чата, сообщение сразу пропускается без дальнейших проверок. Это гарантирует, что администраторы и доверенные пользователи никогда не попадут под фильтры.
3
Проверка запрещающих правил (чёрный список)
Если сообщение не попало в белый список, бот последовательно проверяет запрещающие правила: наличие ссылок, упоминаний, кнопок, совпадение со спам-фразами и другие критерии. Проверка останавливается при первом совпадении.
4
Действия при обнаружении спама
Если сообщение признано спамом, бот выполняет следующие действия:
  1. Копирование в спам-корзину — если настроена спам-корзина, сообщение копируется в архивный чат с информацией о сработавшем правиле, чате, авторе и кнопкой восстановления
  2. Удаление из чата — оригинальное сообщение удаляется из группы
  3. Уведомление — в чат отправляется короткое уведомление о том, что сообщение было удалено как спам. Текст уведомления можно настроить отдельно для каждого правила в параметрах правила
  4. Автоудаление уведомления — через заданное время уведомление автоматически удаляется, чтобы не засорять чат. Время автоудаления также настраивается для каждого правила индивидуально
Совет
Если спам-корзина не настроена, сообщение будет удалено без возможности восстановления. Рекомендуем всегда настраивать спам-корзину, чтобы иметь возможность проверить удалённые сообщения и восстановить ошибочно удалённые.

Отладочный режим

Если включён отладочный режим, бот выполняет все проверки, но не удаляет сообщение из чата. Вместо этого информация о срабатывании отправляется в спам-корзину для анализа. Это позволяет безопасно тестировать настройки.

Восстановление сообщений

Если бот ошибочно удалил нормальное сообщение, вы можете его восстановить. Для этого сначала необходимо настроить спам-корзину.

Как это работает

  1. Удалённые сообщения сохраняются в архиве (спам-корзине)
  2. Администратор получает уведомление об удалении с кнопкой «Это не спам, вернуть»
  3. При нажатии на кнопку сообщение восстанавливается в чате

Настройка спам-корзины

Вы можете настроить отдельный чат для архива удалённых сообщений:

  1. Создайте чат (группу) для архива
  2. Добавьте бота в этот чат как администратора
  3. В настройках созданного чата включите переключатель "Это корзина"
  4. Укажите этот чат в настройках основного чата (Пересылать удаляемый спам в "корзину")
Совет
Архив удалённых сообщений полезен для анализа: вы можете видеть, что именно удаляет бот, и при необходимости корректировать настройки.

Отладочный режим

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

Важно
Для включения отладочного режима необходимо сначала настроить спам-корзину (архивный чат). Без спам-корзины отладочный режим не может быть активирован.

Как работает отладочный режим

Когда отладочный режим включён:

  • Сообщения НЕ удаляются из чата — они остаются видимыми для всех участников
  • Бот определяет, какие сообщения были бы удалены по текущим правилам
  • Информация о срабатывании правил отправляется в спам-корзину
  • В уведомлении указывается, какое именно правило сработало и почему
Когда использовать
  • При первоначальной настройке бота в новом чате
  • После изменения правил или добавления новых спам-фраз
  • Для анализа, какие сообщения попадают под фильтры
  • Для настройки порогов чувствительности семантического поиска

Как включить отладочный режим

1
Перейдите в личный кабинет
Войдите в приложение через Telegram.
2
Выберите чат
Откройте настройки нужного чата из списка ваших чатов.
3
Настройте спам-корзину (если не настроили ранее)
Создайте чат (группу) для архива удалённых сообщений, добавьте туда бота как администратора и укажите этот чат в настройках. Без спам-корзины отладочный режим недоступен.
4
Включите отладочный режим
После настройки спам-корзины появится возможность включить переключатель «Отладочный режим».

Информация в отладочных уведомлениях

Когда правило срабатывает в отладочном режиме, в спам-корзину приходит сообщение с информацией:

  • Текст сообщения — содержимое проверяемого сообщения
  • Сработавшее правило — какое именно правило определило сообщение как спам
  • Чат — куда отправлено сообщение
  • Автор — кто отправил сообщение
Важно
Не забудьте выключить отладочный режим после завершения тестирования! В отладочном режиме спам-сообщения не удаляются и остаются в чате.

Рекомендуемый процесс настройки

  1. Включите отладочный режим и настройте спам-корзину
  2. Наблюдайте за срабатываниями в течение нескольких часов или дней
  3. Анализируйте — какие сообщения ловятся правильно, а какие — ошибочно
  4. Корректируйте настройки — отключайте лишние правила, настраивайте пороги, добавляйте исключения
  5. Повторяйте цикл до достижения нужного баланса
  6. Выключите отладочный режим — бот начнёт реально удалять спам
Совет
Если у вас активный чат с большим количеством сообщений, достаточно нескольких часов в отладочном режиме, чтобы понять, как работают правила. Для менее активных чатов может потребоваться 1-2 дня наблюдения.

Подписки и тарифы

SpamAway предлагает бесплатный и платные тарифы в зависимости от ваших потребностей.

Бесплатный тариф

  • Базовая защита от спама
  • Используются стандартные правила антиспама без возможности их настройки

Платный тариф

  • Возможность выбора и настройки правил антиспама
  • Возможность использовать корзину
  • Возможность использовать отладочный режим
  • Возможность восстановить ошибочно удалённые сообщения
  • Собственная база спам-фраз
  • Семантический поиск спама (ИИ)

Стоимость тарифа

Цена зависит от количества участников в чате:

Тариф Участников Месяц 6 месяцев Год
Start до 1 000 590 ₽ 3 200 ₽ 5 900 ₽
Growth до 5 000 1 290 ₽ 6 900 ₽ 12 900 ₽
Pro до 20 000 2 490 ₽ 13 500 ₽ 24 900 ₽
Scale до 50 000 4 990 ₽ 26 900 ₽ 49 900 ₽
Enterprise до 5 000 000 10 ₽ 55 000 ₽ 55 000 ₽

Оплата

  • Оплата производится через Робокассу
  • Принимаются карты российских банков, СБП
  • Для юридических лиц выставляем счета и предоставляем закрывающие документы
  • Подписка продлевается автоматически (можно отключить)
Важно
При превышении лимита участников чата система уведомит вас о необходимости перейти на более высокий тариф. Защита продолжит работать в течение grace-периода.

Частые вопросы

Бот удаляет нормальные сообщения. Что делать?

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

  • Отключить правило, которое вызывает ложные срабатывания
  • Увеличить порог чувствительности для семантического поиска
  • Добавить исключения в белый список

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

Да, SpamAway корректно работает с другими ботами. Рекомендуем дать SpamAway более высокий приоритет (выше в списке администраторов), чтобы он первым обрабатывал сообщения.

Бот не работает в моём чате

Проверьте:

  • Бот добавлен в чат как администратор
  • У бота есть права на удаление сообщений
  • Чат активирован в личном кабинете
  • Хотя бы одно правило включено

Как отменить подписку?

Автопродление можно отключить в личном кабинете в разделе «Подписка». После окончания оплаченного периода подписка не будет продлена автоматически.

Бот читает мои сообщения?

Бот обрабатывает сообщения только в момент их отправки для проверки на спам. Мы не храним содержимое ваших сообщений и не читаем переписку. Подробнее в Политике конфиденциальности.

Почему информация об авторе в спам-корзине выглядит по-разному?

Telegram предоставляет разный объём информации об авторе в зависимости от типа сообщения:

  • Обычные сообщения — бот получает полную информацию: имя, фамилию, username и ID пользователя
  • Сообщения от имени канала — Telegram передаёт только название и ID канала, без данных о реальном авторе
  • Анонимные администраторы — если в чате включена анонимность для администраторов, бот видит только общий идентификатор группы
  • Пересланные сообщения — информация зависит от настроек приватности исходного автора

Это ограничение Telegram API, а не бота. Бот отображает всю доступную информацию об авторе.

Как связаться с поддержкой?

Напишите нам на info@spamaway.ru или в форму обратной связи.

Перейти в личный кабинет