Berichten van een lid wissen

Wis alle berichten die een lid op je server heeft achtergelaten, ook van een lid dat al weg is of verbannen werd.

Eén commando doet dit: /purge-user (staff, wist definitief).

🧹 De berichten van een lid wissen: `/purge-user`

/purge-user loopt door je kanalen en threads en wist de berichten van één account. Gebruik het na een spamgolf, bij een raid-account of bij een lid dat iets heeft gepost dat je overal weg wilt hebben.

Typ /purge-user.
Geef bij user een vermelding of het Discord-gebruikers-ID van het lid op (17 tot 20 cijfers). Om het ID te kopiëren zet je in Discord de Ontwikkelaarsmodus aan (Developer Mode; Gebruikersinstellingen, Geavanceerd), klik je met de rechtermuisknop op het lid en kies je Gebruikers-ID kopiëren (Copy User ID). Een lid dat is weggegaan of verbannen kan niet meer worden vermeld: gebruik dan het ID.
Beperk het eventueel met channel, days en reason (zie hieronder) en druk op Enter.
De bot laat zien wat hij gaat doen, met twee knoppen: Confirm en Cancel.
Druk op Confirm. Het wissen begint en het bericht wordt onderweg bijgewerkt.

Alles wat de bot hierbij zegt is privé: alleen jij ziet het.

De opties

Optie	Verplicht	Wat ze doet
`user`	ja	Een vermelding of een kaal gebruikers-ID (17 tot 20 cijfers).
`channel`	nee	Alleen dit kanaal en de threads erin. Zonder deze optie wordt elk kanaal van de server doorzocht.
`days`	nee	Alleen berichten van de afgelopen N dagen, van 1 tot 5000. Zonder deze optie wordt de hele geschiedenis doorzocht.
`reason`	nee	Tot 512 tekens. Ze wordt in je moderatielogkanaal geschreven en niet naar het lid gestuurd.

🎯 Wat het bereikt en wat niet

Lees dit voordat je bevestigt.

Het bereikt de berichten van dat account in tekst-, aankondigings-, spraak- en stagekanalen en in threads (actieve en gearchiveerde, inclusief forum- en mediaberichten), maar alleen waar zowel jij als de bot berichten mag beheren.

De bot controleert je permissies kanaal voor kanaal, niet alleen je rol voor de hele server. Een kanaal wordt alleen gewist als:

jij het ziet en daar Manage Messages hebt, en
de bot het ziet, de geschiedenis kan lezen en daar Manage Messages heeft.

Mist een van jullie een permissie in een kanaal, dan blijft dat kanaal onaangeroerd. Het commando faalt niet: het gaat door met de andere kanalen en noemt deze in het eindrapport.

Twee soorten threads zijn strenger:

Privéthreads: je hebt ook Manage Threads nodig. Zonder wordt de thread overgeslagen en niet in het rapport genoemd.
Gearchiveerde threads: ook de bot heeft Manage Threads nodig. Hij heropent de thread, wist de berichten en archiveert hem daarna weer. Gearchiveerde privéthreads worden alleen opgezocht als jij en de bot allebei Manage Threads hebben op het bovenliggende kanaal.

Het doet dit niet:

het lid verbannen, kicken, muten of waarschuwen, en het voegt niets toe aan de moderatiegeschiedenis. Het wist alleen berichten. Zit het lid nog op de server, gebruik dan /ban of /mute apart.
een kanaal bereiken dat je zelf niet kunt beheren, ook al kan de bot dat wel. Dat is bewust: het commando laat je nooit iets wissen wat je niet met de hand zou kunnen wissen.
berichten wissen die het lid plaatst nadat de bot dat kanaal al heeft doorzocht.
andere servers of directe berichten aanraken.
een kanaal noemen dat je niet kunt zien. Het blijft buiten het rapport, dat je dus ook niet kan verraden dat het bestaat.

De bot weigert zijn eigen ID: hem wissen zou de geschiedenis van je logkanaal wegvegen en de panelen voor rollen, tickets, verificatie en weggeefacties breken die hij bijhoudt.

⏳ Hoe lang het duurt, en het rapport

Discord biedt bots geen zoekfunctie, dus de bot leest de geschiedenis van elk kanaal pagina voor pagina en pikt de berichten van het lid eruit.

Berichten die jonger zijn dan 14 dagen worden gewist in groepen van maximaal 100.
Berichten die ouder zijn dan 14 dagen kunnen alleen één voor één worden gewist. Op een drukke server met een lange geschiedenis kan dat lang duren. Beperk het met days of channel waar mogelijk.
Het voortgangsbericht wordt hoogstens elke 5 seconden bijgewerkt: hoeveel berichten er tot nu toe zijn gewist, in welk kanaal de bot zit en hoeveel kanalen er nog volgen.
Per server kan er maar één wisactie tegelijk lopen. Een tweede krijgt "A purge is already running on this server".

Als de bot klaar is, antwoordt hij met het aantal gewiste berichten, het aantal doorzochte kanalen en een lijst per kanaal. Het rapport kan ook bevatten:

Not purged (your permissions): kanalen waar je een permissie mist.
Skipped (bot permissions): kanalen waar de bot er een mist.
Failed, the other channels went on: kanalen die op een fout zijn gestopt. Wat daar al is gewist, blijft gewist.
het aantal berichten dat niet kon worden gewist, per kanaal.

