Back to blog

Moderadores, preserve 45 dias do registro de auditoria e vincule notas de caso

Ilustração isométrica de um arquivo e um cartão de notas de caso
Ilustração isométrica de um arquivo e um cartão de notas de caso

Use o registro de auditoria nativo do Discord para atribuição administrativa com autoridade e um canal privado de registro de moderação alimentado por bot para o histórico duradouro dos casos. O registro de auditoria só retém entradas por 45 dias, então qualquer coisa que você precise além dessa janela tem que viver no seu próprio canal de registro. Revise o acesso a dados de qualquer bot de logging antes de depender dele, e trave o canal de registro de moderação só para a equipe.

TL;DR: - O registro de auditoria do Discord oferece uma janela de 45 dias para acompanhar ações administrativas como banimentos, expulsões e mudanças de cargo, e exige registros externos para retenção mais longa. - Filtrar o registro de auditoria por tipo de ação e ID de usuário agiliza investigações de exclusões de mensagem, banimentos ou acertos do AutoMod dentro do prazo disponível. - Implementar um canal privado de registro de moderação alimentado por bot ajuda a preservar o histórico contínuo dos casos, incluindo avisos e evidências, além do limite nativo de 45 dias do Discord. - As boas práticas de configuração pedem revisar o acesso a dados do bot, reforçar permissões e vincular entradas de auditoria a IDs de caso para resolver disputas de membros com precisão. - Ferramentas de moderação automatizada como o Better Antispam reduzem o esforço de registro manual ao cuidar de ondas de spam e respostas a raids em tempo real, preenchendo o registro de moderação com incidentes já resolvidos.

Índice

O que o Discord registra nativamente: eventos do registro de auditoria e Página de membros/Visualização de moderação

O registro de auditoria embutido do Discord acompanha ações administrativas automaticamente, sem precisar de bot. Ele cobre uma faixa ampla de mudanças no servidor, embora nunca tenha sido feito para guardar narrativas detalhadas de moderação como históricos de aviso ou notas de evidência.

As categorias centrais que os moderadores mais consultam são:

  • Ações de membro: expulsões, banimentos, timeouts e mudanças de cargo.
  • Canais e configurações do servidor: criação, exclusão, exceções de permissão e mudanças de webhook.
  • Eventos de mensagem: exclusão única e exclusão em massa.
  • Eventos do AutoMod: mensagens bloqueadas e conteúdo sinalizado para um canal de revisão.

As entradas ficam nos sistemas do Discord por 45 dias, e a API as devolve em lotes de 1 a 100, com padrão de 50 por requisição, usando cursores before/after para paginar mais para trás. Essa janela importa: se uma disputa aparece dois meses depois do incidente, o rastro de auditoria já sumiu, a menos que você o tenha salvo em outro lugar.

Para investigações mais rápidas e centradas no membro, a Página de membros dá a donos e moderadores elegíveis uma Visualização de moderação com idade da conta, data de entrada, histórico de cargos e contagem de mensagens, além de ações de moderação diretas na mesma tela. É mais rápido do que o registro de auditoria para uma checagem de "o que essa pessoa anda fazendo", mas não substitui o registro administrativo de quem tomou qual ação e quando.

O que o Discord registra nativamente: eventos do registro de auditoria e Página de membros/Visualização de moderação — diagrama geral

Como consultar e filtrar o registro de auditoria do Discord

A maioria das perguntas do dia a dia ("quem baniu essa pessoa", "quem apagou aquela mensagem") se responde no cliente em menos de um minuto.

  1. Abra Configurações do servidor e selecione Registro de auditoria na barra lateral esquerda.
  2. Confirme que você tem a permissão VIEW_AUDIT_LOG; sem ela, a aba não mostra entradas.
  3. Use os menus de filtro para restringir os resultados por tipo de ação ou pelo moderador que a realizou.
  4. Role a lista paginada, já que o Discord carrega as entradas em lotes, e não todas de uma vez.

Para bots e ferramentas próprias, os mesmos dados estão disponíveis em GET /guilds/{guild.id}/audit-logs, que aceita os parâmetros user_id, action_type e before/after, junto com um limit entre 1 e 100 (padrão 50). Os resultados voltam em ordem cronológica inversa, então a paginação com cursores é o jeito confiável de andar mais para trás antes do corte de 45 dias.

Para achar quem apagou mensagens, filtre pelos tipos de ação MESSAGE_DELETE ou MESSAGE_BULK_DELETE em vez de rolar na mão. Rastrear um banimento, uma mudança de cargo ou um acerto do AutoMod funciona do mesmo jeito: filtre primeiro pelo tipo de ação específico e depois restrinja pelo ID de usuário se você souber quem estava envolvido.

Dica: Quando o seu bot realizar uma ação que valha a pena auditar, passe o cabeçalho X-Audit-Log-Reason. O Discord armazena até 512 caracteres com URL-encoding no campo de motivo da entrada, o que te poupa uma busca depois.

Monte um canal persistente de registro de moderação e um bot de logging

