# Автоматическая модерация

# Общие настройки для фильтров

Бот будет удалять свои сообщения в чате, что выделено ограничение через 5 минут.

Если участник чата нарушает правила постоянно, то бот не будет слать предупреждения подряд, чтобы не засорять чат.

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

В дальнейшем будет реализована автокоррекция орфографических и грамматических ошибок. Пока эта функция исправляет неправильную раскладку.
Например, Вы написали в чат слово «Ghbdtn», в ответ на Ваше сообщение бот отправить «Привет».

При отправке нескольких фотографий вместе, Telegram группирует их в альбомы (максимум – 10 фотографий). Вы можете ограничить количество фотографий в альбомах.

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

Удаление команд, адресованных боту. Рекомендуем не включать, если вы пишете команды с комментариями «/mute 1h @username вот тебе за определенные действия».

Интервал времени в минутах – если не прошло N минут с прошлого предупреждения от бота, новое предупреждение показано не будет. Здесь задаётся время для ограничений «Удалить из чата на время» и «Тихий режим» для всех фильтров.

# Face – контроль

Face-контроль – ещё одно оружие против борьбы со спамом. Если фильтры выше работают на содержимое сообщений, то Face-контроль обрабатывает никнеймы и юзернеймы пользователей.

Бот будет давать «mute» (ограничение каких-либо действий в чате) участнику на указанное время от момента вступления участника.

Ограничение длины никнейма пользователя (значения указаны включительно).

Возможность запретить никнеймы с китайскими иероглифами/символами с RTL.

Перечень разрешенных языков, установленных в приложение Telegram. Значения указывать по типу: ru, en, ua. Ввиду особенностей Telegram’а, если в приложении выставлен язык русский, срабатывает на значения en и ru, поэтому будьте аккуратны с этим. Со значениями, которые можно указывать в качестве языка клиента Вы можете ознакомиться здесь (opens new window)

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

Если с заданными условиями Face-контроль должен сработать на пользователя, будут выполнены следующие действия:

  • Появится приветствие в чате о новом пользователе (если включено), то есть бот впустит человека в чат.
  • При попытках человека написать в чат его сообщения будут удалены, а вместе с этим:
    • если включены, будут отправлены предупреждения.
    • если включен бан, после отправки предупреждений пользователь будет забанен («Тихий режим» даёт «mute» на 5 минут)

# Фильтры

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

Итак, всего доступно 28 фильтров. 26 доступны в бесплатной версии, два открываются в тарифе Advanced. 16 фильтров работают с текстом сообщений, 9 с медиа-файлами и ещё три относятся к разделу «Остальные фильтры».

Для фильтров доступна «быстрая настройка» - при перетягивании ползунка вправо-влево заработает определённый режим работы фильтра. По возможности, советуем всё-таки открывать настройки оранжевой кнопкой ниже, чтобы чётко понимать структуру фильтра, видеть все его возможности, настроить более гибко, для себя.

# Схожие черты всех фильтров

Итак, во многих фильтрах в самом верху есть белый/черный список того, что вы хотите запретить. Постепенно добавим такую возможность во все фильтры, где это целесообразно.

Во всех фильтрах можно выставить время. Если ничего не указано – фильтр будет работать всегда. Почти везде в боте неуказанное значение или цифра «0» означает выполнение действия всегда. Время в боте в формате UTC, это МСК+3. Если Вы живёте по московскому времени, и хотите сделать выполнение фильтра «с 23:00 до 7:00», вам нужно написать «с 02:00 до 10:00».

Тип бана за запрещённый контент. Есть 4 типа банов:

  • Не наказывать – бот не будет банить пользователей
  • Удалить из чата на время – аналогично команде /kick – бот исключит человека из группы, однако он в любой момент сможет в нее вернуться
  • Тихий режим – «mute» пользователя – пользователь не сможет писать в чате, но сможет находиться в нём и просматривать все сообщения.
  • Удалить из чата навсегда – бот добавит пользователя в чёрный список, заново зайти в чат пользователь не сможет

Все вышеописанные ограничения можно отменить в ручном порядке с помощью команд: /unban, /unmute.

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

