Permissões dos bots do Discord: uma explicação

O sistema de permissões do Discord consiste, na verdade, em três verificações distintas, encadeadas entre si, e uma funcionalidade só funciona se todas as três estiverem alinhadas. A maioria dos relatos do tipo «o bot não está a funcionar» deve-se, na realidade, ao facto de uma destas três camadas estar a bloquear silenciosamente algo, e não a um erro no próprio bot — razão pela qual verificar metodicamente cada camada, em vez de adivinhar, resolve rapidamente a maioria desses casos.

Isto aplica-se a todos os bots no Discord, não é algo específico de nenhum deles em particular.

• As permissões no servidor decorrem da(s) função(ões) atribuída(s) ao bot — o conjunto básico de ações que este está autorizado a realizar em qualquer parte do servidor.
• As substituições de canal podem conceder ou recusar permissões específicas para uma determinada categoria ou canal, substituindo a configuração predefinida a nível do servidor, seja para permitir ou para recusar.
• A hierarquia de funções limita quais membros e funções um bot pode gerir, independentemente dos bits de permissão — um bot pode ter a função de Administrador e, mesmo assim, não conseguir gerir um membro ou função que se encontre acima da sua própria função mais elevada.

Conceda permissões de acordo com as funcionalidades que efetivamente ativar — não conceda todas de imediato.

• Ver o canal, enviar mensagens, incorporar links e consultar o histórico de mensagens para os fluxos de texto mais relevantes.
• Ligue e fale sobre música; mobilize os membros para que se juntem à criação ou para a moderação de comentários.
• Gerir funções para funções de verificação e de reação.
• Gerir canais para tickets, «aderir para criar» e bloqueios de canais.
• Só é possível banir, expulsar, moderar, silenciar ou desativar o som dos membros através das respetivas ações de moderação — e, para além das permissões do Discord, alguns comandos também exigem que uma funcionalidade do painel de controlo esteja ativada, que se tenha uma função de membro da equipa ou de DJ do Airwavy, acesso Premium ou que se cumpra outra regra de elegibilidade indicada na respetiva entrada de referência.

1. Decida quais as funcionalidades que pretende realmente ativar antes de conceder autorizações — não conceda tudo de imediato.
2. Consulte a entrada de referência de comandos de cada funcionalidade ativada para verificar os requisitos de autorização do bot que lhe estão associados.
3. Conceda apenas essas permissões específicas, em vez de uma função de administrador com poderes gerais.
4. Coloque a função do bot acima de quaisquer funções de membro ou funções-alvo que ele precise de gerir.
5. Teste cada funcionalidade com uma conta normal, que não seja de administrador — uma conta de administrador ignora precisamente as verificações que está a tentar validar.

• Conceder o direito de «Administrador» como atalho, em vez das permissões específicas de que uma funcionalidade necessita.
• Partindo do princípio de que o Administrador contorna a hierarquia de funções — o que não acontece; um bot continua a não poder gerir uma função ou um membro acima do seu próprio nível.
• Verificar apenas as permissões ao nível do servidor e não ter em conta uma substituição ao nível do canal que nega o acesso.
• Não distinguir um problema de permissão no Discord de uma restrição de acesso específica do Airwavy (funcionalidade não ativada, falta do plano Premium, falta de função de membro da equipa).