Como hospedar um bot do Discord em Node.js (passo a passo)

Publicado em 4 min de leitura

Crie o bot no Discord Developer Portal, envie o ZIP para a MyBotCloud e coloque o token com segurança. Um bot de verdade no ar em poucos minutos.

Neste tutorial você coloca um bot do Discord no ar, de ponta a ponta, sem servidor próprio e sem configurar nada de infraestrutura. Vamos usar um bot de exemplo que monta a estrutura de canais do seu servidor (categorias de informação, comunidade, suporte e desenvolvedores) e continua online depois.

O que você vai precisar:

  • uma conta na MyBotCloud (o login é com o Google);
  • uma conta no Discord e um servidor seu, de preferência vazio, para testar;
  • uns 10 minutos.

1. Crie o bot no Discord

  1. Abra o Discord Developer Portal e clique em Novo aplicativo (New Application, se o portal estiver em inglês).

Lista de aplicativos do Discord Developer Portal com uma seta apontando para o botão Novo aplicativo

  1. Digite um nome (por exemplo MeuBot), marque a caixa de aceite dos termos e clique em Criar. As setas mostram 1) o nome, 2) o aceite e 3) o botão.

Janela Criar um novo app com setas numeradas apontando o campo Nome, a caixa de aceite dos termos e o botão Criar

  1. No menu da esquerda, abra Bot.
  2. Clique em Redefinir token (Reset Token) e copie o token que aparecer. Ele é a senha do seu bot: não o cole em código, em prints nem em chats. Se vazar, volte aqui e gere outro.

Página Bot do portal, com uma seta apontando para o botão Redefinir token

Você não precisa ativar nenhum Privileged Gateway Intent: este bot só usa o intent básico de servidores.

2. Convide o bot para o seu servidor

Um token sozinho não coloca o bot dentro do servidor. É preciso convidá-lo:

  1. No portal, abra OAuth2 no menu da esquerda e role até Escopos.
  2. Em Escopos, marque bot.
  3. Em Permissões do bot, marque Gerenciar cargos e Gerenciar canais (Manage Roles e Manage Channels, no portal em inglês). As setas mostram 1) o escopo bot e 2) e 3) as duas permissões.

Página OAuth2 com setas numeradas apontando o escopo bot e as permissões Gerenciar cargos e Gerenciar canais

  1. Mais abaixo, em URL gerado, clique no botão de copiar.

Campo URL gerado do portal, com uma seta apontando para o botão de copiar

  1. Abra a URL no navegador, escolha o seu servidor em Adicionar ao servidor, clique em Continuar e depois em Autorizar.

Tela de autorização do Discord com setas numeradas apontando a lista Adicionar ao servidor e o botão Continuar

O bot aparece na lista de membros do servidor, com a etiqueta BOT.

3. Copie o ID do servidor

O ID diz ao bot em qual servidor ele deve trabalhar (sem ele, o bot age em todos os servidores onde estiver):

  1. No Discord, abra Configurações do usuário, procure a seção Desenvolvedor (use a busca, se precisar) e ative Modo desenvolvedor.

Configurações do Discord na seção Desenvolvedor, com uma seta apontando para o interruptor Modo desenvolvedor ligado

  1. Clique com o botão direito no ícone do seu servidor e escolha Copiar ID do servidor. É um número de 17 a 19 dígitos.

Menu do servidor no Discord com uma seta apontando para a opção Copiar ID do servidor, no fim da lista

4. Envie o bot para a MyBotCloud

  1. Baixe o bot de exemplo (botstartup.zip).
  2. No painel da MyBotCloud, clique em Nova aplicação, dê um nome, deixe Node.js e escolha o arquivo botstartup.zip.
  3. Em Variáveis de ambiente, clique em Adicionar variável duas vezes e preencha:
NomeValor
DISCORD_TOKENo token do passo 1
GUILD_IDo ID do passo 3

O formulário preenchido fica assim. As setas mostram 1) o arquivo ZIP, 2) as variáveis e 3) o botão que cria a aplicação (os valores aparecem mascarados enquanto você digita):

Formulário Nova aplicação da MyBotCloud com setas numeradas apontando o ZIP botstartup.zip, as variáveis DISCORD_TOKEN e GUILD_ID e o botão Criar aplicação

  1. Clique em Criar aplicação e aguarde cerca de 40 segundos: a plataforma instala as dependências e inicia o bot.

As variáveis são só de escrita: depois de salvas, nunca mais aparecem na tela nem nos logs. Elas já ficam disponíveis desde a primeira execução, então o bot não cai por falta de token.

5. Confira se funcionou

Abra Gerenciar → Logs. O resultado esperado é:

Conectado como MeuBot#1234
Servidor: Nome do seu servidor
  + categoria 📢 INFORMATION
  + canal 👋・welcome
  ...
  pronto: 20 criados, 0 já existiam.
Estrutura verificada. O bot continua online.

No Discord, o servidor ganha 5 categorias e 15 canais. Os canais de INFORMATION ficam somente leitura para os membros, e só a equipe e o bot escrevem neles. A categoria 🔒 STAFF (com o canal 🚨・alerts) é invisível para os membros: serve para você receber avisos internos, por exemplo de um webhook.

O bot pode rodar de novo quantas vezes você quiser: ele só cria o que está faltando.

Como o bot funciona

O código é pequeno. A estrutura fica em uma lista que você pode editar:

const STRUCTURE = [
  {
    category: "📢 INFORMATION",
    readOnly: true,
    channels: ["👋・welcome", "📢・announcements", "🟢・status", "📝・changelog"],
  },
  // COMMUNITY, SUPPORT, DEVELOPERS...
];

Ao ligar, o bot conecta com o intent Guilds, lê o servidor e cria o que falta. Se você convidá-lo depois de ele já estar rodando, ele percebe a entrada (evento guildCreate) e monta a estrutura na hora. Para mudar categorias ou canais, edite structure.js e use Atualizar na MyBotCloud: as variáveis são mantidas.

Problemas comuns

O que aparece no logO que fazer
Falta a variável DISCORD_TOKENAdicione a variável em Gerenciar → Variáveis de ambiente. O bot reinicia sozinho.
An invalid token was providedO token foi colado com espaço ou foi trocado. Gere outro com Reset Token e salve de novo.
O bot ainda não está no servidorFalta o convite (passo 2) ou o GUILD_ID é de outro servidor.
Missing PermissionsO bot entrou sem Gerenciar canais e Gerenciar cargos. Convide de novo com essas permissões, ou arraste o cargo do bot para o topo da lista de cargos.

Quanto isso custa em recursos

O bot de exemplo roda no plano Start (grátis) e usa cerca de 30 MB dos 100 MB de memória. Sobra espaço para você evoluir o código.

Segurança em uma frase

Nunca coloque o token dentro do ZIP nem do código: use sempre as variáveis de ambiente da MyBotCloud.

Próximos passos

Agora que você viu o caminho completo, o mesmo fluxo vale para qualquer bot em Node.js: prepare o projeto em um .zip, escolha a linguagem, preencha as variáveis e envie. Se ficar com dúvida em algum passo, pergunte no nosso Discord.

  • discord
  • node.js
  • bots
  • hospedagem
  • tutorial

← Voltar ao blog