Wilma

A connected Wilma account - the school-communication system most Finnish comprehensive and upper-secondary schools use - reporting your children's timetable, homework, exams and attendance, plus your Wilma inbox, as read-only sensors. Logged in with the same Wilma address, username and password you already use in a browser.

Connecting

Devices & Services > Wilma > "+ Add account" asks for your school's Wilma base URL (for example https://yourcity.inschool.fi), your username and your password. There's no public API and no app credentials to create - Athena signs in exactly the way the Wilma web page does, keeps the session cookie, and re-authenticates automatically when it expires. One account covers every child (guardian "role") that login can see.

Entities

Account-level, three sensors: messages_total, unread_messages and latest_message (subject of the newest message).

Then, per child, prefixed with that child's Wilma slug: lessons_today (count), next_lesson, homework (open assignments), next_exam, absences, tardies, praise and grades (most recent). A background loop refreshes every 15 minutes. Everything is read-only, so Wilma appears only as a state source in Automations and on Dashboard cards / History, never as an Action target.

Wilma exposes clean JSON for messages and the timetable; attendance, praise and grades are read by parsing the same HTML pages you would see in a browser, because Wilma offers no JSON for them. If your school runs an unusual Wilma version or theme, those scraped sensors may come back empty even when the message and lesson sensors work - that's a limitation of what Wilma publishes, not a login problem.