Purger les messages d'un membre

Supprime tous les messages qu'un membre a laissés sur ton serveur, même un membre déjà parti ou banni.

Une commande s'en charge : /purge-user (staff, supprime définitivement).

🧹 Supprimer les messages d'un membre : /purge-user

/purge-user parcourt tes salons et tes fils et supprime les messages écrits par un seul compte. Sers-t'en après une vague de spam, un compte de raid, ou un membre qui a posté quelque chose que tu veux voir disparaître partout.

1. Tape /purge-user.
2. Dans user, donne une mention ou l'identifiant d'utilisateur Discord du membre (17 à 20 chiffres). Pour copier l'identifiant, active le Mode développeur (Developer Mode ; Paramètres utilisateur, Avancé) dans Discord, fais un clic droit sur le membre, Copier l'identifiant de l'utilisateur (Copy User ID). Un membre parti ou banni ne peut plus être mentionné : utilise son identifiant.
3. Si tu veux, restreins avec channel, days et reason (voir plus bas), puis appuie sur Entrée.
4. Le bot affiche ce qu'il s'apprête à faire, avec deux boutons : Confirm et Cancel.
5. Appuie sur Confirm. La suppression démarre et le message se met à jour au fil de l'eau.

Tout ce que le bot dit pendant ce temps est privé : toi seul le vois.

Les options

🎯 Ce qu'elle atteint, et ce qu'elle n'atteint pas

Lis ceci avant de confirmer.

Elle atteint les messages écrits par ce compte dans les salons textuels, d'annonces, vocaux et de conférence (stage), et dans les fils (actifs et archivés, publications de forum et de média comprises), mais seulement là où toi et le bot avez le droit de gérer les messages.

Le bot vérifie tes permissions salon par salon, pas seulement ton rôle à l'échelle du serveur. Un salon n'est purgé que si :

• toi tu le vois et tu y as Manage Messages, et
• le bot le voit, peut lire son historique et y a Manage Messages.

Si l'un de vous deux n'a pas une permission dans un salon, ce salon est laissé intact. La commande n'échoue pas : elle continue avec les autres salons et liste ceux-là dans le rapport final.

Deux types de fils sont plus stricts :

• Fils privés : il te faut aussi Manage Threads. Sans cela, le fil est laissé de côté et n'est pas nommé dans le rapport.
• Fils archivés : le bot a lui aussi besoin de Manage Threads. Il rouvre le fil, supprime les messages, puis l'archive de nouveau. Les fils privés archivés ne sont cherchés que lorsque toi et le bot avez Manage Threads sur le salon parent.

Elle ne fait pas ceci :

• bannir, expulser, rendre muet ou avertir le membre, et elle n'ajoute rien à son historique de modération. Elle ne fait que supprimer des messages. Si le membre est encore sur le serveur, utilise /ban ou /mute à part.
• atteindre un salon que tu ne peux pas gérer toi-même, même si le bot le peut. C'est voulu : la commande ne te laisse jamais supprimer ce que tu ne pourrais pas supprimer à la main.
• supprimer les messages que le membre poste après que le bot a déjà parcouru ce salon.
• toucher aux autres serveurs ni aux messages privés.
• nommer un salon que tu ne vois pas. Il est omis du rapport, qui ne peut donc pas t'apprendre son existence.

Le bot refuse son propre identifiant : le purger effacerait l'historique de ton salon de journal et casserait les panneaux de rôles, de tickets, de vérification et de concours qu'il suit.

⏳ Combien de temps ça prend, et le rapport

Discord n'offre aucune recherche aux bots : le bot lit donc l'historique de chaque salon page par page et en tire les messages du membre.

• Les messages de moins de 14 jours sont supprimés par groupes de 100 au plus.
• Les messages de plus de 14 jours ne peuvent être supprimés qu'un par un. Sur un serveur actif avec un long historique, cela peut prendre beaucoup de temps. Restreins avec days ou channel quand tu le peux.
• Le message de progression se met à jour toutes les 5 secondes au plus : combien de messages sont supprimés jusqu'ici, le salon en cours et combien de salons restent.
• Une seule purge peut tourner à la fois par serveur. Une deuxième reçoit « A purge is already running on this server ».

Quand c'est fini, le bot répond avec le nombre de messages supprimés, le nombre de salons parcourus et une liste par salon. Le rapport peut aussi contenir :

• Not purged (your permissions) : les salons où il te manque une permission.
• Skipped (bot permissions) : les salons où il en manque une au bot.
• Failed, the other channels went on : les salons qui se sont arrêtés sur une erreur. Ce qui y a déjà été supprimé reste supprimé.
• le nombre de messages qui n'ont pas pu être supprimés, par salon.

Une longue liste est coupée par « … and N more ». Si rien n'a été trouvé, tu reçois le même rapport avec 0 message supprimé.

