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