Ben do Diário Oficial da União 🤖 📄

O bot Ben do Diário Oficial da União ou Ben do DOU, como ele se autodenominou, é um projeto final da aula de Algoritmos de Automação do Master em Jornalismo de Dados, Automação e Data Storytelling do Insper. O objetivo do robô é informar, diariamente, quais são os destaques do DOU, disponíveis neste link.

Os códigos aqui apresentados executam 3 funcionalidades exigidas no trabalho final: recebimento e envio de mensagens pela API de robôs do Telegram usando a biblioteca requests e o método webhook (site com Flask), leitura e escrita de dados em planilhas do Google Sheets usando a biblioteca gspread e criação de site dinâmicos em Python usando Flask

Para conhecer o Ben, acesse a sua página oficial no Telegram ou busque por @BenDOU_bot.

Composição

Para utilizar esse robô, você irá precisar de alguns processos:

• BotFather: é uma ferramenta do Telegram para criação de bot. Para dar continuidade, é só acessar o site e seguir as orientações. Quando o robô for criado, o Telegram irá te enviar um token. É necessário salvar esse código, pois é com ele que você irá acessar a API do Telegram para enviar os comandos para o seu bot | Acesso
• Google Sheets: Para usar o sheets, é necessário pedir acesso ao Google, que pode ser feito neste link. O resultado final será dois conteúdos: um e-mail genérico do Google, que será usado para você compartilhar a planilha do sheets com ele, e uma chave de acesso, enviada por meio de um arquivo .json. Dica: além de ativar o Google Sheets, você deve ativar também o Google Drive
• Render: é uma plataforma de nuvem, em que podemos usar para rodar o código e automatizar seu funcionamento. No Ben, essa foi a ferramenta utilizada, mas você pode escolher a de sua preferência

Arquivos

• app.py: contém aplicação do robo no Telegram junto com os sites criado no Flask para automatização
• data_hora.py: contém duas funções. a primeira é a que coleta o dia e formata do jeito que é solicitado para raspar o DOU; e a segunda calcula a hora
• raspador.py: contém o raspador do site do DOU oficial e formatação da mensagem a ser enviada
• requirements.txt: é um arquivo de texto que possui todas as bibliotecas que precisam ser instaladas para rodar o código dentro da nuvem

setWebhook

É um método disponível na API do Telegram que permite a configuração de uma URL para receber atualizações do bot de forma assíncrona, em vez de usar o método getUpdates que faz com que o bot precise verificar periodicamente se há atualizações. Quando você configura um webhook, o Telegram enviará uma solicitação HTTP POST para a URL que você especificou sempre que houver uma atualização para o seu bot.

Para fazer essa configuração, você precisa rodar o seguinte código:

import getpass            
import requests

token = getpass.getpass()

dados = {"url": "https://seu-site-do-render.onrender.com"}  # colocar aqui o site do Web Service criado no Render
resposta = requests.post(f"https://api.telegram.org/bot{token}/setWebhook", data = dados)
print(resposta.text)

A biblioteca getpass é uma biblioteca que permite com que você use dados pessoais em um código. Ao rodar, irá aparecer um espaço, onde você irá adicionar o token do seu robô no Telegram.

Contato

Em caso de dúvidas, a API do Telegram documenta de forma acessível os passo a passo para você desenvolver as suas ideias. Para outras dúvidas e sugestões, envie um e-mail para [email protected] ;)

Agradecimentos

Gostaria de agradecer os professores Guilherme Felitti e Álvaro Justen que ministraram as aulas de Pensamento Computacional e Automação de Algoritmos no Master em Jornalismo de Dados, Automação e Data Storytelling do Insper.