Como criar um bot no Discord

Passo 1: Crie o aplicativo e o token do bot

1. Abra o Developer Portal. Acesse discord.com/developers/applications, crie um novo aplicativo e dê um nome a ele.
2. Pegue o token. Na página Bot, clique em Reset Token e copie-o. O Discord mostra o token só uma vez; se você perder, redefina de novo.
3. Mantenha o token em segredo. Ele é a senha do bot: quem tiver o token controla o seu bot. Nunca cole o token em código que você compartilha nem faça commit dele no Git.

Passo 2: Convide o bot para o seu servidor

1. Abra a página Installation do seu aplicativo.
2. Nas configurações de instalação padrão para servidores, adicione os scopes bot e applications.commands e as permissões de que o bot precisa: Send Messages basta para este guia.
3. Abra o link de instalação gerado, escolha o seu servidor e autorize. O bot aparece na lista de membros, offline até o seu código rodar.

Tutoriais mais antigos usam OAuth2 > URL Generator com os mesmos dois scopes; isso ainda funciona.

Passo 3a: Escreva o bot em Python (discord.py)

O discord.py 2.7 exige Python 3.8 ou mais recente. Instale e crie bot.py:

pip install discord.py

import os
import discord
from discord import app_commands

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()

bot = Bot()

@bot.tree.command(description="Replies with Pong!")
async def ping(interaction: discord.Interaction):
    await interaction.response.send_message("Pong!")

bot.run(os.environ["DISCORD_TOKEN"])

Rode com o token em uma variável de ambiente, por exemplo DISCORD_TOKEN=your-token python bot.py no Linux ou macOS.

Passo 3b: Escreva o bot em JavaScript (discord.js)

O discord.js 14 exige Node.js 18 ou mais recente. Em uma pasta nova, rode npm install discord.js e crie index.js:

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

const commands = [new SlashCommandBuilder().setName('ping').setDescription('Replies with Pong!').toJSON()];
const client = new Client({ intents: [GatewayIntentBits.Guilds] });

client.once(Events.ClientReady, async (c) => {
  await new REST().setToken(process.env.DISCORD_TOKEN).put(Routes.applicationCommands(c.user.id), { body: commands });
  console.log(`Logged in as ${c.user.tag}`);
});

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

client.login(process.env.DISCORD_TOKEN);

Inicie com DISCORD_TOKEN=your-token node index.js. Quando o console mostrar Logged in, digite /ping no seu servidor.

Mantenha o token fora do código

• Use uma variável de ambiente ou um arquivo .env, e adicione .env ao .gitignore antes do primeiro commit.
• Se o token vazar, redefina na página Bot na hora. O token antigo para de funcionar, e você atualiza o novo onde o bot roda.
• O GitHub varre repositórios públicos em busca de tokens de bots do Discord e os informa ao Discord, que pode revogá-los; por isso, um token enviado por engano muitas vezes para de funcionar antes de você perceber.

Passo 4: Mantenha seu bot online

Seu bot só fica online enquanto o código está rodando. Fechou o terminal ou desligou o PC, ele fica offline. Você tem três opções:

• Seu próprio PC: grátis e bom para desenvolver e testar, mas o bot dorme quando o computador dorme.
• Um plano gratuito: a maioria suspende ou limita bots que rodam o mês inteiro; os prós e contras estão comparados em hospedagem gratuita de bots do Discord.
• Hospedagem de bots: um pequeno servidor sempre ligado. Na hospedagem de bots do Discord da HytHost você envia seu projeto, escolhe Node.js, Python ou outro runtime, e o painel inicia o bot e o reinicia se ele travar.

O passo a passo completo, do envio ao reinício automático, está em como hospedar um bot do Discord 24/7.