Ele 4028 messaging integ

dev-requirements.txt

@@ -16,6 +16,5 @@ types-pytz
 types-jsonschema
 types-PyYAML
 types-setuptools
-pandas-stubs
 types-retry
 types-decorator

docs/_snippets/setup-teams-integration.mdx

@@ -34,11 +34,13 @@ Call it `Elementary` (or whatever you prefer) and connect it to the workspace of
 
 </Accordion>
 
-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:
 
-<Accordion title="Create Teams Webhook">
+<Accordion title="Option 1: Create Teams Webhook using Connectors (Legacy)">
 
-## Create a webhook
+## Create a webhook using Connectors
+
+**Note:** Microsoft 365 Connectors are being deprecated. Consider using Power Automate Workflows (Option 2) for new integrations.
 
 Go to a channel in your Team and choose `Manage channel`
 
@@ -77,7 +79,38 @@ Copy the URL of the webhook.
 
 </Accordion>
 
-Lastly, pass the webhook to the CLI as a param or in the `config.yml` file:
+<Accordion title="Option 2: Create Teams Webhook using Power Automate (Recommended)">
+
+## 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
+
+</Accordion>
+
+Lastly, pass the webhook URL (from either method) to the CLI as a param or in the `config.yml` file:
 
 <Accordion title="Teams config as CLI params">
 

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
   </div>
 </Frame>
 
-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:
 
-<Accordion title="How to create a Microsoft Teams webhook?">
-  1. Go to a channel in your Team and choose `Manage channel`
+<Accordion title="Option 1: Using Microsoft Teams Connectors (Legacy)">
+1. Go to a channel in your Team and choose `Manage channel`
 
 <Frame>
   <div className="dark:bg-white rounded-md p-1">
     <img
-        src="https://res.cloudinary.com/dgxyrldax/image/upload/v1707203620/npn3p0tsmdvk723etyxn.png"
-        alt="Teams manage channel"
-        width="400"
+      src="https://res.cloudinary.com/dgxyrldax/image/upload/v1707203620/npn3p0tsmdvk723etyxn.png"
+      alt="Teams manage channel"
+      width="400"
     />
   </div>
 </Frame>
 
-
 2. Click on `Edit` connectors.
 
 <Frame>
   <div className="dark:bg-white rounded-md p-1">
     <img
-        src="https://res.cloudinary.com/dgxyrldax/image/upload/v1707203932/utnld7rzvgiwfgumzhtv.png"
-        alt="Teams edit connectors"
-        width="500"
+      src="https://res.cloudinary.com/dgxyrldax/image/upload/v1707203932/utnld7rzvgiwfgumzhtv.png"
+      alt="Teams edit connectors"
+      width="500"
     />
   </div>
 </Frame>
