← Blog

Como criar bot no Discord em 6 passos: discord.js ou Python

Par Benjamin Dayan · PDG

· Mis à jour le 20 de novembro de 2026 · Lecture 7 min

Sumário
Pessoa programando um bot do Discord em um notebook, com editor de código e servidor Discord abertos na tela

Para entender como criar bot no Discord, o caminho é este: crie uma aplicação no Discord Developer Portal, adicione um bot e copie o token dele. Depois você o convida com um link OAuth2 (escopos bot e applications.commands), escreve algumas linhas em discord.js ou Python e o hospeda para que rode 24 horas por dia. Do lado do Discord, tudo é gratuito.

Você precisa de uma conta no Discord, de Node.js ou Python instalado e de um editor de código. O objetivo é ter um comando /ping respondendo no seu servidor e, em seguida, um bot que continua online quando o seu PC está desligado. Um bot sob medida pode, por exemplo, mostrar o status dos seus servidores de jogos para alugar ou avisar sobre um wipe no Rust.

Em resumo

  • Os 6 passos: aplicação, token, convite, escolha da linguagem, código e hospedagem.
  • Dois escopos para marcar no convite: bot e applications.commands.
  • O token fica em um arquivo .env, nunca no código nem no Discord.
  • Um bot "online, mas mudo" quase sempre tem problema nos comandos slash, nas permissões ou no convite.
  • Para ele rodar sem o seu PC, você precisa de uma hospedagem de bot Discord ou de uma máquina ligada o tempo todo.

Passo 1: como criar bot no Discord pelo portal de desenvolvedores

Acesse o Developer Portal (discord.com/developers/applications), clique em New Application, dê um nome e abra a aba Bot. Os rótulos ficam em inglês, mesmo com a conta configurada em português. Adicione um avatar e um nome de exibição.

A aplicação é o contêiner: identificadores, configurações e links de convite. O bot, por sua vez, é a conta que entra nos seus servidores e age em nome da aplicação.

Se o bot serve só à sua comunidade, desmarque Public Bot. Assim, ninguém mais consegue convidá-lo.

Passo 2: pegar o token e proteger

Na aba Bot, clique em Reset Token. Ele aparece uma única vez, então copie na hora. Se perder, é só gerar outro.

O token é a senha do bot. Quem o tiver pode controlá-lo: postar nos seus canais, banir membros, ler o que o bot enxerga.

Crie um arquivo .env na raiz do projeto:

DISCORD_TOKEN=cole_seu_token_aqui
GUILD_ID=id_do_seu_servidor_de_teste

Depois crie um .gitignore para que ele nunca vá parar no GitHub:

.env
node_modules/

Nada de token em print de tela, em mensagem no Discord ou em repositório público. Se vazar, volte à aba Bot e clique em Reset Token: o antigo deixa de funcionar na hora. E não conte com nenhuma detecção automática para te salvar.

Na mesma página ficam três Privileged Gateway Intents: Presence, Server Members e Message Content. Deixe todos desativados enquanto não houver uma necessidade concreta. Segundo a documentação do Discord, esses intents são ativados no portal. Em apps verificados (a verificação é obrigatória a partir de 100 servidores), o intent também precisa ser aprovado no processo de verificação.

Passo 3: convidar o bot para o seu servidor

Vá em OAuth2 > URL Generator. Marque os escopos bot e applications.commands e, em seguida, as permissões de que o bot precisa. Para um primeiro bot, Send Messages e Embed Links costumam bastar. Evite a permissão de Administrador: um bot com o mínimo necessário limita o estrago se o token vazar.

Copie a URL gerada, abra no navegador e escolha o servidor. Para adicionar um bot, você precisa da permissão Gerenciar Servidor.

Depois do convite, o bot aparece offline na lista de membros. É normal: ele só se conecta quando o seu código está rodando.

Passo 4: escolher entre discord.js e Python

Critério discord.js discord.py
Linguagem JavaScript, Node.js Python
Versão v14 (npm) 2.x
Requisito mínimo Node.js 24.17.0 ou mais recente, segundo a documentação atual Python 3.8 ou superior, segundo a documentação
Curva de aprendizado Suave, se você já conhece JS Muito suave para iniciantes
Uso típico Bot ligado a um site ou painel web Scripts, dados, automações

Se você já conhece JavaScript, ou se a sua comunidade tem um painel web, vá de discord.js. Se está começando do zero ou vai trabalhar sobretudo com scripts, escolha Python. Para um primeiro bot, as duas opções funcionam muito bem. Confira as versões nos sites oficiais antes de instalar, porque elas mudam.

Passo 5: escrever o primeiro bot (comando /ping)

O princípio é o mesmo nos dois casos. O token vem do .env, o comando é registrado no seu servidor de teste (valendo na hora) e o bot responde "Pong" com a latência.

Versão discord.js

Em uma pasta vazia, rode npm init -y e depois npm install discord.js dotenv. Crie o index.js:

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

const client = new Client({ intents: [GatewayIntentBits.Guilds] });
const commands = [new SlashCommandBuilder().setName('ping').setDescription('Testa a latência').toJSON()];

client.once(Events.ClientReady, async () => {
  const rest = new REST().setToken(process.env.DISCORD_TOKEN);
  await rest.put(Routes.applicationGuildCommands(client.user.id, process.env.GUILD_ID), { body: commands });
  console.log(`Conectado: ${client.user.tag}`);
});

