Adicionar um bot do Discord ao seu servidor pode automatizar moderação, tocar música, gerenciar cargos e muito mais. No entanto, muitos usuários enfrentam problemas porque pulam ou configuram incorretamente as permissões durante o convite. Este artigo explica as etapas exatas para convidar um bot concedendo as permissões necessárias para que ele funcione corretamente desde o início. Você aprenderá a usar o gerador de URL OAuth2, revisar escopos de permissão e verificar se o bot tem o acesso adequado após entrar.
Principais Conclusões: Convidar um Bot com as Permissões Certas
- Gerador de URL OAuth2 > Escopos > bot: Este é o escopo obrigatório que permite convidar um usuário bot para o seu servidor.
- Aba de Permissões do Bot no Gerador de URL: Selecione exatamente as permissões que o bot precisa, como Enviar Mensagens, Gerenciar Cargos ou Ler Histórico de Mensagens.
- Configurações do Servidor > Integrações > Bots e Aplicativos: Após o bot entrar, use este menu para revisar e ajustar as permissões de cargo e comando do bot.
Entendendo as Permissões de Convite do Bot e o Fluxo OAuth2
Quando você convida um bot do Discord, não está simplesmente adicionando um usuário. Você está autorizando um aplicativo de terceiros a interagir com seu servidor através da API do Discord. O processo de convite usa OAuth2, um framework de autorização padrão da indústria. O desenvolvedor do bot define um conjunto de permissões que o aplicativo solicita, mas o administrador do servidor deve aprová-las durante o convite. Se você aprovar menos permissões do que o bot precisa, certos comandos ou funcionalidades falharão silenciosamente. Se aprovar mais permissões do que o necessário, você cria um risco de segurança, pois o bot pode acessar canais ou dados que não precisa. O objetivo é igualar as permissões exatamente aos requisitos documentados do bot.
O que são Escopos e Permissões?
Escopos definem o que o aplicativo pode fazer de forma geral. Para bots, o escopo relevante é bot. Sem este escopo, a URL de convite não criará um usuário bot. Permissões são ações granulares que o bot pode realizar no servidor, como enviar mensagens, expulsar membros ou gerenciar canais. Você seleciona essas permissões em uma lista ao gerar a URL de convite. A documentação do bot geralmente informa quais permissões são necessárias. Exemplos comuns incluem Ler Mensagens, Enviar Mensagens, Gerenciar Mensagens (para bots de moderação) e Conectar e Falar para bots de voz.
Pré-requisitos Antes de Convidar um Bot
Você deve ter a permissão Gerenciar Servidor no servidor do Discord onde deseja adicionar o bot. Esta permissão geralmente é detida pelo proprietário do servidor ou por usuários com o cargo de Administrador. Sem ela, a página de convite mostrará um erro informando que você não tem permissão para adicionar o bot. Além disso, você precisa do client ID do bot, que é uma string numérica encontrada no Portal do Desenvolvedor do Discord, na aba Informações Gerais do aplicativo. A maioria dos sites de listagem de bots, como top.gg ou discord.bots.gg, fornece um botão de convite que gera automaticamente a URL correta com o client ID e as permissões necessárias.
Passos para Adicionar um Bot do Discord com as Permissões Corretas
Siga estes passos para gerar a URL de convite, selecionar as permissões adequadas e concluir a adição no seu servidor. O processo usa o Gerador de URL OAuth2 do Portal do Desenvolvedor do Discord, que é o método mais confiável para garantir permissões corretas.
- Abra o Portal do Desenvolvedor do Discord
Acesse o Portal do Desenvolvedor do Discord e faça login com sua conta do Discord. Clique no aplicativo que corresponde ao bot que você deseja adicionar. Se você está adicionando um bot que não criou, não usará este portal diretamente; em vez disso, use o link de convite fornecido pelo desenvolvedor do bot. Para bots personalizados que você possui, é aqui que você gera a URL. - Navegue até o Gerador de URL OAuth2
Na barra lateral esquerda, clique em OAuth2 e depois em Gerador de URL. Esta página permite construir a URL de convite passo a passo. - Selecione o Escopo do Bot
Na seção Escopos, marque a caixa bot. Isso informa ao Discord que o convite adicionará um usuário bot. Após selecionar este escopo, uma nova seção chamada Permissões do Bot aparecerá abaixo. - Escolha as Permissões Necessárias do Bot
Na seção Permissões do Bot, marque as caixas para cada permissão que o bot precisa. Consulte a documentação do bot para a lista exata. Permissões comuns incluem:
– Enviar Mensagens
– Ler Histórico de Mensagens (necessário para bots que escaneiam mensagens passadas)
– Gerenciar Mensagens (para bots de moderação que excluem ou fixam mensagens)
– Conectar e Falar (para bots de música ou voz)
– Gerenciar Cargos (para bots que atribuem cargos)
– Expulsar Membros e Banir Membros (para bots de moderação)
Não selecione permissões que o bot não precisa. Se não tiver certeza, comece com o conjunto mínimo e adicione mais depois se o bot relatar permissões ausentes. - Copie a URL Gerada
Na parte inferior da página, uma URL aparece no campo de texto. Clique no botão Copiar ao lado dela. Esta URL contém o client ID, o escopo do bot e o inteiro de permissão representando as permissões selecionadas. - Abra a URL de Convite em um Navegador
Cole a URL copiada em uma nova aba do navegador e pressione Enter. O Discord exibirá uma página de autorização mostrando o nome do bot, avatar e as permissões que você selecionou. - Selecione Seu Servidor e Autorize
Na lista suspensa, escolha o servidor onde deseja adicionar o bot. Certifique-se de ter a permissão Gerenciar Servidor nesse servidor. Clique no botão Autorizar. Pode ser solicitado que você complete um CAPTCHA para provar que é humano. - Verifique se o Bot Aparece no Servidor
Após a autorização, o bot entra no servidor. Ele aparecerá na lista de membros, geralmente com um ícone de bot cinza ao lado do nome. Abra um canal de texto e digite um comando simples como !help ou /help para confirmar que o bot responde.
Se o Bot Não Funcionar Corretamente Após a Adição
Às vezes, um bot entra no servidor mas não responde a comandos ou não consegue realizar as ações pretendidas. Isso geralmente acontece porque o bot não tem as permissões necessárias ou porque seu cargo está posicionado incorretamente na hierarquia de cargos.
Bot Não Consegue Ler ou Enviar Mensagens em um Canal
Mesmo que você tenha concedido ao bot as permissões Enviar Mensagens e Ler Histórico de Mensagens globalmente, permissões individuais de canal podem sobrescrevê-las. Para corrigir isso, vá até o canal onde deseja que o bot opere, clique no ícone de engrenagem para abrir Configurações do Canal, navegue até Permissões e certifique-se de que o cargo do bot tenha as permissões necessárias ativadas. Se o canal tiver permissões personalizadas definidas, o cargo do bot deve ter essas permissões explicitamente permitidas.
Bot Não Consegue Gerenciar Cargos ou Expulsar Membros
O Discord usa uma hierarquia de cargos: um bot só pode gerenciar cargos que estão abaixo do seu cargo mais alto nas configurações do servidor. Se o cargo do bot estiver posicionado abaixo do cargo que ele precisa atribuir ou expulsar, a ação falha. Para corrigir, vá em Configurações do Servidor > Cargos e arraste o cargo do bot para acima de qualquer cargo que o bot precise gerenciar. Lembre-se, o cargo do bot não pode ser movido acima do cargo do proprietário do servidor ou do cargo mais alto do proprietário.
Bot Relata Permissões Ausentes na Saída do Comando
Alguns bots verificam permissões em tempo de execução e exibem um erro como Permissões Ausentes. Isso indica que o bot não tem uma permissão necessária para aquele comando específico. Você pode reconvidar o bot com a permissão ausente adicionada ou conceder a permissão através das configurações de cargo do servidor. Para reconvidar, gere uma nova URL com a permissão adicional marcada e siga os passos de convite novamente. O bot não será duplicado; ele simplesmente atualizará suas permissões autorizadas.
Comparação: Convidar um Bot pelo Portal do Desenvolvedor vs. Lista de Bots de Terceiros
| Item | Gerador OAuth2 do Portal do Desenvolvedor | Site de Lista de Bots (top.gg, discord.bots.gg) |
|---|---|---|
| Acesso | Requer que você seja dono do aplicativo do bot ou tenha seu client ID | Aberto a qualquer um; fornece um botão de convite pronto |
| Controle de Permissões | Controle total para selecionar exatamente quais permissões conceder | Permissões predefinidas pelo desenvolvedor do bot; você não pode alterá-las antes de convidar |
| Segurança | Você pode escolher permissões mínimas, reduzindo riscos | Permissões podem ser maiores que o necessário; você precisa confiar no desenvolvedor |
| Caso de Uso | Melhor para bots personalizados ou auto-hospedados | Melhor para bots públicos de desenvolvedores confiáveis |
Agora você tem o conhecimento para adicionar um bot do Discord com as permissões exatas de que ele precisa. Após o bot estar no seu servidor, verifique a posição do cargo dele em Configurações do Servidor > Cargos e ajuste se o bot precisar gerenciar outros cargos. Como dica avançada, você pode usar a Calculadora de Permissões no Portal do Desenvolvedor do Discord para calcular o inteiro de permissão exato para uso em chamadas de API ou links de convite personalizados.