# 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="/files/JE6NNk1djREwqsKOUG1g" 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="/files/WjLiDPaHhWvk6nBolCDR" 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="/files/05UcrRmqNvU5o9uIjmge" 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="/files/fDEBdFrlVYIvxTB7SgGw" 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="/files/1lo2FuIgqsvoPwFusShf" 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.rox.com/development/engineering/docs/rox-enterprise-integrations/zoom-cloud-orgwide-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.