O registro de auditoria te diz qual foi a ação administrativa. Um canal de registro de moderação te conta a história em volta: avisos, incidentes anteriores, evidências e desfecho, e é a peça que a maioria dos servidores pula até precisar dela.

No mínimo, cada entrada do registro de moderação deve gravar:

  • Um ID de caso para cruzar depois.
  • Tipo de evento (aviso, mute, banimento, expulsão, nota).
  • ID do usuário ou objeto alvo e o moderador ou bot que agiu.
  • Motivo, timestamp, quaisquer links de evidência e o ID da entrada de auditoria quando existir.

Na configuração, mantenha o canal privado só para cargos da equipe, decida cedo se as entradas vão como embeds ou texto puro (embeds são mais fáceis de varrer, mas mais difíceis de pesquisar pelo texto cru) e feche uma política de retenção, inclusive se casos antigos vão para um banco externo quando o canal crescer demais.

Antes de soltar um bot de logging num servidor ao vivo, passe por um checklist curto: revise a aba Acesso a dados, conceda só as permissões de que ele realmente precisa, teste primeiro num servidor de teste, confirme que os registros cruzam limpo com as entradas reais de auditoria e verifique se ele suporta o cabeçalho X-Audit-Log-Reason nas próprias ações.

Dica: Estruture seus registros de caso do jeito que o módulo modlog do Redbot faz, com as funções create_case e get_case, para você consultar o histórico completo de um membro em vez de rolar um canal.

Privacidade, retenção e considerações de política

O próprio registro de auditoria do Discord limpa as entradas depois de 45 dias, mas um registro de moderação alimentado por bot pode persistir indefinidamente, o que transfere responsabilidade de verdade para você como operador. Quanto mais tempo você guarda dados de moderação, mais cuidado precisa ter sobre quem pode vê-los e por quê.

Algumas práticas mantêm essa responsabilidade administrável:

  • Nunca publique evidência NSFW direto num canal de registro de moderação; descreva ou linke para um local com acesso controlado.
  • Restrinja por idade qualquer canal que possa conter evidência sexualmente explícita, de acordo com a política de conteúdo sexual do Discord.
  • Escale casos sensíveis para um grupo pequeno e nomeado de staff de confiança, em vez de toda a equipe de moderação.
  • Leia os termos do desenvolvedor do bot de logging e a orientação de acesso a dados de bots do Discord antes de ativar o registro completo de mensagens ou anexos.

Armazenar só metadados, timestamps, IDs de usuário e tipos de ação, em vez do conteúdo cru, em geral responde à pergunta de moderação sem criar um passivo desnecessário de privacidade.

Cruzar entradas do registro de auditoria com registros do bot: fluxo de atribuição passo a passo

Um registro de bot e o registro de auditoria nativo descrevem o mesmo evento por dois ângulos, e timestamps desalinhados ou entradas faltando são a fonte mais comum de confusão entre moderadores. Um método consistente de cruzamento resolve isso.

  1. Capture primeiro a entrada do registro do bot, anotando timestamp, ID de usuário e ação.
  2. Busque entradas do registro de auditoria em torno daquele timestamp usando cursores before/after, em vez de varrer o histórico inteiro.
  3. Filtre os resultados por action_type e user_id para restringir aos candidatos prováveis.
  4. Confirme o cruzamento e grave o ID da entrada de auditoria no seu registro de caso para referência futura.

Quando VIEW_AUDIT_LOG falta, o conserto é uma mudança de permissão, não um atalho: conceda essa permissão ao cargo em vez de tentar inferir ações só pelos registros do bot. Quando as entradas de auditoria relevantes já passaram da janela de retenção de 45 dias, o registro de caso alimentado por bot vira o único rastro que sobrou, e esse é o motivo central de mantê-lo rodando o tempo todo.

Dica: Registre o ID da entrada de auditoria no instante em que achar o cruzamento. Procurá-lo de novo depois, quando a entrada já expirou, não é possível.

Um fluxo de moderador baseado em registros de caso estruturados

Servidores que mantêm registros de caso estruturados, em vez de depender da memória ou de capturas espalhadas, resolvem disputas de membros mais rápido porque o registro já diz o que aconteceu, quem agiu e por quê. Essa estrutura também importa quando um caso sobe para uma denúncia na plataforma ou para uma apelação, já que uma linha do tempo clara pesa mais do que uma recordação.

A automação tira boa parte do fardo manual daqui. O Better Antispam cuida da detecção de ondas de spam, da resposta a raids e da limpeza de canais em tempo real, o que significa menos ações manuais para um moderador humano registrar na mão.

Para servidores pequenos e médios, uma linha de base viável é simples: capture o evento, cruze com o registro de auditoria, armazene num registro de caso pesquisável e escale qualquer coisa que precise de um segundo olhar.

Fluxo estruturado de caso de moderação em quatro etapas

O que a maioria dos servidores erra nos registros de moderação

A maior parte da orientação sobre o tema trata o registro de auditoria como se fosse um histórico completo de moderação, e não é. É um registro administrativo de 45 dias feito para responsabilização, não um arquivo de evidências, e servidores que nunca montam o próprio registro de caso só descobrem isso depois de precisarem de um rastro que já não existe.