Тумблер позволяет отправлять текст при бане пользователя ботом.

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

Если тумблер включен, появляются такие возможности как: отложить удаление сообщения до 60 секунд, установить количество разрешённого контента и период его обнуления. Как это всё работает:

Например, Вы не хотите, чтобы в Вашей группе спамили стикерами. Для этого:

  • Разрешим 5 стикеров в час для пользователей.
  • Включим тумблер «Удалять сообщения», ниже выставим разрешенное количество стикеров – 5.
  • Далее в «Через сколько обнулять разрешенное количество стикеров» укажем «Час».
  • Поставим 2 предупреждения, напишем текст: «Отправляешь, слишком много стикеров , попробуй позже», во вкладке Other включим авто-удаление через 15 секунд, чтобы не засорять чат.
  • Тип бана поставим Тихий режим, «mute» будет выдаваться в соответствии со временем в общих фильтрах.

Таким образом, пользователь отправляет 5 стикеров, если час не прошел, при шестой отправке стикера бот удалит сообщение и отправит написанное нами предупреждение, которое удалится через 15 секунд. Седьмой раз -> предупреждение, дальше «mute».

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

Возможность выдать ограничение по первому сообщению пользователя, попадающему под фильтр. «Тихий режим» в этом поле выдаёт «mute» навсегда.

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

Поэтому существует такая функция во многих фильтрах. Счетчики «Только по истечении (мин)» и «Только после N новых сообщений» позволяют включить удаление отредактированных сообщений только когда прошло какое-то время после отправки сообщения/было отправлено какое-то количество сообщений. Проще говоря, «сразу» редактировать сообщения пользователю можно, «потом» - нельзя. Вот это «сразу» вы и выставляете.

# Фильтры по тексту:

Стоп-слова - добавьте сюда любые слова или выражения, и бот будет реагировать на них, выдавая ограничения. Регистр для написанных Вами стоп-слов в сообщениях не учитывается.
Строгий режим стоп-слов: если в значениях указано слово «лето», при включенном режиме бот будет фильтровать только это слово, при нестрогом режиме бот отреагирует и на слово билетов.
Фильтр стоп-слов работает очень эффективно засчет того, что удаляет даже самые скрытые маты. Активируйте тумблер "Проверять изменение слов" и бот будет удалять сообщения с такими словами как $ука, сук@, с_у_K_@. Даже если в сообщении целое предложение и в нем есть такие завуалированные маты, бот удалит такое сообщение. Также, бот будет фильтровать слова с английскими и узбекскими буквами, например, syка

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

Фильтр Telegram-ссылок. Фильтрует все виды Telegram-ссылок, фильтрацию по типам можно отключить в расширенных настройках.
Белый список фильтров - в этом списке укажите каналы, упоминания, репосты и ссылки сообщений которых будут допущены в вашей группе. Фильтр будет отрабатывать только с полным совпадением, то есть, например, если вы укажите список допустимых каналов "@name", то бот допустит репост из канала и ссылки на сообщения из канала "@name", но не допустит из канала "@name2". На каждый канал должна быть отдельная ссылка, даже, если они похожи по названию. Обязательно указывайте имя канала с "@"

Фильтр Email (почтовых адресов). Фильтрует почтовые адреса.

Фильтр сообщений с RTL. Грубо говоря, RTL – текст «задом наперёд». Как правило, этим и являются символы арабского языка. В расширенных настройках можно выставить допустимый процент символов с RTL в сообщении (где 0 – запретить использование символов арабского языка полностью)
Здесь фильтруются сообщения с арабским текстом. Для того, чтобы фильтровать никнеймы или юзернеймы пользователей, используйте Face-контроль.

Фильтр китайских иероглифов. В расширенных настройках можно выставить допустимый процент китайских иероглифов в сообщении (где 0 – запретить использование символов арабского языка полностью).

Фильтр Репосты от ботов. Фильтрует сообщения, пересланные от ботов. Тумблером включается фильтрация via-сообщений.
При нажатии на музыкальные треки, сообщение с ними отправится в чат, а сверху будет надпить через @vkmusic_bot или via @vkmusic_bot.
Via-сообщения – сообщения, отправленные через ботов таким способом. Разумеется, таких ботов множество – эти выбраны в качестве примера.

