Primeiro bot do Discord para envio de lembrete: do zero ao deploy! #PASSO1️⃣

Como iniciar o projeto sem saber nada?

Bom, como sendo meu primeiro bot para o discord meu conhecimento somava um total de 0 😆, mas faz parte, tendo em vista que comecei a mexer com javascript no final do ano passado.
Eu tive muito da ajuda de canais no youtube e do próprio chatGPT para o desenvolvimento e entendimento da aplicação.
Com a internet, hoje em dia, só não programa e não aprende quem não quer mesmo, não é?! Então, pensando nisso, e no fato de que eu precisava criar algo que me lembrasse de fazer algumas coisas no dia-a-dia que eram importantes, eu resolvi ir atrás de aprender e é isso mesmo que pretendo compartilhar nesse post.

Obs.: É fundamental que se tenha uma conta criada no discord!

Passo 1: Criar um servidor no Discord.

Com o Discord aberto, você precisa criar um servidor (pode ser com o nome que você vai dar ao seu bot, ou qualquer outro nome que desejar) para dar segmento aos próximos passos.

Se não quiser selecionar aqui, pode dar um skip this question.

Aqui você pode dar o nome que desejar e até adicionar uma foto de perfil do servidor.

Finalizado, ele abrirá dessa forma.

Passo 2: Criar uma nova aplicação no Discord Developer.

Primeiro você precisa acessa o Developer Portal e ir na opção New Application, conforme mostra na imagem abaixo.

Passo 3: Gerar a URL do bot.

Após criar a aplicação, você vai precisar acassar o menu OAuth2 >> URL Generator e marcar a opção BOT, feito isso, será gerada uma URL no campo GENERATED URL, basta copiar ela e abrir ela em nova aba no navegador.

Obs.: Se a URL não for gerada marcando a opção BOT, você precisará marcar a opção ADMINISTRADOR nas opções que serão abertas ao selecionar a opção BOT, conforme imagem.

Passo 4: Marcações importantes que precisam ser feitas no Developer Portal.

Antes de partirmos para o link que foi gerado e aberto em nova aba na web, precisamos finalizar um item importante aqui no Developer Portal para que depois possamos codificar com total acesso as informações. Algumas marcações precisam ser realizadas, para isso, você vai precisar acessar o menu BOT e encontrar o título Privileged Gateway Intents, no final da página e marcar as três opções, logo após salvar.

Passo 5: Autorizar o bot a entrar no servidor.

Agora sim, vamos dar a permissão para que o bot possa acessar o nosso servidor que criamos lá no passo 1, para isso, vamos ir naquela aba aberta com a URL que foi gerada e vamos selecionar o nossos servidor, após, ir na opção Authorize.

Após autorizar ele provavelmente irá pedir para confirmar que é um humano, após confirmar, se tudo der certo, essa tela deverá aparecer para você e inclusive a notificação no canto inferior direito.

No servidor que criamos no discord no Passo 1 deverá aparecer uma nova mensagem dando as boas vindas para o bot e inclusive mostrando que ele está ali, mas offline.

Passo 6: Ferramentas necessárias e indispensáveis.

Primeiramente, você precisa ter instalado em sua máquina dois itens fundamentais, uma IDE para poder criar o código (e ai eu recomendo o VS CODE, mas também tem o Sublime Text ou o Eclipse, além de vários outros) e você também vai precisar ter instalado o Node.Js para que depois possamos instalar as dependências necessárias pare realizar a aplicação.

Passo 7: Instalando dependências necessárias.

Inicialmente vamos começar criando uma pasta em algum lugar do seu computador, eu normalmente gosto de criar na Área de Trabalho, mas isso depende muito de cada pessoa, eu criei a pasta com o nome bot-discord.

Após criada a pasta, vamos abrir a nossa IDE (no meu caso o VS Code) e vamos abrir a pasta que criamos.

Após abrir, vamos abrir o terminal (pode ser do VS Code mesmo) e roda o comando abaixo:

$ npm init

Após rodar o comando acima, ele vai pedir algumas coisas, basta dar ENTER em todas elas e no final, terá o seguinte retorno:

{
  "name": "bot-discord",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "ISC"
}

Além desse retorno no terminal, na pasta onde criamos, dentro do VS Code, vai aparecer o arquivo package.json.

Nesse ponto já podemos começar a baixar algumas dependências que iremos precisar, a principal dela é a Discord.js, então vamos baixá-la.

$ npm install discord.js

Também vamos precisar ter o node-cron ou node-schedule para trabalharmos com cron job, no meu caso, estarei utilizando o node-schedule.

$ npm install node-schedule

Também vamos precisar instalar o fs que é uma lib para gerenciamento de arquivos do sistema, ele permite ler arquivos, renomear, criar, atualizar e excluir, mas não irei me aprofundar muito nesse assunto, vamos ao que interessa.

$ npm install fs

Passo 8: Criando arquivos e montando estrutura do projeto.

