# Zoom Cloud Orgwide Integration

### 1) Adding the App - Integration Flow

#### Step 1 - Zoom Admin Initiates Connection

For Zoom admin:

Goes to Rox → Settings → Integrations → Click "Connect" on Zoom

<figure><img src="https://2986926806-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUBzWA2LkfjbdaffIaGlN%2Fuploads%2F8iirJCwDOiVncQqiN9VL%2FScreenshot%202026-03-28%20at%206.46.06%E2%80%AFPM.png?alt=media&#x26;token=4529a66d-cae3-4334-ac44-9c32dfcc7949" alt=""><figcaption></figcaption></figure>

#### Step 2 — Admin Consent

The admin is redirected to Zoom's standard Admin App Consent screen.

Zoom displays the requested application permissions:

* meeting:read:list\_past\_participants:admin - View a past meeting's participants
* cloud\_recording:read:list\_account\_recordings:admin - List account recordings
* cloud\_recording:read:list\_user\_recordings:admin - Download transcript from recording
* user:read:list\_users:admin - View users

<figure><img src="https://2986926806-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUBzWA2LkfjbdaffIaGlN%2Fuploads%2FVerSMdaxeeBnj655L5bQ%2FScreenshot%202026-03-28%20at%206.52.26%E2%80%AFPM.png?alt=media&#x26;token=c809775e-a865-4b2e-80ca-b03f6e4d6515" alt=""><figcaption></figcaption></figure>

The Zoom admin reviews and clicks Allow. You will be redirected to the Rox application where you can see that the Zoom integration will be connected.

### 2) Usage

As a user, you can go to any customer account view in Rox to view your meeting transcripts and participants for the account. See below -

* Once the integration is connected, you can view your meeting transcripts by navigating to the Accounts view on the home page.

<figure><img src="https://2986926806-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUBzWA2LkfjbdaffIaGlN%2Fuploads%2F7zKkqV8WhnJ1s6xvcTX5%2FScreenshot%202026-04-15%20at%2011.54.01%E2%80%AFPM.png?alt=media&#x26;token=94a21489-96f6-468a-8107-beae1af35b62" alt="" width="243"><figcaption></figcaption></figure>

* Search for the account name that you recorded a meeting with
* Select the account and navigate to the **Notes** tab
* Click on the meeting from your calendar and select the **Transcription** sub-tab to view the transcript

<figure><img src="https://2986926806-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUBzWA2LkfjbdaffIaGlN%2Fuploads%2FckOA9N29ZfMwxhOFrPoi%2FScreenshot%202026-04-15%20at%2011.51.19%E2%80%AFPM.png?alt=media&#x26;token=dfe9102e-20d5-4950-8dd8-2c7f9e7afc9a" alt=""><figcaption></figcaption></figure>

### 3) Removing the App

To remove the App from Zoom, follow these steps -

* Log in to your Zoom account and navigate to the Zoom App Marketplace.
* Click Manage >> Added Apps or search for the "Rox" app.
* Select the "Rox" app.
* Click "Remove"

It is recommended to remove the app from Rox after you have removed it in Zoom. To do so -

* navigate to the Settings page in Rox
* Click the "Remove" icon on the Zoom integration

### 4) Troubleshooting

Incase you face any issues connecting the app in Rox, please ensure that -

* You are an admin in your Rox organization
* You are an admin in your Zoom account and can consent to admin permissions

If you still face issues, please report a bug and our team will get back to you.

<figure><img src="https://2986926806-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUBzWA2LkfjbdaffIaGlN%2Fuploads%2FXXUWeqstoCBSMSvW0tTq%2FScreenshot%202026-04-16%20at%2012.04.43%E2%80%AFAM.png?alt=media&#x26;token=d8a054e3-6da7-407c-9130-c53640ecf952" alt="" width="318"><figcaption></figcaption></figure>

### 5) Scope of Integration

Organization-wide connection to Zoom cloud to automatically ingest Zoom cloud recordings, transcripts into Rox for search, analytics, enrichment, and AI-powered insights.

This integration allows Rox to:

* Discover Zoom cloud recordings across the organization
* Download transcript content (VTT format) for Zoom users, Zoom rooms for meetings already present in Rox
* Parse and structure transcripts
* Associate transcripts with meeting metadata and call attendees
* Enable transcript search and insights within Rox

This is a read-only integration. Rox does not modify meetings, users, or transcripts in Zoom.

**Supported Data Access**

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Data Type</th><th>Purpose</th><th>API Permission (Delegated)</th></tr></thead><tbody><tr><td>Meeting Attendee</td><td>Retrieve attendee name and email for meeting context</td><td>meeting:read:list_past_participants:admin</td></tr><tr><td>Transcript List</td><td>List transcript files for Zoom users and Zoom rooms</td><td>cloud_recording:read:list_account_recordings:admin</td></tr><tr><td>Transcript download</td><td>Download transcript files for Zoom users and Zoom rooms</td><td>cloud_recording:read:list_user_recordings:admin</td></tr><tr><td>Users</td><td>Map Zoom users to Rox users</td><td>user:read:list_users:admin</td></tr></tbody></table>

