# Zoom

Connect your company's Zoom account, pick cloud recordings that have a
transcript, and score them in Chambr.

> [!NOTE]
> Coming soon: we're waiting on Zoom to approve Chambr's Marketplace app. Until then the
> card says "Coming soon" and can't be connected.

| | |
|---|---|
| Status | **Native · Coming soon** |
| Direction | Zoom → Chambr (read only) |
| Set up by | A Chambr manager who is also a Zoom account admin |
| Time | About 3 minutes |
| Data freshness | Recordings are read when a manager opens the import list |
| Plan | Real Call Scoring; Zoom Pro or higher with cloud recording |

## What you need

- A Chambr manager account, and Real Call Scoring on your account.
- A Zoom admin who can authorize apps for the whole Zoom account.
- Cloud recording on, with **Create audio transcript** turned on (Zoom web
  portal: **Settings** > **Recording** > **Cloud recording** > **Advanced
  cloud recording settings**). Meetings without a transcript are not listed.
- Reps whose Zoom email is their Chambr login email.

One Zoom account connects to one Chambr account. If another Chambr account
already connected it, Chambr refuses the second connection.

## What gets imported

| Zoom | Chambr | Notes |
|---|---|---|
| Meeting topic, start time, duration | The call's title and date | |
| Host email | The rep, and the import list | Only meetings hosted by an active Chambr member are listed |
| Host display name | The rep's speaker | Pre-selected when the host speaks in the transcript |
| Audio transcript (VTT) | The scored transcript | Required |

Only meetings a manager selects are imported. Nothing is written back to Zoom.
Meetings hosted by people who aren't Chambr members are never shown to Chambr
users, even though the grant covers the whole Zoom account.

## Permissions and scopes

| Scope | Why Chambr needs it |
|---|---|
| `cloud_recording:read:list_account_recordings:admin` | List the account's cloud recordings to choose from |
| `cloud_recording:read:list_recording_files:admin` | Read the transcript file of a selected meeting |
| `user:read:user:admin` | The host's display name, to find the rep in the transcript |

## Set it up

### 1. Open Integrations in Chambr

Open **Integrations**, find **Zoom** under Call recording, and select
**Connect**.

### 2. Approve in Zoom

Sign in as a Zoom account admin and approve Chambr's read-only access for the
account.

### 3. Back in Chambr

You return to the Integrations page and the Zoom card shows **Connected**.

## Verify it works

1. Open **Real Call Scoring**, select **Score a call**, then
   **Import from a recorder** and **Zoom**.
2. Recordings from the last 30 days with a transcript, hosted by your reps,
   are listed. Pick
   one or two and select **Review calls**.
3. Check the rep match, confirm consent, and select **Import & score**.

## Limitations

- Only cloud recordings with an audio transcript. Local recordings are
  invisible to Zoom's API.
- The list covers recordings from the last 30 days.
- Recordings aren't attached for playback yet; the transcript is scored.
- Managers import; reps can't import Zoom meetings themselves yet.
- Up to 15 calls per import. Calls aren't imported automatically.

## Troubleshooting

| Symptom | Cause | Fix |
|---|---|---|
| "This Zoom account is already connected to another Chambr account" | Another Chambr account holds this Zoom account | Contact support |
| The list is empty | Audio transcripts are off, or no host is a Chambr member | Turn on **Create audio transcript**; invite reps with their Zoom email |
| The card says **Needs attention** | The app was removed in Zoom, or the grant expired | Select **Reconnect** |
| A manager sees "Zoom isn't connected. A manager can reconnect it on the Integrations page." | The connection was removed, or Zoom refused Chambr's access | An admin selects **Reconnect** on the Zoom card |
| "Zoom is busy. Try again in a minute." | Zoom is rate limiting requests | Wait a minute and reload the list |
| "Couldn't load your Zoom calls. Try again." | Zoom returned an error | Reload; if it persists, contact Chambr support |
| The card says "Coming soon" | We're waiting on Zoom to approve Chambr's Marketplace app | Nothing to do yet: it turns on once the app is approved |
| "Zoom isn't available on this Chambr environment yet." | Chambr hasn't set up the Zoom app on this environment | Contact Chambr support |
| "Couldn't connect Zoom. Please try again." | The sign-in didn't complete (expired, or opened in another browser) | Select **Connect** again from the same browser |

## Disconnect

On the **Integrations** page, select **Disconnect** on the Zoom card and
confirm. Chambr deletes its stored tokens and releases the Zoom account;
imported calls and their scores stay. Chambr's access in Zoom stays until you
remove it there: Zoom App Marketplace > **Manage** > **Added Apps** > Chambr >
**Remove**.

## For Chambr operators

- Create an **admin-managed General App** on the Zoom App Marketplace with
  the three scopes above and the redirect URI
  `https://<app host>/api/integrations/zoom/callback` (set it as
  `ZOOM_REDIRECT_URI`, with `ZOOM_CLIENT_ID` and `ZOOM_CLIENT_SECRET`).
- While the app is unpublished, only Zoom accounts it is shared with (beta
  share) can install it; any other account needs the app published after
  Zoom's review.
- Turn it on per company with `ZOOM_COMPANY_IDS`.
