Purgar los mensajes de un miembro

Elimina todos los mensajes que un miembro dejó en tu servidor, incluso si ya se fue o fue baneado.

Un comando se encarga: /purge-user (staff, elimina de forma definitiva).

🧹 Eliminar los mensajes de un miembro: `/purge-user`

/purge-user recorre tus canales e hilos y elimina los mensajes escritos por una sola cuenta. Úsalo después de una oleada de spam, de una cuenta de raid o de un miembro que publicó algo que quieres ver desaparecer en todas partes.

Escribe /purge-user.
En user, indica una mención o el ID de usuario de Discord del miembro (de 17 a 20 dígitos). Para copiar el ID, activa el Modo desarrollador (Developer Mode; Ajustes de usuario, Avanzado) en Discord, haz clic derecho en el miembro y elige Copiar ID de usuario (Copy User ID). A un miembro que se fue o fue baneado ya no se le puede mencionar: usa su ID.
Si quieres, acota con channel, days y reason (ver más abajo) y pulsa Intro.
El bot muestra lo que está a punto de hacer, con dos botones: Confirm y Cancel.
Pulsa Confirm. La eliminación empieza y el mensaje se actualiza sobre la marcha.

Todo lo que el bot dice durante este proceso es privado: solo tú lo ves.

Las opciones

Opción	Obligatoria	Qué hace
`user`	sí	Una mención o un ID de usuario sin más (de 17 a 20 dígitos).
`channel`	no	Solo este canal y los hilos que contiene. Sin ella, se recorren todos los canales del servidor.
`days`	no	Solo los mensajes de los últimos N días, de 1 a 5000. Sin ella, se recorre todo el historial.
`reason`	no	Hasta 512 caracteres. Se escribe en tu canal de registro de moderación y no se envía al miembro.

🎯 Qué alcanza y qué no

Lee esto antes de confirmar.

Alcanza los mensajes escritos por esa cuenta en canales de texto, de anuncios, de voz y de escenario, y en hilos (activos y archivados, incluidas las publicaciones de foro y de medios), pero solo donde tanto tú como el bot podéis gestionar mensajes.

El bot comprueba tus permisos canal por canal, no solo tu rol en todo el servidor. Un canal solo se purga si:

tú lo ves y tienes Manage Messages en él, y
el bot lo ve, puede leer su historial y tiene Manage Messages en él.

Si a alguno de los dos le falta un permiso en un canal, ese canal se deja intacto. El comando no falla: continúa con los demás canales y los enumera en el informe final.

Dos tipos de hilo son más estrictos:

Hilos privados: necesitas además Manage Threads. Sin él, el hilo se deja de lado y no se nombra en el informe.
Hilos archivados: el bot también necesita Manage Threads. Reabre el hilo, elimina los mensajes y lo vuelve a archivar. Los hilos privados archivados solo se buscan cuando tú y el bot tenéis Manage Threads en el canal padre.

No hace lo siguiente:

banear, expulsar, silenciar ni advertir al miembro, y no añade nada a su historial de moderación. Solo elimina mensajes. Si el miembro sigue en el servidor, usa /ban o /mute por separado.
llegar a un canal que tú no puedes gestionar, aunque el bot sí pueda. Es a propósito: el comando nunca te deja eliminar lo que no podrías eliminar a mano.
eliminar los mensajes que el miembro publique después de que el bot ya haya recorrido ese canal.
tocar otros servidores ni los mensajes directos.
nombrar un canal que no ves. Se omite del informe, que por tanto no puede decirte que existe.

El bot rechaza su propio ID: purgarlo borraría el historial de tu canal de registro y rompería los paneles de roles, tickets, verificación y sorteos que gestiona.

⏳ Cuánto tarda y el informe

Discord no ofrece búsqueda a los bots, así que el bot lee el historial de cada canal página por página y extrae los mensajes del miembro.

Los mensajes de menos de 14 días se eliminan en grupos de hasta 100.
Los mensajes de más de 14 días solo se pueden eliminar uno por uno. En un servidor con mucha actividad y un historial largo, puede tardar mucho. Acota con days o channel cuando puedas.
El mensaje de progreso se actualiza como máximo cada 5 segundos: cuántos mensajes se han eliminado hasta ahora, el canal en curso y cuántos canales quedan.
Solo puede ejecutarse una purga a la vez por servidor. Una segunda recibe «A purge is already running on this server».

Al terminar, el bot responde con el número de mensajes eliminados, el número de canales recorridos y una lista por canal. El informe también puede incluir:

Not purged (your permissions): canales donde te falta un permiso.
Skipped (bot permissions): canales donde le falta uno al bot.
Failed, the other channels went on: canales que se detuvieron por un error. Lo que ya se eliminó allí sigue eliminado.
un recuento de los mensajes que no se pudieron eliminar, por canal.

