Los permisos de los bots de Discord, explicados

El sistema de permisos de Discord consiste, en realidad, en tres comprobaciones independientes encadenadas, y una función solo funciona si las tres coinciden. La mayoría de los avisos del tipo «el bot no funciona» se deben, en realidad, a que una de estas tres capas está bloqueando algo de forma silenciosa, y no a un error del propio bot; por eso, comprobar metódicamente cada capa, en lugar de hacer conjeturas, resuelve la mayoría de los problemas rápidamente.

Esto se aplica a todos los bots de Discord, no es algo específico de ninguno de ellos.

• Los permisos del servidor se derivan de los roles asignados al bot: el conjunto básico de acciones que está autorizado a realizar en cualquier parte del servidor.
• Las modificaciones de canal permiten conceder o denegar permisos específicos para una categoría o un canal concretos, anulando la configuración predeterminada de todo el servidor en cualquier sentido.
• La jerarquía de roles limita qué miembros y roles puede gestionar un bot, independientemente de los bits de permiso: un bot puede tener el rol de «Administrador» y, aun así, no poder gestionar a un miembro o un rol situado por encima de su propio rol más alto.

Concede permisos en función de las funciones que realmente actives, no todos desde el principio.

• Ver el canal, enviar mensajes, insertar enlaces y consultar el historial de mensajes de los flujos de texto más relevantes.
• Conéctate y habla para la música; mueve a los miembros para que se unan a la creación o para moderar las intervenciones.
• Gestionar los roles de verificación y de respuesta.
• Gestionar canales para tickets, la función «unirse para crear» y los bloqueos de canales.
• Solo se puede bloquear, expulsar, moderar, silenciar o inhabilitar a los miembros mediante las acciones de moderación correspondientes; además, más allá de los permisos de Discord, algunos comandos también requieren que esté habilitada una función del panel de control, tener un rol de miembro del personal o de DJ de Airwavy, acceso Premium u otra condición de elegibilidad que se indique en su entrada de referencia.

1. Decide qué funciones vas a activar realmente antes de conceder permisos; no lo concedas todo de entrada.
2. Consulta la entrada de referencia de comandos de cada función activada para conocer los permisos de bot que requiere.
3. Otorga únicamente esos permisos específicos, en lugar de un rol de administrador general.
4. Coloca el rol del bot por encima de los roles de miembro o de los roles de destino que tenga que gestionar.
5. Prueba cada función con una cuenta normal, que no sea de administrador; una cuenta de administrador se salta precisamente las comprobaciones que estás intentando validar.

• Conceder el rol de «Administrador» como atajo en lugar de los permisos específicos que necesita una función.
• Suponiendo que el administrador pueda saltarse la jerarquía de roles —lo cual no es así; un bot sigue sin poder gestionar un rol o un miembro de rango superior al suyo—.
• Se comprueban únicamente los permisos a nivel de servidor y se pasa por alto una sobrescritura a nivel de canal que deniega el acceso.
• No se distingue entre un problema de permisos en Discord y una restricción de acceso específica de Airwavy (función no habilitada, falta de suscripción Premium, falta de rol de personal).