Avisos, denúncias e o registro de moderação

Introdução

Nem toda decisão de moderação deve ser um banimento imediato. Um membro que quebra uma regra uma vez talvez só precise de um lembrete; já um membro que continua quebrando regras deve enfrentar uma consequência clara e previsível. Este conjunto de recursos oferece aos admins uma forma gradual de lidar com comportamentos — uma escala de avisos que só evolui para banimento após infrações repetidas, uma maneira de membros comuns sinalizarem mensagens problemáticas para os admins e um registro privado que documenta o que o sistema de moderação fez.

Cada recurso vem desativado por padrão e não toma nenhuma ação até que um admin o habilite no painel do grupo. Ativar o bot não começa, silenciosamente, a avisar ou banir ninguém.

A escala de avisos

A escala de avisos permite que admins apliquem infrações a um membro. Quando a contagem de infrações atinge um limite configurado, o membro é banido automaticamente e sua contagem é zerada. Ela é controlada por duas configurações:

• set_warnings_enabled — o interruptor de ativar/desativar. Desativado por padrão.
• set_warn_limit — o número de infrações que aciona um banimento. Padrão 3.

Três comandos exclusivos para admins gerenciam as infrações:

• /warn — aplica uma infração. Responda à mensagem do membro ou informe o id numérico ou @handle dele. Você pode adicionar um motivo opcional, por exemplo /warn @user spamming links.
• /unwarn — remove uma infração de um membro, caso um aviso tenha sido aplicado por engano.
• /warns — verifica quantas infrações um membro tem no momento, em relação ao limite.

Quando um /warn leva um membro ao limite — por exemplo, a terceira infração com o limite padrão de 3 — o bot o bane e limpa sua contagem de infrações. Abaixo do limite, o bot registra a nova infração e responde com a contagem atual, para que tanto o admin quanto o membro vejam como está a situação. A própria mensagem do comando é removida depois de processada, mantendo o chat visível organizado.

Todos os três comandos são exclusivos para admins. Um membro comum que tentar usá-los será recusado, e ninguém pode avisar a si mesmo.

Denúncias de membros

As denúncias permitem que membros comuns sinalizem uma mensagem para a atenção dos admins. Isso é, deliberadamente, um recurso para membros, não para admins: as pessoas que leem o chat costumam ser as primeiras a perceber um problema. Ele é controlado por uma única configuração:

• set_reports_enabled — o interruptor de ativar/desativar. Desativado por padrão.

Para denunciar uma mensagem, um membro responde a ela e envia /report, opcionalmente com um motivo curto. O bot publica um aviso dentro do grupo para que os admins vejam qual mensagem foi sinalizada e por quem, e registra a denúncia no registro de moderação se houver um configurado.

Duas regras evitam que as denúncias se tornem um incômodo:

• Limite de frequência. Cada membro só pode denunciar uma vez a cada 30 segundos. Denúncias repetidas dentro dessa janela são ignoradas discretamente, para que ninguém consiga bombardear os admins com avisos de denúncia.
• Chat organizado. A mensagem do comando /report é sempre apagada depois de processada, quer a denúncia seja enviada ou não, para que a conversa sinalizada não fique poluída com comandos de denúncia.

Uma denúncia, por si só, não pune ninguém. Ela é um sinal para os admins, que então decidem se devem avisar, silenciar, banir ou não tomar nenhuma ação.

O registro de moderação

O registro de moderação espelha o que o sistema de moderação faz em um canal separado, para que os admins tenham um histórico contínuo sem precisar acompanhar o grupo em tempo real. Ele é controlado por uma configuração:

• set_modlog_channel_id — o id numérico do canal que recebe o registro. Configure-o no painel de administração do grupo, na seção Moderação Automática. Deixá-lo vazio (o padrão) desativa o registro.

Quando um id de canal é definido, o bot publica uma entrada de uma linha para eventos de moderação à medida que eles acontecem. Isso inclui avisos aplicados, banimentos (tanto banimentos por limite de avisos quanto outros banimentos automáticos, como o de um abusador conhecido banido), denúncias de membros e bloqueios contra raids. Cada entrada informa a ação, o membro envolvido e o admin ou sistema que a executou.

Para que o registro funcione, o bot precisa ser admin do canal de destino — é isso que permite que ele publique lá. Se o bot não for admin do canal, as entradas de registro não poderão ser entregues. O registro funciona em modo de melhor esforço: uma falha ao publicar uma única entrada nunca bloqueia a própria ação de moderação, que ainda acontece no grupo.

Como esses recursos se complementam

Esses três recursos são complementares. As denúncias permitem que membros tragam problemas à tona. A escala de avisos permite que admins respondam de forma proporcional, escalando apenas quando um membro não para. O registro de moderação documenta ambos, dando à equipe de admins um histórico compartilhado do que aconteceu e de quem agiu. Uma configuração comum é habilitar os três: membros denunciam, admins aplicam avisos, e tudo vai para o canal de registro para revisão.

Boas práticas

• Defina o limite de avisos de acordo com a tolerância da sua comunidade. Um limite de 3 dá aos membros duas chances antes de um banimento; aumente-o para um grupo mais tolerante, reduza-o para um grupo mais rígido.
• Prefira aplicar /warn como resposta à mensagem infratora — isso direciona o comando ao membro correto com a menor chance de erro ao digitar um id.
• Use /warns antes de uma decisão de banimento para verificar se um membro é reincidente ou se é a primeira vez.
• Crie um canal privado de registro de moderação, adicione o bot como admin lá e defina o id dele no painel para que sua equipe tenha uma trilha de auditoria.
• Habilite denúncias em grupos maiores, onde os admins não conseguem ler todas as mensagens; os membros se tornam um par extra de olhos.

Resumo

Avisos, denúncias e o registro de moderação transformam a moderação de uma série de banimentos isolados em um sistema. Membros sinalizam problemas com /report, admins aplicam infrações graduais com /warn, /unwarn e /warns, um membro só é banido automaticamente depois de atingir o limite configurado, e cada ação é espelhada para um canal de registro quando houver um configurado. Tudo isso permanece desativado até que um admin habilite, e os comandos de aviso ficam restritos aos admins.