<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Henrique Borges on Medium]]></title>
        <description><![CDATA[Stories by Henrique Borges on Medium]]></description>
        <link>https://medium.com/@henriquelborges?source=rss-a326d5a6cd9c------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*Cvib-1Gj68quIREtCILakQ.jpeg</url>
            <title>Stories by Henrique Borges on Medium</title>
            <link>https://medium.com/@henriquelborges?source=rss-a326d5a6cd9c------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Tue, 17 Nov 2026 18:56:23 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@henriquelborges/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Como criar um bot para o Twitter com Node.js]]></title>
            <link>https://medium.com/@henriquelborges/como-criar-um-bot-para-o-twitter-com-node-js-4f44df8d5c41?source=rss-a326d5a6cd9c------2</link>
            <guid isPermaLink="false">https://medium.com/p/4f44df8d5c41</guid>
            <category><![CDATA[twitter]]></category>
            <category><![CDATA[bots]]></category>
            <category><![CDATA[nodejs]]></category>
            <category><![CDATA[heroku]]></category>
            <category><![CDATA[expressjs]]></category>
            <dc:creator><![CDATA[Henrique Borges]]></dc:creator>
            <pubDate>Tue, 02 Jan 2018 18:15:55 GMT</pubDate>
            <atom:updated>2018-01-02T22:24:44.497Z</atom:updated>
            <content:encoded><![CDATA[<p>Nesse tutorial vamos criar um bot em Node.js com Express que posta tweets com informações sobre o clima em São Paulo — SP. Também vamos subir essa aplicação no GitHub e posteriormente publicar a mesma no Heroku, para que ela não rode apenas localmente na sua máquina. Nesse artigo eu detalhei a construção de uma versão mais simples do meu próprio projeto <a href="https://twitter.com/climaoSP">@climaoSP</a>.</p><h3>Configuração inicial</h3><p>Para escrever essa aplicação eu utilizei Ubuntu com Visual Studio Code. Para agilizar o processo vamos pular o a instalação do Nodel.js, GitHub e Heroku, porém eu anexei <strong>links para te auxiliar a instalar esses programas (caso necessário) no final do artigo</strong>. Sempre que você quiser testar a aplicação utilize o comando abaixo (lembrando que <strong>para que uma modificação tenha efeito é preciso fechar a aplicação com ctrl + C e utilizar o comando novamente</strong>).</p><pre>node app.js</pre><p>Abra um terminal na pasta em que você deseja salvar seu projeto e insira os seguintes comandos.</p><pre>mdkir &lt;nome do projeto&gt;<br>touch app.js<br>touch config.env<br>mkdir config<br>cd config/<br>touch server.js<br>touch twitter.js<br>cd ..<br>npm init<br>npm install cron --save<br>npm install express --save<br>npm install yql --save<br>npm install twitter --save<br>npm install dotenv --save</pre><p>Já criamos os arquivos e módulos nescessários para a nossa aplicação.</p><h3>Editantos nossos arquivos</h3><p>Abra o arquivo server.js em qualquer editor de texto.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/fb52b8fc563fd4b17686cad90a34de03/href">https://medium.com/media/fb52b8fc563fd4b17686cad90a34de03/href</a></iframe><p>No arquivo acima nós importamos o Express, instanciamos, o anexamos à variável app e exportamos a mesma. O express é o framework que nos permitirá configurar o ambiente para a nossa aplicação.</p><p>Abra o arquivo app.js</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/c66f980c9c44e83141c8eb0dcc3f7d75/href">https://medium.com/media/c66f980c9c44e83141c8eb0dcc3f7d75/href</a></iframe><p>No arquivo acima nós importamos o app que configuramos no arquivo “server.js”, cofiguramos a porta e o host, definimos uma função que fará as consultas na API do Yahoo, iniciamos a aplicação com o “app.listen()” e configuramos uma reposta para requisições GET na rota “/”. A ideia é que toda vez que o aplicativo receba essa requisição, seja realizada uma consulta na API do Yahoo.</p><pre>buscarPrevisao(&quot;são paulo, br&quot;, function (data) {                res.json(data); //Devolve os dados em JSON    });<br>}</pre><p>A função “buscarPrevisao()” passa uma String que contém os parâmetros necessários para a query de busca (você pode verificar a documentação da Yahoo Weather API para mais detalhes na sessão de links úteis) e uma função de callback. Passamos uma função como parâmetro para que a mesma possa ser chamada dentro da função “buscarPrevisao()”. Precisamos fazer isso pois quando executamos a função “query.exec()” o retorno dela não é instantâneo e o código não espera o retorno dessa função (podemos imaginar que o bloco “Continuação de código” continuaria sendo executado), por isso essas funções são chamadas de “funções assíncronas”. Para que possamos lidar com os dados devolvidos pela API assim que eles estiverem disponíveis passamos uma outra função com os parâmetros “err” e “data” como parâmetro na função “queryExec()” e dentro dela chamamos nossa própria função de callback que passamos como parâmetro na “buscarPrevisao()”.</p><pre>query.exec(function (err, data) {    <br>  callbackFunction(data);    <br>});<br>/*Continuação do código*/</pre><p>Nesse caso estamos devolvendo os dados diretamente via JSON para quem fez a requisição. Podemos olhar a resposta desses dados dentro do <a href="https://www.getpostman.com/">Postman</a> ou do navegador através da URL “<a href="http://localhost:3000/">http://localhost:3000/</a>”.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/8f1dfbd45c4bce240e225542351e29b5/href">https://medium.com/media/8f1dfbd45c4bce240e225542351e29b5/href</a></iframe><p>Bom, já conseguimos realizar consultas na API e receber esse resultado da mesma. Vamos montar um tweet mostrando a temperatura máxima e mínima para o dia atual. Primeiramente precisamos filtrar esses dados. O resultado contém um array de objetos chamado “forecast”, o índice 0 desse array é o dia atual. Podemos passar o objeto como parâmetro para a nossa função de callback diretamente utlizando “data.query.results.channel.item.forecast[0]”.</p><pre>//Executa a query</pre><pre>query.exec(function (err, data) {</pre><pre>//Função de call back   callbackFunction(data.query.results.channel.item.forecast);</pre><pre>});</pre><p>Agora, ao realizarmos qualquer requisição com o método GET na rota “/”. Recebemos o seguinte objeto.</p><pre>{<br>    &quot;code&quot;: &quot;47&quot;,<br>    &quot;date&quot;: &quot;02 Jan 2018&quot;,<br>    &quot;day&quot;: &quot;Tue&quot;,<br>    &quot;high&quot;: &quot;26&quot;,<br>    &quot;low&quot;: &quot;19&quot;,<br>    &quot;text&quot;: &quot;Scattered Thunderstorms&quot;<br>}</pre><p>Podemos modificar nossa função de callback novamente para que ela monte uma mensagem com o objeto recebido.</p><pre>buscarPrevisao(&quot;são paulo, br&quot;, function (data) {</pre><pre>  res.json({msg: &quot;Hoje a máxima é de &quot; + data.high +</pre><pre>    &quot;ºC, e a mínima de &quot; + data.low + &quot;ºC.&quot;});</pre><pre>});</pre><p>Nossa reposta no navegador/Postman agora é um JSON com a propriedade mensagem.</p><pre>{<br>    &quot;msg&quot;: &quot;Hoje a máxima é de 26ºC, e a mínima de 19ºC.&quot;<br>}</pre><h3>Configurando o arquivo “twitter.js”</h3><p>Agora precisamos configurar o Twitter para que possamos postar nossas mensagens. Vamos editar o arquivo “twitter.js” dentro da pasta “./config”.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/de71d8a7b2c76246fc77190e8f4f831c/href">https://medium.com/media/de71d8a7b2c76246fc77190e8f4f831c/href</a></iframe><p>Importamos o módulo twitter, instanciamos um novo objeto Twitter. Esse objeto espera algumas credenciais que vamos obter mais tarde. Vamos utilizar variáveis de ambiente para manter nossa informação privada segura (vamos configurar nossas variáveis de ambiente posteriormente). Também configuramos uma propriedade para o objeto cliente e anexamos a função que realizará o post no Twitter (exemplo: cliente.tweet(“Novo tweet!”) e exportamos a variável “cliente”.</p><h3>Conseguindo as credenciais de acesso no Twitter</h3><p>Visite a página do <a href="https://apps.twitter.com/">apps twitter</a> e clique em “Create New App” para criar um app para o Twitter. Clique na aba “Keys and Access Tokens”, lá você pode anotar as suas chaves “Consumer Key (API Key)” e “Consumer Secret (API Secret)” e gerar seus tokens de acesso, “Access Token” e “Access Token Secret”.</p><h3>Reescrevendo o “app.js”</h3><p>Vamos incluir o arquivo “twitter.js” que modificamos anteriormente no arquivo “app.js”.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/0682e29a9b670b4dbe761f6bcfe2e732/href">https://medium.com/media/0682e29a9b670b4dbe761f6bcfe2e732/href</a></iframe><p>Agora nossa aplicação recebe uma requisição, consulta a API e é capaz de postar a mensagem que montamos no twitter, quando realizamos uma requisitação. Porém, para que seja possível realizar a autenticação, precisamos configurar as váriaveis de ambiente da nossa aplicação. Essas variáveis serão configuradas no arquivo “config.env”.</p><pre>consumer_key=XXXXXXXXXXXXXXXXXXX<br>consumer_secret=XXXXXXXXXXXXXXXXXX<br>access_token_key=XXXXXXXXXXXXXXX<br>access_token_secret=XXXXXXXXXXXXXXXXXXXX</pre><p>Substitua os valores colando as chaves da sua aplicação obtidos anteriormente (não utilize aspas!).</p><h3>Rodando a nossa aplicação</h3><p>Agora que já possuímos o arquivo que contém as nossas váriaveis de ambiente. Cole o seguinte comando no terminal “node -r dotenv/config app.js dotenv_config_path=” junto com o caminho do arquivo “config.env” no seu computador. Agora a nossa aplicação iniciou carregando o módulo “doenv” que instalamos anteriormente, e passando o caminho do arquivo “config.env” que contém os valores para as nossas variáveis de ambiente. Ao realizar uma nova requisição, um post no twitter com a nossa mensagem deve ser realizado também.</p><h3>Agendando ações dentro da nossa aplicação</h3><p>Até o momento nossa aplicação só executa tarefas quando a mesma recebe uma requisição GET em “/”. Para que o nosso bot se torne independente podemos agendar execuções de consultas e posts no Twitter através do módulo “node-cron”. Vamos reescrever o arquivo “app.js” uma última vez.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/d2cb8faf2a11d0672dc41192620972ca/href">https://medium.com/media/d2cb8faf2a11d0672dc41192620972ca/href</a></iframe><p>Nossa aplicação agora não recebe mais nenhuma requisição. Instanciamos um novo objeto CronJob que recebe 4 parâmetros, o primeiro parâmetro é uma String contendo as instruções de execução (você pode conferir a syntaxe aceita pelo módulo na documentação em links úteis), a função que vai ser executada quando o job ativar, a função que será executada quando o job finalizar, parâmetro booleano para criar um job já ativo, e o fuso horário do mesmo (você pode verificar os fuso horários disponíveis e syntaxe correta deles <a href="http://momentjs.com/timezone/">aqui</a>). Com isso nossa aplicação já está realizando consultas e posts no Twitter automaticamente, porém estamos rodando ela localmente.</p><h3>Colocando nosso projeto no GitHub</h3><p>Certifique-se de que você possui <a href="https://github.com/">Github</a> instalado no seu computador. Crie um novo repositório e copie o link do mesmo. No terminal, na pasta do seu projeto insira o seguintes comandos:</p><pre>git init<br>git remote add origin &lt;link do seu repositóio&gt;<br>touch .gitignore</pre><p>O arquivo “.gitignore” deve conter os arquivos que não serão incluídos no nosso repositório no GitHub. É importante configurar esse arquivo pois não queremos que o “config.env” que contém as credenciais do nosso app no Twitter estejam disponíveis em um repositório aberto online.</p><pre>/node_modules<br>config.env</pre><p>Vamos ignorar nosso arquivo “config.env” e a pasta “/node_modules” (essa pasta contém os módulos que anexamos ao nosso projeto, todos os módulos necessários para a execução da nossa aplicação estão salvos no arquivo “package.json”). Salve o arquivo “.gitignore”. No terminal insira os seguintes comandospara subir sua aplicação no GitHub:</p><pre>git add --all<br>git commit -m &quot;changes&quot;<br>git push origin master</pre><h3>Publicando nossa aplicação no Heroku</h3><p><a href="https://www.heroku.com/">Heroku</a> é uma plataforma como serviço com suporte à diversas linguagens que possui planos gratuitos e pagos. Caso você não tenha o Heroku instalado na sua máquina você pode seguir as instruções <a href="https://devcenter.heroku.com/articles/heroku-cli#download-and-install">aqui</a>. Precisamos modificar nosso arquivo “package.json” na pasta raiz do projeto. Modifique a chave scripts de acordo com o trecho abaixo, assim o Heroku identificará como executar nossa aplicação.</p><pre>&quot;scripts&quot;: {</pre><pre>   &quot;start&quot;: &quot;node app.js&quot;<br>},</pre><p>Execute os seguintes comandos (caso você não tenha uma conta no heroku crie uma):</p><pre>heroku login<br>heroku create<br>git push heroku master<br>heroku logs -t</pre><p>Pronto, nossa aplicação foi criada e já está online. Porém ainda precisamos configurar nossas variáveis de ambiente no <a href="https://dashboard.heroku.com/">dashboard do heroku</a>. Selecione sua aplicação, clique na aba “Settings”, existe uma sessão chamada “Reveal Variables” clique no botão “Reveal Config Vars” e adicione a chave e o valor da mesma forma que o arquivo “config.env” clicando posteriormente no botão “add”, dessa forma suas variáveis de ambiente serão setadas. Reinicie a aplicação inserindo o comando abaixo no terminal.</p><pre>heroku restart -a &lt;nome da aplicação&gt;</pre><h3>Mantendo a aplicação “acordada”</h3><p>No plano gratuito o Heroku coloca a nossa aplicação em descanso depois de uma hora de inatividade. Para prevenir que sua aplicação entre em descanso utilize o <a href="http://kaffeine.herokuapp.com/">Kaffeine</a> (que irônicamente é uma aplicação Heroku) ela realizará uma requisição GET a cada 30 minutos para manter a sua aplicação acordada. Usando o comando “heroku logs -t” é possível verificar as requisições do Keffeine para a nossa aplicação.</p><h3>Conclusão</h3><p>Ao realizar todos esses passos você terá uma aplicação online capaz de realizar consultas na Yahoo Weather API e posts no Twitter de forma agendada. Utilize a sua criatividade para tornar o seu bot mais robusto e interativo, explorando Yahoo Weather API e a API do Twitter.</p><h3>Links úteis</h3><ul><li><a href="http://nodebr.com/instalando-node-js-atraves-do-gerenciador-de-pacotes/">Instalando o Node.js</a></li><li><a href="https://www.getpostman.com/">Instalando o Postman</a></li><li><a href="https://git-scm.com/book/pt-br/v1/Primeiros-passos-Instalando-Git">Instalando o GitHub</a></li><li><a href="https://devcenter.heroku.com/articles/heroku-cli#download-and-install">Instalando o Heroku</a></li><li><a href="https://github.com/expressjs/express">Express.js</a></li><li><a href="https://www.devpleno.com/dotenv-e-variaveis-de-ambiente/">Váriaveis de ambiente</a></li><li><a href="http://kaffeine.herokuapp.com/">Kaffeine</a></li><li><a href="http://momentjs.com/timezone/">Syntaxe de Fuso horários para o CronJob</a></li><li><a href="https://github.com/HenriqueLBorges/weather-twitter">Repositório do meu projeto no GitHub</a></li><li>Documentação — <a href="https://developer.yahoo.com/weather/">Yahoo Weather API</a></li><li>Documentação — <a href="https://github.com/motdotla/dotenv">dotenv</a></li><li>Documentação — <a href="https://github.com/desmondmorris/node-twitter">Twitter</a></li><li>Documentação — <a href="https://github.com/kelektiv/node-cron">Node-cron</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4f44df8d5c41" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>