Zoom integration
Last updated: 2026-05-27
LaVoix's Zoom integration lets you pull your Zoom Cloud Recordings directly into a LaVoix project — no manual download + upload. Once a recording is in a project, you can search it, ask cross-meeting questions, and link directly to specific moments via citations.
This guide covers everything you need to know about the integration: how to add it, how to use it, the permissions it requests, and how to remove it.
What the integration does
- Lists your Zoom Cloud Recordings inside LaVoix's Add Videos dialog.
- Downloads the MP4 video for any recording you pick into your LaVoix project storage.
- Pulls the VTT transcript Zoom auto-generated for the recording (if your Zoom plan has that feature enabled), so LaVoix doesn't need to re-transcribe.
- Indexes everything for transcript search and AI Q&A the same way it handles YouTube videos and manually uploaded files.
Permissions the integration requests
When you click Connect, Zoom shows a consent screen asking you to grant LaVoix two specific permissions:
| Permission | What it allows |
|---|---|
| user:read:user | Read your basic Zoom profile (id and email address) so we can show “Connected as you@example.com” in your LaVoix account settings. Not used for anything else. |
| cloud_recording:read:list_user_recordings | List your Zoom Cloud Recordings and access the download URLs for each recording's files (MP4 video, VTT transcript). We only download files for recordings you specifically pick. |
The integration does not request write permissions to Zoom — we can't create, edit, or delete anything in your Zoom account. We don't request access to meeting chat, participant lists, or other users' recordings.
How to add the app to your LaVoix account
- Sign in to LaVoix.ai. If you don't have an account yet, you can create one for free first.
- Open your account settings via the avatar dropdown in the top-right corner of the dashboard, or visit /dashboard/account directly.
- Scroll down to the Connected accounts section. You'll see a Zoom card.
- Click Connect. You'll be redirected to
zoom.usto sign in (if you aren't already) and approve the two permissions listed above. - Zoom redirects you back to LaVoix. The card now shows “Connected as <your Zoom email>” with a Disconnect button.
How to use the app
- Open a project in LaVoix (or create a new one).
- Click + Add videos in the project header.
- Switch to the From Zoom tab in the dialog. You'll see a paginated list of your Zoom Cloud Recordings with date, title, and duration for each.
- Pick one or more recordings using the checkboxes, then click Add to project.
- LaVoix downloads the MP4 + VTT transcript in the background. Each recording appears in your project's sources rail with a processing indicator, then transitions to ready once indexing completes (typically 1-3 minutes per recording).
- Once ready, the recording works exactly like any other source: ask questions across it, search the transcript, click citations to deep-link to specific timestamps in the in-browser player.
How to remove the app
You can disconnect the integration from either side — LaVoix or Zoom. Both routes have the same effect: the OAuth tokens are revoked, and LaVoix can no longer access your Zoom account.
From LaVoix
- Visit /dashboard/account.
- Scroll to the Connected accounts section.
- Click Disconnect on the Zoom card. LaVoix revokes the OAuth grant on Zoom's side and deletes your tokens from our database immediately.
From Zoom
- Sign in to the Zoom App Marketplace.
- Click Manage in the top-right, then Added Apps in the left sidebar.
- Find LaVoix in the list and click Remove. Zoom will revoke the grant; LaVoix receives a deauthorization webhook and deletes your stored tokens automatically.
Data handling
- OAuth tokens are encrypted at rest using AES-256-GCM with a server-only key. They are never logged, never exposed to client code, and never visible in our admin interfaces.
- Only the recordings you pick are downloaded. We never bulk-import your entire recording library. The recordings list is fetched on-demand when you open the “From Zoom” tab, not cached indefinitely.
- Downloaded recordings live in your LaVoix project storage (Supabase Storage). They're subject to the same privacy + retention rules as any other content in your projects — see our Privacy Policy for details.
- Deleting your LaVoix account cascade-deletes the ZoomConnection row + all stored tokens. We also call Zoom's revoke endpoint to invalidate the grant server-side at Zoom.
Troubleshooting
“No recordings found” on the From Zoom tab. You may be on a Zoom plan without Cloud Recording. Check the Recordings section at zoom.us/recording — if it's empty there, LaVoix has nothing to pull either. Use the manual-upload path for local recordings.
The Connect button says “not configured.” The LaVoix deployment you're using doesn't have the Zoom integration env vars set. Try the production app at lavoix.ai.
Connection link expired. The OAuth state cookie has a 10-minute lifetime. If the Connect flow took longer (you switched tabs, signed into Zoom from scratch, etc.), the callback rejects the response as a CSRF safeguard. Click Connect again to start a fresh flow.
Anything else, including support requests. Use our support page or the in-app feedback drawer (the “?” button at the bottom-right of the dashboard).