adds docs for cloud MS Teams integration (#16834)

Co-authored-by: Ilya Mashchenko <ilya@netdata.cloud>

1 files changed, 50 insertions, 0 deletions

diff --git a/integrations/cloud-notifications/metadata.yaml b/integrations/cloud-notifications/metadata.yaml
index 4c5e0c56ac..01810d3016 100644
--- a/integrations/cloud-notifications/metadata.yaml
+++ b/integrations/cloud-notifications/metadata.yaml
@@ -360,6 +360,56 @@
           - Finally, click on **Create topic** on the bottom of the page
       3. Now, use the new **Topic ARN** while adding AWS SNS integration on your space.
 
+- id: 'notify-cloud-microsoftteams'
+  meta:
+    name: 'Microsoft Teams'
+    link: 'https://www.microsoft.com/en-us/microsoft-teams'
+    categories:
+      - notify.cloud
+    icon_filename: 'teams.svg'
+  keywords:
+    - microsoft
+    - teams
+  overview:
+    notification_description: "From the Netdata Cloud UI, you can manage your space's notification settings and enable the configuration to deliver notifications to a Microsoft Teams channel."
+    notification_limitations: ''
+  setup:
+    description: |
+      ### Prerequisites
+
+      To add Microsoft Teams notifications integration to your Netdata Cloud space you will need the following:
+
+      - A Netdata Cloud account.
+      - Access to the Netdata Cloud space as an **administrator**.
+      - The Space to be on **Business** plan or higher.
+      - A [Microsoft 365 for Business Account](https://www.microsoft.com/en-us/microsoft-365/business). Note that this is a **paid** account.
+
+      ### Settings on Microsoft Teams
+     
+      - The integration gets enabled at a team's channel level.
+      - Click on the `...` (aka three dots) icon showing up next to the channel name, it should appear when you hover over it.
+      - Click on `Connectors`.
+      - Look for the `Incoming Webhook` connector and click configure.
+      - Provide a name for your Incoming Webhook Connector, for example _Netdata Alerts_. You can also customize it with a proper icon instead of using the default image.
+      - Click `Create`.
+      - The _Incoming Webhook URL_ is created.
+      - That is the URL to be provided to the Netdata Cloud configuration.
+
+      ### Settings on Netdata Cloud
+
+      1. Click on the **Space settings** cog (located above your profile icon).
+      2. Click on the **Notification** tab.
+      3. Click on the **+ Add configuration** button (near the top-right corner of your screen).
+      4. On the **Microsoft Teams** card click on **+ Add**.
+      5. A modal will be presented to you to enter the required details to enable the configuration:
+        * **Notification settings** are Netdata specific settings:
+            - Configuration name - you can optionally provide a name for your configuration  you can easily refer to it.
+            - Rooms - by specifying a list of Rooms you are select to which nodes or areas of your infrastructure you want to be notified using this configuration.
+            - Notification - you specify which notifications you want to be notified using this configuration: All Alerts and unreachable, All Alerts, Critical only.
+        * **Integration configuration** are the specific notification integration required settings, which vary by notification method. For Microsoft Teams:
+            - Microsoft Teams Incoming Webhook URL - the _Incoming Webhook URL_ that was generated earlier.
+
+
 - id: 'notify-cloud-telegram'
   meta:
     name: 'Telegram'