Como hospedar um bot do Discord 24/7

​

Introdução

​

Pré-requisitos

• Conta Square Cloud: Cadastre-se através da página de cadastro usando seu e-mail.
• Plano ativo: Garante recursos dedicados e desempenho otimizado para seu aplicativo. Confira nossos planos disponíveis e escolha o mais adequado às suas necessidades.

​

Crie o projeto

​

Aplicação de bot no Discord

Crie a aplicação

Acesse o Developer Portal e clique em “New Application”. Defina um nome para o seu bot e clique em “Create” para criar a aplicação.

Gere o token

Após criar a aplicação, navegue até a aba “Bot” e clique em “Reset Token” para gerar o token de autenticação. Copie-o: você vai defini-lo como variável de ambiente na Square Cloud, nunca no seu código.

Ative as intents privilegiadas

O bot de exemplo lê o texto das mensagens, então precisa da Message Content Intent. Permaneça na aba “Bot”, role até “Privileged Gateway Intents” e ative a Message Content Intent. Este exemplo não precisa das outras duas intents privilegiadas (Presence e Server Members).

​

Desenvolva o bot

npm init -y

npm install discord.js

const { Client, Events, GatewayIntentBits } = require("discord.js");

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    // Privilegiada: ative a "Message Content Intent" no Developer Portal
    GatewayIntentBits.MessageContent,
  ],
});

client.once(Events.ClientReady, (readyClient) => {
  console.log(`Logged in as ${readyClient.user.tag}`);
});

client.on(Events.MessageCreate, (message) => {
  if (message.author.bot) return;
  if (message.content === "!hello") {
    message.reply("Olá!");
  }
});

// O token vem da variável de ambiente DISCORD_TOKEN
client.login(process.env.DISCORD_TOKEN);

pip install discord.py

import os

import discord
from discord.ext import commands

intents = discord.Intents.default()
# Privilegiada: ative a "Message Content Intent" no Developer Portal
intents.message_content = True

bot = commands.Bot(command_prefix="!", intents=intents)


@bot.event
async def on_ready():
    print(f"Logged in as {bot.user}")


@bot.command()
async def hello(ctx):
    await ctx.reply("Olá!")


# O token vem da variável de ambiente DISCORD_TOKEN
bot.run(os.environ["DISCORD_TOKEN"])

discord.py

​

Configure a Square Cloud

DISPLAY_NAME=My Discord Bot
MAIN=index.js
MEMORY=512
VERSION=recommended
AUTORESTART=true

DISPLAY_NAME=My Discord Bot
MAIN=main.py
MEMORY=512
VERSION=recommended
AUTORESTART=true

• MAIN é o arquivo que a Square Cloud executa, e MEMORY é a RAM do bot em MB. Bots precisam de pelo menos 256 MB; 512 MB deixa espaço para crescer.
• AUTORESTART=true inicia o bot de novo se ele travar. Veja como funciona o auto restart.
• Não há SUBDOMAIN: um bot não serve páginas web.

​

Defina o token do bot

• Dashboard: na página de upload, abra Configuração avançada e adicione uma variável chamada DISCORD_TOKEN com o seu token como valor. Para um bot que já está no ar, adicione-a na página Variáveis de ambiente da aplicação e reinicie o bot.
• CLI: logo depois de enviar o bot (veja Faça o deploy e verifique), defina-a com squarecloud app env set e reinicie o bot:

squarecloud app env set DISCORD_TOKEN=your_token_here
squarecloud app restart

​

O que vai no ZIP

• O seu arquivo principal (index.js ou main.py) e os seus outros arquivos de código.
• package.json ou requirements.txt.
• squarecloud.app.

​

Faça o deploy e verifique

​

Via dashboard

1

Acesse a página de upload

Acesse a página de upload e envie seu arquivo zip.

2

Configure seu ambiente

Após fazer o upload do seu arquivo zip, você precisará configurar o nome, o arquivo principal ou o ambiente de execução e outras configurações do seu projeto.
Se você estiver enviando um projeto web, certifique-se de selecionar “Publicação na Web” e definir um subdomínio para o seu projeto.

3

Faça o deploy do projeto

Por fim, clique no botão “Deploy” para hospedar seu projeto na Square Cloud. Após o deploy, você poderá monitorar o status e os registros do seu projeto no dashboard.

4

Confirme que seu app está no ar

Seu primeiro deploy geralmente leva menos de um minuto. No dashboard, aguarde o status da sua aplicação mudar para em execução e verifique os registros em busca de erros de inicialização.
Se você fez deploy de um site ou API, abra https://<seu-subdominio>.squareweb.app no navegador: você deve ver sua aplicação respondendo. Se você fez deploy de um bot, envie um comando para confirmar que ele está online.

Seu app não está iniciando? Veja o guia de solução de problemas para as causas e correções mais comuns.

​

Via CLI

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

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

squarecloud app status
squarecloud app logs

​

Convide o bot para o seu servidor

1. Acesse o Developer Portal e selecione seu bot.
2. Navegue até a aba “OAuth2” e vá para “OAuth2 URL Generator”.
3. Em “Scopes”, marque a opção “bot”.
4. Em “Bot Permissions”, marque apenas o que o exemplo precisa: View Channels, Send Messages e Read Message History. Evite Administrator: bots raramente precisam dela, e um token vazado passaria a controlar o seu servidor inteiro.
5. Copie a URL gerada, abra-a no navegador e adicione o bot ao seu servidor. A URL se parece com esta:

https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=68608&scope=bot

​

Erros comuns

​

An invalid token was provided

​

Used disallowed intents

​

O bot está online, mas não responde ao !hello

​

Próximos passos

​

Contate-nos