Como adicionar um bot ao Discord (Guia para principiantes)
As três coisas de que toda a instalação de um bot no Discord realmente precisa — a autorização adequada, a atribuição correta de funções e um teste a sério — explicadas de uma vez por todas.
Quick answer
Adicionar um bot ao Discord implica autorizá-lo através do próprio fluxo OAuth do Discord a partir do link de convite oficial do bot e, em seguida, atribuir-lhe a função correta em relação aos membros e às funções que precisa de gerir. A maioria dos problemas de instalação deve-se a uma de duas razões: utilizar um link de convite semelhante em vez do link oficial, ou atribuir ao bot uma função com permissões demasiado limitadas para que este possa efetivamente realizar as tarefas para as quais foi configurado.
What you'll learn
- O que acontece realmente quando se clica em «Adicionar ao Discord»?
- Por que razão a atribuição de funções é tão importante quanto o próprio convite
- Como verificar se uma instalação funcionou mesmo, em vez de simplesmente partir do princípio de que sim
- Sinais de alerta que indicam que não se trata de um convite oficial
- O que verificar em primeiro lugar quando um bot recém-adicionado parece não funcionar
Por que é que as instalações de bots correm mal com mais frequência do que deveriam
Adicionar um bot parece ser uma ação que se faz com um único clique e, na maioria das vezes, é mesmo assim — mas, logo após o clique, ocorrem dois passos invisíveis que determinam se ele funciona realmente: a concessão de permissões pelo Discord e a posição que a função do bot ocupa na hierarquia do teu servidor. Se ignorares a verificação de qualquer um destes passos, o bot pode parecer «adicionado», mas sem conseguir realizar a maior parte das funções para as quais foi concebido.
O que o processo de instalação do Discord faz, na verdade
Ao clicar num link de convite oficial, é redirecionado para o ecrã de autorização OAuth2 do próprio Discord — escolhe a que dos seus servidores pretende adicionar o bot (só são apresentados aqueles em que a sua conta pode autorizar integrações), verifica as permissões solicitadas e aprova. O Discord adiciona então o bot como membro e cria uma função para ele, posicionada por predefinição no final da sua lista de funções.
As duas coisas que realmente importam depois de clicar em «Convidar»
Todos os bots funcionam da mesma forma a nível técnico — o Discord não tem um percurso especial para uma «instalação correta». O que distingue uma instalação que funciona de uma que não funciona é o que fazes nestes dois passos.
1. Utilize sempre o link oficial de convite
Não autorizes aplicações que se façam passar por outras nem links de convite copiados de servidores ou mensagens desconhecidos. Um convite oficial provém sempre do próprio site do bot ou de uma fonte em que confies especificamente.
2. Colocar a função do bot acima de tudo aquilo que este precisa de gerir
O Discord impede que um bot gere um membro ou uma função que se encontre no mesmo nível ou acima da sua função mais elevada — independentemente das permissões de que disponha. A função de um bot recém-adicionado situa-se, por predefinição, no nível mais baixo, razão pela qual as funcionalidades dependentes da função (funções automáticas, moderação, verificação) deixam de funcionar imediatamente após a instalação, até que a mova.
Faz bem feito à primeira
- Abre o link oficial «Adicionar ao Discord» e seleciona o servidor pretendido — o Discord apenas apresenta os servidores nos quais a tua conta pode autorizar integrações.
- Verifique as autorizações solicitadas no ecrã de autorização antes de aprovar.
- Volta ao servidor e confirma se o bot aparece na lista de membros.
- Abra «Definições do servidor» → «Funções» e mova a função do bot para cima de quaisquer funções de membro, de utilizador verificado ou sujeitas a moderação que ele precise de gerir — mantendo as funções de proprietário e administrador acima dela.
- Execute um comando inofensivo (como /help) para confirmar se está realmente a responder antes de configurar mais alguma coisa.
Erros comuns
- Autorizar um link de convite proveniente de uma fonte não oficial — comece sempre pelo próprio site do bot.
- Deixar a função do bot no fim da lista e ficar confuso quando as funcionalidades baseadas em funções não funcionam.
- Colocar a função do bot acima das suas próprias funções de administrador — mantenha as funções humanas com privilégios acima dela, e não abaixo.
- Partindo do princípio de que a instalação correu bem porque o bot aparece como estando online, sem testar nenhum comando ou funcionalidade concreta.
Resolução de problemas
O bot aparece como offline logo após ser convidado
Aguarda um minuto até que a ligação esteja totalmente estabelecida e, em seguida, experimenta um comando básico. Se continuar offline, consulta a página de estado do próprio bot antes de assumires que a instalação falhou.
Existe um comando, mas não consigo executá-lo
Confirme se os comandos da aplicação são permitidos nesse canal e se todos os requisitos de permissão específicos de cada comando estão cumpridos — os comandos também podem demorar algum tempo a concluir a sincronização depois de o bot se ter ligado pela primeira vez.
As funcionalidades baseadas em funções não estão a funcionar de todo
Na maioria das vezes, trata-se de uma questão de atribuição de funções. Coloque a função do bot acima daquilo que ele precisa de gerir e, em seguida, tente novamente.
Related guides
Discord Bot Permissions, Explained
The three permission layers that actually control what a bot can do — server permissions, channel overwrites, and role hierarchy — and how they interact.
Read guideYour First 10 Minutes With Airwavy
A practical checklist for the first ten minutes after adding Airwavy — role placement, first feature, and validating it actually works.
Read guide