Discord Developer Portal: criar bot, token e intents

No Discord Developer Portal (discord.com/developers/applications), você cria um bot clicando em New Application, dando um nome e confirmando com Create. Na página Bot, o botão Reset Token gera o token, que só aparece uma vez. Ative ali apenas os Privileged Gateway Intents que o bot usa e gere o link de convite em Installation ou em OAuth2, no URL Generator.

Hospedar seu bot Discord? Na HostValues a partir de €1,40 por mês, online em poucos minutos. Ver planos →

Este guia passa por todas as páginas do portal que importam para um bot: General Information, Bot, Installation e OAuth2. Você vê para que serve cada opção, quais erros aparecem com mais frequência e como deixar o bot online depois. Vale para a API v10 do Discord, com discord.js 14.27 e discord.py 2.7.1. Conferimos os fatos em 27 de outubro de 2026 na documentação oficial para desenvolvedores do Discord, que agora fica em docs.discord.com/developers.

Para que serve o Discord Developer Portal

O Discord Developer Portal, ou portal de desenvolvedores do Discord, é onde você registra um aplicativo. É ali que nascem o usuário bot, o token, os intents e o link de convite. O portal não roda o seu código: o bot é um programa que precisa ficar ligado num computador ou num servidor. Para começar, você precisa de três coisas:

• Uma conta do Discord para entrar no portal.
• Um servidor de teste em que você tenha a permissão Gerenciar servidor (MANAGE_GUILD na API). Sem ela, você não consegue adicionar o bot. O Discord recomenda testar num servidor que ninguém mais usa.
• Uma biblioteca para a sua linguagem, como discord.js para Node.js, discord.py para Python ou JDA para Java.

Três mudanças de 2026 deixaram muitos tutoriais antigos desatualizados:

• 9 de março de 2026: o portal ganhou uma página inicial nova (discord.com/developers/home), um tema novo e suporte a idiomas. Ele usa o mesmo idioma que você escolheu no Discord, então os botões podem aparecer em português.
• 10 de junho de 2026: o acesso livre aos Privileged Intents passou a depender do número de usuários, e não mais do número de servidores. Explicamos a regra mais abaixo.
• Documentação nova: os guias oficiais estão em docs.discord.com/developers. Os links antigos, em discord.com/developers/docs, redirecionam para lá.

Neste guia usamos os nomes em inglês da documentação oficial, com uma explicação curta em português. Não achou um botão no portal traduzido? Mude por um momento o idioma do Discord para English, já que o portal segue o idioma do aplicativo.

Criar o aplicativo e o bot passo a passo

1. Abra discord.com/developers/applications e entre com a sua conta do Discord.
2. Clique em New Application, no canto superior direito. Digite o nome do aplicativo e clique em Create.
3. Você cai na página General Information. Ali ficam a descrição, o ícone, o Application ID e a Public Key.
4. Abra a página Bot no menu lateral. Segundo o Discord, aplicativos novos já vêm com um usuário bot ativado, então não há botão extra para criar o bot.

O Application ID é público. Ele aparece no link de convite com o nome client_id. A Public Key serve para conferir requisições HTTP que o Discord envia para uma Interactions Endpoint URL. Um bot que se conecta pelo Gateway, como os de discord.js e discord.py, não precisa dela.

Token do bot: copiar, guardar e redefinir

O token é a senha do bot: ele autoriza as requisições à API e carrega as permissões do bot. Quem tem o token controla o seu bot. Para gerar o token:

1. Na página Bot, em Token, clique em Reset Token e confirme o aviso, se aparecer.
2. Copie o token na hora. A documentação avisa que você não consegue ver o token de novo, a não ser gerando outro.
3. Guarde o token num gerenciador de senhas ou num arquivo .env do projeto.

DISCORD_TOKEN=SEU_TOKEN_AQUI

Coloque .env no .gitignore. O token nunca vai no código, num repositório Git, num print, num ticket ou num chat. Se ele vazar, clique de novo em Reset Token: o token antigo para de funcionar e você troca pelo novo em todo lugar onde o bot roda.

Na mesma página há duas opções que confundem muita gente:

• Public Bot: desmarcado, só você adiciona o bot a servidores. Marcado, qualquer pessoa com o link adiciona o bot a um servidor em que tenha a permissão necessária.
• Requires OAuth2 Code Grant: deixe desligado, a não ser que você tenha um fluxo OAuth2 completo com redirecionamento próprio. Ligado, quem adiciona o bot precisa passar por esse fluxo inteiro, e um link de convite simples não basta.

