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.