​
Introdução

Para desenvolver e hospedar um bot do Discord na Square Cloud, é essencial seguir uma sequência estruturada de configurações e pré-requisitos. Este guia técnico abordará todo o processo, desde a configuração inicial até o deploy em produção.

​
Pré-requisitos Essenciais

  • Conta ativa no Discord: Fundamental para criar e gerenciar bots na plataforma. Caso não possua, acesse o site oficial do Discord para criar sua conta.
  • Conta na Square Cloud: Plataforma de hospedagem para sua aplicação. Registre-se através da página de cadastro utilizando seu email.
  • Plano pago ativo: Garante recursos dedicados e performance otimizada para seu bot. Consulte nossos planos disponíveis e escolha o mais adequado às suas necessidades.

​
Configuração Inicial do Bot Discord

Criação da Aplicação

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

Obtenção do Token de Autenticação

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 token gerado para uso posterior na implementação do código.

Ativação de Intents Privilegiadas

Com o token configurado, ative as intents necessárias. Permaneça na aba “Bot”, role para baixo e localize “Privileged Gateway Intents”. Ative as intents conforme mostrado na imagem:
Segurança Crítica: Mantenha o token do seu bot em absoluto sigilo. Este token concede controle total sobre o bot e deve ser tratado como informação confidencial.

​
Desenvolvimento do Bot

​
Bibliotecas e Frameworks Recomendados

Configuração do Ambiente Node.js
  1. Verifique se o Node.js está instalado em seu sistema. Caso contrário, faça o download no site oficial do Node.js.
  2. Inicialize um novo projeto Node.js:
Terminal
npm init -y
  1. Instale a biblioteca Discord.js:
Terminal
npm install discord.js
  1. Crie um arquivo JavaScript (por exemplo, index.js) e adicione o código a seguir para criar um bot Discord básico:
index.js
const { Client, GatewayIntentBits } = require("discord.js");

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent,
  ],
});

client.on("ready", () => {
  console.log(`${client.user.tag}!`);
});

client.on("messageCreate", (message) => {
  if (message.content === "!hello") {
    message.reply("Hello!");
  }
});

client.login("seu token aqui");

​
Configuração do Arquivo Square Cloud

Aprenda sobre: como criar o arquivo de configuração para a Square Cloud.

O arquivo squarecloud.app é um arquivo de configuração que será utilizado para configurar sua aplicação na Square Cloud. Ele define nome, descrição, versão, arquivo principal, entre outras configurações essenciais.

​
Configuração do Campo START

Utilize este campo apenas se você tem total certeza do que está fazendo.
No arquivo de configuração da Square Cloud, o campo START é opcional e necessário apenas se você estiver utilizando um script personalizado para iniciar o bot. No exemplo fornecido, o campo START não é necessário.

​
Upload do Projeto para a Square Cloud

Após seguir todos os passos, empacote os arquivos da sua aplicação em um arquivo zip onde o arquivo de configuração está localizado e faça o upload do bot em Upload. Lembre-se de incluir o arquivo requirements.txt ou package.json, mas não inclua arquivos como __pycache__ ou node_modules. Você pode obter mais informações sobre arquivos desnecessários durante a hospedagem em exclusão-automática-de-arquivos-ao-fazer-deploy-de-uma-aplicação-na-squarecloud.

​
Testando o Bot

Se você seguiu todos os passos corretamente, o próximo passo é convidar seu bot para testá-lo. Para fazer isso, siga estas etapas:
  1. Acesse o Portal do Desenvolvedor.
  2. Selecione seu bot.
  3. Navegue até a aba “OAuth2”.
  4. Vá para “OAuth2 URL Generator”.
  5. Marque a opção “bot”.
  6. Escolha as permissões que seu bot terá quando for convidado usando este convite.
  7. Abaixo das permissões, um link de convite para seu bot será gerado. Deve ser parecido com este:
https://discord.com/oauth2/authorize?client_id=00000000000000&permissions=8&scope=bot
Lembre-se de que o client_id na URL deve ser substituído pelo ID real do seu bot. O valor de permissions também pode precisar ser ajustado com base nas permissões que você deseja que seu bot tenha. Agora, para testar se tudo está funcionando, execute o seguinte comando no seu servidor: !hello.

​
Recursos Adicionais

Para mais informações sobre como criar bots com discord.py e discord.js, visite a documentação oficial do discord.py e o guia oficial do discord.js. Lá, você encontrará guias detalhados, tutoriais e documentação da API para ajudá-lo a aproveitar ao máximo essas bibliotecas. Se você continuar enfrentando dificuldades técnicas, nossa equipe de suporte especializada está disponível para auxiliá-lo. Entre em contato conosco e teremos prazer em ajudá-lo a resolver qualquer questão.