# Chorus

Connect Chorus by ZoomInfo with an API token, pick recorded calls, and score
them in Chambr against your scorecards.

> [!NOTE]
> Early access: ask your Chambr contact to turn it on. Until then the card
> says "Early access: ask your Chambr contact".

| | |
|---|---|
| Status | **Native · Early access** |
| Direction | Chorus → Chambr (read only) |
| Set up by | A Chambr manager, with a Chorus API token |
| Time | About 2 minutes |
| Data freshness | Calls are read when a manager opens the import list |
| Plan | Real Call Scoring |

## What you need

- A Chambr manager account, and Real Call Scoring on your account.
- A Chorus API token from a Chorus user whose role allows API access and who
  can see every rep's recordings. Chorus applies that user's data-access
  controls to the token, so a rep's token only sees that rep's calls.
- Reps whose Chorus email is their Chambr login email.

## What gets imported

| Chorus | Chambr | Notes |
|---|---|---|
| Engagement subject, date, duration | The call's title and date | |
| Participants marked as reps | The rep match, and the import list | Only calls with a rep who is an active Chambr member are listed |
| Conversation owner | The rep | The rep's speaker is pre-selected when the owner is a speaker |
| Utterances (speaker, text, time) | The scored transcript | Required; calls without one can't be imported |

Only calls a manager selects are imported. Nothing is written back to Chorus.
Recordings marked private in Chorus are never returned to Chambr.

## Permissions

Chorus API tokens carry the permissions of the user who created them. Chambr
only reads:

| Chorus endpoint | Why Chambr needs it |
|---|---|
| `GET /v3/engagements` | List recent calls to choose from |
| `GET /api/v1/conversations/{id}` | The owner and the transcript to score |

## Set it up

### 1. Create a token in Chorus

Sign in to Chorus as an admin (or a user who can see every rep's calls),
open **Personal Settings**, then **API**, and generate a token. If you don't
see the API section, ask your Chorus customer success manager to enable API
access for your role.

### 2. Connect in Chambr

In Chambr, open **Integrations**, find **Chorus** under Call recording, select
**Connect**, paste the token, and select **Connect** again. Chambr checks the
token with Chorus before saving it.

### 3. Done

The Chorus card shows **Connected**. The token is stored encrypted and never
shown again.

## Verify it works

1. Open **Real Call Scoring**, select **Score a call**, then
   **Import from a recorder** and **Chorus**.
2. Your reps' Chorus calls from the last 30 days are listed. Pick one or two and select
   **Review calls**.
3. Check the rep match, confirm consent, and select **Import & score**. The
   calls appear on Real Call Scoring and are scored within a few minutes.

## Limitations

- The list covers calls from the last 30 days.
- A call is listed when one of its reps (Chorus participant type "rep") is an
  active Chambr member; that rep is the one matched.
- Managers import; reps can't import Chorus calls themselves yet.
- Up to 15 calls per import. Calls aren't imported automatically.
- Recordings aren't attached for playback yet; the transcript is scored.

## Troubleshooting

| Symptom | Cause | Fix |
|---|---|---|
| "Could not connect to Chorus with that token" | The token is wrong, expired, or the role has no API access | Generate a new token and paste it again |
| The list is empty | The token user can't see other reps' calls, or no rep on recent calls is a Chambr member | Use an admin's token; invite reps with their Chorus email |
| The card says **Needs attention** | Chorus refused the token (revoked or deleted) | Select **Reconnect** and paste a new token |
| A manager sees "Chorus isn't connected. A manager can reconnect it on the Integrations page." | The connection was removed, or Chorus refused Chambr's access | An admin selects **Reconnect** on the Chorus card |
| "Chorus is busy. Try again in a minute." | Chorus is rate limiting requests | Wait a minute and reload the list |
| "Couldn't load your Chorus calls. Try again." | Chorus returned an error | Reload; if it persists, contact Chambr support |
| The card says "Early access: ask your Chambr contact" | Chorus isn't turned on for your account yet | Ask your Chambr contact to turn it on |
| "Chorus isn't available on this Chambr environment yet." | Chambr hasn't set up the Chorus app on this environment | Contact Chambr support |

## Disconnect

On the **Integrations** page, select **Disconnect** on the Chorus card and
confirm. Chambr deletes the stored token; imported calls and their scores
stay. To revoke the token itself, delete it in Chorus under
**Personal Settings** > **API**.
