Hospedar um bot do Discord

Um bot do Discord abre uma conexão com o gateway do Discord e fica ouvindo eventos. Ele não recebe conexões, então roda como worker: um processo contínuo, sem porta pública, que o Hydro reinicia se cair.

Antes de começarCopiar o link da seção

• O token do bot, em Discord Developer Portal → Applications → seu app → Bot → Reset Token.
• Os Privileged Gateway Intents que o bot usa ligados na mesma página (por exemplo, Message Content Intent para ler mensagens).
• O código num repositório do GitHub ou num .zip (sem node_modules nem .venv).

1. Leia o token da variável de ambienteCopiar o link da seção

Nunca deixe o token no código. Leia de DISCORD_TOKEN:

import { Client, Events, GatewayIntentBits } from 'discord.js';

const client = new Client({ intents: [GatewayIntentBits.Guilds] });
client.once(Events.ClientReady, (ready) => console.log(`Online como ${ready.user.tag}`));
client.login(process.env.DISCORD_TOKEN);

import os
import discord

client = discord.Client(intents=discord.Intents.default())

@client.event
async def on_ready():
    print(f"Online como {client.user}")

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

2. Garanta o comando de inícioCopiar o link da seção

• Node.js: um script start no package.json, como "start": "node index.js". O gerenciador (npm, pnpm, yarn ou bun) vem do lockfile.
• Python: um main.py na raiz e as dependências no requirements.txt (ou pyproject.toml com Poetry ou uv).

3. Crie o workerCopiar o link da seção

Em Aplicações → Criar aplicação, escolha a origem (GitHub, .zip ou imagem Docker), o tipo Worker e a memória. Bots pequenos costumam rodar bem com 128 a 256 MB; acompanhe o consumo em Métricas e ajuste.

4. Cadastre o token e faça o deployCopiar o link da seção

Na aba Variáveis, crie DISCORD_TOKEN marcada como segredo e faça o deploy. Nos Logs, aparece a linha Online como … quando o bot conecta.

Erros comunsCopiar o link da seção

Dados do botCopiar o link da seção

Arquivos que o bot grava, como um banco SQLite, ficam na pasta do projeto, que continua entre deploys e entra no backup diário (detalhes). Para muitos acessos simultâneos, use um banco gerenciado.