> For the complete documentation index, see [llms.txt](https://docs.does.qa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.does.qa/platform/integrations/microsoft-teams.md).

# Microsoft Teams

Connect Microsoft Teams to DoesQA for Run alerts in channel.

Bring DoesQA results into Microsoft Teams so engineering and QA see pass and fail next to the rest of their work. Connect Teams once, then post Run results into the channel you choose.

## Why use it

* Keep release confidence visible in Teams without chasing reports in another tab.
* Alert on CI, schedules, or Runs started in the app with the same notification model as Slack.
* Limit CI alerts to specific [CI / CD](/configuration/ci-cd.md) keys when one team owns one pipeline.

## Connect Microsoft Teams

{% stepper %}
{% step %}

## Generate a linking code

In DoesQA, go to **Settings → Integrations**, choose **Microsoft Teams**, and generate a 6-character linking code. Keep this code ready for the next step.
{% endstep %}

{% step %}

## Add the DoesQA app

In Microsoft Teams, add the **DoesQA** app.
{% endstep %}

{% step %}

## Link the channel

In the Teams channel that should receive DoesQA notifications, type:

```
/link YOUR_CODE
```

Replace `YOUR_CODE` with the 6-character code from step 1. Confirm the channel is linked in DoesQA under **Settings → Integrations**.
{% endstep %}
{% endstepper %}

One link maps to one channel. Repeat these steps to link additional channels. Type `/help` in any linked channel to see available commands.

You only need to link Teams channels once. Notification rules use those linked channels.

## Send Run results to a channel

Create a Teams notification under **Settings → Notifications** to send Run results to a linked channel.

{% stepper %}
{% step %}

## Add a Teams rule

Select **Add**, then choose **Teams**.
{% endstep %}

{% step %}

## Configure the rule

1. Enter a **Title**.
2. Choose the **Run Types** that should post to Teams.
3. Select the linked **Teams channel** that should receive notifications.
4. If the rule uses **CI/CD Webhook** with **Select Keys**, confirm the Key list.
5. Save the rule.
   {% endstep %}
   {% endstepper %}

Field-by-field detail for notification rules lives on [Notifications → Microsoft Teams](/configuration/notifications/teams.md) and [Notifications](/configuration/notifications.md).

## Related

* [Integrations](/platform/integrations.md)
* [Slack](/platform/integrations/slack.md)
* [Notifications](/configuration/notifications.md)
* [Notifications → Microsoft Teams](/configuration/notifications/teams.md)
* [GitHub](/platform/integrations/github.md)
* [Universal Webhook](/platform/integrations/universal-webhook.md)
