Como Criar um Bot de Discord: Um Guia Completo Para Iniciantes

Se estás a configurar um Beatra Custom Bot, a primeira coisa de que precisas é do teu próprio bot de Discord — uma aplicação com um token e os intents corretos ativados. Este guia acompanha-te em cada passo. Preferes ver em vez de ler? Tens um tutorial em vídeo completo ligado abaixo.

🎥 Tutorial em vídeo: https://www.youtube.com/watch?v=qddwRsNU2X8

Criar um bot de Discord é gratuito e demora apenas alguns minutos. Segue os passos pela ordem indicada.

Passo 1 — Abre o Discord Developer Portal

Acede ao Discord Developer Portal em https://discord.com/developers/applications e inicia sessão com a tua conta Discord. Este é o local oficial onde todos os bots de Discord são criados e geridos.

Passo 2 — Cria uma Nova Aplicação

Clica em New Application no canto superior direito. Dá-lhe um nome — este é o nome do projeto do teu bot e pode ser alterado mais tarde — aceita os termos e clica em Create. Já tens uma aplicação.

Passo 3 — Abre o Separador Bot

Na barra lateral esquerda, clica no separador Bot. O Discord cria automaticamente um utilizador bot para a tua aplicação. Aqui podes definir o nome de utilizador e a foto de perfil do bot, que é o que a tua comunidade vai ver.

Passo 4 — Ativa os Privileged Gateway Intents

Este é o passo mais importante, e aquele que mais pessoas esquecem. Desce até Privileged Gateway Intents e ativa os três:

• Presence Intent
• Server Members Intent
• Message Content Intent

A Beatra precisa do Message Content Intent para ler comandos, e dos outros para funcionar corretamente no teu servidor. Se estiverem desativados, o teu bot não vai iniciar ou responder. Clica em Save Changes depois de os ativares.

Passo 5 — Torna o Bot Público

Ainda no separador Bot, encontra a definição Public Bot e garante que está ativada. Isto permite-te a ti — e ao processo de integração da Beatra — adicionar o bot ao teu servidor com um link de convite. Se estiver desativada, só tu poderias adicioná-lo, e a configuração pode falhar.

Passo 6 — Copia o Teu Token

No topo do separador Bot, clica em Reset Token e confirma. O Discord mostra o token do teu bot apenas uma vez — clica em Copy.

⚠️ Mantém o teu token em segredo. Qualquer pessoa com o teu token tem controlo total sobre o teu bot. Nunca o partilhes nem o publiques. Se algum dia for exposto, volta aqui e repõe-no. A Beatra guarda o teu token totalmente encriptado e nunca o volta a mostrar.

Passo 7 — Cola-o na Beatra

Regressa ao ecrã de integração do Beatra Custom Bot e cola o teu token no respetivo campo. A Beatra valida o token e verifica se o Message Content Intent está ativado antes de continuar. Se vires um erro relacionado com intents, volta ao Passo 4, ativa os intents, guarda e tenta novamente.

Problemas Comuns

• "Message Content Intent is disabled" — saltaste o Passo 4. Ativa os três intents e guarda.
• "Invalid token" — o token foi copiado incorretamente ou foi reposto depois. Repõe-no novamente e copia o novo token.
• Não consegues adicionar o bot a um servidor — o Public Bot está desativado (Passo 5), ou não tens a permissão "Manage Server" nesse servidor.

Está Concluído

Assim que o teu token for validado, a Beatra configura o teu bot e dá-te um link de convite. A partir daí, o teu Custom Bot executa a experiência completa da Beatra com o teu próprio nome. Para saberes mais sobre esta funcionalidade, lê Apresentamos o Custom Bot.