🤖 Bot de Notificação via Telegram¶

Script que verifica as notas do semestre atual e envia um resumo para um chat do Telegram.

Pré-requisitos¶

pip install requests

Você também precisa de um bot do Telegram e do seu chat_id. Consulte a documentação oficial do BotFather para criar o bot e obter o token.

Código¶

import os
import requests
from suap_api import SuapClient

TELEGRAM_TOKEN = os.environ["TELEGRAM_TOKEN"]
TELEGRAM_CHAT_ID = os.environ["TELEGRAM_CHAT_ID"]


def enviar_mensagem(texto: str) -> None:
    url = f"https://api.telegram.org/bot{TELEGRAM_TOKEN}/sendMessage"
    requests.post(url, json={"chat_id": TELEGRAM_CHAT_ID, "text": texto, "parse_mode": "Markdown"})


with SuapClient() as client:
    periodos = client.edu.get_periods()
    semestre = periodos[0].semestre
    disciplinas = client.edu.get_disciplines(semestre)

    linhas = [f"📋 *Notas — {semestre}*\n"]

    for d in disciplinas:
        linhas.append(f"📘 *{d.disciplina}*")
        linhas.append(f"   Etapa 1: `{d.nota_etapa_1}` | Etapa 2: `{d.nota_etapa_2}` | Situação: `{d.situacao}`")

    enviar_mensagem("\n".join(linhas))
    print("Mensagem enviada!")

Variáveis de ambiente¶

Variável	Descrição
`TELEGRAM_TOKEN`	Token do bot obtido no BotFather
`TELEGRAM_CHAT_ID`	ID do chat para receber as mensagens

Automatizar

Adicione este script a um cron ou serviço agendado para receber notificações automáticas no início de cada semana.