Apagar as mensagens de um membro

Apague todas as mensagens que um membro deixou no seu servidor, mesmo que ele já tenha saído ou sido banido.

Um comando faz isso: /purge-user (equipe, apaga de forma definitiva).

🧹 Apagar as mensagens de um membro: `/purge-user`

/purge-user percorre os seus canais e tópicos e apaga as mensagens escritas por uma única conta. Use depois de uma onda de spam, com uma conta de raid ou com um membro que postou algo que você quer ver sumir de todo lugar.

Digite /purge-user.
Em user, informe uma menção ou o ID de usuário do Discord do membro (de 17 a 20 dígitos). Para copiar o ID, ative o Modo desenvolvedor (Developer Mode; Configurações de usuário, Avançado) no Discord, clique com o botão direito no membro e escolha Copiar ID do usuário (Copy User ID). Um membro que saiu ou foi banido não pode mais ser mencionado: use o ID dele.
Se quiser, restrinja com channel, days e reason (veja abaixo) e pressione Enter.
O bot mostra o que está prestes a fazer, com dois botões: Confirm e Cancel.
Pressione Confirm. A exclusão começa e a mensagem é atualizada ao longo do processo.

Tudo o que o bot diz durante isso é privado: só você vê.

As opções

Opção	Obrigatória	O que faz
`user`	sim	Uma menção ou um ID de usuário puro (de 17 a 20 dígitos).
`channel`	não	Somente este canal e os tópicos dentro dele. Sem ela, todos os canais do servidor são percorridos.
`days`	não	Somente as mensagens dos últimos N dias, de 1 a 5000. Sem ela, todo o histórico é percorrido.
`reason`	não	Até 512 caracteres. É escrita no seu canal de logs de moderação e não é enviada ao membro.

🎯 O que ele alcança e o que não alcança

Leia isto antes de confirmar.

Ele alcança as mensagens escritas por essa conta em canais de texto, de anúncios, de voz e de palco, e em tópicos (ativos e arquivados, incluindo posts de fórum e de mídia), mas somente onde você e o bot podem gerenciar mensagens.

O bot verifica as suas permissões canal por canal, não apenas o seu cargo no servidor inteiro. Um canal só é limpo se:

você o vê e tem Manage Messages nele, e
o bot o vê, consegue ler o histórico e tem Manage Messages nele.

Se faltar uma permissão a um de vocês em um canal, esse canal é deixado intacto. O comando não falha: continua com os outros canais e lista esses no relatório final.

Dois tipos de tópico são mais rígidos:

Tópicos privados: você também precisa de Manage Threads. Sem isso, o tópico é deixado de lado e não é citado no relatório.
Tópicos arquivados: o bot também precisa de Manage Threads. Ele reabre o tópico, apaga as mensagens e o arquiva de novo. Tópicos privados arquivados só são procurados quando você e o bot têm Manage Threads no canal pai.

Ele não faz o seguinte:

banir, expulsar, silenciar ou advertir o membro, e não acrescenta nada ao histórico de moderação dele. Ele apenas apaga mensagens. Se o membro ainda está no servidor, use /ban ou /mute separadamente.
alcançar um canal que você mesmo não pode gerenciar, mesmo que o bot possa. É de propósito: o comando nunca deixa você apagar o que não poderia apagar à mão.
apagar mensagens que o membro postar depois que o bot já percorreu aquele canal.
mexer em outros servidores ou em mensagens diretas.
citar um canal que você não vê. Ele fica fora do relatório, que portanto não pode revelar que ele existe.

O bot recusa o próprio ID: limpá-lo apagaria o histórico do seu canal de logs e quebraria os painéis de cargos, tickets, verificação e sorteios que ele acompanha.

⏳ Quanto tempo leva, e o relatório

O Discord não oferece busca para bots, então o bot lê o histórico de cada canal página por página e separa as mensagens do membro.

Mensagens com menos de 14 dias são apagadas em grupos de até 100.
Mensagens com mais de 14 dias só podem ser apagadas uma a uma. Em um servidor movimentado com um histórico longo, isso pode levar muito tempo. Restrinja com days ou channel quando puder.
A mensagem de progresso é atualizada no máximo a cada 5 segundos: quantas mensagens já foram apagadas, o canal em andamento e quantos canais faltam.
Só uma limpeza pode rodar por vez em cada servidor. Uma segunda recebe "A purge is already running on this server".

Quando termina, o bot responde com o número de mensagens apagadas, o número de canais percorridos e uma lista por canal. O relatório também pode conter:

