Skip to content
Mirza Fathir
2026Solo Developer

Grade Notification Bot

A serverless bot that checks ITS's academic portal every 8 hours and pings Telegram the moment a new grade is published.

infoNilai
01 — Problem

What I set out to solve

  • Grades at ITS appear on the academic portal without any notification, so students end up refreshing it for weeks. Automating the check is harder than it sounds: sign-in goes through Microsoft SSO with 2FA, and the grade pages only render properly in a real browser.
02 — Approach

How I built it

  • Drove headless Chromium with Playwright to open the per-semester grades page and parse every course and grade.
  • Handled SSO and 2FA without ever storing a password: sign in by hand once, export the authenticated session, and keep it as an encrypted GitHub Actions secret.
  • Ran it serverlessly on a GitHub Actions schedule every 8 hours, keeping the last snapshot in the Actions cache — never in the repo — and diffing each run against it.
  • Sent Telegram alerts only when a grade appears or changes, plus a weekly heartbeat and a 'session expired' alert, so the bot can't fail silently.
03 — Outcome

What it achieved

  • Zero-cost, zero-server automation — new grades reach my phone within hours, with no manual checking.
  • No credentials or personal data in the repository; secrets and state live in GitHub's encrypted secrets and cache.
  • Built-in observability: change-only alerts, a heartbeat, and session-expiry detection.
Stack

Built with

  • Python
  • Playwright
  • GitHub Actions
  • Telegram Bot API
  • SMTP
Keep exploring

More projects