ACLClouds
ACLClouds

Calculadora de permissões Discord

Calcule o inteiro de permissões do seu bot Discord e crie o link de convite OAuth2. Grátis, no navegador e sem conta.

Marque as permissões de que o seu bot precisa: a ferramenta calcula o inteiro para o link de convite e gera o URL OAuth2. Tudo acontece no seu navegador.

O que é o inteiro de permissões do Discord?

Cada permissão do Discord corresponde a um bit. O inteiro de permissões é a soma dos valores das permissões concedidas: Ver canais (1024) mais Enviar mensagens (2048) dá 3072. Administrador sozinho vale 8.

O Discord lê este inteiro no parâmetro permissions do link de convite. Ao adicionar o bot, cria um cargo gerido com o nome do bot e exatamente essas permissões. Cole um inteiro na calculadora para ver que permissões contém.

O link de convite de um bot

O link de instalação tem a forma https://discord.com/oauth2/authorize?client_id=…&permissions=…&scope=bot%20applications.commands. O client_id é o ID da aplicação, mostrado no Developer Portal na página General Information.

O scope bot adiciona o utilizador do bot ao servidor e aplica as permissões pedidas; applications.commands permite os comandos de barra. O link não contém nenhum segredo: nunca cole o token do bot numa ferramenta online.

Valores das permissões mais usadas

Valores oficiais da documentação do Discord, a somar entre si.

Constante Valor O que permite
VIEW_CHANNEL 1024 Ver os canais e ler as mensagens
SEND_MESSAGES 2048 Enviar mensagens
EMBED_LINKS 16384 Mostrar pré-visualizações de links e embeds
ATTACH_FILES 32768 Anexar ficheiros e imagens
READ_MESSAGE_HISTORY 65536 Ler mensagens enviadas antes da sua entrada
MANAGE_MESSAGES 8192 Apagar mensagens de outros membros
KICK_MEMBERS 2 Expulsar membros
BAN_MEMBERS 4 Banir membros
MODERATE_MEMBERS 1099511627776 Castigar temporariamente (timeout)
MANAGE_ROLES 268435456 Atribuir e editar cargos
CONNECT 1048576 Entrar num canal de voz
SPEAK 2097152 Falar num canal de voz
ADMINISTRATOR 8 Todas as permissões, sem exceção

Boas práticas

  • Peça o mínimo: um bot que responde a comandos precisa de Ver canais, Enviar mensagens, Inserir links e Ler histórico de mensagens.
  • Evite Administrador: concede tudo e ignora as definições dos canais. Um bot comprometido teria então todos os direitos no servidor.
  • Coloque o cargo do bot acima dos cargos que atribui e dos membros que modera: o Discord bloqueia qualquer ação sobre um cargo mais alto.
  • As permissões de um canal podem retirar um direito concedido no servidor: verifique-as se o bot só responde em alguns canais.
  • Fixar mensagens tem agora a sua própria permissão (PIN_MESSAGES), separada de Gerir mensagens.

Perguntas frequentes

Como se calculam as permissões de um bot Discord?

Some o valor de cada permissão concedida: Ver canais vale 1024, Enviar mensagens 2048, Inserir links 16384. A calculadora faz a soma assim que marca uma caixa e gera o link de convite.

Que permissões dar a um bot Discord?

Só as de que precisa. Para um bot de comandos: Ver canais, Enviar mensagens, Inserir links e Ler histórico de mensagens. Acrescente a moderação (expulsar, banir, castigar) só se o bot moderar, e evite Administrador.

Onde encontro o client ID do meu bot?

No Discord Developer Portal: abra a sua aplicação, página General Information, campo Application ID. É um número público de 17 a 20 dígitos, que não deve ser confundido com o token do bot.

Porque é que o meu bot não tem as permissões depois do convite?

Três causas frequentes: o cargo do bot está abaixo dos cargos que deve gerir, uma permissão de canal retira o direito, ou o bot foi convidado com um inteiro antigo. Edite o cargo nas definições do servidor ou convide-o de novo com o novo link.

A calculadora envia os meus dados?

Não. O inteiro e o link são calculados no seu navegador; nada é enviado à ACLClouds nem ao Discord. A ferramenta nunca pede o token do bot.