Comandos de historial

Consulta qué registros de moderación tiene un miembro en tu servidor, deja que los miembros revisen los suyos y borra los registros ya terminados de un miembro cuando se ha ganado un borrón y cuenta nueva.

Tres comandos hacen esto: /history (personal), /my-history (cualquiera) y /clear-history (personal, borra).

🔎 Ver el historial de un miembro: `/history`

Copia el ID de usuario de Discord del miembro: en Discord activa el Modo desarrollador (Developer Mode; Ajustes de usuario, Avanzado), haz clic derecho en el miembro y elige Copiar ID de usuario (Copy User ID).
Escribe /history, pega el ID en user_id y pulsa Intro.
El bot responde en privado, solo a ti, con los últimos 10 registros, del más reciente al más antiguo.

Cada línea se ve así:

1. BAN 🔴 (3d) - spamming invites - 2 hours ago #418

el tipo en mayúsculas (BAN, MUTE, KICK, WARN, SOFTBAN, UNBAN, UNMUTE)
🔴 cuando el registro sigue activo
la duración entre paréntesis en bans, mutes y softbans
el motivo, o «No reason»
cuándo ocurrió
el número de caso tras el #. Es el número que se usa con /reason para cambiar el texto de un registro.

Necesitas el permiso Kick Members en Discord para ver el comando. La misma lista, con más detalle, está en el panel: Moderación → pestaña Historial, una tabla con una fila por registro que puedes filtrar por tipo y por estado.

🙋 Dejar que los miembros vean su propio historial: `/my-history`

Cualquiera puede escribir /my-history. El bot les muestra en privado los últimos 10 registros de moderación que el servidor guarda sobre ellos. Es una forma rápida de resolver «¿por qué me advirtieron?» sin molestar al personal.

Necesita que la función Moderación esté activada en tu servidor. Si está desactivada, el miembro recibe un mensaje que lo indica.
Ignora tu ajuste Roles de moderador permitidos (comandos slash): no hace falta ningún rol.
Con un prefijo de comandos de texto definido, también funciona !my-history, pero una respuesta de texto no puede ser privada: el bot la publica en el canal y la borra a los 30 segundos.
Un miembro sin registros recibe «You have no moderation records on this server.» (no tiene registros de moderación en este servidor).

La página propia del miembro en el panel, Mis sanciones, enumera los mismos registros de todos los servidores.

🧹 Borrar los registros terminados de un miembro: `/clear-history`

/clear-history borra todos los registros que ya no están activos de un miembro en tu servidor. Úsalo cuando alguien ha cumplido su condena y quieres un historial limpio.

Asegúrate de que el miembro no tiene nada activo (consulta más abajo).
Escribe /clear-history, pega el ID de usuario del miembro en user_id y pulsa Intro.
El bot responde Cleared N inactive records for @member (N registros inactivos borrados) o No inactive records found for @member (no se encontraron registros inactivos).

No se puede deshacer. Los registros se borran, no se ocultan.

Qué cuenta como inactivo

Registro	Cuándo pasa a inactivo
Ban, mute	Cuando termina o se levanta (unban, unmute, caducidad, o Levantar en el panel)
Warn, softban	Solo cuando un moderador lo elimina desde el panel (Moderación → pestaña Historial → Eliminar en el registro). Una advertencia no tiene fecha de fin.
Kick, unban, unmute	De inmediato: ya son inactivos al escribirse

Los registros activos se dejan como están. Si quieres que también desaparezcan las advertencias de un miembro, elimínalas primero en el panel y luego ejecuta /clear-history.

Quién puede usarlo

Deben cumplirse todas estas condiciones:

la función Moderación está activada en el servidor
la persona tiene el permiso Ban Members en Discord (ojo: es más alto que /history, que pide Kick Members)
si definiste Roles de moderador permitidos (comandos slash) en los ajustes de Moderación, también tiene uno de esos roles

La misma acción en el panel

Moderación → pestaña Historial, luego Borrar todo en cualquier registro terminado (no activo) de ese miembro: haz clic y vuelve a hacer clic donde dice Haz clic de nuevo para confirmar. Elimina todos los registros terminados de ese miembro, el mismo borrado que hace el comando.

El botón del panel escribe una línea en el Registro de actividad de tu servidor («Vaciado el historial inactivo de … (eliminados: N)») y, si definiste un canal de registro de moderación, también publica allí. El comando /clear-history no hace ninguna de las dos cosas: no deja ninguna entrada en el Registro de actividad y no publica nada en el canal de registro. Si tu equipo quiere un rastro visible, usa el botón del panel o escribe una línea a mano en tu canal de registro.

💡 Ejemplo

Un miembro fue advertido dos veces en marzo y silenciado un día en abril. Es octubre y se ha portado bien.

/history user_id:123456789012345678 muestra: MUTE (1d, sin punto, terminado), WARN 🔴, WARN 🔴.
Las dos advertencias siguen en 🔴, así que /clear-history por sí solo solo eliminaría el mute.
En el panel: Moderación → pestaña Historial, busca al miembro y haz clic en Eliminar en la fila de cada advertencia.
Ahora /clear-history user_id:123456789012345678. El bot responde Cleared 3 inactive records y el historial del miembro queda vacío.

🔧 Cuando algo sale mal

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

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

🚨 No veo `/clear-history` en la lista de comandos

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

🚨 «No inactive records found» pero `/history` muestra registros

Los registros siguen activos. Levántalos o elimínalos primero en el panel (las advertencias y los softbans solo se eliminan a mano).

🚨 «Failed to clear history» o «Server not registered in panel»

El bot no pudo conectar con el panel, o el servidor no está conectado a él. Inténtalo de nuevo en un minuto; si el servidor es nuevo, conéctalo primero.

🚨 He borrado al miembro equivocado

No se puede restaurar. Vuelve a crear los registros a partir de tus propias notas o de tu Registro de actividad; el Registro de actividad solo guarda una línea cuando el borrado se hizo desde el panel.

🚨 `/my-history` dice que el servidor no está registrado

La misma causa que arriba: el servidor no está conectado al panel.