Vamos começar criando um arquivo bot.js (ou pode ser index.js), vamos precisar criar também um arquivo config.json, também vamos criar uma pasta chamada Comands(ou o nome que desejar, lembrando que essa pasta eu criei com a primeira letra maiúscula) e dentro dessa pasta uma outra pasta general (tudo minúsculo e também pode ser um outro nome que desejar), ali dentro criaremos o arquivo sendMessage.js.
Fora da pasta Comands, ou seja, na raíz do projeto, criaremos uma pasta chamada handler e dentro dela o arquivo
index.js, a estrutura de arquivos, então, ficará dessa forma.

.
├── Comands
│   └── general
│       └── sendMessage.js
├── handler
│   └── index.js
├── bot.js
├── config.json
├── package.json

Passo 9: Configurando a pasta config.json.

Esse arquivo vai conter o token do seu bot, é muito importante que esse token não seja espalhado e muito menos divulgado no github quando for publicá-lo (caso suba ele no github, claro). Por isso, se pretende subir esse projeto no seu github, como eu fiz com o meu, você precisa criar um arquivo .gitignore e dentro dele informar o nome do arquivo config.json, dessa forma.

// arquivo .gitignore
config.json

Agora sim, sabendo disso, vamos montar a estrutura do arquivo.

{
  "token": "TOKEN_DO_SEU_SERVIDOR_DISCORD"
}

Para encontrar esse token, você precisa ir no Developer Portal, no menu Bot e na opção Reset Token e então copiá-lo e colar ele no lugar do "TOKEN_DO_SEU_SERVIDOR_DISCORD", dentro do arquivo config.json.

Ficará dessa forma o arquivo.

{
  "token": "123456fdsd78sd54d"
}

Passo 10: Hora de fazer acontecer!!!

Agora vamos começar a trabalhar no nosso bot e na sua funcionalidade de enviar lembretes. Primeiramente, dentro do arquivo bot.js vamos adicionar esse código.

1 const Discord = require("discord.js");
2 const config = require("./config.json")
3 const client = new Discord.Client({ 
4  intents: [
5   "Guilds", 
6   "GuildMembers", 
7   "MessageContent", 
8   "GuildMessages"
9  ] 
10 });
11
12 module.exports = client
13
14 client.on('interactionCreate', (interaction) => {
15
16  if (interaction.type === 
17  Discord.InteractionType.ApplicationCommand) {
18
19    const cmd = client.slashCommands
20    .get(interaction.commandName);
21
22    if (!cmd) return interaction.reply(`Error`);
23
24    interaction["member"] = 
25    interaction.guild.members.cache
26    .get(interaction.user.id);
27
28    cmd.run(client, interaction)
29
30  }
31 })
32
33 client.on("ready", () => {
34 console.log(`Estou online em ${client.user.username}`)
35
36  client.user.setActivity({
37    name: 'Lembrete',
38    type: Discord.ActivityType.Watching
39  })
40 })
41
42 client.slashCommands = new Discord.Collection()
43 require("./handler")(client)
44
45 client.login(config.token)

Para facilitar a explicação eu adicionei o número das linhas ao lado, então vamos lá.

Próximo passo, vamos adicionar essa função dentro da pasta handler >> index.js.

1 const fs = require("fs")
2
3 module.exports = async (client) => {
4
5  const SlashsArray = []
6
7  fs.readdir(`./Comands`, (error, folder) => {
8    folder.forEach(subfolder => {
9      fs.readdir(`./Comands/${subfolder}/`, (error, files) => {
10        files.forEach(files => {
11
12          if (!files?.endsWith('.js')) return;
13          files = require(`../Comands/${subfolder}/${files}`);
14          if (!files?.name) return;
15          client.slashCommands.set(files?.name, files);
16
17          SlashsArray.push(files)
18        });
19      });
20    });
21  });
22  client.on("ready", async () => {
23    client.guilds.cache.forEach(guild => 
24    guild.commands.set(SlashsArray))
25  });
26 };

Por fim, vamos adicionar essa função ao arquivo sendMessage.js.

1 const Discord = require("discord.js");
2 const schedule = require("node-schedule");
3 const client = require("../../bot")
4
5 const jobOne = schedule.scheduleJob("0 8 * * *", () => {
6  sendMessage("8:00", "Correr");
7 });
8
9 const jobTwo = schedule.scheduleJob("0 12 * * *", () => {
10  sendMessage("12:00", "Caminhar");
11 });
12
13 async function sendMessage(time, activity) {
14  const channelToSend = await client.channels
15    .fetch("1113553458931437720")
16    .catch(() => null);
17
18  if (channelToSend) {
19    const embed = new Discord.EmbedBuilder()
20      .setDescription(`Olá, são ${time}, hora de  
21      ${activity}`)
22      .setColor(0x2a3756);
23
24    channelToSend.send({ embeds: [embed] });
25  }
26 }

Passo 11: Como encontrar o ID do canal?

Agora explicarei como encontrar o ID que foi comentado no passo anterior.
Primeiramente, você precisará estar com o modo desenvolvedor do discord ativado.

Após ativar, é só ir no servidor que criamos no passo 1 e no canal que general, pressionar o botão direito do mouse >> copy Channel ID.