Microsoft Teams

Elementary’s Microsoft Teams integration enables sending alerts when data issues happen. The alerts are sent using Adaptive Cards format, which provides rich formatting and interactive capabilities.

The alerts include rich context, and you can create alert rules to distribute alerts to different channels and destinations.

Enabling Microsoft Teams alerts

1. Go to the Environments page on the sidebar.
2. Select an environment and click connect on the Connect messaging app card (first card), and select Microsoft Teams.

3. For each MS Teams channel you connect to Elementary, you will need to create a Webhook. There are two ways to create a webhook:

Option 1: Using Microsoft Teams Connectors (Legacy)

1. Go to a channel in your Team and choose Manage channel

2. Click on Edit connectors.

3. Search for Incoming webhook and choose Add.

4. Choose Add again and add a name to your webhook, then click on Create.

5. Copy the URL of the webhook.

Note: Microsoft 365 Connectors (previously called Office 365 Connectors) are nearing deprecation, and the creation of new Microsoft 365 Connectors will soon be blocked. Consider using Power Automate Workflows instead.

Option 2: Using Power Automate Workflows (Recommended)

You can create a webhook using Power Automate in two ways:

Method 1: Directly from Teams (Recommended)

1. Go to your Teams channel
2. Click the three dots (…) next to the channel name
3. Select Workflows
4. Choose the template “Post to channel when a webhook request is received”
5. Copy the webhook URL

Method 2: From Power Automate Website

1. Go to Power Automate
2. Create a new instant cloud flow
3. Search for “When a HTTP request is received” as your trigger
4. In the flow, add a “Post adaptive card in a chat or channel” action
5. Configure the team and channel where you want to post
6. Save the flow and copy the HTTP POST URL

Important Note: When using Power Automate Workflows, Elementary CLI cannot directly verify if messages were successfully delivered. You’ll need to monitor your workflow runs in Power Automate to check for any errors.

4. Configure your Microsoft Teams webhooks, and give each one a name indicating it’s connected channel:

5. Select a default channel for alerts, and set the suppression interval.

The default channel you select will automatically add a default alert rule to sends all failures to this channel. Alerts on warnings are not sent by default. To modify and add tules, navigate to Alert Rules page.