#### Permission Model

* Delegated permissions
* Granted once by a Zoom admin
* No per-user consent required
* Delegated scopes used

### 6) What Data Rox Accesses

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Property</th><th>Description</th></tr></thead><tbody><tr><td>Transcript Content</td><td>Full meeting transcript in WebVTT format</td></tr><tr><td>Meeting Metadata</td><td>Subject, meeting URL, scheduled start/end time, host email</td></tr><tr><td>Attendance Data</td><td>Participant names and email addresses</td></tr><tr><td>User's Data</td><td>Basic user attributes(name, email) for host mapping</td></tr></tbody></table>

This integration is strictly limited to Zoom meeting transcript ingestion.

### 7) Zoom Application Details <a href="#id-3-microsoft-entra-azure-a-d-application-details" id="id-3-microsoft-entra-azure-a-d-application-details"></a>

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Property</th><th>Description</th></tr></thead><tbody><tr><td>App Type</td><td>Admin-managed Zoom app</td></tr><tr><td>Protocol</td><td>OAuth 2.0</td></tr><tr><td>Consent Model</td><td>Zoom admin user consent based</td></tr><tr><td>Token Handling</td><td>Short-lived service-to-service access tokens</td></tr><tr><td>Redirect URI</td><td>https://run.rox.com/settings</td></tr></tbody></table>

### 8) Components & Hosting Locations <a href="#id-4-components-and-hosting-locations" id="id-4-components-and-hosting-locations"></a>

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Component</th><th>Vendor</th><th>Region</th></tr></thead><tbody><tr><td>Rox Frontend</td><td>Vercel</td><td>United States</td></tr><tr><td>Rox Backend</td><td>AWS</td><td>us-east-2 (Ohio)</td></tr><tr><td>Zoom APIs</td><td>Zoom</td><td>Zoom dependent</td></tr></tbody></table>

### 9) Data Handling & Privacy <a href="#id-5-data-handling-and-privacy" id="id-5-data-handling-and-privacy"></a>

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Category</th><th>Description</th></tr></thead><tbody><tr><td>Data Accessed</td><td>Meeting transcripts, meeting metadata, attendees</td></tr><tr><td>Encryption</td><td>TLS 1.2+ in transit, AES-256 at rest</td></tr><tr><td>Storage</td><td>Encrypted AWS storage</td></tr><tr><td>Retention</td><td>Operational use only</td></tr><tr><td>Deletion</td><td>Purged upon org request</td></tr></tbody></table>

### 10) Security Controls <a href="#id-6-security-controls" id="id-6-security-controls"></a>

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Control</th><th>Detail</th></tr></thead><tbody><tr><td>Auth Model</td><td>OAuth 2.0 client credentials</td></tr><tr><td>Credential Type</td><td>Certificate-based authentication</td></tr><tr><td>Token Handling</td><td>Short-lived access_token token and long lived refresh_token</td></tr><tr><td>Revocation</td><td>Admin-controlled in Zoom app and Rox app anytime</td></tr><tr><td>Audit</td><td>Rox logs + Zoom audit logs</td></tr><tr><td>Least Privilege</td><td>Cloud recording, users read, and meeting participants Zoom API scopes</td></tr></tbody></table>

### 11) Summary <a href="#id-6-security-controls" id="id-6-security-controls"></a>

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Aspect</th><th>Detail</th></tr></thead><tbody><tr><td>Purpose</td><td>Org-wide Zoom transcript ingestion</td></tr><tr><td>Access Model</td><td>Delegated permissions</td></tr><tr><td>Write Access</td><td>None</td></tr><tr><td>Restriction Method</td><td>Using Rox settings and Zoom marketplace page</td></tr><tr><td>Permissions</td><td><p>meeting:read:list_past_participants:admin</p><p>cloud_recording:read:list_account_recordings:admin</p><p>cloud_recording:read:list_user_recordings:admin</p><p>user:read:list_users:admin</p></td></tr><tr><td>Revocable</td><td>Yes, anytime</td></tr><tr><td>Hosting</td><td>Vercel (US), AWS us-east-2 (US)</td></tr><tr><td>Data</td><td>Transcripts, meetings, meeting attendees, and Zoom user data synced securely and encrypted</td></tr><tr><td>Controls</td><td>OAuth 2.0 flow; no user credentials stored; Zoom admin consent required; least-privilege scope</td></tr><tr><td>Governance</td><td>Zoom remains authoritative; revocation and audit available anytime via Zoom Marketplace portal</td></tr></tbody></table>