# Microsoft Teams

Connect your Microsoft 365 tenant, pick transcribed Teams meetings your reps
organized, and score them in Chambr.

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

| | |
|---|---|
| Status | **Native · Coming soon** |
| Direction | Microsoft Teams → Chambr (read only) |
| Set up by | A Chambr manager who is a Microsoft 365 Global Administrator or Privileged Role Administrator, plus a Teams administrator for one PowerShell step |
| Time | About 15 minutes, plus up to 30 minutes for Microsoft to apply the policy |
| Data freshness | Transcripts are read when a manager opens the import list |
| Plan | Real Call Scoring; Teams meetings with transcription turned on |

## What you need

- A Chambr manager account, and Real Call Scoring on your account.
- Someone who is **Global Administrator** or **Privileged Role
  Administrator** in your Microsoft Entra tenant, to sign in and grant
  consent. Chambr checks the role in the sign-in itself; other accounts are
  refused. If you use Privileged Identity Management (PIM), activate the role
  before you sign in: an eligible role that isn't active doesn't count.
- A Teams administrator who can run Teams PowerShell.
- Meeting transcription turned on, and transcripts actually started in the
  meetings you want to score.
- Reps whose Microsoft 365 email is their Chambr login email.

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

## What gets imported

| Teams | Chambr | Notes |
|---|---|---|
| Meeting subject, start and end time | The call's title, date and duration | |
| Meeting organizer | The rep | Only meetings organized by active Chambr members are read |
| Transcript (WebVTT with speaker names) | The scored transcript | Required |

Chambr reads transcripts one member at a time. It never lists your whole
tenant, and meetings organized by people who aren't Chambr members are never
read. Nothing is written back to Microsoft 365.

## Permissions

Chambr's app uses **application** permissions, granted once by an
administrator for the tenant:

| Permission | Why Chambr needs it |
|---|---|
| `OnlineMeetingTranscript.Read.All` | Read the transcripts of meetings your reps organized |
| `OnlineMeetings.Read.All` | The meeting subject |
| `User.Read.All` | Find each rep's Microsoft 365 user from their email |

The sign-in itself asks only for `openid profile`; Chambr stores no Microsoft
user token or refresh token.

## Set it up

### 1. Connect in Chambr

Open **Integrations**, find **Microsoft Teams** under Call recording, and
select **Connect**. Sign in with your Global Administrator or Privileged Role
Administrator account.

### 2. Grant consent

Microsoft then shows Chambr's permissions for your organization. Select
**Accept**. You return to Chambr, a message says you're almost done, and the
card shows **Finish setup**. Consent can take a few minutes to reach every
Microsoft service, so wait a few minutes before you test.

### 3. Allow Chambr to read meeting transcripts

Microsoft requires an application access policy before an app can read
meeting transcripts. A Teams administrator runs, in Teams PowerShell (the
Microsoft Teams card shows both commands with Chambr's app id filled in, each
with a copy button):

```
New-CsApplicationAccessPolicy -Identity Chambr -AppIds "<Chambr app id>" -Description "Chambr transcripts"
Grant-CsApplicationAccessPolicy -PolicyName Chambr -Global
```

It can take up to 30 minutes to apply. To limit Chambr to some users, grant
the policy to those users instead of `-Global`.

### 4. Test the connection

On the Microsoft Teams card, select **Test connection**. When everything is
in place the card shows **Connected**.

## Verify it works

1. Open **Real Call Scoring**, select **Score a call**, then
   **Import from a recorder** and **Microsoft Teams**.
2. Transcribed meetings your reps organized are listed. Pick one or two and
   select **Review calls**.
3. Check the rep match, confirm consent, and select **Import & score**.

## Limitations

- Only meetings a member **organized**. Meetings hosted by a buyer live in the
  buyer's tenant and aren't visible. Channel meetings and live events aren't
  covered.
- If your tenant turns off speaker attribution, transcripts come without
  speaker names and can't be scored.
- Recordings aren't attached for playback yet; the transcript is scored.
- The list reads the last 30 days.
- Managers import; reps can't import Teams meetings themselves yet.

## Troubleshooting

**Test connection** names what is missing:

| Card says | Cause | Fix |
|---|---|---|
| Admin consent pending / Admin consent not granted yet | Consent wasn't accepted, was revoked, or hasn't propagated yet | Wait a few minutes and test again; if it persists, select **Reconnect** and accept the permissions |
| Application access policy missing | Step 3 hasn't been done, or hasn't applied yet | Run the two commands from the card, wait up to 30 minutes, test again |
| Graph access to transcripts is turned off | A Microsoft 365 policy in your tenant blocks apps from reading transcripts | Contact Chambr support; we'll work through it with your Microsoft 365 administrator |
| Speaker attribution is off | Your tenant removes speaker names from transcripts | Chambr can't tell the rep from the buyer without names, so these calls can't be scored. Ask your Microsoft 365 administrator to allow speaker attribution, then test again |
| "Microsoft Teams wasn't connected: sign in as an administrator of your organization's account." | The account that signed in has neither admin role active | Sign in with a Global Administrator or Privileged Role Administrator; with PIM, activate the role first |
| "This Microsoft Teams account is already connected to another Chambr account. Contact support." | Another Chambr account holds this tenant | Contact support |
| A manager sees "Microsoft Teams isn't connected. A manager can reconnect it on the Integrations page." | Setup isn't finished, or consent was revoked (the card then says so) | An admin finishes setup or selects **Reconnect** |
| "Microsoft Teams is busy. Try again in a minute." | Microsoft is throttling requests | Wait a minute and reload the list |
| "Couldn't load your Microsoft Teams calls. Try again." | Microsoft returned an error | Reload; if it persists, contact Chambr support |
| The card says "Coming soon" | We're waiting on Microsoft to finish verifying Chambr's app | Nothing to do yet: it turns on once the app is approved |
| "Microsoft Teams isn't available on this Chambr environment yet." | Chambr hasn't set up the Microsoft app on this environment | Contact Chambr support |
| "Couldn't connect Microsoft Teams. Please try again." | The sign-in didn't complete | Select **Connect** again from the same browser |

## Disconnect

On the **Integrations** page, select **Disconnect** on the Microsoft Teams
card and confirm. Chambr deletes the connection and releases the tenant;
imported calls and their scores stay. Chambr's access in Microsoft 365 stays
until you remove it there: Microsoft Entra admin center > **Enterprise
applications** > Chambr > **Properties** > **Delete**, and remove the
application access policy with
`Remove-CsApplicationAccessPolicy -Identity Chambr`.

## For Chambr operators

The Entra app registration must set `groupMembershipClaims` to
`"DirectoryRole"` in its manifest. Without it Microsoft omits `wids` from
the sign-in token and every admin is refused. Register both redirect URIs
(`/api/integrations/teams/callback` and `/api/integrations/teams/consent-return`)
and grant only the three application permissions above. The app id
(`MS_GRAPH_CLIENT_ID`) is shown to customers on the card for the PowerShell
step.
