Como criar um bot de Discord

Passo 1: Crie a aplicação e o token do bot

1. Abra o Developer Portal. Aceda a discord.com/developers/applications, crie uma nova aplicação e dê-lhe um nome.
2. Obtenha o token. Na página Bot, clique em Reset Token e copie-o. O Discord mostra-o apenas uma vez; se o perder, reponha-o de novo.
3. Mantenha o token secreto. É a palavra-passe do bot: quem o tiver controla o seu bot. Nunca o cole em código que partilhe nem o envie para o Git.

Passo 2: Convide o bot para o seu servidor

1. Abra a página Installation da sua aplicação.
2. Nas definições de instalação predefinidas para servidores, adicione os scopes bot e applications.commands e as permissões de que o bot precisa: Send Messages chega para este guia.
3. Abra a ligação de instalação fornecida, escolha o seu servidor e autorize. O bot aparece na lista de membros, offline até o seu código correr.

Os tutoriais mais antigos usam OAuth2 > URL Generator com os mesmos dois scopes; continua a funcionar.

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

O discord.py 2.7 requer Python 3.8 ou mais recente. Instale-o 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"])

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

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

O discord.js 14 requer Node.js 18 ou mais recente. Numa pasta nova, execute 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-o com DISCORD_TOKEN=your-token node index.js. Quando a consola mostrar Logged in, escreva /ping no seu servidor.

Mantenha o token fora do código

• Use uma variável de ambiente ou um ficheiro .env, e adicione .env ao .gitignore antes do primeiro commit.
• Se o token for divulgado, reponha-o de imediato na página Bot. O token antigo deixa de funcionar e atualiza o novo onde o bot corre.
• O GitHub analisa os repositórios públicos à procura de tokens de bots de Discord e comunica-os ao Discord, que os pode revogar; por isso, um token enviado por engano muitas vezes deixa de funcionar antes de dar por isso.

Passo 4: Mantenha o seu bot online

O seu bot só está online enquanto o código corre. Feche o terminal ou desligue o PC, e ele fica offline. Tem três opções:

• O seu próprio PC: gratuito e adequado para desenvolver e testar, mas o bot adormece quando o computador adormece.
• Um plano gratuito: a maioria suspende ou limita os bots que correm o mês inteiro; as vantagens e desvantagens são comparadas em alojamento gratuito de bots de Discord.
• Alojamento de bots: um pequeno servidor sempre ligado. No alojamento de bots de Discord da HytHost carrega o seu projeto, escolhe Node.js, Python ou outro runtime, e o painel inicia o bot e reinicia-o se falhar.

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