Si la purge dure plus de 14 minutes

Discord ne laisse le bot modifier sa réponse que pendant 15 minutes. Environ 14 minutes après que tu as tapé la commande, le bot cesse de mettre le message à jour et t'envoie le rapport final en message privé, avec le nom du serveur en bas. Vérifie que tes messages privés venant de membres du serveur sont ouverts, sinon tu risques de le manquer. Les entrées du salon de journal (plus bas) sont écrites quand même.

⚠️ Confirmation et annulation

• La confirmation nomme le membre, indique quels salons et combien de jours sont visés, et dit This cannot be undone (impossible à annuler).
• Toi seul peux appuyer sur les boutons.
• Tu as 60 secondes. Passé ce délai, le message indique « Confirmation expired: nothing was deleted. » et rien ne se passe.
• Cancel arrête tout : « Cancelled: nothing was deleted. »
• Une fois que tu as appuyé sur Confirm, on ne peut plus annuler. Les boutons disparaissent et il n'existe aucune commande d'arrêt. Si le bot redémarre en cours de route, la purge s'arrête là où elle en était : ce qui a été supprimé le reste, le reste demeure en place.

Les messages supprimés ne peuvent pas être récupérés. Le bot ne conserve pas le contenu des messages qu'il supprime.

📋 Ce qui est consigné

Si tu as défini un salon de journal de modération, deux entrées y apparaissent :

1. MESSAGE PURGE STARTED, écrite avant la première suppression : le membre, le périmètre, ton nom et la raison. Si la purge est interrompue, tu sais quand même qui l'a lancée et sur qui.
2. MESSAGES PURGED, écrite à la fin : combien de messages ont été supprimés et dans combien de salons, avec les mêmes détails.

Aucune des deux entrées ne contient le texte d'un message, seulement des nombres.

🔑 Qui peut l'utiliser

Toutes ces conditions doivent être réunies :

• la fonctionnalité Modération est activée sur le serveur
• la personne a la permission Manage Messages dans Discord. C'est cette permission qui rend la commande visible.
• si tu as défini Rôles de modération autorisés (commandes slash) dans les réglages de Modération, elle possède aussi l'un de ces rôles
• elle a Manage Messages dans chaque salon qu'elle veut purger, comme expliqué plus haut (et Manage Threads pour les fils privés)

Dans chaque salon à purger, le bot a besoin de : View Channel, Read Message History et Manage Messages. Pour les fils archivés, aussi de Manage Threads.

💡 Exemple

Un compte de spam a rejoint le serveur, posté des liens d'invitation dans plusieurs salons, puis a été banni deux jours plus tard.

1. Copie l'identifiant du compte (un utilisateur banni ne peut pas être mentionné).
2. Tape /purge-user user:123456789012345678 days:3 reason:invite spam.
3. Le bot te demande de confirmer. Appuie sur Confirm.
4. À la fin, le rapport donne le nombre de messages supprimés, dans combien de salons, et combien de salons ont été parcourus.
5. Un salon listé sous Not purged (your permissions) est un salon où tu n'as pas Manage Messages, par exemple un salon réservé au staff. Un autre modérateur peut lancer la commande avec channel réglé dessus si besoin.

🔧 Quand quelque chose ne va pas

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

Le champ user n'est ni une mention ni un identifiant. Copie à nouveau l'identifiant avec le Mode développeur activé. Un nom ou un tag ne fonctionne pas.

🚨 « The Moderation feature is not enabled for this server »

Active la fonctionnalité dans le panel, puis réessaie. Le message contient le lien.

🚨 « This server is not registered in the YAWBDB panel »

Le serveur n'est pas connecté au panel. Connecte-le d'abord.

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

Ton serveur limite les commandes de modération à certains rôles. Demande à un admin d'ajouter le tien dans Rôles de modération autorisés (commandes slash), ou de vider cette liste.

🚨 « A purge is already running on this server »

Une autre purge est en cours. Attends son rapport, puis lance la tienne.

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

Discord n'a pas transmis tes permissions au bot. Rien n'a été supprimé. Réessaie dans un instant.

🚨 Je ne vois pas /purge-user dans la liste des commandes

Discord la masque à quiconque n'a pas Manage Messages. Un admin du serveur peut aussi changer qui la voit dans Paramètres du serveur → Intégrations → YAWBDB (Server Settings → Integrations).

🚨 Certains messages sont encore là après le rapport

Regarde le rapport : un salon sous Not purged (your permissions) ou Skipped (bot permissions) est resté intact, et un fil privé sans Manage Threads est lui aussi ignoré. Corrige la permission et relance la commande avec channel. Relancer ne risque rien : les messages déjà disparus ne sont simplement pas retrouvés.

🚨 J'ai purgé le mauvais membre

Impossible à annuler. Les messages sont définitivement perdus.