Una lista larga se corta con «… and N more». Si no se encontró nada, recibes el mismo informe con 0 mensajes eliminados.

Si la purga dura más de 14 minutos

Discord solo deja que el bot edite su respuesta durante 15 minutos. Unos 14 minutos después de que escribiste el comando, el bot deja de actualizar el mensaje y te envía el informe final por mensaje directo, con el nombre del servidor al final. Asegúrate de tener abiertos los mensajes directos de los miembros del servidor o podrías no verlo. Las entradas del canal de registro (más abajo) se escriben igualmente.

⚠️ Confirmación y cancelación

La confirmación nombra al miembro, indica qué canales y cuántos días abarca, y dice This cannot be undone (no se puede deshacer).
Solo tú puedes pulsar los botones.
Tienes 60 segundos. Pasado ese tiempo, el mensaje dice «Confirmation expired: nothing was deleted.» y no ocurre nada.
Cancel lo detiene todo: «Cancelled: nothing was deleted.»
Una vez que pulsas Confirm, ya no se puede cancelar. Los botones desaparecen y no hay ningún comando para detenerla. Si el bot se reinicia a mitad de camino, la purga se detiene donde estaba: lo eliminado sigue eliminado y el resto se queda en su sitio.

Los mensajes eliminados no se pueden recuperar. El bot no guarda el contenido de los mensajes que elimina.

📋 Qué se registra

Si definiste un canal de registro de moderación, aparecen allí dos entradas:

MESSAGE PURGE STARTED, escrita antes de la primera eliminación: el miembro, el alcance, tu nombre y el motivo. Si la purga se interrumpe, sigues sabiendo quién la lanzó y sobre quién.
MESSAGES PURGED, escrita al final: cuántos mensajes se eliminaron y en cuántos canales, con los mismos datos.

Ninguna de las dos entradas contiene el texto de un mensaje, solo cifras.

🔑 Quién puede usarlo

Deben cumplirse todas estas condiciones:

la función Moderación está activada en el servidor
la persona tiene el permiso Manage Messages en Discord. Es el permiso que hace visible el comando.
si definiste Roles de moderador permitidos (comandos slash) en los ajustes de Moderación, también tiene uno de esos roles
tiene Manage Messages en cada canal que quiere purgar, como se explica arriba (y Manage Threads para los hilos privados)

El bot necesita, en cada canal que deba purgar: View Channel, Read Message History y Manage Messages. Para los hilos archivados, además Manage Threads.

💡 Ejemplo

Una cuenta de spam se unió al servidor, publicó enlaces de invitación en varios canales y fue baneada dos días después.

Copia el ID de la cuenta (un usuario baneado no se puede mencionar).
Escribe /purge-user user:123456789012345678 days:3 reason:invite spam.
El bot te pide confirmar. Pulsa Confirm.
Al terminar, el informe indica cuántos mensajes se eliminaron, en cuántos canales y cuántos canales se recorrieron.
Un canal que aparece en Not purged (your permissions) es uno donde no tienes Manage Messages, por ejemplo un canal solo para el staff. Otro moderador puede ejecutar el comando con channel apuntando a él si hace falta.

🔧 Cuando algo sale mal

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

El campo user no es una mención ni un ID. Vuelve a copiar el ID con el Modo desarrollador activado. Un nombre o una etiqueta no sirve.

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

Activa la función en el panel y vuelve a intentarlo. El mensaje contiene el enlace.

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

El servidor no está conectado al panel. Conéctalo primero.

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

Tu servidor limita los comandos de moderación a ciertos roles. Pide a un admin que añada el tuyo en Roles de moderador permitidos (comandos slash), o que vacíe esa lista.

🚨 «A purge is already running on this server»

Hay otra purga en curso. Espera su informe y luego lanza la tuya.

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

Discord no dio al bot tus permisos. No se eliminó nada. Inténtalo de nuevo en un momento.

🚨 No veo `/purge-user` en la lista de comandos

Discord lo oculta a quien no tenga Manage Messages. Un admin del servidor también puede cambiar quién lo ve en Ajustes del servidor → Integraciones → YAWBDB (Server Settings → Integrations).

🚨 Quedan mensajes después del informe

Mira el informe: un canal en Not purged (your permissions) o Skipped (bot permissions) se quedó intacto, y un hilo privado sin Manage Threads también se omite. Corrige el permiso y vuelve a ejecutar el comando con channel. Volver a ejecutarlo es seguro: los mensajes que ya no están simplemente no se encuentran.

🚨 He purgado al miembro equivocado

No se puede deshacer. Los mensajes se han perdido para siempre.