Zoom Integration

Connect your Zoom account to automatically sync meeting transcripts into your Storytell projects.

Written By Mark Ku

Last updated 9 days ago

Overview

The Zoom integration automatically syncs your Zoom meeting transcripts and chat logs into Storytell, making them searchable and accessible alongside your other knowledge assets. Once connected, your Zoom recordings are continuously synced, so you can reference meeting discussions, decisions, and action items directly in your chats and prompts.

This integration works seamlessly with your existing Storytell workflow—synced Zoom content appears in your knowledge base and can be referenced using @ mentions in prompts, just like any other asset.

Good to know: The Zoom integration uses OAuth authentication, which means you maintain full control over your Zoom account access. You can disconnect at any time from your Settings.

Important: Zoom integrations are scoped to individual projects. When you connect Zoom, it's connected to the currently active project. Each project can have its own Zoom integration, allowing you to organize recordings by project context.

Connecting Zoom

You can connect your Zoom account from multiple places in Storytell. Choose whichever method is most convenient for you:

Method 1: From the prompt bar

  1. In the prompt bar, click on the sources pill

  2. In the right panel that shows up, click on connect (shows Google Drive and Zoom icons)

  3. In the dropdown menu, click Connect Zoom

  4. You'll be redirected to Zoom's authorization page

  5. Review the permissions and click Allow to authorize Storytell

  6. You'll be redirected back to Storytell, and the sync will begin automatically

Method 2: From the Assets page

  1. In the sidebar, click on Assets

  2. Scroll to the Integrations section

  3. Find the Zoom card

  4. Click the Connect button

  5. You'll be redirected to Zoom's authorization page

  6. Review the permissions and click Allow to authorize Storytell

  7. You'll be redirected back to Storytell, and the sync will begin automatically

After connecting

Once connected, you'll see a checkmark next to Zoom with the message "Your Zoom recordings are automatically synced."

🚀 Tip: Make sure you're signed in to the Zoom account that has access to the recordings you want to sync. The integration will sync recordings from the account you authorize.

Important: The Zoom integration is connected to your currently active project. Make sure you're in the correct project before connecting, as the synced content will be associated with that project.

What gets synced

The Zoom integration automatically syncs two types of files from your Zoom recordings:

  • Meeting transcripts (TRANSCRIPT files) - Full text transcripts of your recorded meetings

  • Chat logs (CHAT files) - Chat messages sent during recorded meetings

Important: Only recordings that have transcripts or chat logs available will be synced. Video recordings (MP4) and audio-only files (M4A) are not synced, as Storytell focuses on text-based content for search and AI interactions.

Automatic sync schedule

Since Zoom doesn't support webhooks for OAuth-based integrations, Storytell uses a periodic sync process to check for new recordings. Your Zoom content is automatically re-synced on a regular schedule to ensure new recordings are captured.

🚀 Pro-Tip: After connecting Zoom, the initial sync begins immediately. Subsequent syncs happen automatically in the background—you don't need to do anything to keep your content up to date.

Project-scoped integrations

Zoom integrations are tied to specific projects in Storytell. This means:

  • Each project can have its own Zoom integration - You can connect Zoom separately for different projects

  • Content is organized by project - Synced recordings appear in the project where the integration was created

  • Project isolation - Recordings synced to one project won't appear in other projects, even if they're from the same Zoom account

When you connect Zoom, it's automatically associated with your currently active project. If you need to sync Zoom recordings to multiple projects, you can:

  1. Connect Zoom in your first project

  2. Switch to another project

  3. Connect Zoom again in that project (using the same or different Zoom account)

Note: While you can connect the same Zoom account to multiple projects, each connection is independent. Recordings will be synced separately to each project, and you'll need to manage each integration individually.

Automatic labeling

Every Zoom recording that gets synced is automatically labeled with time-based labels to help you organize and find your meeting content. These labels are created automatically and attached to each synced file.

Label categories

Synced Zoom files receive the following labels based on the meeting's start time:

  • Zoom - Applied to all synced Zoom content

  • Year {year} - The year the meeting occurred (e.g., "Year 2025")

  • Month name - The full month name (e.g., "January", "February")

  • Day {day} - The day of the month (e.g., "Day 15")

  • Weekday - The day of the week (e.g., "Monday", "Tuesday")

  • Q{quarter} - The quarter of the year (e.g., "Q1", "Q2", "Q3", "Q4")

  • Week {week} - The ISO week number (e.g., "Week 3", "Week 42")

How labels work

Labels are automatically created within your project when the first Zoom file is synced that requires them. For example, if you sync a meeting from January 15, 2025, the system will create labels like "Year 2025", "January", "Day 15", "Monday", "Q1", and "Week 3" (if they don't already exist in your project).

🚀 Pro-Tip: You can use these automatic labels to filter and search for meetings by time period. For instance, search for "Q1" to find all meetings from the first quarter, or "Week 3" to find meetings from a specific week.

Good to know: Labels are created per project, so the same labels may exist in multiple projects but are scoped independently. You can also manually add additional labels to Zoom recordings if you want to organize them further.

Managing your integration

Once Zoom is connected, you can view your synced content in your knowledge base. Zoom recordings appear as individual assets, named with the meeting topic and file type (e.g., "Team Standup - transcript" or "Project Review - chat").

You can use synced Zoom content just like any other asset in Storytell:

  • Reference them in prompts using @ mentions

  • Search for specific meetings or topics

  • Include them in your project's knowledge scope

  • Chat about meeting content with Storytell's AI

Note: The integration syncs recordings from the Zoom account you authorized. If you need to sync recordings from a different account, you'll need to disconnect the current integration and reconnect with the other account.

Good to know: Since integrations are project-scoped, you can have different Zoom accounts connected to different projects. This is useful if you want to separate work and personal recordings, or organize recordings by team or department.

Disconnecting Zoom

To disconnect your Zoom integration:

  1. Go to Settings → Integrations

  2. Find the Zoom section

  3. Click Remove Integration

  4. Confirm the disconnection in the dialog that appears

Important: Disconnecting Zoom will stop all future syncing, but it won't delete content that has already been synced to your Storytell project. Previously synced transcripts and chat logs will remain in your knowledge base unless you manually delete them.

Troubleshooting

If you're experiencing issues with the Zoom integration, try these steps:

  1. Check your connection status

    • Go to Settings → Integrations and verify Zoom shows as "Connected"

    • If it shows an error, try disconnecting and reconnecting

  2. Verify Zoom permissions

    • Make sure your Zoom account has access to the recordings you expect to see

    • Check that recordings have transcripts or chat logs enabled (these are required for syncing)

  3. Wait for sync to complete

    • Initial sync may take a few minutes depending on how many recordings you have

    • New recordings are synced automatically on a schedule

  4. Check for error messages

    • If you see an error message on the Integrations page, it will provide details about what went wrong

    • Common issues include expired OAuth tokens (which require reconnection) or Zoom API rate limits

  5. Reconnect the integration

    • If problems persist, try disconnecting and reconnecting your Zoom account

    • This refreshes the OAuth token and restarts the sync process

If you continue to experience issues after trying these steps, reach out to us via live chat for assistance. Please include details about:

  • When you connected the integration

  • What recordings you expect to see

  • Any error messages you've encountered

FAQ