---
title: "Microsoft Teams"
description: "Learn more about Sentry's Microsoft Teams integration and how you can get alerts that let you triage issues directly in your Teams channels."
url: https://docs.sentry.io/organization/integrations/notification-incidents/msteams/
---

# Microsoft Teams

Microsoft Teams is a hub for teamwork in Office 365. Keep all your team's chats, meetings, files, and apps together in one place. Get alerts that let you assign, archive, and resolve issues right in your Teams channels with the Sentry integration for Microsoft Teams.

Set this integration up once per organization, then it's available for *all* projects.

## [Install](https://docs.sentry.io/organization/integrations/notification-incidents/msteams.md#install)

Sentry owner, manager, or admin permissions are required to install this integration.

1. Visit [the Microsoft Teams App Store](https://teams.microsoft.com/l/app/5adee720-30de-4006-a342-d454317db1d4)

2. Click "Open".

3. Select the General channel for the Team you want for the integration. Click "Go".

##### Note

If you click "Open" instead of selecting a channel, this will incorrectly install Sentry as a personal app.

3. You should see a welcome message in your selected channel within a few seconds. Click "Complete Setup".

The integration should be installed at this point.

## [Configure](https://docs.sentry.io/organization/integrations/notification-incidents/msteams.md#configure)

Use Microsoft Teams for [alerts](https://docs.sentry.io/product/alerts.md) regarding issues, environments, deployment, etc.

### [Alert Rules](https://docs.sentry.io/organization/integrations/notification-incidents/msteams.md#alert-rules)

If Microsoft Teams is not appearing as an option in issue alert actions, re-install the integration using "Add to team".

Set up an alert rule by going to **Alerts** and clicking "Create Alert". From here, you can configure alerts to route notifications to your Microsoft Team's channels.

In [issue alerts](https://docs.sentry.io/product/alerts/alert-types.md#issue-alerts), select "Send a Microsoft Teams notification" in the actions dropdown and then select your team and channel:

In [metric alerts](https://docs.sentry.io/product/alerts/alert-types.md#metric-alerts), select the Microsoft Teams option in the dropdown that corresponds to your team and then enter the username or channel:

Once you receive a Microsoft Teams notification, you can use the "Resolve", "Archive", or "Assign" buttons to update the Issue in Sentry.

The first time you try to interact with a notification, you will get a message from the Sentry bot asking you to link your identity. Click "Link Identities" to complete this step. Until you do this, you can't interact with messages.