OFFICIAL ZOOM APP MARKETPLACE DOCUMENTATION

User Documentation & Integration Guide

Comprehensive guide to adding, using, configuring, and removing ClassMind AI from your Zoom account

📌 Quick Navigation:

1. Adding the App (Installation Guide)
2. Usage & Feature Walkthrough (Prerequisites & Descriptions)
3. Removing the App (De-authorization & Data Compliance)
4. Troubleshooting Guide
5. Frequently Asked Questions (FAQ)

1. Adding the App (Installation Guide)

Follow this step-by-step guide to connect ClassMind AI to your Zoom account. ClassMind AI connects via official Zoom OAuth 2.0 with granular scopes, requiring zero API keys, zero complex Server-to-Server JSON configurations, and zero desktop software.

Prerequisites

A Zoom account (Pro, Business, Enterprise, or Education tier).
Zoom Account Administrator or User role with permissions to authorize Marketplace applications.
Cloud Recording enabled: In your Zoom settings (Settings > Recording > Cloud Recording), ensure Cloud Recording is toggled ON so Zoom automatically records and stores completed lessons for ingestion.

Step-by-Step Installation Instructions

Locate the App: Visit the Zoom App Marketplace and search for ClassMind AI, or navigate directly to our 1-Click authorization portal at https://getclassmind.com/zoom/oauth/authorize.
Click Add / Install: Click the Add button to initiate the secure OAuth 2.0 installation flow.
Review Permissions: Zoom will display the official consent screen detailing the granular scopes requested by ClassMind AI:
- recording:read:admin / recording:read:list_user_recordings:admin: Enables ClassMind to receive notifications when class recordings complete and download audio streams for pedagogical transcription.
- user:read:email:admin: Enables ClassMind to correlate lesson recordings with the designated teacher profile and school workspace.
Authorize: Review the permissions and click Allow (Authorize).
Workspace Confirmation: Upon authorization, Zoom securely redirects you to https://getclassmind.com/zoom/oauth/success. ClassMind AI automatically registers your school workspace, links your webhook subscriptions, and enables automatic lesson processing.

🔗 Encountering an issue during setup? See our Troubleshooting Guide below.

2. Usage & Feature Walkthrough

ClassMind AI is an autonomous educational intelligence platform tailored for language schools, tutoring centers, and academies. Below is a detailed description of each core feature, its primary use case, and required prerequisites.

Feature 1: Automated Zoom Cloud Recording Ingestion

Use Case: Eliminates manual video downloading and file management. Whenever a teacher finishes a class on Zoom, ClassMind automatically detects the completed session, verifies duration, and begins transcription in the cloud.
Prerequisites: Zoom Cloud Recording enabled in meeting host's Zoom settings; meeting duration must exceed 3 minutes (short test calls under 3 minutes are automatically filtered).
How to Use: Simply conduct and end your Zoom meeting as usual. Zoom automatically notifies ClassMind via secure webhooks (recording.completed). The platform ingests the session, extracts audio over TLS 1.3, and dispatches it to our high-accuracy transcription engine.

Feature 2: AI Pedagogical Quality & CELTA Talk-Time Analysis

Use Case: Gives academic directors and methodists 100% visibility into teaching quality without having to sit through dozens of hours of recorded lessons.
Prerequisites: Ingested Zoom lesson audio with discernible speech.
How to Use: Following transcription, ClassMind's acoustic Silero VAD v5 and LLM cascade evaluate Cambridge CELTA standards:
- Teacher Talk Time vs. Student Talk Time (TTT / STT Ratio): Measures exact conversational balance to ensure students get sufficient speaking practice.
- Red-Flag Churn Radar: Detects student frustration, disengagement, language barrier fatigue, or excessive silence (>3s pauses).
- Diagnostic CEFR Level: Continuously estimates the student's communicative proficiency (A1 to C2) based on lexical diversity and grammar complexity.

Feature 3: Personalized Student Homework & Parent Follow-Up Letters (Co-Pilot)

Use Case: Saves teachers 15–20 minutes after every lesson by auto-drafting comprehensive, personalized progress notes, vocabulary lists, and targeted homework exercises for parents and students.
Prerequisites: Completed lesson analysis.
How to Use: Within 90 seconds of lesson completion, ClassMind drafts an individualized follow-up report. Teachers and administrators can review, edit, or approve the draft with one tap in our Telegram bot or web dashboard for direct delivery to student/parent Telegram chats or email.

Feature 4: Daily Morning Coaching for Teachers

Use Case: Provides continuous pedagogical professional development. Delivers personalized 2-minute micro-training tips tailored to each teacher's individual growth areas.
Prerequisites: Teacher profile connected to the school workspace.
How to Use: Every morning at 09:00 Kyiv time, teachers receive a targeted coaching tip from our 30-skill CELTA taxonomy (e.g. Concept Checking Questions, elicitation techniques, reduction of teacher echo) addressing areas observed in their recent classes.