Privileged Gateway Intents: quando ativar

Os intents definem quais eventos o Discord envia ao bot pelo Gateway. Três deles são privilegiados, porque liberam dados sensíveis. Eles ficam na página Bot, na seção Privileged Gateway Intents. A regra da documentação é clara: ative só o que o bot precisa para funcionar.

No tutorial oficial de app instalável por usuário, a chave de Guild Members aparece como Server Member Intent. Sem o Message Content, o bot recebe o texto vazio, com algumas exceções: mensagens que o próprio bot envia, DMs para o bot, mensagens que mencionam o bot e a mensagem em que alguém usa um comando de menu de contexto do bot. Comandos de barra (slash commands) não precisam de nenhum dos três intents.

A regra desde 10 de junho de 2026: se o seu aplicativo tem menos de 10.000 usuários, basta ligar a chave no portal. Conta o número de usuários únicos que conseguem ver o aplicativo em todos os servidores em que ele está. Acima disso, é preciso pedir o acesso. Depois do aviso no portal, você tem 90 dias para fazer o pedido, e o aplicativo continua entrando em servidores durante a análise. Um acesso aprovado precisa ser pedido de novo todo ano. Antes, o limite era de 100 servidores. A verificação do aplicativo virou um processo separado, e a documentação continua exigindo a verificação para apps em 100 servidores ou mais.

O intent precisa estar certo em dois lugares: no portal e no código. Se o código pede um intent privilegiado que está desligado no portal, o Discord fecha a conexão com o código 4014. E reinicie o bot depois de mudar algo no portal, porque os intents só valem numa conexão nova com o Gateway.

discord.js 14 (Node.js), com o pacote dotenv:

require('dotenv').config();
const { Client, Events, GatewayIntentBits } = require('discord.js');

const client = new Client({
  intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages, GatewayIntentBits.MessageContent],
});

client.once(Events.ClientReady, (c) => console.log(`Online como ${c.user.tag}`));
client.login(process.env.DISCORD_TOKEN);

discord.py 2.7 (Python), com o pacote python-dotenv:

import os
import discord
from dotenv import load_dotenv

load_dotenv()
intents = discord.Intents.default()   # tudo, menos presences, members e message_content
intents.message_content = True        # só se a chave estiver ligada no portal

client = discord.Client(intents=intents)

@client.event
async def on_ready():
    print(f"Online como {client.user}")

client.run(os.getenv("DISCORD_TOKEN"))

Se o bot só usa comandos de barra, tire GatewayIntentBits.MessageContent ou intents.message_content = True e deixe a chave desligada. Para o intent de membros, use GatewayIntentBits.GuildMembers no discord.js e intents.members = True no discord.py.

Convidar o bot: Install Link ou OAuth2 URL Generator

Um bot entra num servidor por um fluxo de autorização OAuth2, e só quem tem a permissão Gerenciar servidor naquele servidor consegue concluir a instalação. O portal oferece dois caminhos.

Caminho A, Installation e Install Link. É o caminho do guia oficial de primeiros passos:

1. Abra a página Installation. Em Installation Contexts, deixe marcado Guild Install (instalação em servidores). Aplicativos novos só aceitam esse contexto por padrão; User Install só serve para comandos que o usuário usa na própria conta.
2. Em Install Link, escolha Discord Provided Link, se ainda não estiver marcado.
3. Em Default Install Settings, para Guild Install, adicione os scopes bot e applications.commands. Ao marcar bot, aparece o menu Permissions, onde você escolhe as permissões do bot.
4. Copie o link da seção Install Link, abra no navegador, escolha Add to server (adicionar ao servidor) se o Discord perguntar, selecione o servidor e confirme.

Esse link tem só o seu client_id, sem scopes nem permissões na URL. O Discord pede o que estiver nas Default Install Settings, e o Discord Provided Link aceita apenas os scopes bot e applications.commands.

Caminho B, OAuth2 e URL Generator:

1. Abra OAuth2 no menu lateral e depois o URL Generator.
2. Em Scopes, marque bot e applications.commands. Segundo a documentação, applications.commands já vem incluído com bot, e um dos tutoriais oficiais marca os dois.
3. Em Bot Permissions, marque só as permissões que o bot usa.
4. Copie a Generated URL, abra no navegador, escolha o servidor e autorize.

O link pronto tem esta forma. O número depois de permissions é a soma das permissões escolhidas:

https://discord.com/oauth2/authorize?client_id=SEU_APPLICATION_ID&scope=bot+applications.commands&permissions=84992

