diff --git a/docs/_snippets/setup-teams-integration.mdx b/docs/_snippets/setup-teams-integration.mdx index 9780e3c97..dd9aa0a70 100644 --- a/docs/_snippets/setup-teams-integration.mdx +++ b/docs/_snippets/setup-teams-integration.mdx @@ -34,11 +34,13 @@ Call it `Elementary` (or whatever you prefer) and connect it to the workspace of -Now it is time to setup the webhook for this channel. +Now it's time to set up a webhook. You have two options for creating a webhook: - + -## Create a webhook +## Create a webhook using Connectors + +**Note:** Microsoft 365 Connectors are set to be deprecated end of 2025. Consider using Power Automate Workflows (Option 2) for new integrations. Go to a channel in your Team and choose `Manage channel` @@ -61,6 +63,7 @@ Search for `Incoming webhook` and choose `Add`. alt="Teams add incoming webhook" /> + Choose `Add` again and add name your webhook `ElementaryWebhook` (or whatever you prefer). And `Create` the webhook. -Lastly, pass the webhook to the CLI as a param or in the `config.yml` file: + + +## Create a webhook using Power Automate + +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](https://flow.microsoft.com) +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 Notes:** + +- 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 delivery issues. +- Workflows can't post in private channels as a flow bot, but can post on behalf of a user +- Workflows can only be created in your default environment + + + +Lastly, pass the webhook URL (from either method) to the CLI as a param or in the `config.yml` file: diff --git a/docs/cloud/integrations/alerts/ms-teams.mdx b/docs/cloud/integrations/alerts/ms-teams.mdx index b359e91ac..a9caf1f1d 100644 --- a/docs/cloud/integrations/alerts/ms-teams.mdx +++ b/docs/cloud/integrations/alerts/ms-teams.mdx @@ -3,6 +3,7 @@ title: "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](/features/alerts-and-incidents/alert-rules) to distribute alerts to different channels and destinations. @@ -30,30 +31,29 @@ The alerts include rich context, and you can create [alert rules](/features/aler -3. For each MS Teams channel you connect to Elementary, you will need to create a Webhook. +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: - - 1. Go to a channel in your Team and choose `Manage channel` + +1. Go to a channel in your Team and choose `Manage channel`
Teams manage channel
- 2. Click on `Edit` connectors.
Teams edit connectors
@@ -63,9 +63,9 @@ The alerts include rich context, and you can create [alert rules](/features/aler
Teams add incoming webhook
@@ -74,11 +74,11 @@ The alerts include rich context, and you can create [alert rules](/features/aler
- + Teams create webhook
@@ -86,17 +86,43 @@ width="400"
- + Teams copy URL 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. + + +You can create a webhook using Power Automate in two ways: + +### Method 1: Directly from Teams + +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](https://flow.microsoft.com) +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: @@ -112,11 +138,12 @@ width="400" 5. Select a default channel for alerts, and set the suppression interval. -The default channel you select will automatically add a default [alert rule](/features/alerts-and-incidents/alert-rules) -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. + The default channel you select will automatically add a default [alert + rule](/features/alerts-and-incidents/alert-rules) 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. -