Você convidou um bot do Discord para o seu servidor, mas quando você ou seus membros tentam usar seus comandos, o bot responde com um erro “Missing Access” ou simplesmente não faz nada. Esse erro significa que o bot não tem as permissões necessárias para ler, enviar mensagens ou executar suas ações designadas em canais específicos ou em todo o servidor. A causa raiz é quase sempre uma incompatibilidade entre as permissões concedidas ao cargo do bot e as permissões exigidas pelos comandos de barra ou intents de mensagem do bot. Este artigo fornece uma auditoria de permissões estruturada que você pode seguir para identificar e corrigir o erro de acesso ausente em qualquer bot do Discord.
Principais Conclusões: Auditoria de Permissões do Bot do Discord
- Configurações do Servidor > Cargos > Cargo do Bot: Conceda ao cargo do bot exatamente as permissões listadas na documentação do bot ou no link de convite.
- Substituições de permissão específicas do canal: Verifique se o cargo do bot não tem permissões negadas, como Ler Mensagens ou Enviar Mensagens, no canal onde os comandos são usados.
- Portal do Desenvolvedor do Bot > OAuth2 > Gerador de URL: Reconvide o bot usando uma URL que inclua o escopo correto (bot) e todas as permissões necessárias.
Por que os Bots do Discord Mostram “Missing Access”
Os bots do Discord operam por meio de um cargo atribuído a eles quando entram em um servidor. Esse cargo, geralmente nomeado após o bot, deve ter permissões específicas ativadas. Quando o bot tenta executar uma ação que seu cargo não permite, o Discord retorna um erro “Missing Access”. O erro pode aparecer em três camadas principais:
1. Permissões de nível de cargo
O próprio cargo do bot pode não ter as alternâncias necessárias. Por exemplo, um bot de música precisa de “Conectar” e “Falar” em canais de voz, enquanto um bot de moderação precisa de “Expulsar Membros” e “Banir Membros”. Se o cargo não tiver essas permissões, o bot não pode executar esses comandos.
2. Substituições de permissão de canal
Mesmo que o cargo do bot tenha permissões globais, canais individuais podem substituí-las. Um canal configurado para negar “Ler Mensagens” para o cargo do bot impedirá que o bot veja ou responda nesse canal.
3. Intents do bot e intents privilegiados do gateway
Alguns bots exigem “Server Members Intent” ou “Message Content Intent” para funcionar. Esses intents são ativados no Portal do Desenvolvedor do Discord nas configurações do bot. Se o desenvolvedor do bot não os ativou, o bot pode falhar silenciosamente ou mostrar “Missing Access” ao tentar ler listas de membros ou conteúdo de mensagens.
Passos para Auditar e Corrigir Permissões do Bot
- Identifique as permissões necessárias do bot
Abra a documentação do bot, página de suporte ou o link de convite original. A maioria dos bots lista as permissões exatas de que precisam. Anote os nomes das permissões, como “Ler Mensagens”, “Enviar Mensagens”, “Gerenciar Mensagens”, “Conectar”, “Falar”, “Expulsar Membros” ou “Banir Membros”. - Verifique o cargo do bot nas Configurações do Servidor
Vá para o seu servidor, abra Configurações do Servidor e clique em Cargos. Encontre o cargo com o nome do bot. Clique nele. Percorra as alternâncias de permissão. Ative todas as permissões que o bot exige. Se o bot exigir “Administrador”, você pode ativar essa única permissão para cobrir todas as outras, mas esteja ciente de que isso concede ao bot controle total sobre o servidor. - Verifique as substituições específicas do canal
Clique com o botão direito no canal onde o bot não está funcionando e selecione Editar Canal. Vá para a guia Permissões. Encontre o cargo do bot na lista. Certifique-se de que marcas de verificação verdes apareçam para as permissões necessárias. Se você vir X vermelhos para Ler Mensagens ou Enviar Mensagens, altere-os para a barra cinza neutra ou para uma marca de verificação verde. Repita para cada canal onde o bot deve operar. - Verifique a posição do cargo do bot
Em Configurações do Servidor > Cargos, observe a ordem da lista de cargos. O cargo do bot deve estar posicionado acima de qualquer cargo que ele precise gerenciar. Para bots de moderação, o cargo do bot deve estar acima dos cargos que ele deve expulsar ou banir. Arraste o cargo do bot para uma posição mais alta na lista, se necessário. - Reconvide o bot com as permissões corretas
Se o bot ainda mostrar “Missing Access”, gere uma nova URL de convite. Vá para o Portal do Desenvolvedor do Discord, selecione seu aplicativo e clique em OAuth2 > Gerador de URL. Marque o escopo “bot”. Na seção Permissões do Bot, ative exatamente as permissões que o bot precisa. Copie a URL gerada, abra-a em um navegador e reconvide o bot para o seu servidor. Esta etapa garante que o cargo do bot seja criado com o conjunto de permissões correto desde o início. - Ative intents privilegiados do gateway (se você for o desenvolvedor do bot)
Se você é o proprietário do bot, vá para o Portal do Desenvolvedor do Discord, selecione seu aplicativo e clique em Bot no menu esquerdo. Role até a seção Intents Privilegiados do Gateway. Ative “Server Members Intent” e “Message Content Intent” se o seu bot precisar deles. Salve as alterações e reinicie o bot.
Se o Discord Ainda Tiver Problemas Após a Correção Principal
Os comandos do bot funcionam em alguns canais, mas não em outros
Isso indica que substituições de permissão específicas do canal estão bloqueando o bot. Revise as permissões de cada canal para o cargo do bot. Use a guia Editar Canal > Permissões do canal e certifique-se de que nenhum X vermelho apareça para Enviar Mensagens ou Ler Mensagens.
O bot não responde a comandos de barra
Comandos de barra exigem a permissão “Usar Comandos de Barra” no cargo do bot. Essa permissão geralmente é ativada por padrão, mas pode ser desativada acidentalmente. Verifique as alternâncias de permissão do cargo do bot e ative “Usar Comandos de Barra”. Verifique também se o bot tem o escopo “applications.commands” em sua URL de convite.
O bot mostra “Missing Access” após uma atualização do servidor ou mudança de cargo
O Discord às vezes redefine as permissões de cargo durante atualizações do servidor ou quando os cargos são reorganizados. Refaça a auditoria de permissões começando pela etapa 2. Se o cargo do bot foi excluído, você deve reconvidar o bot para criar um novo cargo.
O bot não consegue ver membros ou conteúdo de mensagens
Isso é um problema de intent privilegiado. Se você é o desenvolvedor do bot, ative Server Members Intent e Message Content Intent no Portal do Desenvolvedor. Se você é um administrador de servidor usando um bot de terceiros, entre em contato com a equipe de suporte do bot para perguntar se esses intents estão ativados por parte deles.
Permissões do Cargo do Bot vs. Permissão de Administrador
| Item | Cargo do Bot com Permissões Específicas | Cargo do Bot com Administrador |
|---|---|---|
| Descrição | Permissões individuais ativadas para ações exatas | Uma permissão que concede todas as outras permissões |
| Risco de segurança | Baixo — o bot só pode fazer o que está ativado | Alto — o bot pode excluir canais, banir qualquer um, alterar configurações do servidor |
| Recomendado para | A maioria dos bots, especialmente de desenvolvedores desconhecidos | Bots confiáveis que precisam de controle total do servidor, como bots de moderação |
| Facilidade de auditoria | Requer verificar cada alternância de permissão | Simples — uma alternância cobre tudo |
Auditar permissões de bot é um processo direto quando você sabe onde procurar. Após concluir as etapas acima, teste o bot executando um comando simples como /help ou /ping. Se o bot responder, o erro “Missing Access” está resolvido. Para futuras adições de bot, sempre gere uma URL de convite com as permissões exatas que o bot precisa para evitar esse erro desde o início. Como dica avançada, você pode usar o visualizador de permissões integrado do Discord selecionando o cargo do bot em Configurações do Servidor > Cargos e clicando no botão “Ver Permissões” para ver as permissões efetivas em qualquer canal.