Coordinator Commands

Admin-only commands for platform coordinators. These provide system-wide visibility and operational tools directly in Telegram.

/dashboard

Quick system overview showing platform-wide metrics:

  • Total students (active child profiles)
  • Total educators
  • Today's session count
  • Open postings
  • Open support tickets
  • Disputed sessions

/sessions

Shows all sessions across all tutors for today (limited to 20). Each entry displays the time, tutor name, student name, and check-in status. This gives coordinators a birds-eye view of the day's activity.

/alerts

Lists open support tickets (status Open or In_Progress), showing category, subject, and status for each. Limited to the 10 most recent.

/pending

All sessions currently in Awaiting_Approval_Parent status. Useful for following up with parents who haven't approved completed sessions.

/postingsqueue

Summary of the posting pipeline: number of open postings, applications awaiting review, and pushed matches awaiting parent response.

/student <query>

Quick student lookup. Accepts a name (fuzzy matched) or numeric ID (exact match). Returns:

  • Child profile (name, age, subjects)
  • Parent information
  • Active tutor matches
  • Recent session history

/tutor <query>

Quick tutor lookup. Accepts a name or numeric ID. Returns tutor profile, active matches, and session statistics.

/lowpackages

Lists all parents whose session package balance is below 20%. Each entry shows the parent name, remaining sessions, and total package size. Useful for proactive outreach about package renewal.

/newapps

Shows the most recent posting applications that haven't been reviewed by a coordinator yet. Helps ensure no applications fall through the cracks.

Impersonation

Admin-only feature

Impersonation lets coordinators see the bot exactly as a specific tutor would see it. This is invaluable for debugging, training, and verifying that tutors see the correct data.

/impersonate

Without arguments, shows a list of all tutors with inline selection buttons (up to 30, ordered alphabetically). Each button shows the tutor's name, ID, and active match count.

With an ID argument (/impersonate 42), immediately sets impersonation to that tutor.

While impersonating, the following commands show the tutor's data instead of the coordinator's:

  • /sessions -- that tutor's sessions today
  • /upcoming -- that tutor's upcoming sessions
  • /todos -- that tutor's to-do list
  • /checkin / /checkout -- operates on that tutor's sessions

A mask icon indicator appears in the output when impersonation is active.

/stopimpersonate

Clears the impersonating_tutor_id field in telegram_links and returns the coordinator to their normal view. If not currently impersonating, responds with an informational message.

Notifications Received

Coordinators automatically receive notifications (they don't need to request them) for:

  • Session cancellations: When a tutor cancels a session via Telegram, all linked coordinators receive a notification with the tutor name, student name, date/time, and parent acknowledgement status.
  • Reschedule requests: When a tutor requests a reschedule, coordinators receive the details and are asked to set the new date via the platform.