Feature 5: Executive Weekly School Digest & Anti-Churn Radar

Use Case: Enables school owners and directors to monitor student retention, teacher performance benchmarks, and overall academic health in a single concise Friday briefing.
Prerequisites: School Administrator or Owner role.
How to Use: Every Friday at 18:00, school leaders receive an aggregated executive digest in Telegram and email containing lesson volumes, top-performing teachers, and anti-churn alerts for students at risk of drop-off.

3. Removing the App (De-authorization & Data Purge)

You can remove or uninstall ClassMind AI at any time directly through your Zoom account.

Step-by-Step Instructions to Remove ClassMind AI

Log in to your Zoom account and navigate to the Zoom App Marketplace.
Click Manage >> Added Apps (or search for ClassMind AI).
Locate and select the ClassMind AI app.
Click Remove (or Uninstall).
Confirm the removal when prompted.

Potential Implications of Removal

ClassMind AI will immediately cease receiving Zoom webhook events (recording.completed).
Automated lesson ingestion, transcription, CELTA metric scoring, and Co-Pilot draft generation will stop immediately for all upcoming lessons.
Existing OAuth 2.0 access and refresh tokens will be immediately invalidated and cannot be reused.
Access to automated teacher morning coaching and executive weekly digests will be paused.

How User Data is Handled After Removal (Compliance & Data Retention)

🔒 Zoom Data Compliance & GDPR/CCPA Right to be Forgotten:

ClassMind AI strictly adheres to Zoom Marketplace Developer Data Compliance standards:

Immediate Synchronous Token Deletion (<10ms): Upon receiving the app_deauthorized webhook from Zoom, our system immediately and synchronously deletes stored OAuth access tokens and refresh tokens from our encrypted database (flipping status to deauthorized and purging credential fields).
Zoom Data Compliance API Confirmation: Within seconds of deauthorization, ClassMind sends a verified compliance acknowledgment to Zoom's compliance reporting endpoint (POST https://api.zoom.us/oauth/data/compliance) with signature verification and deauthorization timestamp.
Complete Data Purge (Within 24–48 Hours): All historical session transcripts, AI metrics, temporary files, and school records associated with the deauthorized account are permanently and irreversibly purged from our database in automated compliance batches.
Expedited Manual Erasure: If you require immediate manual verification or certified data erasure, you may submit a request directly to our Compliance Officer at privacy@getclassmind.com.

4. Troubleshooting Guide

If you encounter any issues while adding, using, or removing ClassMind AI, consult the solutions below:

Common Issues & Resolutions

Issue 1: Recordings are not appearing or being processed.

Ensure Cloud Recording is enabled in your Zoom settings (Settings > Recording > Cloud Recording). Local computer recordings are not accessible via Zoom Cloud webhooks.
Verify meeting duration: Sessions shorter than 3 minutes are automatically filtered out to prevent false alerts from accidental connects.
Wait 3–5 minutes: Zoom requires a brief processing interval to render the cloud recording before issuing the recording.completed webhook.

Issue 2: "Invalid redirect URI" or OAuth authorization error during install.

Ensure you are initiating the authorization from the official marketplace link or our canonical portal at https://getclassmind.com/zoom/oauth/authorize.
Verify that your browser allows cookies and redirects from zoom.us and getclassmind.com.

Issue 3: Permissions or Administrator approval required.

If your Zoom organization restricts marketplace installations, ask your Zoom Account Administrator to pre-approve ClassMind AI under Zoom Marketplace > Manage > App Requests.

Issue 4: Passcode-protected or restricted recordings.

Ensure that your Zoom account permissions grant cloud recording read access to authorized marketplace apps. If recording downloads require additional SAML SSO verification, adjust your account recording sharing settings to allow authorized OAuth API access.

5. Frequently Asked Questions (FAQ)

Are video files of students or teachers stored on ClassMind servers?

No. ClassMind operates under a strict Zero Video Retention architecture. Only the isolated speech audio track is extracted over TLS 1.3, processed for speech-to-text, and immediately erased from server memory. We do not store raw MP4 video files.

Are classroom recordings used to train public AI models?

Never. All model inference is executed via enterprise zero-data-retention APIs. Customer data is strictly isolated by cryptographic multi-tenant boundaries and never shared or used for foundational model training.

How can I reach customer support?

Our dedicated technical and educational support team is available 24/7/365:

Official Email: support@getclassmind.com (Response time < 1 hour for P1 issues)
Telegram Support: @the_classmind_bot
Support Portal & SLA: Customer Support & SLA Desk