Zoom Integration Guide

Complete guide for teachers to set up and use Zoom integration

Table of Contents

Overview

The Zoom integration allows teachers to automatically import their Zoom cloud recordings into Riff Repeat and create lessons for their students. This saves significant time and ensures no lessons are missed.

What the Zoom Integration Does

  • Connects securely to your Zoom account using OAuth 2.0
  • Fetches up to 300 recent cloud recordings
  • Downloads video and audio files
  • Stores files securely in cloud storage
  • Extracts participant information from each meeting
  • Automatically creates lessons for matched students

Requirements

Important Requirements:
  • You must have a teacher account on Riff Repeat
  • You need a Zoom account with cloud recording enabled
  • Recordings must be saved to Zoom cloud (not local computer)
  • You should have students added to your Riff Repeat account

Connecting Your Zoom Account

Follow these steps to securely connect your Zoom account to Riff Repeat:

Navigate to Settings

Click on your name or the Settings icon in the top navigation menu to access your Settings page.

Find Zoom Integration Section

Scroll down to the "Zoom Integration" section. This section is only visible to teacher accounts.

Click "Connect Zoom Account"

Click the blue "Connect Zoom Account" button. You will be redirected to Zoom's authorization page.

Authorize Riff Repeat on Zoom

Log in to your Zoom account if prompted, then click "Authorize" to grant Riff Repeat access to your recordings. Riff Repeat will only access your cloud recordings and meeting participant information.

Confirmation

You will be redirected back to the Riff Repeat Settings page with a success message. Your Zoom account email will now be displayed in the Zoom Integration section.

Connection Successful! You can now sync your Zoom recordings to automatically create lessons.

Troubleshooting Connection Issues

  • Authorization Failed: Make sure you're using the correct Zoom account and that you clicked "Authorize" on the Zoom page
  • Redirect Error: Check that pop-up blockers are not preventing the redirect
  • Can't See Integration Section: Verify that you're logged in with a teacher account (not a student account)

Syncing Recordings

Once your Zoom account is connected, Riff Repeat automatically syncs your cloud recordings twice daily.

Automatic Sync: Your Zoom recordings are automatically synced twice per day (morning and evening). You don't need to do anything - new recordings will appear automatically!

How Sync Works

During each automatic sync, Riff Repeat performs the following operations:

  1. Fetches Recordings: Retrieves up to 300 recent meetings with cloud recordings from your Zoom account
  2. Downloads Files: Downloads MP4 video files and M4A audio files (when available)
  3. Uploads to Storage: Securely uploads files to cloud storage for fast playback
  4. Extracts Participants: Retrieves the list of meeting participants and their email addresses
  5. Creates Lessons: Automatically creates lessons for students whose email matches a participant email

Manual Sync (Optional)

If you need immediate access to a recording and don't want to wait for the next automatic sync, you can manually trigger a sync:

Go to Settings

Navigate to the Settings page where you connected your Zoom account.

Click "Sync Recordings"

In the Zoom Integration section, click the "Sync Recordings" button.

Wait for Completion

The sync process may take several minutes depending on how many recordings you have. Do not navigate away from the page until you see the success message.

View Results

After completion, you'll see how many recordings were synced and how many lessons were automatically created. The "Last synced" timestamp will update to show when the sync completed.

Note: Manual syncing is safe to use anytime - the system will automatically skip duplicate recordings that have already been processed.

Automatic Lesson Creation

One of the most powerful features of Zoom integration is automatic lesson creation for your students.

How Students Are Matched

When you sync recordings, Riff Repeat automatically creates lessons by:

  1. Extracting the participant list from each Zoom recording
  2. Comparing each participant's email address to your student list
  3. Creating a lesson for any student whose email matches a participant
Email Matching: Matching is case-insensitive and based on exact email matches. Make sure your students use the same email address in Zoom that you registered them with in Riff Repeat.

Viewing Auto-Created Lessons

To see lessons that were automatically created:

  • Navigate to the Lessons page
  • Lessons created from Zoom will have the recording date as the lesson date
  • Each student will only see their own lessons in their account

Manual Matching for Unmatched Recordings