A lacuna maior não é volume de registro, é disciplina de cruzamento. Muitos servidores rodam um bot de logging e ainda assim não conseguem responder "a gente já baniu essa pessoa pela mesma coisa da última vez", porque ninguém cruza as entradas do bot com os IDs de usuário e os tipos de ação do registro de auditoria. Um canal de registro de moderação cheio de mensagens sem vínculo é só um pouco melhor do que nenhum registro.

Priorize primeiro a parte chata: um esquema consistente de ID de caso, o hábito de colar o ID da entrada de auditoria em cada nota de caso, e um canal travado para o menor grupo de staff que de fato precisa dele. Automação e formatação podem vir depois.

— Adam

Como o Better Antispam ajuda nos registros de moderação

Betterantispam

Montar registros de moderação confiáveis exige menos esforço manual quando as ações de moderação que geram esses registros são tratadas automaticamente. O Better Antispam responde a ondas de spam, golpes e tentativas de raid em tempo real, silenciando spammers ou travando canais antes de um humano precisar intervir, o que significa que o seu registro de caso se enche de incidentes resolvidos em vez de caos em andamento.

Recursos relevantes para um fluxo de registro incluem resposta automatizada a spam e raid com limpeza instantânea de canal, opções flexíveis de verificação de membros, monitoramento de mudanças de permissão, proteção contra sabotagem da equipe e recursos de tratamento de casos para ações de moderação em massa.

Adicione-o primeiro a um servidor de teste, revise a aba Acesso a dados, ative só os escopos de que a sua equipe realmente precisa e rode um incidente simulado antes de ir ao ar. Detalhes de preço e configuração estão na página do Better Antispam.

Mantenha estes à mão nos recursos da equipe ou no roteiro de incidente:

Fontes

Perguntas frequentes

Como consultar os registros de moderação do Discord?

Abra Configurações do servidor, selecione Registro de auditoria e confirme que você tem a permissão VIEW_AUDIT_LOG para ver as entradas. Dá para filtrar por tipo de ação ou moderador no mesmo painel, e desenvolvedores podem puxar os mesmos dados pela API do registro de auditoria.

Como consultar a atividade de moderação no Discord?

O registro de auditoria mostra ações administrativas como banimentos, expulsões e mudanças de cargo dos últimos 45 dias, filtráveis por moderador ou tipo de ação. Para uma visão específica de um membro, a Página de membros e a Visualização de moderação reúnem detalhes da conta e ferramentas de moderação no mesmo lugar.

NSFW viola os Termos de Serviço do Discord?

Conteúdo sexualmente explícito não é automaticamente contra as regras do Discord, mas precisa ficar em canais restritos por idade segundo a política de conteúdo sexual do Discord. Publicar esse conteúdo fora de um canal devidamente restrito, ou expô-lo a membros menores de idade, viola a política.

Como vejo registros no Discord?

Ações administrativas nativas aparecem em Configurações do servidor, em Registro de auditoria, retidas por 45 dias segundo a documentação do Discord. Para qualquer coisa mais antiga, ou para notas de caso detalhadas, você precisa de um canal de registro de moderação alimentado por bot montado com antecedência, já que o Discord não guarda esse histórico por conta própria.

Recomendado

Criado com a tecnologia BabyLoveGrowth

BetterAntispam on Nick LaunchesFeatured on ToolFameFeatured on Startup FameVerified on DANG!ToolpilotToolpilotFeatured on SaaSGrowFeatured on ShowMeBestAIFazierSubmit AI ToolsFeatured on Twelve ToolsFeatured on Wired BusinessFeatured on Findly.toolsListed on Turbo0Featured on SaaSFameFeatured on neeed.directoryFeatured on Dofollow.ToolsGood AI ToolsAI Agents DirectoryAura++SideProjectorsFoundrListShinyLaunchStartup FastNextGen ToolsFind-Us-HereDeepLaunchAcid ToolsStartupBaseNewToolUFindWhatsYourHoursOpenHuntsMarketingDBStartup InspireStarter BestTiny StartupsFeatured on aitoolfame.comFeatured on IndieHuntShinyLaunchLaunched on LaunchPandaFeatured on WhatsthebigdataFeatured on Yo.directoryAs seen on Launch Llama Newsletterbetterantispam.com Domain RatingVerified DR - Verified Domain Rating for betterantispam.comFeatured on ToolfioBetterAntispam | Firsto LaunchFeatured on DailyPingsFeatured on DanielLaunchesFeatured on ShipBoostFeatured on AgentWork.ToolsFeatured on SaaSCityFeatured on WayfindioFeatured on DodoDirectoryFeatured on TinyLaunchpadFeatured on ListMySaaSVerified on directreeFeatured on Submit HuntFeatured on VibeCodingListFeatured on NoonlaunchFeatured on LaunchItListed on MaidensailVerified on Endors — BetterAntispamMarked on IndieAscentListed on CurlShipListed on PublishYourSaaS