@@ -63,9 +63,9 @@ The alerts include rich context, and you can create [alert rules](/features/aler
 <Frame>
   <div className="dark:bg-white rounded-md p-1">
     <img
-    src="https://res.cloudinary.com/dgxyrldax/image/upload/v1707204047/esvfhescsxgttanzv3kx.png"
-    alt="Teams add incoming webhook"
-    width="400"
+      src="https://res.cloudinary.com/dgxyrldax/image/upload/v1707204047/esvfhescsxgttanzv3kx.png"
+      alt="Teams add incoming webhook"
+      width="400"
     />
   </div>
 </Frame>
@@ -74,29 +74,55 @@ The alerts include rich context, and you can create [alert rules](/features/aler
 
 <Frame>
   <div className="dark:bg-white rounded-md p-1">
-<img
-src="https://res.cloudinary.com/dgxyrldax/image/upload/v1707204465/mcncjpvsnptd0gcsbb21.png"
-alt="Teams create webhook"
-width="400"
-/>
+    <img
+      src="https://res.cloudinary.com/dgxyrldax/image/upload/v1707204465/mcncjpvsnptd0gcsbb21.png"
+      alt="Teams create webhook"
+      width="400"
+    />
   </div>
 </Frame>
 
 5. Copy the URL of the webhook.
 
 <Frame>
   <div className="dark:bg-white rounded-md p-1">
-<img
-src="https://res.cloudinary.com/dgxyrldax/image/upload/v1707204718/gkt2uhz2qaow1lm1frnp.png"
-alt="Teams copy URL webhook"
-width="400"
-/>
+    <img
+      src="https://res.cloudinary.com/dgxyrldax/image/upload/v1707204718/gkt2uhz2qaow1lm1frnp.png"
+      alt="Teams copy URL webhook"
+      width="400"
+    />
   </div>
 </Frame>
 
+**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.
 
 </Accordion>
 
+<Accordion title="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](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.
+
+  </Accordion>
+
 4. Configure your Microsoft Teams webhooks, and give each one a name indicating it's connected channel:
 
 <Frame>
@@ -112,17 +138,18 @@ width="400"
 5. Select a default channel for alerts, and set the suppression interval.
 
 <Note>
-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.
 </Note>
 
-
 <Frame>
   <div className="dark:bg-white rounded-md p-1">
     <img
       src="https://res.cloudinary.com/diuctyblm/image/upload/v1719906740/ms_teams_select_channel_and_suppression_vtbsks.png"
       alt="Select channel and suppression interval"
-width="800"
+      width="800"
     />
   </div>
 </Frame>

docs/oss/deployment-and-configuration/teams.mdx

@@ -3,17 +3,23 @@ title: "Teams setup for Elementary CLI"
 sidebarTitle: "Teams"
 ---
 
-Elementary Teams integration includes sending [Teams alerts](/oss/guides/alerts/send-teams-alerts) on failures in dbt tests and models.
+Elementary Teams integration includes sending [Teams alerts](/oss/guides/alerts/send-teams-alerts) on failures in dbt tests and models. The alerts are sent using Microsoft Teams Adaptive Cards format, which provides rich formatting and interactive capabilities.
 
 ## Integration options
 
-There is one integration option for Microsoft Teams: a Webhook. This method let you receive alerts from Elementary, but lacks
-some support that is available in the Slack integration solution.
-Below is features support comparison table (with Slack), to help you select the integration method.
+There are two ways to create a webhook for Microsoft Teams:
 
-| Integration   | Elementary alerts | Elementary report | Multiple channels | Slack workflows |
-| ------------- | ----------------- | ----------------- | ----------------- | --------------- |
-| Teams Webhook | ✅                | ❌                | ❌                | ❌              |
+1. **Microsoft Teams Connectors (Legacy)**: The traditional way of creating webhooks, but this method is being deprecated by Microsoft.
+2. **Power Automate Workflows (Recommended)**: The newer, more flexible way to create webhooks. Note that when using this method, Elementary CLI cannot directly verify if messages were delivered - you'll need to monitor your workflow runs in Power Automate.
+
+Below is a features support comparison table (with Slack), to help you select the integration method.
+
+| Integration              | Elementary alerts | Elementary report | Multiple channels |
+| ------------------------ | ----------------- | ----------------- | ----------------- |
+| Teams Connector (Legacy) | ✅                | ❌                | ❌                |
+| Power Automate Workflows | ✅                | ❌                | ❌                |
+
+**Note:** Microsoft 365 Connectors (previously called Office 365 Connectors) are nearing deprecation. We recommend using Power Automate Workflows for new integrations.
 
 ## Teams integration setup
 

docs/oss/guides/alerts/send-teams-alerts.mdx

@@ -9,6 +9,8 @@ title: "Setup Teams alerts"
 Before you can start using the alerts, make sure to [install the dbt package](/oss/quickstart/quickstart-cli-package), [configure a profile and install the CLI](/oss/quickstart/quickstart-cli).
 This is **required for the alerts to work.**
 
+Elementary sends alerts using Microsoft Teams Adaptive Cards format, which provides rich formatting and interactive capabilities. You can create a webhook URL using either Microsoft Teams Connectors (legacy, being deprecated) or Power Automate Workflows (recommended).
+
 <br />
 </Info>