Модуль модерации

Модератор

Кнопка содержит базовые настройки модерации:

Удаление событий

При включении бот будет удалять все системные сообщения (Юзер присоединился к группе, Юзер покинул Группу и т.д.).
Режимы:
Выкл ⏹️ - функция выключена.
Вкл ▶️ - функция включена.

Принимать Запросы

При включении бот будет автоматически принимать запросы на присоединение в группах, для которых установлено требование отправлять запросы на присоединение, прежде чем пользователь сможет попасть в группу.
Режимы:
Выкл ⏹️ - функция выключена.
Вкл ▶️ - функция включена.

Сообщение при запросе

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

Добавленное тут сообщение будет показано пользователю который отправил запрос на присоединение к чату в котором работает ваш бот. В сообщении можно использовать картинку. Удалите добавленное ранее сообщение чтобы бот перестал связываться с новыми пользователями.

ВАЖНО: Аккаунт пользователя НЕ станет юзером бота автоматически. Пользователь должен будет запустить бота самостоятельно и осмысленно, используя инлайн кнопку под сообщением, добавленную ботом автоматически. Поэтому, в созданном вами сообщении приведите веские причины присоединится к боту и попросите нажать на инлайн кнопку. Текст на инлайн кнопке изменить НЕЛЬЗЯ, равно как НЕЛЬЗЯ добавлять юзера в бот автоматически (было нельзя, нельзя сейчас и нельзя будет в будущем, ни платно, ни если очень нужно, а по ЭТИЧЕСКИМ соображениям).

Команды Модератора

Данный функционал не имеет настроек и потому не представлен в виде кнопок.

ВАЖНО: бот реагирует на команды отправленные админами ГРУППЫ. То есть не имеет значения является ли пользователь админом в боте - пользоваться командами модерации он сможет ТОЛЬКО являясь админом в ГРУППЕ.

Отдельные функции и команды могут потребовать конкретных разрешений Админа группы.

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

НЕИСПРАВНОСТИ: Если ваш бот не отвечает на команды только что добавленного администратора группы, обновите для бота список администраторов, отправив команду:
!admins
в чат группы.

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

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

Любое слово или сообщение начинающееся с "!" если отправлены как ответ (reply) на сообщение пользователя - НЕ дойдут до пользователя. Это сделано для того, чтобы не путать пользователя технической информацией в случае опечаток или ошибок любого рода допущенных в Командах или Триггерах.

ID

Позволяет Узнать ID пользователя со скрытым аккаунтом в группе - если отправлена в ответ (reply) на сообщение пользователя.

Ответ бота с данными пользователя придёт в чат с самим ботом. Это сделано для того чтобы сохранить конфиденциальность. 

Mute

Команда позволяет ограничить право юзера писать в группе.

Mute - немой англ. RO - read only - только чтение англ. В Русском варианте эта команда известна как Мут, Мьют или РО

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

НАВСЕГДА запретит данному юзеру писать в вашей группе. Используйте осторожно.

Чтобы временно ограничить юзера в праве писать в группу используйте дополнительный числовой параметр:

ВРЕМЕННО (на ХХ дней) ограничит право юзера писать в вашей группе.
Например:
!mute 10
Мьют юзера на 10 дней.

ВРЕМЕННО (на указанный срок z) ограничит право юзера писать в вашей группе.
Модификаторы числового праметра:
d - день
w - неделя
m - месяц
y - год
Например:
!mute 2w
Мьют на 2 недели (14 дней).

Обратите внимание на то что если срок ограничения более 365 дней (1 год), то юзер будет ограничен навсегда - в соответствии с настройками API Telegram.

Mute (РО - read only) НЕ удаляет юзера из группы и НЕ запрещает ему читать сообщения. Юзер только не сможет писать в чат группы.

Команда !mute поддерживает комментарии. После времени мьюта можно указать дополнительный текст.
Например:
!mute 7d флуд и спам
В этом случае юзер потеряет право писать в группе, а в качестве ответа, будет выдано сообщение:

"Только чтение 7 дней (до хх.хх.ххх) флуд и спам"

Язык сообщения будет зависеть от языка меню установленного в вашем боте.

Если мьют по каким-то причинам не прошел (неправильная команда, ошибка или еще что-то) - бот выдаст в чат сообщение "fail".
Работает ТОЛЬКО для админов группы независимо от настроек бота и триггеров.

Unmute

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

Ban

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

Unban

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

Reply

В ответ на сообщение пользователя в группе отправьте этот триггер и нужный текст. Бот удалит ваше сообщение и ответит пользователю от своего имени.
Например:
!reply text
Отправит "text" от имени бота в ответ на сообщение юзера.

Команда умеет работать с любыми сообщениями - с форматированием текста и медиа.

Можно отправлять сообщения в группу от имени бота и без конкретного адресата. Для этого просто начните своё сообщение с этого Триггера.

❖ Сообщения об ошибках

Fail

Отправляется в группу если:
1. Вызван триггер mute/ban/unban/unmute и не удалось совершить действие с юзером.
2. Вызван триггер media и почему-то не удалось дать разрешение юзеру.
3. Может возникать если по какой-то причине необходимо удалить сообщение в чате, однако это сообщение уже было удалено каким-то другим способом.
Оно лаконично сообщает админу, что его действие не выполнено.