Tutor Commands

Complete reference for all Telegram bot commands available to educators. All commands require a linked Telegram account.

/sessions

Shows all sessions scheduled for today, including:

Session time range (e.g., 09:00-10:00)
Student name
Address with Google Maps link
Check-in/out status indicators
Current appointment status

Inline action buttons appear at the bottom:

Check In -- appears for the next unchecked session (if within the 30-min window)
Check Out -- appears if a session is currently active (checked in but not out)
Change -- appears for each Scheduled session that hasn't started, opening the cancel/reschedule menu

/upcoming

Displays all scheduled sessions for the next 7 days, grouped by date. Useful for weekly planning and identifying conflicts early.

/checkin

Checks into the next unchecked session today.

Time Window Rule

Check-in opens 30 minutes before the scheduled start time. If invoked too early, the bot responds with the exact minutes remaining until the window opens.

The command automatically finds the next eligible session (status Scheduled, not yet checked in) ordered by start time. You can also check in via the inline button on /sessions, which specifies the exact appointment ID.

/checkout

Checks out of the currently active session (checked in but not yet out).

Time Window Rule

Check-out opens 30 minutes after the scheduled start time and closes 24 hours after the end time. Outside this window, the bot rejects the request with a message.

On checkout:

1 The checked_out_at timestamp is recorded.
2 Status transitions to Awaiting_Approval_Parent.
3 The tutor is prompted to submit session notes.

/todos

Shows the tutor's pending to-do items for today:

Sessions to attend (not yet checked in)
Active sessions (checked in, need checkout)
Session notes pending upload (checked out but no notes submitted)

/mystudents

Lists all active matches where the status is Admin_Approved or Parent_Accepted. Each entry shows:

Child name
Subject
Area/location

/postings

Browse open postings available for application. Shows posting details including subject, schedule, location, and special requirements. Tutors can apply directly via inline buttons.

/notes

Submit session notes for a recently completed session. The bot accepts multiple formats:

Input Type	How to Send	Storage
Text	Reply to the note prompt with text	Stored as `tutor_notes` on the appointment
Photo	Send a photo in the chat	Downloaded from Telegram, uploaded to R2
Document	Send a PDF/file in the chat	Downloaded from Telegram, uploaded to R2 (max 10MB)
Voice	Send a voice message	Downloaded from Telegram, uploaded to R2

Files are stored in R2 under the key pattern telegram-notes/{timestamp}-{filename}.

/mypay

Shows the current month's billing summary:

Total sessions this month (approved + awaiting approval)
Total hours worked
Sessions still pending parent approval

For full payout details including rates and amounts, use the NIVAA web platform.

/help

Displays the full list of available commands for the educator role.