Cómo borrar muchos mensajes en Discord con un bot

Antes de empezar

• Ten un bot online con Moderation activado en tu servidor. Tu cuenta necesita Manage Messages, y el bot necesita Manage Messages, View Channel, Read Message History y Send Messages en el canal objetivo.
• Usa un canal de prueba desechable que contenga solo mensajes que creaste para esta comprobación. Purge no ofrece vista previa ni confirmación, así que no experimentes en un canal con conversaciones que la gente necesite conservar.

1. Activa Moderation y revisa los permisos del canal

   En la pestaña Modules del bot, activa Moderation y espera a que el bot esté online. En Discord, revisa los permisos del canal objetivo tanto para tu rol de personal como para el bot. Purge exige que quien lo ejecuta tenga Manage Messages; poder enviar mensajes no es suficiente. Discord también debe permitir que el bot obtenga y borre mensajes en ese canal.

   Las excepciones de permisos del canal pueden bloquear al bot aunque su rol del servidor parezca correcto. Dale View Channel y Read Message History para obtener los mensajes recientes, Manage Messages para quitar los mensajes de otros usuarios, y Send Messages para publicar el resultado. Su respuesta usa un embed, así que permite también Embed Links. Deja esta capacidad en manos de moderadores de confianza que entiendan que el borrado no se puede deshacer.

2. Usa !purge <amount> [@user]

   Para una prueba pequeña, escribe `!purge 5` en el canal desechable. La cantidad debe ser un entero del 1 al 100. Sustituye ! si tu bot usa otro prefijo. Los alias registrados son `!clear` y `!prune`, con la misma cantidad y el argumento opcional de usuario. Los comandos con prefijo dependen de Message Content Intent; sigue la lista de comprobación del creador al activar el módulo.

   Para limitar el borrado a un autor dentro del lote reciente que se obtuvo, usa `!purge 5 @Alex` y selecciona la mención real del usuario en Discord. Esto no busca en todo el canal cinco mensajes de Alex: el bot recoge un lote reciente y después lo filtra por ese usuario. Si esa persona escribió menos mensajes aptos en ese lote, borrará menos. Opera en el canal donde ejecutas el comando, no en todo el servidor.

3. Entiende los límites de 100 mensajes y 14 días

   La operación de borrado masivo de Discord permite como máximo 100 mensajes por solicitud y rechaza mensajes de más de 14 días. Este módulo excluye del borrado masivo los mensajes de 14 días o más. Las conversaciones antiguas permanecen; pedir una cantidad mayor no evita ese límite de antigüedad. Purge no tiene un modo para borrar todo el historial de un canal ni para borrar MD.

   Existe una particularidad actual de conteo: aunque la entrada acepta de 1 a 100, la implementación obtiene la cantidad más uno después de intentar borrar el mensaje del comando con prefijo. Cuando ese mensaje ya se eliminó, un !purge 5 sin filtro puede borrar seis mensajes recientes. Con la cantidad 100, intenta obtener 101 y puede fallar ante el límite de solicitud de Discord. Trata la cantidad como entrada para un lote, no como una garantía exacta de borrado; usa lotes pequeños solo donde aceptarías un borrado adicional.

4. Comprueba el resultado antes de ejecutar otro lote

   Si tiene éxito, el bot informa “Deleted [count] message(s)” en un embed y añade la etiqueta del usuario cuando se proporcionó un filtro. La cantidad es el número real que devuelve la operación de borrado. La confirmación se elimina tras unos tres segundos. Revisa los mensajes de prueba restantes mientras aún es visible en lugar de asumir que la cantidad solicitada coincidió exactamente con lo que desapareció.

   Si el comando falla, revisa su error y los permisos del canal antes de reintentarlo. Puede omitir mensajes porque son demasiado antiguos o no coinciden con el filtro opcional de autor. Un error después de que desaparezca el mensaje del comando no prueba que la limpieza funcionó. Evita repetir un comando grande en un canal activo: pueden entrar mensajes nuevos en el siguiente lote.

5. Mantén la limpieza dentro del alcance del módulo Free

   Moderation es un módulo Free, por lo que esta limpieza de mensajes recientes no requiere Pro. Free publica una asignación de un bot alojado y diez custom commands, con logs de alojamiento conservados durante un día. La comparación de Pro indica tres bots, doscientos custom commands y treinta días de logs de alojamiento. Purge es un comando del módulo incluido, no un custom command que creas.

   Una mejora de plan no elimina los límites de edad o solicitudes del borrado masivo de Discord. El módulo usa la misma implementación de purge en Pro. Consulta el enlace del módulo Moderation para el conjunto de herramientas completo o Pricing para los detalles de planes; ninguno promete borrar historial antiguo de un canal ni conversaciones privadas.