Criar um aplicativo do Discord leva cerca de cinco minutos e não exige programação: entre no Developer Portal, clique em New Application, adicione um bot a ele, ative os intents de que ele precisa, gere um token e crie um link de convite. Tudo até esse último passo é só preencher formulários. O que você faz com o aplicativo depois, escrever o seu próprio código ou entregar o token a uma hospedagem que roda um conjunto de recursos para você, é uma decisão separada.
O que é, de fato, um “aplicativo do Discord”
Um aplicativo é o contêiner que o Discord cria para tudo o que você desenvolve na plataforma: um nome, um ícone, um client ID e, opcionalmente, um usuário de bot associado. O aplicativo em si não faz nada. O usuário de bot ligado a ele é quem de fato entra, envia mensagens e responde a comandos. A maioria das pessoas usa “aplicativo” e “bot” como sinônimos, porque na prática você cria um para obter o outro, mas a distinção importa quando chega aos escopos e permissões do OAuth2, pois eles são solicitados em nome do aplicativo, e não digitados manualmente.
Passo a passo
- Abra o Developer Portal. Acesse discord.com/developers/applications e entre com a conta que deve ser dona do bot.
- Clique em New Application. Dê um nome a ele. Esse nome se torna o nome interno do aplicativo; você pode renomeá-lo depois sem afetar nada que já esteja rodando.
- Abra a aba Bot. Um usuário de bot é adicionado automaticamente. Defina o nome de usuário e envie um avatar aqui; é isso que aparece em todos os servidores em que ele entrar.
- Ative os intents privilegiados de que ele precisa. Em Privileged Gateway Intents, Server Members Intent e Message Content Intent vêm desligados por padrão. Um bot que lê o texto das mensagens ou reage a membros entrando e saindo precisa dos dois ativados, ou não conseguirá fazer login.
- Clique em Reset Token. O Discord gera o token e o mostra exatamente uma vez. Copie-o imediatamente, não existe página que exiba um token existente novamente, e clicar em Reset Token uma segunda vez invalida o que você acabou de copiar.
- Crie um link de convite. Use o URL Generator da aba OAuth2, marque os escopos
boteapplications.commands, marque as permissões de que o bot realmente precisa e copie o link gerado. - Convide-o para um servidor. Abra o link, escolha um servidor que você administra e aprove as permissões que o Discord mostrar.
Erros que pegam as pessoas
- Confundir o nome do aplicativo com o nome de usuário do bot. Eles podem ser diferentes. Renomear o aplicativo depois não renomeia o bot; isso é feito na aba Bot.
- Perder o token antes de colá-lo em algum lugar. Se você fechar a aba antes de copiar, não se preocupe, basta clicar em Reset Token de novo para gerar um novo. O antigo simplesmente deixa de existir.
- Pular os intents e depois não entender por que o bot não fica online. Um bot cujo código pede um intent privilegiado que não está ativado no portal não conecta em um estado degradado: o Discord recusa o login por completo, com um erro de “disallowed intents”.
- Pedir Administrator no link de convite por hábito. Funciona, mas é a tela de permissões mais assustadora que o Discord pode mostrar ao dono de um servidor, e um motivo comum para o convite ser recusado. Marque apenas o que o bot usa.
O que fazer com o aplicativo a seguir
Depois de ter um aplicativo, um usuário de bot e um token, há dois caminhos a partir daqui. Você pode escrever ou baixar o código do bot e rodá-lo por conta própria, na sua máquina ou em uma hospedagem, que é o tema do nosso guia de hospedagem gratuita de bots. Ou pode pular a parte de programação: colar o token em um serviço que roda um conjunto de recursos existente com a identidade do seu bot. O Custom Bot do Noxyr faz exatamente isso: tickets, loja, segurança, sorteios, verificação e muito mais, tudo respondendo com o nome e o avatar que você acabou de definir, hospedado gratuitamente em troca de um voto no Top.gg. O passo a passo completo da configuração, incluindo os dois intents citados acima, está na documentação do Custom Bot.
Qualquer que seja o caminho escolhido, o aplicativo que você acabou de criar é a única coisa de que qualquer um dos dois precisa. Criá-lo não te prende a nenhuma direção.
Perguntas frequentes
Preciso saber programar para criar um aplicativo do Discord? Não. Criar o aplicativo, o usuário de bot e o token são passos de apontar e clicar no Developer Portal. A programação só entra se você escolher escrever o comportamento do bot por conta própria.
Qual é a diferença entre o client ID e o token do bot? O client ID é público, aparece em todo link de convite e pode ser compartilhado sem problemas. O token é uma credencial: quem o tiver pode fazer login com o bot. Trate-o como uma senha.
Posso renomear o aplicativo ou o bot depois? Sim, tanto o nome do aplicativo quanto o nome de usuário do bot podem ser alterados a qualquer momento no portal, sem perder o token, os servidores em que ele está ou qualquer outra coisa ligada ao seu ID de usuário no Discord.
Todo bot precisa de intents privilegiados? Não. Só bots que leem o texto das mensagens (Message Content Intent) ou precisam de dados de entrada/saída de membros e de cargos (Server Members Intent) precisam deles ativados. Um bot simples que usa apenas comandos de barra não precisa de nenhum dos dois.
Criar um aplicativo do Discord é grátis? Sim, não custa nada criar um, gerar um token ou convidá-lo para qualquer lugar. Rodar o código por trás dele é que pode custar dinheiro, a menos que você use uma hospedagem gratuita ou um serviço como o Custom Bot do Noxyr.
E se eu perder o token ou achar que ele vazou? Volte para a aba Bot e clique em Reset Token. O antigo para de funcionar imediatamente, em todos os lugares em que estava sendo usado, e você recebe um novo para colar onde for necessário.
Depois que o seu aplicativo existir, veja nosso guia sobre links de convite e escopos OAuth2 para montar esse link corretamente, ou adicione o Noxyr de graça e transforme seu novo aplicativo em um bot totalmente funcional, sem escrever uma linha de código.