# Gong

Connect Gong, pick recorded calls, and score them in Chambr with the
recording attached for playback.

| | |
|---|---|
| Status | **Native** |
| Direction | Gong → Chambr (read only) |
| Set up by | A Chambr manager, approving access in Gong |
| 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 (on the Integrations page, or from Real Call
  Scoring), and Real Call
  Scoring on your account. Managers import calls once it's connected.
- A Gong user who can authorize apps for your Gong company, usually a Gong
  technical administrator.
- Reps whose Gong email is their Chambr login email.

## What gets imported

| Gong | Chambr | Notes |
|---|---|---|
| Call title, start time, duration | The call's title and date | |
| Parties and speakers | Who said what | The rep is the internal party who owns the call |
| Transcript | The scored transcript | Required; calls without one can't be imported |
| Media URL | The recording, for playback | When Gong has one |
| User directory | The rep filter on the import list | Matched by email |

Only calls a manager selects are imported. Nothing is written back to Gong.

## Permissions and scopes

| Scope | Why Chambr needs it |
|---|---|
| `api:calls:read:basic` | List calls to choose from |
| `api:calls:read:extensive` | Parties and speakers, to find the rep |
| `api:calls:read:transcript` | The transcript to score |
| `api:calls:read:media-url` | Download the recording for playback |
| `api:users:read` | Filter the list by rep |

## Set it up

### 1. Open Integrations in Chambr

In Chambr, open **Integrations** in the left nav and find **Gong** under
Call recording.

Managers can also connect from **Real Call Scoring**: select **Score a call**,
then **Import from a recorder**.

### 2. Connect

Select **Connect**. Gong asks you to sign in and approve Chambr's read-only
access. Approve it.

### 3. Back in Chambr

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

## Verify it works

1. Open **Real Call Scoring**, select **Score a call**, then
   **Import from a recorder** and **Gong**.
2. Your recent Gong calls 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

- A call is matched to a rep by email. A call owned by someone who isn't a
  Chambr user can be given a rep by hand during review (**Choose a rep**).
- Up to 15 calls per import.
- Calls aren't imported automatically.

## Troubleshooting

| Symptom | Cause | Fix |
|---|---|---|
| Gong shows an error when you approve | Your Gong user can't authorize apps | Ask a Gong technical administrator to connect |
| The list is empty | No recent calls with transcripts, or a filter is on | Widen the date range or clear the rep filter |
| A rep shows as not found | Their Gong email isn't their Chambr email | Pick the rep by hand in review, or invite them with that email |
| The card says **Needs attention** | Access was revoked in Gong, or it expired | Disconnect, then connect again |

## Disconnect

On the **Integrations** page, select **Disconnect** on the Gong card and
confirm. Chambr deletes its stored access; imported calls and their scores
stay. A Gong technical administrator can also remove Chambr from the apps
authorized in your Gong company.
