Предупреждения, жалобы и журнал модерации

Введение

Не каждое решение модерации должно сразу приводить к бану. Участнику, который нарушил правило один раз, может быть достаточно напоминания; участник, который продолжает нарушать правила, должен столкнуться с понятными и предсказуемыми последствиями. Эта группа функций даёт администраторам гибкий способ реагировать на поведение — шкалу предупреждений, которая приводит к бану только после повторных нарушений, возможность для обычных участников сообщать администраторам о неподобающих сообщениях и приватный журнал, в котором фиксируются действия системы модерации.

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

Шкала предупреждений

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

• set_warnings_enabled — переключатель включения и выключения. По умолчанию выключен.
• set_warn_limit — количество нарушений, после которого срабатывает бан. По умолчанию 3.

Три команды, доступные только администраторам, управляют нарушениями:

• /warn — выдать нарушение. Ответьте на сообщение участника или укажите его числовой id либо @handle. Можно добавить необязательную причину, например /warn @user spamming links.
• /unwarn — снять одно нарушение с участника, если предупреждение было выдано по ошибке.
• /warns — проверить, сколько нарушений сейчас у участника относительно установленного лимита.

Когда /warn доводит участника до лимита — например, до третьего нарушения при стандартном лимите 3, — бот банит его и очищает счётчик нарушений. Если лимит ещё не достигнут, бот записывает новое нарушение и отвечает текущим счётом, чтобы и администратор, и участник понимали ситуацию. Само сообщение с командой удаляется после обработки, чтобы видимый чат оставался аккуратным.

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

Жалобы от участников

Жалобы позволяют обычным участникам обратить внимание администраторов на сообщение. Это намеренно функция для участников, а не для администраторов: люди, которые читают чат, часто первыми замечают проблему. Она управляется одной настройкой:

• set_reports_enabled — переключатель включения и выключения. По умолчанию выключен.

Чтобы пожаловаться на сообщение, участник отвечает на него и отправляет /report, при желании добавив короткую причину. Бот публикует уведомление внутри группы, чтобы администраторы увидели, на какое сообщение пожаловались и кто это сделал, а также записывает жалобу в журнал модерации, если он настроен.

Два правила не дают жалобам превратиться в источник шума:

• Ограничение частоты. Каждый участник может отправлять жалобу только раз в 30 секунд. Повторные жалобы в течение этого времени тихо игнорируются, чтобы никто не мог заспамить администраторов уведомлениями.
• Аккуратный чат. Сообщение с командой /report всегда удаляется после обработки, независимо от того, прошла ли жалоба, поэтому обсуждение не засоряется командами жалоб.

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

Журнал модерации

Журнал модерации дублирует действия системы модерации в отдельный канал, чтобы у администраторов была постоянная история событий без необходимости следить за группой в реальном времени. Он управляется одной настройкой:

• set_modlog_channel_id — числовой id канала, в который отправляется журнал. Укажите его в панели администратора группы в разделе Auto-Moderation. Если оставить поле пустым (по умолчанию), журнал будет отключён.

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

Чтобы журнал работал, бот должен быть администратором целевого канала — именно это позволяет ему публиковать сообщения там. Если бот не является администратором канала, записи журнала не смогут быть доставлены. Журнал работает по принципу best-effort: неудачная отправка отдельной записи никогда не блокирует само действие модерации, которое всё равно выполняется в группе.

Как эти функции работают вместе

Эти три функции дополняют друг друга. Жалобы позволяют участникам выносить проблемы на поверхность. Шкала предупреждений помогает администраторам реагировать соразмерно, усиливая меры только тогда, когда участник не прекращает нарушения. Журнал модерации фиксирует и то и другое, давая команде администраторов общую историю того, что произошло и кто действовал. Распространённая настройка — включить все три функции: участники жалуются, администраторы выдают предупреждения, а всё попадает в канал журнала для последующего просмотра.

Рекомендации

• Настройте лимит предупреждений в соответствии с терпимостью вашего сообщества. Лимит 3 даёт участникам две возможности исправиться до бана; увеличьте его для более мягкой группы или уменьшите для более строгой.
• По возможности выдавайте /warn ответом на сообщение с нарушением — так команда точно применяется к нужному участнику и меньше риск ошибиться в id.
• Используйте /warns перед решением о бане, чтобы проверить, является ли участник систематическим нарушителем или ошибся впервые.
• Создайте приватный канал журнала модерации, добавьте туда бота администратором и укажите его id в панели управления, чтобы у вашей команды была история действий.
• Включайте жалобы в больших группах, где администраторы не могут читать каждое сообщение; участники станут дополнительной парой глаз.

Итоги

Предупреждения, жалобы и журнал модерации превращают модерацию из набора разовых банов в систему. Участники сообщают о проблемах через /report, администраторы выдают поэтапные нарушения с помощью /warn, /unwarn и /warns, участник автоматически банится только после достижения заданного лимита, а каждое действие дублируется в канал журнала, если он настроен. Всё это остаётся выключенным, пока администратор не включит функции, а команды предупреждений доступны только администраторам.