# Fathom

Connect Fathom with an API key, pick recorded meetings, and score them in
Chambr.

| | |
|---|---|
| Status | **Native** |
| Direction | Fathom → Chambr (read only) |
| Set up by | A Chambr manager, with a Fathom API key |
| Time | About 2 minutes |
| Data freshness | Meetings 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 Fathom API key. A Fathom key sees the meetings of the Fathom user who
  created it, so create it as the user whose meetings you'll score.
- Reps whose Fathom email is their Chambr login email.

## What gets imported

| Fathom | Chambr | Notes |
|---|---|---|
| Meeting title, date, duration | The call's title and date | |
| Recorded by | The rep match | Matched by email |
| Transcript with speaker names | The scored transcript | |

Fathom's API doesn't offer the recording, so Fathom calls have no playback in
Chambr. Nothing is written back to Fathom.

## Permissions

The API key can read the meetings its Fathom user can see. Chambr stores it
encrypted and never shows it again.

## Set it up

### 1. Create a key in Fathom

In Fathom, open **Settings** and create an **API key**. Copy it.

### 2. Paste it in Chambr

In Chambr, open **Integrations**, find **Fathom** under Call recording, and
select **Connect**. Paste the key and select **Connect**.

Managers can also paste the key from **Real Call Scoring** (**Score a call**,
then **Import from a recorder**, then **Fathom**).

Chambr checks the key with Fathom before saving it. A wrong key is refused
and nothing is stored.

## Verify it works

1. Open **Real Call Scoring**, select **Score a call**, then
   **Import from a recorder** and **Fathom**.
2. Your recent Fathom meetings are listed. Pick one and select **Review call**.
3. Check the rep match, confirm consent, and select **Import & score**. The call appears on
   Real Call Scoring and is scored within a few minutes.

## Limitations

- One key per Chambr account, so only its Fathom user's meetings are listed.
- No recording playback.
- Up to 15 calls per import.

## Troubleshooting

| Symptom | Cause | Fix |
|---|---|---|
| "Could not connect to Fathom with that key" | The key is wrong, expired or deleted | Create a new key in Fathom and paste it |
| Meetings you expected are missing | The key belongs to another Fathom user | Connect with a key from the right user |
| The card says **Needs attention** | The key was deleted in Fathom | Disconnect, then connect with a new key |

## Disconnect

On the **Integrations** page, select **Disconnect** on the Fathom card and
confirm. Chambr deletes the stored key; imported calls and their scores stay.
Delete the key in Fathom's **Settings** too, if you no longer use it.
