# Microsoft Teams

Post the weekly practice digest to a Microsoft Teams channel with a Workflows
webhook.

| | |
|---|---|
| Status | **Native** |
| Direction | Chambr → Teams (posts only) |
| Set up by | A Chambr manager, with a Teams member who can create a workflow in the channel |
| Time | About 5 minutes |
| Data freshness | Weekly, Mondays at around 14:00 UTC, covering the week that just ended |
| Plan | Team |

## What you need

- A Chambr manager account on a Team plan.
- In Teams, access to **Workflows** in the channel.

> [!WARNING]
> Office 365 connector webhooks (URLs on `webhook.office.com`) were retired by
> Microsoft in May 2026. Chambr refuses them. Use a Workflows webhook.

## What gets sent

| Chambr | Teams | Notes |
|---|---|---|
| Reps who practiced, roleplays | An Adaptive Card | Monday to Sunday, UTC |
| Overdue assignments | A count and a **View assignments** button | |
| Leaderboard, top five | First name, last initial, average score, roleplays | Only when turned on for the channel |

Nothing is read from Teams. Chambr can't edit or delete a card once it is
posted.

## Permissions

The Workflows URL lets whoever holds it post to that one channel. Chambr stores
it encrypted, shows only its host, and posts only the digest and test
messages. No Microsoft app or consent is involved.

## Set it up

### 1. Create the workflow in Teams

1. In Teams, open the channel, select **...** and then **Workflows**.
2. Choose the template **Send webhook alerts to a channel** (also listed as
   **Post to a channel when a webhook request is received**; either works),
   name it (for example "Chambr digest") and finish.
3. Copy the webhook URL it shows. It's a long `https://` URL on a Power
   Automate or Logic Apps host.

### 2. Paste it in Chambr

1. In Chambr, open **Integrations**. Under Collaboration, select **Add a
   channel** in Weekly digest channels.
2. Name the channel, paste the URL, and choose whether it covers a team or the whole organization.

**Connect** on the Microsoft Teams card takes the same URL, but adds a channel
that covers your team without the leaderboard; change either in the
list afterwards.

### 3. Choose what it shows

In **Weekly digest channels**, turn on **Leaderboard** if the channel may see
names and scores. It's off by default, and unavailable while your account's
leaderboard is off.

## Verify it works

1. In **Weekly digest channels**, select **Send test** on the channel.
2. A "Test message from Chambr" card appears in the channel, posted by the
   workflow.
3. The first digest arrives the next Monday at around 14:00 UTC.

Send test works once a minute per channel.

## Limitations

- The workflow belongs to the person who created it. If their account is
  removed, the workflow stops and the channel shows Needs attention. Add a
  co-owner to the workflow in Power Automate, or create it from a shared
  account, so it outlives one person.
- Private channels: Workflows can't post there as the Flow bot, only as a
  user. Use a standard or shared channel, or set the workflow to post as a
  user who is in the private channel.
- Cards post as the workflow (for example "Workflows" or its owner), not as
  Chambr.
- Up to 10 channels per Chambr account. Weekly only.

## Troubleshooting

| Symptom | Cause | Fix |
|---|---|---|
| "That's an Office 365 connector URL, which Microsoft retired" | The URL is a retired connector webhook | Create a Workflows webhook (step 1) |
| "Use a Teams Workflows webhook URL" | The URL isn't on a Power Automate or Logic Apps host | Copy the URL from the workflow's trigger |
| The channel shows Needs attention | The workflow was turned off or deleted, or its owner left | Turn the workflow back on, or create a new one and add the channel again |
| No names in the digest | The leaderboard is off for the channel, or for your account | Turn on Leaderboard for the channel; if the switch is unavailable, the account's leaderboard is off |
| No digest on Monday | The account was suspended or moved off the Team plan | Check the plan, then send a test |
| A channel disappeared from the list | The team it covered was deleted in Chambr | Add the channel again for another team, or for the whole account |

## Disconnect

On **Integrations**, select **Remove** next to a channel in Weekly digest
channels, or **Disconnect** on the Microsoft Teams card to remove every Teams
channel. Chambr deletes the stored URL; cards already posted stay in Teams.

Turn the workflow off or delete it in Teams too (**Workflows** in the channel,
or Power Automate > **My flows**), so the URL stops working.
