> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elementary-data.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Teams

Elementary's Microsoft Teams app sends alerts when data issues happen, as
[Adaptive Cards](https://adaptivecards.io/) with rich context. The app is
installed once per team and Elementary posts to any standard channel in that
team.

You can create [alert rules](https://docs.elementary-data.com/features/alerts-and-incidents/alert-rules.md) to
distribute alerts to different channels and destinations.

![Elementary alert in a Microsoft Teams channel](https://mintcdn.com/elementary/d0zFKVpjiuNi8aSB/images/teams/hero-alert.png?fit=max\&auto=format\&n=d0zFKVpjiuNi8aSB\&q=85\&s=687b8c946be60c2deb6f0cceb6a6c215)

[Elementary Microsoft Teams App — alerts and incidents](https://www.youtube.com/embed/sT1CHwTKloM)

## Connecting the Microsoft Teams app

**1. Install the Elementary app in Microsoft Teams**

Install the [Elementary app from the Microsoft Teams App Store](https://marketplace.microsoft.com/en-us/product/teams-app/WA200011427)
and add it to the team where you want to receive alerts.

**2. Connect your Teams workspace to Elementary**

Once the bot is installed in a team, you should see this card.
Click **Connect to Elementary** to link this workspace to your
Elementary account.

![Elementary welcome card with Connect to Elementary button](https://mintcdn.com/elementary/d0zFKVpjiuNi8aSB/images/teams/welcome-card.png?fit=max\&auto=format\&n=d0zFKVpjiuNi8aSB\&q=85\&s=264712f85acb75120f158abb842c5941)

This opens **Elementary** and connects the workspace automatically.
Connecting requires an Elementary user with the **Edit integrations**
permission — usually a user with the **Admin** role.

Once complete, you should see both:

**In Elementary** — a dialog confirming the workspace is connected.
Pick a **Default channel** to start receiving alerts right away.

![Elementary dialog showing Microsoft Teams workspace is connected, with default channel picker](https://mintcdn.com/elementary/d0zFKVpjiuNi8aSB/images/teams/connected-dialog.png?fit=max\&auto=format\&n=d0zFKVpjiuNi8aSB\&q=85\&s=73c670b1f908a769797fc71d5f1c06b1)

> [!NOTE]
>
> Setting a default channel automatically adds a default
> [alert rule](https://docs.elementary-data.com/features/alerts-and-incidents/alert-rules.md) that sends all
> failures to that channel. Alerts on warnings are not sent by default — to
> refine this, go to the `Alert Rules` page.

**In Microsoft Teams** — a confirmation card in the channel:

![Welcome and connected confirmation cards in Microsoft Teams](https://mintcdn.com/elementary/d0zFKVpjiuNi8aSB/images/teams/teams-cards-after-connection.png?fit=max\&auto=format\&n=d0zFKVpjiuNi8aSB\&q=85\&s=66c379441f329c463e6046bbfccd0bf7)

> [!TIP]
>
> You can regenerate the connection link any time by typing
> **`@Elementary connect`** in the channel.

**3. Route alerts to channels**

Use [alert rules](https://docs.elementary-data.com/features/alerts-and-incidents/alert-rules.md) to control
which alerts go to which channels — for example, routing test failures to
one channel and freshness issues to another.

## Bot commands

**In Microsoft Teams**, mention the bot in any channel it's installed in:

* **`@Elementary help`** — what Elementary can do and how to get started.

![@Elementary help response](https://mintcdn.com/elementary/d0zFKVpjiuNi8aSB/images/teams/help-card.png?fit=max\&auto=format\&n=d0zFKVpjiuNi8aSB\&q=85\&s=49a6cfa2fcbb15a3991906e40beb9076)

* **`@Elementary connect`** — a fresh link to connect the team to your Elementary account.

![@Elementary connect response](https://mintcdn.com/elementary/d0zFKVpjiuNi8aSB/images/teams/connect-command.png?fit=max\&auto=format\&n=d0zFKVpjiuNi8aSB\&q=85\&s=bfc685bef0b724371e35f182e043c663)

## Supported channels

The app posts to **standard channels** in the team it's installed in. Private
and shared channels are not supported.

## Disconnecting

You can disconnect from either side:

* **From Elementary** — go to `Environments` → `Connect messaging app`, open the
  **Microsoft Teams App** menu, and choose **Disconnect**. This unlinks the
  workspace from your Elementary account and stops alerts. The app stays
  installed in Teams — remove it there too if you want to fully uninstall.
* **In Microsoft Teams** — remove the Elementary app from the team
  (`Manage team` → `Apps` → remove **Elementary**). This uninstalls the app, and
  the integration then shows as disconnected **in Elementary**.

Either way, you can reconnect later from the welcome message or by typing
**`@Elementary connect`** in the channel.

> [!NOTE]
>
> Each Teams team can be connected to a single Elementary account. If a team is
> already connected to a different account, connecting it again is rejected.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.