Not purged (your permissions): canais em que falta uma permissão a você.
Skipped (bot permissions): canais em que falta uma ao bot.
Failed, the other channels went on: canais que pararam por causa de um erro. O que já foi apagado ali continua apagado.
uma contagem das mensagens que não puderam ser apagadas, por canal.

Uma lista longa é cortada com "… and N more". Se nada foi encontrado, você recebe o mesmo relatório com 0 mensagens apagadas.

Se a limpeza durar mais de 14 minutos

O Discord só deixa o bot editar a resposta por 15 minutos. Cerca de 14 minutos depois de você digitar o comando, o bot para de atualizar a mensagem e envia o relatório final para você por mensagem direta, com o nome do servidor no fim. Confira se as suas mensagens diretas de membros do servidor estão abertas, ou você pode não vê-lo. As entradas do canal de logs (abaixo) são escritas de qualquer forma.

⚠️ Confirmação e cancelamento

A confirmação cita o membro, diz quais canais e quantos dias são cobertos e traz This cannot be undone (não pode ser desfeito).
Só você pode pressionar os botões.
Você tem 60 segundos. Depois disso, a mensagem diz "Confirmation expired: nothing was deleted." e nada acontece.
Cancel interrompe tudo: "Cancelled: nothing was deleted."
Depois de pressionar Confirm, não dá mais para cancelar. Os botões desaparecem e não existe comando para interromper. Se o bot reiniciar no meio, a limpeza para onde estava: o que foi apagado continua apagado, o resto fica no lugar.

Mensagens apagadas não podem ser recuperadas. O bot não guarda o conteúdo das mensagens que apaga.

📋 O que é registrado

Se você definiu um canal de logs de moderação, duas entradas aparecem nele:

MESSAGE PURGE STARTED, escrita antes da primeira exclusão: o membro, o escopo, o seu nome e o motivo. Se a limpeza for interrompida, você ainda sabe quem a iniciou e contra quem.
MESSAGES PURGED, escrita no fim: quantas mensagens foram apagadas e em quantos canais, com os mesmos detalhes.

Nenhuma das duas entradas contém o texto de uma mensagem, apenas números.

🔑 Quem pode usar

Todas estas condições precisam ser verdadeiras:

o recurso Moderação está ativado no servidor
a pessoa tem a permissão Manage Messages no Discord. É essa permissão que torna o comando visível.
se você definiu Cargos de moderador permitidos (comandos de barra) nas configurações de Moderação, ela também tem um desses cargos
ela tem Manage Messages em cada canal que quer limpar, como explicado acima (e Manage Threads para tópicos privados)

O bot precisa, em cada canal que deve limpar, de: View Channel, Read Message History e Manage Messages. Para tópicos arquivados, também Manage Threads.

💡 Exemplo

Uma conta de spam entrou no servidor, postou links de convite em vários canais e foi banida dois dias depois.

Copie o ID da conta (um usuário banido não pode ser mencionado).
Digite /purge-user user:123456789012345678 days:3 reason:invite spam.
O bot pede que você confirme. Pressione Confirm.
No fim, o relatório informa quantas mensagens foram apagadas, em quantos canais e quantos canais foram percorridos.
Um canal listado em Not purged (your permissions) é um canal em que você não tem Manage Messages, por exemplo um canal só da equipe. Outro moderador pode executar o comando com channel definido para ele, se for preciso.

🔧 Quando algo dá errado

🚨 "Give a user mention or a Discord user ID (17 to 20 digits)"

O campo user não é uma menção nem um ID. Copie o ID de novo com o Modo desenvolvedor ativado. Um nome ou uma tag não funciona.

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

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

🚨 "This server is not registered in the YAWBDB panel"

O servidor não está conectado ao painel. Conecte-o primeiro.

🚨 "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.

🚨 "A purge is already running on this server"

Outra limpeza está em andamento. Espere o relatório dela e depois execute a sua.

🚨 "I could not read your permissions on this server, so nothing was deleted"

O Discord não passou as suas permissões ao bot. Nada foi apagado. Tente de novo daqui a pouco.

🚨 Não vejo `/purge-user` na lista de comandos

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

🚨 Algumas mensagens ainda estão lá depois do relatório

Veja o relatório: um canal em Not purged (your permissions) ou Skipped (bot permissions) foi deixado intacto, e um tópico privado sem Manage Threads também é ignorado. Corrija a permissão e execute o comando de novo com channel. Executar de novo é seguro: as mensagens que já sumiram simplesmente não são encontradas.

🚨 Limpei o membro errado

Não pode ser desfeito. As mensagens se foram para sempre.

Apagar as mensagens de um membro