ModerAntBot

0

Описание

Телеграм бот для модерации групп с топиками.

Языки

  • Java100%
7 месяцев назад
5 дней назад
5 дней назад
5 дней назад
README.md

ModeAntBot

Описание

Телеграм бот-модератор для модерации группы.

Бот осуществляет модерацию топиков в группе согласно настройкам: (настройки могут быть указаны отдельно для каждого из топиков)

  • Ограничение по времени:

    Бот может контролировать частоту сообщений от пользователей.

  • Ограничение по контенту в сообщениях:

    Бот проверяет сообщения на допустимый в топике контент.

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

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

Конфигурация

Конфигурация для бота должна быть записана в файле

settings.json

Пример конфигурации:

Обязательные параметры:

  • botToken
  • recycleId

Остальные параметры:

  • proxy
    - если он добавлен в конфиг, то обязательно должен содержать:
    • type
      - допустимые значения
      HTTP
      ,
      SOCKS
    • host
    • port
  • proxy.auth
    - если добавлен в конфиг, то обязательно должен содержать:
    • login
    • pass
  • logLevel
    - по умолчанию используется уровень
    WARN
    . Допустимые уровни логирования (от более строгого к более свободному):
    OFF
    ,
    FATAL
    ,
    ERROR
    ,
    WARN
    ,
    INFO
    ,
    DEBUG
    ,
    TRACE
    ,
    ALL
  • processHistory
    - по умолчанию бот не будет обрабатывать сообщения, которые были отправлены, пока бот не работал, или у бота не было прав администратора в группе. Если установить
    true
    - все доступные для бота сообщения на момент запуска будут обработаны.

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

deleteTopicMinutes
- по умолчанию равен
5
deleteRecycleMinutes
- по умолчанию равен
10

mutingMinutes
- для отключения ограничения по времени необходимо указать ноль. Если этот параметр в топике вообще не указан - будет взято значение из корневого объекта. Если там тоже не указан этот параметр - ограничение по времени будет устанавливаться до конца текущих суток.

Запуск

  • Взять последнюю версию из релизов.
  • Распаковать.
  • Заполнить файл конфигурации
    settings.json
  • Запускать бота командой
    java -jar ModerAntBot.jar
    .

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