Configurar permissões para um bot do Discord geralmente envolve marcar caixas nas configurações do servidor. Mas algumas configurações avançadas exigem que você insira um número inteiro bruto para definir o conjunto de permissões do bot. Esse número inteiro, chamado de bitfield, é uma forma compacta de representar quais permissões estão ativadas e quais estão desativadas. Se você está configurando um bot auto-hospedado ou usando um painel de terceiros que pede um número inteiro de permissões, precisa entender como calculá-lo. Este artigo explica o que é um bitfield de permissão, como usar uma calculadora online para gerar o número inteiro correto e como aplicá-lo ao seu bot do Discord.
Principais Conclusões: Calculadora de Bitfield de Permissões para Bot do Discord
- Portal do Desenvolvedor Discord > Aplicativo > Bot > Intents de Gateway Privilegiados: Ative os intents necessários antes de definir permissões.
- Site Calculadora de Permissões Discord (discordapi.com/permissions): Selecione as permissões para gerar o bitfield inteiro correto.
- Escopo OAuth2: bot e número inteiro de permissões: Combine o escopo e o número inteiro na URL OAuth2 para convidar o bot com as permissões exatas.
O Que é um Bitfield de Permissão de Bot do Discord?
O Discord atribui a cada permissão um valor único de potência de dois. Por exemplo, a permissão Enviar Mensagens tem o valor 2048, e Gerenciar Mensagens tem 8192. Quando você ativa várias permissões, o Discord soma esses valores para criar um único número inteiro. Esse número inteiro é o bitfield. O bot lê esse número inteiro e sabe exatamente quais permissões possui.
Usar um bitfield em vez de caixas de seleção individuais economiza espaço no código do bot e na URL OAuth2. Quando você convida um bot pelo fluxo OAuth2 do Discord, o parâmetro permissions na URL contém esse número inteiro. O bot então usa esse número inteiro para solicitar as permissões exatas de que precisa.
Valores de Permissão que Você Precisa Saber
Cada permissão corresponde a um valor inteiro específico. Aqui estão os mais comuns usados para bots:
- Enviar Mensagens: 2048
- Gerenciar Mensagens: 8192
- Ler Histórico de Mensagens: 65536
- Conectar (Voz): 1048576
- Falar (Voz): 2097152
- Silenciar Membros (Voz): 4194304
- Ensurdecer Membros (Voz): 8388608
- Mover Membros (Voz): 16777216
- Usar Atividade de Voz: 33554432
- Orador Prioritário: 256
- Adicionar Reações: 64
- Anexar Arquivos: 32768
- Inserir Links: 16384
- Ler Mensagens: 1024
Se precisar de uma lista completa, visite a página de Documentação para Desenvolvedores do Discord sobre permissões. O número inteiro do bitfield é a soma de todos os valores das permissões que você deseja ativar.
Passos para Calcular o Bitfield de Permissão Usando uma Calculadora Online
Somar manualmente os valores das permissões é propenso a erros. Uma calculadora de permissões online faz a matemática para você e gera o número inteiro correto. Siga estes passos para obter o bitfield exato para o seu bot.
- Abra a Calculadora de Permissões do Discord
Acesse o site Calculadora de Permissões do Discord emdiscordapi.com/permissions. Esta é a ferramenta oficial fornecida pelo Discord para gerar números inteiros de permissão. - Selecione as Permissões que Seu Bot Precisa
Marque as caixas para cada permissão que seu bot requer. Por exemplo, se seu bot lê mensagens e envia respostas, marque Ler Mensagens e Enviar Mensagens. Se ele gerencia canais, marque Gerenciar Canais. Não selecione permissões que seu bot não usa. Dar permissões em excesso pode ser um risco de segurança. - Copie o Número Inteiro Gerado
Na parte inferior da calculadora, você verá um número rotulado como Bitfield. Este é o número inteiro que você precisa. Clique no botão Copiar ou destaque o número e pressione Ctrl+C no teclado. - Use o Número Inteiro na URL OAuth2
Abra o Portal do Desenvolvedor Discord. Selecione seu aplicativo. Vá para a página OAuth2. Em Gerador de URL, marque o escopo bot. Em seguida, cole o número inteiro que você copiou no campo Permissões. A URL gerada agora incluirá o parâmetropermissionscorreto. Use esta URL para convidar seu bot para um servidor. - Verifique as Permissões no Seu Servidor
Após o bot entrar, vá para as configurações do seu servidor. Abra Configurações do Servidor > Cargos. Encontre o cargo atribuído ao seu bot. As permissões que você selecionou devem estar ativadas. Se alguma permissão estiver faltando, verifique novamente o número inteiro que você inseriu e reconvide o bot com a URL corrigida.
Se o Número Inteiro do Bitfield Não Funcionar como Esperado
Mesmo com o número inteiro correto, você pode encontrar problemas de permissão. Aqui estão problemas comuns e suas soluções.
Bot Não Consegue Enviar Mensagens em um Canal Específico
O bot pode ter a permissão Enviar Mensagens no nível do servidor, mas o canal pode ter substituições que a bloqueiam. Vá para as configurações do canal. Abra Permissões do canal. Verifique se o cargo do bot tem um X vermelho ao lado de Enviar Mensagens. Se sim, altere para uma marca de verificação verde. A substituição do canal tem prioridade sobre a permissão do servidor.
Bot Não Consegue Ler o Histórico de Mensagens
Se seu bot precisa ler mensagens passadas, você deve ativar a permissão Ler Histórico de Mensagens. Esta permissão tem o valor 65536. Se você não a incluiu no bitfield, o bot verá apenas novas mensagens enviadas após ele ficar online. Recalcule o bitfield com esta permissão incluída e reconvide o bot.
Bot Não Consegue Gerenciar Cargos
A permissão Gerenciar Cargos (valor 268435456) permite que o bot crie e atribua cargos. Mas o bot não pode atribuir um cargo que seja superior ao seu próprio cargo mais alto. Mova o cargo do bot para acima dos cargos que ele precisa gerenciar na lista de cargos do servidor. O cargo do bot deve estar posicionado mais alto na hierarquia.
Calculadora de Bitfield de Permissões para Bot do Discord: Manual vs Online
| Item | Cálculo Manual | Calculadora Online |
|---|---|---|
| Facilidade de uso | Requer somar vários números manualmente | Selecione caixas de seleção e copie o número inteiro |
| Taxa de erro | Alta — fácil pular uma permissão ou somar incorretamente | Baixa — a ferramenta faz a matemática |
| Velocidade | Lenta para mais de três permissões | Resultado instantâneo |
| Lista de permissões | Deve consultar cada valor na documentação | Todas as permissões listadas com descrições |
| Geração de URL | Deve montar manualmente a URL OAuth2 | Gera URL completa com escopo e permissões |
A calculadora online é o método recomendado para todos os usuários. Ela reduz erros e economiza tempo. O cálculo manual só é útil se você precisar entender como o bitfield funciona internamente.
Agora você pode gerar o número inteiro de permissão correto para seu bot do Discord usando a calculadora online. Use o número inteiro na URL OAuth2 para convidar o bot com exatamente as permissões de que ele precisa. Para bots avançados, considere usar a permissão Administrador (valor 8) apenas se o bot realmente precisar de controle total. Dar permissões em excesso pode levar a problemas de segurança se o bot for comprometido. Sempre conceda as permissões mínimas necessárias para o funcionamento do seu bot.