{"id":2982,"date":"2020-09-23T19:09:00","date_gmt":"2020-09-23T22:09:00","guid":{"rendered":"https:\/\/www.ufsm.br\/pet\/sistemas-de-informacao\/?p=2982"},"modified":"2025-09-02T14:09:49","modified_gmt":"2025-09-02T17:09:49","slug":"bots-para-iniciantes","status":"publish","type":"post","link":"https:\/\/www.ufsm.br\/pet\/sistemas-de-informacao\/2020\/09\/23\/bots-para-iniciantes","title":{"rendered":"Bots para iniciantes"},"content":{"rendered":"\n

Fala pessoal, no PET Reda\u00e7\u00e3o desta semana iremos entender mais sobre o que s\u00e3o Bots e como s\u00e3o feitos. Vamos desenvolver um exemplo utilizando um dos aplicativos de voz mais famosos atualmente: o Discord. Mas primeiro vamos entender um pouco da teoria.<\/span><\/p>\n

O que s\u00e3o Bots?<\/strong><\/p>\n

Basicamente, Bots \u2212 abrevia\u00e7\u00e3o de robots \u2212 s\u00e3o programas desenvolvidos para realizar alguma tarefa de maneira padronizada e repetitiva. Essa tarefa pode ser\u00a0 feita de forma autom\u00e1tica ou com base em algum comando gatilho feito por um humano ou outro programa.\u00a0<\/span><\/p>\n

Para que eles s\u00e3o utilizados?<\/strong><\/p>\n

Os bots est\u00e3o por toda internet exercendo tanto tarefas simples quanto algumas extremamente\u00a0 complexas. Grandes empresas usufruem dos bots para automatizar tarefas ou como servi\u00e7o atendimento (os chamados chatbots). O Google, por exemplo, utiliza Bots para rastrear e classificar as p\u00e1ginas na internet, melhorando assim a pesquisa dentro da web. Al\u00e9m disso, programadores comuns tamb\u00e9m recorrem a essa tecnologia para automatizar tarefas, como no Discord que existem bots que servem para pesquisar m\u00fasicas ou gerenciar o servidor, baseando-se em comandos.\u00a0<\/span><\/p>\n

Como s\u00e3o feitos?<\/strong><\/p>\n

A programa\u00e7\u00e3o de um bot n\u00e3o tem uma linguagem espec\u00edfica, mas muitas linguagens possuem mais conte\u00fado sobre o assunto que outras.<\/span><\/p>\n

Olhando bots prontos e funcionando imagina-se ser um trabalho extremamente complexo para um programador, mas n\u00e3o \u00e9 bem assim. \u00c9 claro que existem bots com uma complexidade inimagin\u00e1vel, utilizando at\u00e9 mesmo machine learning que interagem com o meio, aprendem e tentam reagir da melhor maneira poss\u00edvel, por\u00e9m os bots que vemos diariamente, como no Discord e Twitter, operam com o aux\u00edlio de bibliotecas e APIs.\u00a0<\/span><\/p>\n

Implementa\u00e7\u00e3o<\/strong><\/p>\n

Depois de um pouco de teoria, agora partiremos para a implementa\u00e7\u00e3o. Para essa reda\u00e7\u00e3o desenvolveremos, como exemplo, um bot para o Discord utilizando o conhecido NodeJS. Para a implementa\u00e7\u00e3o usaremos a <\/span>IDE Visual Studio Code<\/span><\/a>, ela facilita o desenvolvimento por ter um terminal\/cmd integrado. Al\u00e9m disso, iremos instalar o <\/span>NodeJS<\/span><\/a>, que pode ser instalado tanto para Windows quanto para Linux (baixe a vers\u00e3o LTS). Ap\u00f3s realizar os downloads e instala\u00e7\u00f5es, vamos criar uma pasta em qualquer diret\u00f3rio do seu computador (\u00c1rea de trabalho ou alguma pasta de projetos caso voc\u00ea possua). Agora podemos abrir o VS Code e abrir a pasta criada a partir dele. Siga o caminho abaixo e procure a sua pasta criada:\u00a0<\/span><\/p>\n

\u00a0<\/p>\n

File \u2192 Open Folder<\/span><\/i><\/p>\n

Agora iremos abrir o terminal do VS Code. Siga o caminho novamente:<\/span><\/p>\n

Terminal \u2192 New Terminal<\/span><\/i><\/p>\n

Seguindo essas instru\u00e7\u00f5es teremos o terminal aberto na nossa pasta selecionada, ficando dessa forma no meu caso:\u00a0<\/span><\/p>\n

\"\"<\/p>\n

Para iniciarmos nosso projeto devemos utilizar o gerenciador de pacotes do NodeJS: o npm. Ele que ir\u00e1 lidar com todas as depend\u00eancias do nosso projeto (caso queira saber mais sobre npm, clique aqui). Dessa forma, podemos rodar o seguinte comando:<\/span><\/p>\n

\"\"<\/p>\n

Ao executar o comando vai ser criado um arquivo chamado <\/span>package.json<\/span><\/i>, que \u00e9 um arquivo de configura\u00e7\u00e3o que guarda algumas informa\u00e7\u00f5es e quais as depend\u00eancias necess\u00e1rias para a execu\u00e7\u00e3o do programa.<\/span><\/p>\n

Nossa \u00fanica depend\u00eancia vai ser a biblioteca <\/span>Discord.js<\/span><\/i>, que dar\u00e1 recursos para conseguirmos interagir com a API do Discord. Para instalar usaremos o npm novamente:<\/span><\/p>\n

\"\"<\/p>\n

Vamos ent\u00e3o criar o arquivo que iremos escrever c\u00f3digo em breve. Seguindo este comando podemos criar o arquivo rapidamente:<\/span><\/p>\n

\"\"<\/p>\n

Antes de iniciar o desenvolvimento precisamos configurar algumas coisas no Discord. Primeiramente, caso voc\u00ea n\u00e3o tenha uma conta no Discord, clique aqui. Ap\u00f3s isso, criaremos um servidor onde o bot ir\u00e1 ficar, como na imagem a seguir:<\/span><\/p>\n

\"\"<\/p>\n

Agora basta selecionar a op\u00e7\u00e3o <\/span>Create My Own<\/span><\/i> e nome\u00e1-lo. Feito isso, agora vamos criar uma aplica\u00e7\u00e3o no discord e depois defini-la como um bot. Para isso, precisamos acessar a \u00e1rea de desenvolvimento do Discord, <\/span>clique aqui<\/span><\/a>. Clicando no link abrir\u00e1 a p\u00e1gina onde iremos criar e configurar nosso bot, para depois program\u00e1-lo. Basta clicar em <\/span>New Application<\/span><\/i> e nome\u00e1-la, no meu caso: Meu Bot. Por\u00e9m, nossa aplica\u00e7\u00e3o ainda n\u00e3o \u00e9 um bot. Para resolvermos isso, podemos acessar a parte chamada <\/span>Bot<\/span><\/i>, como na imagem a seguir:<\/span><\/p>\n

\"\"<\/p>\n

Clicando em <\/span>Add Bot<\/span><\/i> e confirmando, vai aparecer uma p\u00e1gina com as informa\u00e7\u00f5es do nosso Bot. Uma das mais importantes \u00e9 o Token, logo abaixo do Username, pois ele \u00e9 como uma senha para acessar o Bot e precisaremos dele futuramente. Mas agora vamos rolar um pouco para baixo e selecionar as permiss\u00f5es do nosso Bot. Como isso \u00e9 um teste daremos permiss\u00e3o de administrador. Dessa forma:\u00a0<\/span>\u00a0<\/span><\/p>\n

\"\"<\/p>\n

Depois de configurarmos nosso Bot podemos prosseguir adicionando ele ao servidor. Para isso, devemos acessar o General Information, no lado esquerdo da tela. Chegando l\u00e1, copie o <\/span>Client ID<\/span><\/i>, logo abaixo no <\/span>Name, <\/span><\/i>e acesse o seguinte <\/span>link<\/span><\/a>. Feito isso, defina a permiss\u00e3o de administrador novamente e cole o <\/span>Client ID<\/span><\/i> no local adequado. Por \u00faltimo, logo abaixo ter\u00e1 um link que foi gerado com base no seu <\/span>ID<\/span><\/i>. Clicando nele, seremos redirecionados para uma p\u00e1gina onde podemos escolher o servidor de prefer\u00eancia para o Bot. Olhando o servidor criado podemos visualizar nosso Bot, por\u00e9m ele est\u00e1 offline por enquanto.\u00a0<\/span><\/p>\n

Finalmente iremos programar nosso Bot. Para come\u00e7ar, no arquivo <\/span>bot.js<\/span><\/i>, iremos criar uma constante para ter acesso aos recursos que a biblioteca discord.js fornece e outra para instanciar o Bot. Desse jeito:<\/span><\/p>\n

\"\"<\/p>\n

Feito isso, o bot ainda estar\u00e1 offline, por isso, antes de executarmos nosso programa pela primeira vez, iremos adicionar apenas mais duas linhas de c\u00f3digo. Lembra quando foi falado que o Token seria importante para o desenvolvimento? Ent\u00e3o, agora iremos precisar dele para fazer o login do Bot e deix\u00e1-lo online. Acesse aquela mesma parte e copie o Token do Bot. Bem como a imagem abaixo:\u00a0<\/span><\/p>\n

\"\"<\/p>\n

Copiado o Token, continuaremos o desenvolvimento criando uma constante para armazenar o Token e usaremos a fun\u00e7\u00e3o <\/span>login()<\/span><\/i>, a partir da constante bot criada anteriormente. Dessa forma:<\/span><\/p>\n

\"\"<\/p>\n

Ap\u00f3s isso, voltaremos para os comandos e executaremos o seguinte:<\/span><\/p>\n

\"\"<\/p>\n

Executando esse comando estamos rodando nosso Bot pela primeira vez e ele estar\u00e1 online no servidor criado. Mas agora vamos fazer algumas automatiza\u00e7\u00f5es nesse Bot. Para come\u00e7ar, criaremos uma fun\u00e7\u00e3o que de boas-vindas sempre que tivermos novos membros no servidor. Como na imagem a seguir:<\/span><\/p>\n

\"\"<\/p>\n

Basicamente, ele cria um evento toda vez que um novo membro \u00e9 adicionado ao servidor e executa a chamada Arrow Function em caso positivo. Essa fun\u00e7\u00e3o possui uma constante chamada <\/span>channel<\/span><\/i>, que procura o canal de texto para escrever a mensagem de boas-vindas (nesse caso o nome do canal de texto \u00e9 o padr\u00e3o de todos servidores: geral). Caso ela n\u00e3o ache o canal de texto, a fun\u00e7\u00e3o retorna sem nenhuma execu\u00e7\u00e3o, por\u00e9m, em caso afirmativo, \u00e9 executado a fun\u00e7\u00e3o <\/span>send()<\/span><\/i>, a partir da constante <\/span>channel<\/span><\/i>, para enviar uma mensagem de recep\u00e7\u00e3o, seguido do nome de usu\u00e1rio do novo membro. Executando novamente o programa e adicionando um novo membro ao servidor temos este resultado:<\/span><\/p>\n

\"\"<\/p>\n

Por \u00faltimo, vamos desenvolver algumas fun\u00e7\u00f5es que s\u00e3o chamadas de acordo com alguns comandos pr\u00e9 definidos. podemos fazer dessa forma:\u00a0<\/span><\/p>\n

\"\"<\/p>\n

Muito parecido com a fun\u00e7\u00e3o passada, por\u00e9m com o par\u00e2metro <\/span>message <\/span><\/i>sendo passado, esse evento analisa se as mensagens enviadas no canal de texto s\u00e3o aquelas dentro do <\/span>if <\/span><\/i>(!logo e !redacoes), utilizando o <\/span>content<\/span><\/i>, pois trata-se do conte\u00fado da mensagem. Caso seja escrito !logo, define-se uma constante attachment (como um acess\u00f3rio da mensagem, podendo ser uma imagem, um v\u00eddeo, etc), que recebe um link de uma imagem e \u00e9 enviado uma mensagem, seguido da imagem definida anteriormente. Mas caso for escrito !redacoes ser\u00e1 retornado um link para o site do PET Reda\u00e7\u00e3o. Salvando e executando novamente nosso Bot encontramos o seguinte resultado:<\/span><\/p>\n

\"\"<\/p>\n

Com isso, agora voc\u00ea entende um pouco mais sobre o funcionamento de um Bot e como eles s\u00e3o desenvolvidos. Caso tenha alguma d\u00favida ou queira um minicurso sobre o assunto futuramente, entre em contato com os petianos. O c\u00f3digo desenvolvido nesta reda\u00e7\u00e3o est\u00e1 neste <\/span>reposit\u00f3rio<\/span><\/a>.\u00a0<\/span><\/p>\n

Obrigado por acompanhar mais uma edi\u00e7\u00e3o do PET Reda\u00e7\u00e3o!<\/span><\/p>\n

\u00a0<\/p>\n

Refer\u00eancias:<\/strong><\/p>\n