Comandos de histórico

Consulte os registros de moderação de um membro no seu servidor, deixe os membros verem os próprios registros e apague os registros já encerrados de um membro quando ele merecer começar do zero.

Três comandos fazem isso: /history (equipe), /my-history (qualquer pessoa) e /clear-history (equipe, apaga).

🔎 Ver o registro de um membro: /history

1. Copie o ID de usuário do Discord do membro: no Discord, ative o Modo desenvolvedor (Developer Mode; Configurações de usuário, Avançado), clique com o botão direito no membro e escolha Copiar ID do usuário (Copy User ID).
2. Digite /history, cole o ID em user_id e pressione Enter.
3. O bot responde em privado, só para você, com os 10 últimos registros, do mais recente para o mais antigo.

Cada linha tem este formato:

1. BAN 🔴 (3d) - spamming invites - 2 hours ago #418

• o tipo em maiúsculas (BAN, MUTE, KICK, WARN, SOFTBAN, UNBAN, UNMUTE)
• 🔴 quando o registro ainda está ativo
• a duração entre parênteses para bans, mutes e softbans
• o motivo, ou "No reason"
• quando aconteceu
• o número do caso depois do #. É esse número que você usa com /reason para mudar o texto de um registro.

Você precisa da permissão Kick Members no Discord para ver o comando. A mesma lista, com mais detalhes, está no painel: Moderação → aba Histórico, uma tabela com uma linha por registro que você pode filtrar por tipo e por status.

🙋 Deixar os membros verem o próprio registro: /my-history

Qualquer pessoa pode digitar /my-history. O bot mostra, em privado, os 10 últimos registros de moderação que o servidor guarda sobre ela. É um jeito rápido de resolver o "por que eu levei um aviso?" sem incomodar a equipe.

• Exige o recurso Moderação ativado no seu servidor. Se estiver desativado, o membro recebe uma mensagem dizendo isso.
• Ignora a configuração Cargos de moderador permitidos: nenhum cargo é necessário.
• Com um prefixo de comandos de texto definido, !my-history também funciona, mas uma resposta em texto não pode ser privada: o bot a publica no canal e a apaga depois de 30 segundos.
• Um membro sem registros recebe "You have no moderation records on this server." (Você não tem registros de moderação neste servidor.)

A página do próprio membro no painel, Minhas Sanções, lista os mesmos registros de todos os servidores.

🧹 Apagar os registros encerrados de um membro: /clear-history

/clear-history apaga todos os registros que não estão mais ativos de um membro no seu servidor. Use quando alguém cumpriu a pena e você quer deixar a ficha limpa.

1. Confirme que o membro não tem nada ativo (veja abaixo).
2. Digite /clear-history, cole o ID de usuário do membro em user_id e pressione Enter.
3. O bot responde Cleared N inactive records for @member ou No inactive records found for @member.

Isso não pode ser desfeito. Os registros são apagados, não ocultados.

O que conta como inativo

Os registros ativos não são tocados. Se você quer que os avisos de um membro também sumam, remova-os primeiro no painel e depois use /clear-history.

Quem pode usar

Todas estas condições precisam ser verdadeiras:

• o recurso Moderação está ativado no servidor
• a pessoa tem a permissão Ban Members no Discord (atenção: mais alta que a de /history, que exige Kick Members)
• se você definiu Cargos de moderador permitidos (comandos de barra) nas configurações de Moderação, ela também tem um desses cargos

A mesma ação no painel

Moderação → aba Histórico, depois Limpar tudo em qualquer registro encerrado (não ativo) desse membro: clique e clique de novo onde está escrito Clique novamente para confirmar. Isso remove todos os registros encerrados do membro, a mesma exclusão do comando.

O botão do painel grava uma linha no Registro de auditoria do seu servidor ("Cleared N inactive sanction(s)...") e, se você definiu um canal de log de moderação, publica lá também. O comando /clear-history não faz nenhuma das duas coisas: não deixa entrada no Registro de auditoria e não publica nada no canal de log. Se a sua equipe quer um rastro visível, use o botão do painel ou escreva uma linha no canal de log manualmente.

💡 Exemplo

Um membro levou dois avisos em março e foi silenciado por um dia em abril. Estamos em outubro e ele se comportou bem.

1. /history user_id:123456789012345678 mostra: MUTE (1d, sem ponto, encerrado), WARN 🔴, WARN 🔴.
2. Os dois avisos ainda estão em 🔴, então /clear-history sozinho removeria apenas o mute.
3. No painel: Moderação → aba Histórico, encontre o membro e clique em Remover na linha de cada aviso.
4. Agora /clear-history user_id:123456789012345678. O bot responde Cleared 3 inactive records e a ficha do membro fica vazia.

🔧 Quando algo dá errado

🚨 "The Moderation feature is not enabled for this server"

Ative o recurso no painel e tente de novo. A mensagem contém o link.

🚨 "You do not have a role that is allowed to use moderation commands on this server"

O seu servidor limita os comandos de moderação a certos cargos. Peça a um administrador para adicionar o seu em Cargos de moderador permitidos (comandos de barra) ou para esvaziar essa lista.

🚨 Não vejo /clear-history na lista de comandos

O Discord o esconde de quem não tem Ban Members. Um administrador do servidor também pode mudar quem o vê em Configurações do servidor → Integrações → YAWBDB (Server Settings → Integrations).

🚨 "No inactive records found", mas /history mostra registros

Os registros ainda estão ativos. Revogue ou remova-os primeiro no painel (avisos e softbans só são removidos manualmente).

🚨 "Failed to clear history" ou "Server not registered in panel"

O bot não conseguiu falar com o painel, ou o servidor não está conectado a ele. Tente de novo em um minuto; se o servidor é novo, conecte-o primeiro.

🚨 Apaguei o registro do membro errado

Não dá para restaurar. Recrie os registros a partir das suas anotações ou do seu Registro de auditoria; o Registro de auditoria guarda uma linha apenas para uma limpeza feita pelo painel.

🚨 /my-history diz que o servidor não está registrado

Mesma causa de cima: o servidor não está conectado ao painel.