Added documentation how to setup the Microsoft Teams alerting

docs/_snippets/setup-teams-integration.mdx

@@ -0,0 +1,108 @@
+First create a Microsoft Teams team:
+
+<Accordion title="Create a new Team">
+
+## Create a new Team
+
+Go to the Microsoft Teams desktop app and create a new team.
+
+<img
+  src="https://res.cloudinary.com/dgxyrldax/image/upload/v1707202577/ghoizqzywicyipr7nbrm.png"
+  alt="Microsoft Teams team"
+/>
+
+Create a team from from a template and use the `From Scratch` template.
+
+<img
+  src="https://res.cloudinary.com/dgxyrldax/image/upload/v1707202897/dhftnz4zc0jsuay6eh2c.png"
+  alt="Microsoft Teams template"
+/>
+
+Choose `Public` as the kind of a team.
+
+<img
+  src="https://res.cloudinary.com/dgxyrldax/image/upload/v1707203017/s2buhk5yncmortzlvge5.png"
+  alt="Microsoft Teams public team"
+/>
+
+Call it `Elementary` (or whatever you prefer) and connect it to the workspace of your choice.
+
+<img
+  src="https://res.cloudinary.com/dgxyrldax/image/upload/v1707203137/jw2wgscz9cruarapmzpj.png"
+  alt="Microsoft Teams Elementary team"
+/>
+
+</Accordion>
+
+Now it is time to setup the webhook for this channel.
+
+<Accordion title="Create Teams Webhook">
+
+## Create a webhook
+
+Go to a channel in your Team and choose `Manage channel`
+
+<img
+  src="https://res.cloudinary.com/dgxyrldax/image/upload/v1707203620/npn3p0tsmdvk723etyxn.png"
+  alt="Teams manage channel"
+/>
+
+Choose `Edit` connectors.
+
+<img
+  src="https://res.cloudinary.com/dgxyrldax/image/upload/v1707203932/utnld7rzvgiwfgumzhtv.png"
+  alt="Teams edit connectors"
+/>
+
+Search for `Incoming webhook` and choose `Add`.
+
+<img
+  src="https://res.cloudinary.com/dgxyrldax/image/upload/v1707204047/esvfhescsxgttanzv3kx.png"
+  alt="Teams add incoming webhook"
+/>
+
+Choose `Add` again and add name your webhook `ElementaryWebhook` (or whatever you prefer). And `Create` the webhook.
+
+<img
+  src="https://res.cloudinary.com/dgxyrldax/image/upload/v1707204465/mcncjpvsnptd0gcsbb21.png"
+  alt="Teams create webhook"
+/>
+
+Copy the URL of the webhook.
+
+<img
+  src="https://res.cloudinary.com/dgxyrldax/image/upload/v1707204718/gkt2uhz2qaow1lm1frnp.png"
+  alt="Teams copy URL webhook"
+/>
+
+</Accordion>
+
+Lastly, pass the webhook to the CLI as a param or in the `config.yml` file:
+
+<Accordion title="Teams config as CLI params">
+
+## Webhook:
+
+Use the webhook URL when you execute edr monitor using the option `-tw, --teams-webhook`:
+
+```shell
+edr monitor --teams-webhook <your_teams_webhook_url>
+```
+
+</Accordion>
+
+<Accordion title="Teams config as in config.yml">
+
+The CLI reads the Teams integration from a file, copy it into a file called config.yml.
+Create it here: `HOME_DIR/.edr/config.yml`
+
+Here is the format in the yml itself:
+
+## Webhook:
+
+```yml config.yml
+teams:
+  teams_webhook: <your_teams_webhook_url>
+```
+
+</Accordion>

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

@@ -0,0 +1,22 @@
+---
+title: "Teams setup for Elementary CLI"
+sidebarTitle: "Teams"
+---
+
+Elementary Teams integration includes sending [Teams alerts](/oss/guides/send-teams-alerts) on failures in dbt tests and models.
+
+## 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.
+
+| Integration   | Elementary alerts | Elementary report | Multiple channels | Slack workflows |
+| ------------- | ----------------- | ----------------- | ----------------- | --------------- |
+| Teams Webhook | ✅                | ❌                | ❌                | ❌              |
+| Slack Token   | ✅                | ✅                | ✅                | ❌              |
+| Slack Webhook | ✅                | ❌                | ❌                | ✅              |
+
+## Teams integration setup
+
+<Snippet file="setup-teams-integration.mdx" />

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

@@ -0,0 +1,50 @@
+---
+title: "Setup Teams alerts"
+---
+
+<Snippet file="alerts/alerts-introduction.mdx" />
+
+## Setup Teams Integration
+
+<Info>
+
+**Before you start**
+
+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.**
+
+<br />
+</Info>
+
+<Snippet file="setup-teams-integration.mdx" />
+
+## Execute the CLI
+
+Make sure to run the following command after your dbt runs and tests:
+
+```
+edr monitor --teams-webhook <your_teams_webhook> --group-by [table | alert]
+```
+
+Or just `edr monitor` if you used `config.yml`.
+
+---
+
+## Alert on source freshness failures
+
+_Not supported in dbt cloud_
+
+To alert on source freshness, you will need to run `edr run-operation upload-source-freshness` right after each execution of `dbt source freshness`.
+This operation will upload the results to a table, and the execution of `edr monitor` will send the actual alert.
+
+- Note that `dbt source freshness` and `upload-source-freshness` needs to run from the same machine.
+- Note that `upload-source-freshness` requires passing `--project-dir` argument.
+
+## Continuous alerting
+
+In order to monitor continuously, use your orchestrator to execute it regularly (we recommend running it right after
+your dbt job ends to monitor the latest data updates).
+
+Read more about how to deploy [Elementary in production](/oss/deployment-and-configuration/elementary-in-production).
+If you need help or wish to consult on this, reach out to us
+on [Slack](https://elementary-data.com/community).

elementary/monitor/data_monitoring/alerts/integrations/slack/slack.py

@@ -29,11 +29,10 @@
     list_of_lists_of_strings_to_comma_delimited_unique_strings,
 )
 from elementary.utils.log import get_logger
+from elementary.utils.strings import prettify_and_dedup_list
 
 logger = get_logger(__name__)
 
-from elementary.utils.strings import prettify_and_dedup_list
-
 TABLE_FIELD = "table"
 COLUMN_FIELD = "column"
 DESCRIPTION_FIELD = "description"