Avisos, denúncias e o registro de moderação
Link to this sectionIntrodução
Link to this sectionNem 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
Link to this sectionA 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@handledele. 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
Link to this sectionAs 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
Link to this sectionO 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
Link to this sectionEsses 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
Link to this section- 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
/warncomo resposta à mensagem infratora — isso direciona o comando ao membro correto com a menor chance de erro ao digitar um id. - Use
/warnsantes 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
Link to this sectionAvisos, 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.