Een lange lijst wordt afgekapt met "… and N more". Is er niets gevonden, dan krijg je hetzelfde rapport met 0 gewiste berichten.

Als het wissen langer dan 14 minuten duurt

Discord laat de bot zijn antwoord maar 15 minuten bewerken. Ongeveer 14 minuten nadat je het commando typte, stopt de bot met het bijwerken van het bericht en stuurt hij je het eindrapport in plaats daarvan als direct bericht, met de servernaam onderaan. Zorg dat directe berichten van serverleden bij je openstaan, anders mis je het misschien. De items in het logkanaal (hieronder) worden hoe dan ook geschreven.

⚠️ Bevestigen en annuleren

De bevestiging noemt het lid, zegt welke kanalen en hoeveel dagen worden gedekt en zegt This cannot be undone (kan niet ongedaan worden gemaakt).
Alleen jij kunt op de knoppen drukken.
Je hebt 60 seconden. Daarna staat er in het bericht "Confirmation expired: nothing was deleted." en gebeurt er niets.
Cancel stopt alles: "Cancelled: nothing was deleted."
Zodra je op Confirm hebt gedrukt, kan het niet meer worden geannuleerd. De knoppen verdwijnen en er is geen stopcommando. Herstart de bot halverwege, dan stopt het wissen waar het was: wat gewist is blijft gewist, de rest blijft staan.

Gewiste berichten zijn niet terug te halen. De bot bewaart de inhoud van de berichten die hij wist niet.

📋 Wat er wordt vastgelegd

Als je een moderatie-logkanaal hebt ingesteld, verschijnen daar twee items:

MESSAGE PURGE STARTED, geschreven vóór het eerste wissen: het lid, het bereik, je naam en de reden. Wordt het wissen afgebroken, dan weet je nog steeds wie het startte en bij wie.
MESSAGES PURGED, aan het eind geschreven: hoeveel berichten in hoeveel kanalen zijn gewist, met dezelfde gegevens.

Geen van beide items bevat de tekst van een bericht, alleen aantallen.

🔑 Wie het kan gebruiken

Al deze voorwaarden moeten waar zijn:

de functie Moderatie staat aan op de server
de persoon heeft in Discord de permissie Manage Messages. Die permissie maakt het commando zichtbaar.
heb je Toegestane moderatorrollen (slash-commando's) ingesteld bij de Moderatie-instellingen, dan heeft de persoon ook een van die rollen
de persoon heeft Manage Messages in elk kanaal dat gewist moet worden, zoals hierboven uitgelegd (en Manage Threads voor privéthreads)

De bot heeft in elk kanaal dat hij moet wissen nodig: View Channel, Read Message History en Manage Messages. Voor gearchiveerde threads ook Manage Threads.

💡 Voorbeeld

Een spamaccount kwam op de server, plaatste uitnodigingslinks in meerdere kanalen en werd twee dagen later verbannen.

Kopieer het ID van het account (een verbannen gebruiker kan niet worden vermeld).
Typ /purge-user user:123456789012345678 days:3 reason:invite spam.
De bot vraagt om bevestiging. Druk op Confirm.
Aan het eind geeft het rapport het aantal gewiste berichten, in hoeveel kanalen, en hoeveel kanalen zijn doorzocht.
Een kanaal onder Not purged (your permissions) is een kanaal waar je geen Manage Messages hebt, bijvoorbeeld een kanaal alleen voor staff. Een andere moderator kan het commando zo nodig uitvoeren met channel op dat kanaal gezet.

🔧 Als er iets misgaat

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

Het veld user is geen vermelding en geen ID. Kopieer het ID opnieuw met de Ontwikkelaarsmodus aan. Een naam of tag werkt niet.

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

Zet de functie aan in het paneel en probeer het opnieuw. Het bericht bevat de link.

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

De server is niet verbonden met het paneel. Verbind hem eerst.

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

Je server beperkt moderatiecommando's tot bepaalde rollen. Vraag een beheerder om de jouwe toe te voegen onder Toegestane moderatorrollen (slash-commando's), of om die lijst leeg te maken.

🚨 "A purge is already running on this server"

Er loopt al een andere wisactie. Wacht op het rapport ervan en start dan de jouwe.

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

Discord gaf de bot je permissies niet door. Er is niets gewist. Probeer het zo meteen opnieuw.

🚨 Ik zie `/purge-user` niet in de commandolijst

Discord verbergt het voor iedereen zonder Manage Messages. Een serverbeheerder kan ook wijzigen wie het ziet via Serverinstellingen → Integraties → YAWBDB (Server Settings → Integrations).

🚨 Na het rapport staan er nog berichten

Kijk in het rapport: een kanaal onder Not purged (your permissions) of Skipped (bot permissions) is onaangeroerd gebleven, en een privéthread zonder Manage Threads wordt ook overgeslagen. Los de permissie op en voer het commando opnieuw uit met channel. Opnieuw uitvoeren is veilig: berichten die al weg zijn, worden gewoon niet gevonden.

🚨 Ik heb het verkeerde lid gewist

Het kan niet ongedaan worden gemaakt. De berichten zijn voorgoed weg.