Google Assistant¶

Use Google Assistant to capture student notes, log activities, set reminders, run workflows, and give general voice commands to Mossie -- all hands-free from any Google-enabled device.

Getting Started¶

Link Your Account¶

Open the Google Home app on your phone
Tap your profile icon, then Assistant settings
Scroll to Services and tap Works with Google
Search for "Mossie"
Tap Link and sign in with your Mossie credentials

Account linking uses OAuth. Your credentials are stored securely by Google.

Your First Command¶

Once linked, try:

"Hey Google, talk to Mossie"

Google Assistant responds with a welcome message and explains what you can do.

Voice Commands¶

Capture a Note¶

Save a general note to your Mossie workspace.

Say this

"Hey Google, tell Mossie to capture a note"
"Hey Google, ask Mossie to take a note about curriculum planning"
"Hey Google, tell Mossie note that we need more supplies"

Google Assistant asks "What would you like to capture?" if no content is provided.

Student Notes¶

Capture observations about specific students. Mossie uses entity extraction to match student names against your roster.

Say this

"Hey Google, tell Mossie about Sarah's reading progress"
"Hey Google, tell Mossie note about Jake that he helped a classmate"
"Hey Google, ask Mossie to note that Emma finished her project early"

Google Assistant asks follow-up questions if needed:

"Which student is this note about?"
"What would you like to note about this student?"

If the student name matches someone in your roster, Mossie creates a performance note linked to that student. If no match is found, the note is saved as a quick capture for you to review in the app.

Activity Log¶

Log what happened in class today.

Say this

"Hey Google, tell Mossie to log class activity"
"Hey Google, tell Mossie we did multiplication tables today"
"Hey Google, ask Mossie to log that we went on a field trip"

Smart Reminders¶

Set context-aware reminders. When you mention a student's name, Mossie automatically links the reminder to that student.

Say this

"Hey Google, tell Mossie to remind me about parent conferences"
"Hey Google, ask Mossie to follow up on Jake's homework"
"Hey Google, tell Mossie remind me to check on Emma's reading progress"

Reminders default to tomorrow morning. If a student name is detected, the reminder is linked to that student so you see relevant context when the reminder fires.

Quick Notes¶

Short, general notes without a specific category.

Say this

"Hey Google, tell Mossie quick note library books due Friday"
"Hey Google, tell Mossie jot down assembly next Tuesday"

Run a Workflow¶

Trigger one of your custom Mossie workflows by name.

Say this

"Hey Google, tell Mossie to run my Friday newsletter"
"Hey Google, ask Mossie to run the weekly report workflow"

The command is sent to the voice execute endpoint, which matches it to your workflows. If the workflow is found, it is queued and runs in the background. Results appear in the Mossie app.

If the workflow name is not recognized, Google Assistant tells you it could not find a matching workflow.

Voice Command (General)¶

For anything that does not fit a specific category, you can give a general command. Mossie's AI classifies the intent and acts accordingly.

Say this

"Hey Google, ask Mossie to create a lesson plan on fractions"
"Hey Google, tell Mossie to draft feedback for Sarah"
"Hey Google, ask Mossie to build an assessment on vocabulary"

The voice execute endpoint classifies the command into one of:

Capture -- Saved as a note
Execute Workflow -- Triggers a named workflow
Execute Assistant -- Triggers a custom assistant
Execute Built-in -- Prepares a built-in tool (lesson plan, assessment, or feedback) and tells you to open the Mossie app to finish
Query -- Looks up information in your knowledge base

How It Works¶

sequenceDiagram
    participant U as You
    participant G as Google Assistant
    participant F as Cloud Function
    participant M as Mossie API

    U->>G: "Tell Mossie about Sarah's progress"
    G->>F: StudentNoteIntent (studentName, noteContent)
    F->>M: Extract entities from text
    M->>F: Matched: Sarah Smith (studentId: 42)
    F->>M: Create performance note for student 42
    M->>F: Note created
    F->>G: "Note saved for Sarah Smith"
    G->>U: Speaks confirmation

The Google Assistant action runs as a Google Cloud Function using the @assistant/conversation library. It receives the recognized intent and slot values, calls the Mossie API with your linked OAuth credentials, and returns a spoken confirmation.

Entity Recognition¶

Mossie automatically detects student names in your commands and matches them against your roster.

"Tell Mossie that Ethan and Maya worked well together on the science project"

Mossie will:

Detect "Ethan" and "Maya" in your note
Match them to students in your classroom roster
Create a linked note associated with both students

If a name cannot be matched, Mossie saves the note as a quick capture and tells you the student was not found. You can review and link it manually in the app.

Where It Works¶

The Mossie Google Assistant action works on any device with Google Assistant:

Device	Supported
Google Nest Hub	Yes
Google Nest Mini	Yes
Google Home	Yes
Pixel phones	Yes
Android phones	Yes
Android Auto	Yes
Wear OS watches	Yes
Smart displays	Yes

Privacy¶

Voice audio is processed by Google's Assistant service, which converts it to text
Only the transcribed text is sent to the Mossie API
Your Mossie credentials are stored securely via OAuth token exchange
You can unlink your account at any time in the Google Home app

Tips¶

Use student names clearly -- Google needs to understand the name before Mossie can match it
Keep commands brief -- Short, direct commands are recognized more reliably
Use in quiet environments -- Background noise affects speech recognition
Check your roster -- Make sure students are in your Mossie classroom before expecting name matching

Troubleshooting¶

"Please link your Mossie account"¶

Your account is not linked:

Open the Google Home app
Go to Settings then Works with Google
Search for Mossie
Tap Link and sign in

"I couldn't find that student"¶

The student name was not matched:

Check that the student is in your classroom roster in the Mossie app
Try using the student's full first name
Unusual spellings or nicknames may not match automatically