1024 + 2048 + 16384 + 65536 dá os 84992 do exemplo. Evite Administrador: ele concede todas as permissões e ignora as permissões de cada canal. Um bot de música precisa ainda de CONNECT e SPEAK, para entrar e falar no canal de voz; o passo a passo está em como adicionar um bot de música ao Discord. Depois de instalado, o bot aparece na lista de membros do servidor, mas só responde quando o seu código estiver rodando.

Deixar o bot online 24 horas por dia

O bot só fica online enquanto o programa dele está rodando. No seu PC, isso acaba quando você desliga o computador, fecha o notebook ou o Windows reinicia para uma atualização. Um bot que outras pessoas usam precisa de uma máquina sempre ligada. Num servidor de bot do Discord na HostValues, o caminho é este:

1. Contrate um plano. O servidor fica pronto logo após o pagamento.
2. Envie os arquivos do bot pelo gerenciador de arquivos do painel (aba File managers) ou por SFTP.
3. Crie o arquivo .env com o token no gerenciador de arquivos.
4. Na seção Startup, escolha o ambiente: Node.js para discord.js, Python para discord.py, pycord ou nextcord, ou Java para JDA (iniciado como arquivo .jar). A versão fica em Docker Image: Node.js 18, 20, 22, 24 ou 26, Python 3.11, ou Java 17 ou 21.
5. Com Node.js, o painel roda npm install a cada inicialização se houver um package.json. Com Python, ele instala a cada inicialização os pacotes do requirements.txt, como discord.py e python-dotenv.
6. Inicie o bot na aba Console. Quando a mensagem do evento ready aparecer, ele está online.

Se o bot cair, o painel reinicia o processo sozinho. Se ele cair de novo logo depois, o painel não reinicia mais, para que um erro no código não vire um loop infinito; o console mostra a causa. Todos os planos têm proteção DDoS, 2 slots de backup e banco de dados MySQL, que você cria na seção Databases e gerencia pelo phpMyAdmin. Trocou de ambiente? Apague os arquivos antigos que não servem para o novo e clique em Reinstall, em Settings.

Os preços incluem IVA e o cancelamento é mensal. Pagando por trimestre você tem 10% de desconto, e por ano, 15%: o Small sai por € 3,78 por trimestre ou € 14,28 por ano. Um bot simples em discord.js costuma usar de 100 a 200 MB, e um em discord.py, de 80 a 150 MB, então o Small atende à maioria dos bots. Se o uso de memória passar de 80% ou se você quiser rodar vários bots no mesmo servidor, mude para um plano maior na área do cliente, mantendo arquivos e banco de dados. Outras opções de hospedagem estão no guia como hospedar um bot de Discord 24/7.

Erros comuns e como resolver

Mais uma mudança a caminho: segundo o changelog do Discord, a partir de 16 de novembro de 2026 a rota GET /guilds/{guild.id}/channels deixa de listar os canais que o bot não pode ver, e pelo Gateway esses canais chegam com o nome ___hidden___. Bots que só agem em canais visíveis não são afetados.

Perguntas frequentes

Onde fica o token do bot no Discord Developer Portal?

Na página Bot, em Token. O Discord só mostra o token logo depois que você clica em Reset Token. Se você não guardou, gere outro com Reset Token: o antigo deixa de funcionar e você troca pelo novo em todo lugar onde o bot roda.

Como adicionar meu bot a um servidor do Discord?

Use o Install Link da página Installation ou monte um link em OAuth2, no URL Generator, com os scopes bot e applications.commands. Abra o link, escolha o servidor e autorize. Você precisa da permissão Gerenciar servidor nesse servidor.

Quais Privileged Intents meu bot precisa?

Só os que uma função realmente exige. Comandos de barra não precisam de nenhum. Mensagens de boas-vindas pedem Guild Members, comandos com prefixo como !help pedem Message Content e painéis de status pedem Guild Presences.

Preciso verificar meu bot do Discord?

A documentação exige a verificação para apps em 100 servidores ou mais. Os Privileged Intents seguem outra regra desde 10 de junho de 2026: abaixo de 10.000 usuários você liga as chaves no portal; acima disso, pede o acesso e renova o pedido todo ano.

Meu bot continua online se eu desligar o PC?

Não. O bot só funciona enquanto o programa dele está rodando. Para ficar online o tempo todo, ele precisa de uma máquina sempre ligada, como um plano de hospedagem de bots do Discord na HostValues a partir de € 1,40 por mês.