Pular para o conteúdo principal

Introdução

Para desenvolver e hospedar um aplicativo no 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é a implantação em produção.

Pré-requisitos

  • Conta Square Cloud: Plataforma de hospedagem para seu aplicativo. Cadastre-se através da página de cadastro usando seu e-mail.
  • Plano Pago Ativo: Garante recursos dedicados e desempenho otimizado para seu aplicativo. Confira nossos planos disponíveis e escolha o mais adequado às suas necessidades.
Está se perguntando quanta RAM e CPU seu plano precisa para hospedar Bots de Discord?
Não se preocupe, estamos aqui para ajudar. Nosso plano Hobby oferece 2GB de RAM e 2vCPU, o que deve ser suficiente para a maioria dos Bots de Discord. No entanto, se você estiver trabalhando em um projeto maior e precisar de mais estabilidade, recomendamos considerar nosso plano Pro. Com recursos adicionais, você pode manter a estabilidade mesmo durante picos de demanda. Para comprar, basta clicar aqui.

Criando o projeto

Para criar um bot do Discord, é fundamental ter uma conta para criar e gerenciar bots na plataforma. Se você não tem uma, visite o site oficial do Discord para criar sua conta.

Aplicação de Bot no Discord

Criação da 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.

Geraçã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. Permanecendo 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 sigilo absoluto. Este token concede controle total sobre o bot e deve ser tratado como informação confidencial.

Desenvolvendo o projeto

Agora que temos o token do bot, podemos começar a codificar. Você pode usar sua linguagem favorita para isso.
Configuração do Ambiente Node.js
  1. Verifique se o Node.js está instalado em seu sistema. Caso contrário, baixe-o 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 (ex: index.js) e adicione o seguinte código 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} está online!`);
});

client.on("messageCreate", (message) => {
  if (message.content === "!olá") {
    message.reply("Olá!");
  }
});

client.login("seu token aqui");

Realizando o Deploy

Após preparar os arquivos do seu projeto, você pode enviá-los para a Square Cloud e hospedar seu projeto. Para fazer isso, crie um arquivo ZIP contendo todos os arquivos do seu projeto.

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

Finally, click on the "Deploy" button to host your project on Square Cloud.
After deployment, you can monitor your project's status and logs from the dashboard.

Via CLI

Para usar esse método, você precisa criar um arquivo de configuração chamado squarecloud.app no diretório raiz do seu projeto. Esse arquivo conterá a configuração necessária para o seu projeto.

Saiba mais sobre: Como criar arquivo de configuração da Square Cloud.

O arquivo squarecloud.app é um arquivo de configuração que será usado para configurar seu aplicativo; ele será usado para definir seu ambiente.
1

Primeiro Passo

Primeiro, você precisa ter a CLI instalada em seu ambiente. Se você ainda não a possui, execute o seguinte comando em seu terminal:
npm install -g @squarecloud/cli
Se você já a possui, recomendamos atualizá-la. Para fazer isso, execute o seguinte comando em seu terminal:
squarecloud update
2

Segundo Passo

Agora, para autenticar e usar outros comandos da CLI, você encontrará sua chave de autorização aqui clicando em "Solicitar Chave da API". Após obter sua chave de autorização, execute o seguinte comando:
squarecloud auth login
3

Terceiro Passo

Finalmente, para fazer o deploy da sua aplicação para a Square Cloud usando a CLI, você precisa executar o seguinte comando:
squarecloud upload
Ou se já possui o zip criado:
squarecloud upload --file <caminho/para/zip>

Testando o Bot

Se você seguiu todas as etapas corretamente, o próximo passo é convidar seu bot para teste. Para fazer isso, siga estas etapas:
  1. Acesse o Developer Portal.
  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á ao ser convidado usando este convite.
  7. Abaixo das permissões, um link de convite para o seu bot será gerado. Ele deve se parecer com este:
[https://discord.com/oauth2/authorize?client_id=00000000000000&permissions=8&scope=bot](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 está tudo funcionando, execute o seguinte comando no seu servidor: !olá.

Recursos Adicionais

Para mais informações sobre a criação de 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 tirar o máximo proveito dessas bibliotecas.

Contate-nos

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.