Cómo dar un rol de Discord que caduca automáticamente

Antes de empezar

• Ten un bot conectado con Pro y el módulo Roles temporales activado para el servidor de destino.
• El bot necesita el permiso Gestionar roles, con su rol más alto por encima del rol que quieras conceder.
• Quien use los comandos necesita Gestionar roles o el rol gestor configurado. Su rol más alto también debe estar por encima del rol de destino, salvo que sea quien posee el servidor.
• Un miembro del servidor que no tenga ya ese rol, y un rol normal en vez de @everyone o un rol gestionado por una integración.

1. Configura el módulo y la jerarquía de roles

   Empieza por el enlace de registro, conecta tu bot y activa Roles temporales en «Módulos». Abre la configuración para el servidor correspondiente. Elige «Rol de gestión» y «Canal de registro» si los necesitas (usa «Ninguno (sin registro)» si no quieres registro), define «Duración máxima (días)» y decide si activas «Mensaje privado al caducar». Guarda los ajustes.

   En los ajustes de roles de Discord, coloca el rol más alto del bot por encima del rol que vaya a conceder y retirar. Dale al bot Gestionar roles. Quien emita los comandos también necesita Gestionar roles o el rol gestor, y debe superar al rol de destino salvo que sea quien posee el servidor. Delegar el rol gestor no evita esta comprobación de jerarquía.

2. Asigna un rol con una duración admitida

   Usa /temprole add y rellena las opciones user, role y duration. Por ejemplo, elige un miembro de prueba, un rol de acceso de prueba y 2h. La duración debe ser un número entero positivo de minutos, horas o días seguido de m, h o d: 30m, 2h y 7d son ejemplos válidos. No se aceptan fracciones, duraciones combinadas como 1h30m ni la unidad de semanas.

   «Duración máxima (días)» es 30 de forma predeterminada, ajustable de 1 a 365. Cada concesión nueva debe ajustarse al máximo guardado. La respuesta distingue una concesión activa de una operación en cola; una respuesta en cola no significa que Discord ya haya añadido el rol.

   El bot rechaza una concesión guardada duplicada para el mismo miembro y rol. También rechaza convertir en una concesión temporal un rol que el miembro ya tenga. Elige un rol distinto para el acceso temporal en vez de esperar que el bot tome el control de una asignación permanente ya existente.

3. Consulta las concesiones y termina una antes de tiempo

   Usa /temprole list para ver las concesiones guardadas, su caducidad y su estado. La opción user, opcional, filtra por un miembro. La respuesta muestra hasta quince concesiones a la vez e indica si hay más. Consultarlas requiere la misma autorización: Gestionar roles o el rol gestor.

   Ejemplo práctico — conceder → consultar → caducar: ejecuta /temprole add para un miembro de prueba, un rol de acceso de prueba y 30m. Luego ejecuta /temprole list con ese miembro para comprobar la concesión guardada, su caducidad relativa y su estado. Al pasar los 30 minutos, el bot retira ese rol registrado; si está desconectado al llegar la hora, la retirada espera hasta que vuelva a estar online y pueda procesar la concesión guardada.

   Usa /temprole remove con las opciones user y role para terminar una concesión guardada antes de tiempo. Esto vuelve a comprobar la jerarquía y retira solo una concesión registrada por Roles temporales. Si Discord impide la retirada, la operación queda en cola para reintentarse. Confirma tanto el estado guardado como el rol del miembro antes de considerar terminado el acceso.

4. Elige el registro y los mensajes privados de caducidad

   Un canal de registro opcional recibe un mensaje cuando termina un rol temporal, incluida una retirada manual anticipada. «Mensaje privado al caducar» está desactivado de forma predeterminada. Si se activa, el bot intenta enviar un mensaje privado al miembro tras la caducidad automática; no lo envía para una retirada manual anticipada.

   Las notificaciones son de mejor esfuerzo. Un mensaje privado bloqueado o un canal de registro inaccesible no deshacen una retirada de rol ya completada. Este módulo no tiene un ajuste de mensaje privado al conceder el rol, así que no uses la recepción de un mensaje privado como prueba de que una concesión se activó.

5. Entiende los reinicios y la caducidad retrasada

   Las concesiones y sus marcas de caducidad se guardan en la base de datos del bot generado. Al iniciarse y en comprobaciones periódicas, el bot reconcilia las operaciones pendientes. Si la caducidad pasó mientras estaba desconectado, la retirada puede intentarse al volver. Conserva el almacenamiento persistente del bot; sustituirlo por una base de datos vacía pierde ese calendario guardado.

   Un bot desconectado no puede retirar roles de Discord. Un módulo desactivado detiene el procesamiento, y los permisos faltantes o los cambios de jerarquía pueden retrasar la retirada. Las operaciones fallidas se reintentan. Restaura el acceso del bot y revisa el rol del miembro en vez de asumir que el acceso desapareció justo en la marca de tiempo.

   Roles temporales es un gestor de roles con caducidad programada. No cobra pagos, no verifica asistencia ni concede automáticamente un rol cuando alguien confirma su presencia en un evento. Úsalo cuando una persona autorizada pueda elegir explícitamente el miembro, el rol y la duración.