Как настроить Самурая

01Быстрый старт

На всё про всё уходит около минуты. Защита включается автоматически — никаких сложных настроек делать не нужно.

1. Добавьте бота в чат или канал

   Откройте профиль бота @SamuraiDefensebot в Telegram и нажмите «Добавить в группу» или «Добавить в канал». Бот сразу попадёт в выбранный чат.

2. Выдайте права администратора

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

3. Откройте бота в личных сообщениях

   Напишите /start и нажмите «Мои чаты». Здесь будут все чаты и каналы, где вы — владелец и где стоит Самурай.

4. Готово

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

Через веб-панель

Если удобнее настраивать в браузере. Войти можно либо через Telegram (одна кнопка), либо по email с паролем. В панели видны те же чаты и те же тогглы.

02Фильтры контента

Каждый фильтр — независимый тоггл. Включается из настроек чата в боте («Мои чаты» → выбрать чат → «Настройки») или в веб-панели.

🤬 Антимат

Встроенный словарь обсценной лексики. Учитывает попытки обхода через цифры (п0здец) и спецсимволы (п*здец). Сообщение с матом удаляется мгновенно, в чате остаётся короткое уведомление, которое тоже самоудалится через 3 минуты.

⏱ Антифлуд

Если участник пишет слишком быстро — он получает мут на минуту, а его флуд-сообщения удаляются скопом. Параметры (количество сообщений за окно, длительность мута) настраиваются.

🔗 Удаление ссылок

Один тоггл — и любые URL, упоминания каналов и @username удаляются автоматически. Админы и привязанный к группе канал — пропускаются: им можно публиковать ссылки беспрепятственно.

🚫 Стоп-слова

Свой список запрещённых слов и фраз. Любое сообщение, где они встречаются, удаляется без предупреждения. Полезно для тематических ограничений (запретить названия конкурентов, нежелательные темы).

🌙 Ночной режим

Закрывает чат в указанные часы (например, с 23:00 до 08:00). Все вступления в это окно блокируются, существующие участники писать могут. Время — в часовом поясе сервера, по умолчанию это Москва.

03Поведенческий скоринг

Накрученные аккаунты выглядят похоже: рандомный логин из букв и цифр, нет аватара, странное имя, свежая регистрация. Скоринг — это система баллов: каждому новому участнику Самурай начисляет очки за каждый «подозрительный» признак.

Что проверяется

• Профильные базы — числится ли пользователь в публичных реестрах спамеров (CAS, LOLS).
• Имя и username — рандомные сочетания вроде asdfqwerty1234, эмодзи в имени, попытки замаскировать под админов.
• Аватар — есть ли он, сколько фотографий загружено.
• Язык клиента — насколько он соответствует языковой группе вашего чата.
• ID аккаунта — свежие ID получают больше баллов, очень старые — меньше.

Как работает порог

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

Premium-пропуск

Telegram Premium во время атаки пропускается без проверок: накрутка обычно идёт с бесплатных аккаунтов, а лояльные пользователи не должны страдать. Тоггл можно отключить, если вам нужна полная проверка всех.

04Капча для входящих

Капча — это математическая задачка с эмодзи-цифрами (например, 2️⃣ + 3️⃣ = ?). Ответ нужно написать в чат текстом. Это отсекает ботов, которые умеют только нажимать кнопки.

Где включить

В настройках чата: «Мои чаты» → выбрать чат → «Капча». Можно включить отдельно тоггл и параметры:

• Время на ответ — обычно 60 секунд. Если не успел — кик.
• Количество попыток — две-три попытки до окончательного кика.
• Текст приветствия — что писать пользователю при показе капчи.

Форум-группы (топики)

Если у вас форум-группа (включены темы / topics) — Самурай может отправлять капчу в отдельный служебный топик, чтобы не засорять основной чат. Топик нужно создать заранее и указать в настройках.

Капча vs скоринг — что выбрать

• Скоринг — невидимый, кикает молча, не мешает реальным пользователям. Достаточно для большинства чатов.
• Капча — добавляет небольшое трение для всех новичков, но ловит даже тех ботов, которых скоринг пропустил. Имеет смысл для крупных чатов с ценным сообществом.
• Можно использовать оба фильтра одновременно.

05Защита от атак

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

Как это происходит

1. Бот считает количество вступлений за окно (по умолчанию — 60 секунд).
2. Если число превысило порог — Самурай объявляет «атаку»: все вступившие в этом окне разом кикаются, новых вступающих блокирует на лету.
3. Когда поток падает до нормы — защита снимается сама. В лог-канал прилетает отчёт: длительность атаки, сколько кикнуто.

Антинакрутка для каналов

В каналах атаки выглядят иначе: 30–100 ботов за минуту-две, без последующей активности. Для каналов работают отдельные, более жёсткие пороги. Это значит: если на канал начнут лить накрутку — фильтр сработает раньше.

Параметры (если хотите подкрутить)

• Порог — сколько вступлений за окно считается атакой. По умолчанию — 10.
• Окно — длительность окна в секундах. По умолчанию — 60.
• Защита Premium — пропускать ли Premium-аккаунты во время атаки.

Куда смотреть, что бот сработал

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

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