If a recording has participants that don't match any students in your system:

  1. Go to the Recordings page
  2. Find the unmatched recording
  3. Click the option to manually create a lesson
  4. Select the student from your list

What Gets Included in Auto-Created Lessons

Each automatically created lesson includes:

  • Student Assignment: Linked to the matched student
  • Lesson Date: Set to the recording start time
  • Video File: MP4 video from Zoom
  • Audio File: M4A audio (when available)
  • Placeholder for Summary/Transcript: Can be generated separately using AI

Managing Recordings

The Recordings page gives you full visibility and control over all your synced Zoom recordings.

Navigate to Recordings Page

Click on Recordings in the main navigation menu. This page is only accessible to teachers.

View All Synced Recordings

On the Recordings page, you'll see a list of all recordings synced from Zoom, including:

  • Meeting Topic: The name of the Zoom meeting
  • Recording Date: When the meeting was recorded
  • Duration: How long the recording is
  • Matched Students: Which of your students were identified as participants
  • Lesson Status: Whether lessons have been created for matched students

Understanding Recording Metadata

Each recording card shows important information:

  • Participant List: All participants detected in the meeting (your email is filtered out)
  • Match Indicators: Green highlights show participants that match students
  • Action Buttons: Options to create lessons or view existing ones

Disconnecting Zoom

If you need to disconnect your Zoom account from Riff Repeat, follow these steps.

When to Disconnect

You might want to disconnect if:

  • You want to connect a different Zoom account
  • You no longer use Zoom for recording lessons
  • You're troubleshooting connection issues

How to Disconnect

Go to Settings

Navigate to your Settings page.

Click "Disconnect"

In the Zoom Integration section, click the red "Disconnect" button.

Confirm Action

A confirmation dialog will appear. Click "OK" to confirm disconnection.

What Happens to Existing Data

Important:
  • Zoom Connection Removed: Your Zoom OAuth credentials are deleted
  • Recordings Remain: Previously synced recordings stay in your Recordings page
  • Lessons NOT Deleted: Any lessons already created for students are preserved
  • Video Files Safe: Video files continue to be accessible for existing lessons

You can reconnect the same or a different Zoom account at any time by following the connection steps again.

Troubleshooting

Common issues and solutions for Zoom integration:

"Failed to Connect" Errors

  • Check Zoom Login: Make sure you're logged in to the correct Zoom account
  • Authorization Required: You must click "Authorize" on the Zoom OAuth page
  • Pop-up Blockers: Disable pop-up blockers for the Riff Repeat domain
  • Try Again: Sometimes OAuth flows need to be retried - go back to Settings and try connecting again

Sync Not Finding Recordings

  • Cloud Recordings Only: Riff Repeat can only access Zoom cloud recordings, not local recordings saved to your computer
  • Recording Limit: The system fetches up to 300 recent recordings - older ones may not appear
  • Processing Time: Very recent recordings may still be processing in Zoom's cloud - wait a few hours and try syncing again
  • Account Permissions: Verify that cloud recording is enabled on your Zoom account

Recordings Not Matching Students

  • Email Mismatch: The participant's Zoom email must exactly match the student email in Riff Repeat (case-insensitive)
  • Student Not Added: Make sure you've added the student to your student list before syncing
  • Participant Left Early: If a participant left before the recording ended, they may not appear in the participant list
  • Manual Override: Use the Recordings page to manually create lessons for unmatched participants

Missing Video or Audio Files

  • Audio Only Meetings: Some Zoom meetings may only have audio recordings
  • Download Failed: Network issues during sync can cause file download failures - try syncing again
  • Zoom Expiration: Zoom may delete old cloud recordings based on your plan - sync regularly to avoid data loss

Permission Issues

  • Revoked Access: If you revoked Riff Repeat's access in your Zoom settings, you'll need to reconnect
  • Expired Token: OAuth tokens expire - if sync fails, try disconnecting and reconnecting your Zoom account
Still Having Issues? Contact our support team with details about the error you're experiencing.

Related Resources

Getting Started

Learn the basics of using Riff Repeat for students and teachers.

FAQ

Frequently asked questions about Riff Repeat and Zoom integration.