Предупреждение

Фильтр не обрабатывает сообщения других ботов в чате – не может - боты не видят друг друга, политика Telegram.

# Фильтр команды от ботов

Фильтр репосты из каналов и репосты из чатов. Будут фильтроваться репосты пользователей из каналов и чатов. В белом списке выше можно указывать: ID канала или чата, его @username (можно без знака @, регистр не важен), ссылку на него с t.me/ или https://t.me/.
При привязке канала и группы фильтр не обрабатывает присылаемые посты из канала!

Фильтр разрешенные слова. Фильтр доступен в лицензиях Advanced и Ultimate. Бот будет наказывать пользователя за сообщения, в которых нет перечня разрешенных слов.
Строгий режим разрешенных слов: если в значениях указано слово «лето», при включенном режиме бот будет фильтровать только это слово, при нестрогом режиме бот отреагирует и на слово билетов.

Фильтр регулярные выражения. Фильтр доступен в лицензиях Advanced и Ultimate. Бот будет обрабатывать указанные вами регулярные выражения языка программирования Java. О том что это, и как это использовать, можно прочитать здесь. При включенном тумблере Удалять регулярные выражения появляется возможность отключить этот фильтр для подписей (к файлам, картинкам, видео и т. д.)

Фильтр мат. Бот будет фильтровать нецензурную лексику. В расширенных настройках вынесены некоторые слова, которые можно отключить для фильтрации. При включении фильтрации мата по словарю, бот также обрабатывает разные формы слов, при этом открывается возможность дописать этот словарь вашими словами.

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

Фильтр реферальные ссылки. Это сслыки, отправляемые боту (не @ChatKeeperBot, а другому) для идентификации ссылки (например, по ID). Имеют вид https://t.me/chei_to_bot?startgroup=test.

# Фильтры по медиа-файлам

Фильтры по медиа-файлам. В них входят: стикеры, голосовые сообщения, изображения, Gif, аудиозаписи, видео, видеосообщения пользователя, файлы и контакты. Все они имеют одинаковую структуру, различаются лишь настройкой разных параметров в разделе расширенные настройки (например высота/ширина/пиксели у фото, gif и видео, время у голосовых и видеосообщений).

Фильтр файлы. В расширенных настройках есть возможность разрешить определённые типы файлов по расширению. Оно может указываться так: exe (без точки). Также доступен выбор mime-типов файлов. Доступные значения: application, audio, example, image, message, model, multipart, text, video.

# Другие фильтры

Фильтр флуда. Флуд в этом фильтре означает слишком частое написание сообщений. Можно задать удаление при отправке N сообщений за определённый интервал времени, установить время между двумя соседними сообщениями, удалить предыдущие сообщения.

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

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

# Как понять почему фильтр работает не так как вы хотите?

Общее

  • Убедитесь, что бот включен и работает. Отправьте в чате команду /test, бот должен удалить сообщение и прислать в личные сообщения диагностику чата
  • Проверьте, есть ли бот в списке администраторов в чате. Для этого зайдите в управление группой => список администраторов и, если бота там нет, то добавьте.

Зайдите в личный кабинет, раздел «Модерация» => «Фильтры» и откройте настройку необходимого фильтра

  • Проверьте «Иммунитет к фильтру», пользователи с указанного ранга освобождаются от ограничений. (Доступно с тарифа Advanced)

  • Зайдите в «Общие правила фильтра» и убедитесь, что включен тумблер «Удалять сообщения с …»

Пример:

Ссылки и Telegram-ссылки

  • Убедитесь не находится ли ссылка в белом списке.

  • Затем, проверьте отключен ли тумблер «Разрешить ссылки ТОП-100» в разделе «Дополнительные настройки», если нет, то отключите, скорее всего, ваш сайт входит в этот ТОП-100.

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

  • Зайдите в раздел «Общие правила фильтра»

  • Включите тумблер «Удалять отредактированные сообщения»