Como hospedar um Bot de Discord

1. Pré-requisitos

Antes de subir seu bot, verifique se você possui:

Conta na Square Cloud: Crie sua conta via Página de Registro (E-mail ou GitHub).
Plano Ativo: É necessário um plano pago para realizar a hospedagem. Confira os preços aqui.

2. Preparação do Código Fonte

Para que a Square Cloud execute seu bot corretamente, ele deve estar organizado e conter o arquivo de definição de dependências.

Exemplo em Python (discord.py)

Certifique-se de ter um arquivo requirements.txt na raiz do projeto:

discord.py

Exemplo em JavaScript (discord.js)

Certifique-se de ter um arquivo package.json na raiz do projeto:

{
  "name": "meu-bot-discord",
  "version": "1.0.0",
  "main": "index.js",
  "dependencies": {
    "discord.js": "^14.0.0"
  }
}

3. Compactação e Limpeza (Importante)

Um erro comum é tentar enviar todos os arquivos do projeto, incluindo pastas de cache ou dependências locais. Para um deploy limpo e rápido, você deve criar um arquivo .zip contendo apenas o essencial:

O que INCLUIR: Arquivos .py ou .js, arquivos de configuração (.json, .txt) e o arquivo de dependências (requirements.txt ou package.json).
O que EXCLUIR: * node_modules/ (Pasta de módulos do Node)
- __pycache__/ (Cache do Python)
- .env (As variáveis de ambiente serão configuradas no dashboard)
- .git/ ou arquivos de IDE (como .vscode/)

4. Realizando o Deploy

Existem duas formas principais de enviar seu bot para a Square Cloud:

Via Dashboard

Acesse o Dashboard da Square Cloud.
Clique em "Nova Aplicação".
Selecione o envio de zip.
No momento do envio, você verá campos para configurar as Variáveis de Ambiente (ENVs).

Via CLI

Instale a CLI:

npm i -g @squarecloud/cli

Autenticar na CLI: Pegue seu token de API na página de Minha Conta, indo na seção Autenticação e solicitando a chave API; Em sequência, se autentique na CLI com o comando a seguir.

squarecloud auth login

Crie seu arquivo de configuração: o arquivo de configuração, squarecloud.config ou squarecloud.app, deve estar presente no seu projeto
Faça o upload:

squarecloud upload

Ou se criou o zip:

squarecloud upload --file <caminho/para/zip>

5. Configurando Variáveis de Ambiente (ENV)

Nunca deixe o Token do seu bot exposto diretamente no código. Utilize o sistema de ENVs da Square Cloud para manter seu bot seguro.

Configuração no Dashboard: No campo de variáveis, defina o nome (ex: DISCORD_TOKEN) e o valor (seu token).
Atenção aos valores: Se o valor da sua variável contiver espaços ou caracteres especiais (como links ou chaves complexas), utilize aspas para delimitar o valor.
- Exemplo: NOME_VARIAVEL="Valor com espaço ou caracteres especiais"

No seu código, acesse a variável assim:

Python: os.getenv('DISCORD_TOKEN')
JavaScript: process.env.DISCORD_TOKEN

6. Ciclo de Vida e Monitoramento

Após o envio:

A Square Cloud detectará automaticamente, com base no arquivo principal escolhido, o runtime necessário e instalará as dependências.
Acompanhe os Logs em tempo real para verificar se o bot logou corretamente.

Atualizado em: 12/05/2026

Este artigo foi útil?

Obrigado!