client.on(Events.InteractionCreate, async (interaction) => {
  if (interaction.isChatInputCommand() && interaction.commandName === 'ping') {
    await interaction.reply(`Pong: ${client.ws.ping} ms`);
  }
});

client.login(process.env.DISCORD_TOKEN);

Inicie com node index.js. O guia do discord.js recomenda, aliás, usar comandos de servidor durante o desenvolvimento e os testes.

Versão Python (discord.py)

Instale as dependências com pip install discord.py python-dotenv e crie o bot.py:

import os
import discord
from discord import app_commands
from dotenv import load_dotenv

load_dotenv()
GUILD = discord.Object(id=int(os.getenv("GUILD_ID")))

class Bot(discord.Client):
    def __init__(self):
        super().__init__(intents=discord.Intents.default())
        self.tree = app_commands.CommandTree(self)

    async def setup_hook(self):
        await self.tree.sync(guild=GUILD)

bot = Bot()

@bot.tree.command(name="ping", description="Testa a latência", guild=GUILD)
async def ping(interaction: discord.Interaction):
    await interaction.response.send_message(f"Pong: {round(bot.latency * 1000)} ms")

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

Inicie com python bot.py. Se uma versão principal mudar a sintaxe, vale o que diz a documentação oficial.

Meu bot está online, mas não responde: 4 causas frequentes

  1. Comandos slash não sincronizados: reinicie o bot depois de adicionar o comando e teste primeiro em um servidor específico. Comandos globais demoram mais para aparecer.
  2. Intent Message Content desativado: ele só importa para comandos com prefixo (do tipo ?status). Ative na aba Bot ou passe para os comandos slash.
  3. Escopo applications.commands esquecido no convite: gere a URL de novo com os dois escopos e convide o bot outra vez.
  4. Falta de permissão no canal: confira se o bot consegue ver o canal e enviar mensagens nele.

Passo 6: manter o bot do Discord online 24 horas por dia

Enquanto o terminal estiver aberto no seu PC, o bot responde. Desligou a máquina, ele some. Para um aviso de wipe programado para as 19h ou um comando /status usado às 3h da manhã, isso não funciona.

Opção Vantagens Limites
PC pessoal Gratuito Quedas, consumo de energia, seu IP residencial exposto
Mini PC em casa Custo baixo de uso Manutenção, atualizações, conexão residencial
Hospedagem de bot Discord da Fly-Serv Máquina sempre ligada, sem depender da sua internet de casa Uma assinatura

Se você hospeda em casa, instale um gerenciador de processos para religar o bot depois de uma falha ou de uma reinicialização. Com Node.js, o PM2 resolve:

npm install -g pm2
pm2 start index.js --name bot-comunidade
pm2 save
pm2 startup

No Linux, um serviço systemd com Restart=always cumpre o mesmo papel para um script Python. Nosso guia hospedar em casa ou contratar uma hospedagem detalha essa escolha.

A solução pronta: Hospedagem de bot Discord: seu bot online 24/7. Lá você encontra os detalhes da oferta, os recursos e os preços. Se você administra vários bots ou quer um painel, dê uma olhada na VPS Pterodactyl.

O que evitar: self-bots e automação da sua conta pessoal

Automatizar a sua conta de usuário com um token pessoal é um self-bot. O Discord proíbe isso nos termos de uso, e você corre o risco de ter a conta suspensa. Só é permitido usar uma conta de bot criada pelo portal, com a API oficial.

Existem bots prontos, mas eles não sabem consultar o seu servidor de Rust nem anunciar o seu wipe do seu jeito. Para funções específicas da sua comunidade, um bot sob medida continua sendo a melhor resposta.

Perguntas frequentes

Criar um bot no Discord é grátis?

Sim. O portal de desenvolvedores, a API e as bibliotecas discord.js e discord.py são gratuitos. O único custo possível é a hospedagem, se você não quiser deixar a sua própria máquina ligada.

Preciso saber programar para criar um bot no Discord?

Algumas noções de JavaScript ou Python bastam para um primeiro bot. Os exemplos deste artigo têm menos de 30 linhas: copie, faça o /ping funcionar e depois mude o texto da resposta.

O que fazer se o token do meu bot vazou?

Redefina na hora com Reset Token, na aba Bot: o antigo para de funcionar. Coloque o novo no seu .env, apague qualquer print ou commit que contenha o anterior e reinicie o bot.

Por que meu bot está online, mas não responde aos comandos?

As causas de sempre: comandos slash não sincronizados, escopo applications.commands ausente no convite, falta de permissão no canal ou intent Message Content desativado em um comando com prefixo.

Como manter meu bot online sem deixar o PC ligado?

Ele precisa rodar em uma máquina ligada o tempo todo: um mini PC em casa com um gerenciador de processos ou a hospedagem de bot Discord da Fly-Serv. A segunda opção poupa você da manutenção e das quedas da internet de casa.

Self-bot no Discord é permitido?

Não. Automatizar uma conta de usuário vai contra os termos de uso do Discord e pode levar à suspensão da conta. Use uma conta de bot oficial.

O seu bot já funciona? Deixe-o rodando 24 horas por dia sem precisar manter o PC ligado: a gente cuida do resto. Veja a página Hospedagem de bot Discord: seu bot online 24/7 para conhecer as opções, e fale com a equipe da Fly-Serv no Discord se tiver dúvida sobre a configuração.

Leia também