Microsoft Teams

This document provides a step-by-step guide for integrating your MikroCloud portal with Microsoft Teams using webhooks. This integratin allows you to receive notifications about faults on your devices from MikroCloud directly to your Microsoft Teams channels.

Prerequisites

• Access to a Microsoft Teams workspace with permissions to manage channels and add connectors.

Setting up the Microsoft Teams Webhook

Now, let's get the webhook integration up and running.

Step 1: Create Webhook

1. Open Microsoft Teams and navigate to the channel where you want to receive the notifications.
2. Right-Click on the channel name and select Manage Channel.

3. Expand the Connectors section within the channel settings menu.
4. Click on Edit to open the connectors configuration page.

5. On the new page, search for Incomming Webhook in the search bar.
6. Click Add Next to the Incomming Webhook integration option.
7. On the new page, you will have to click on Add again.

After clicking Add, you will be redirected to a configuration page where you can set up the webhook.

8. On the configuration page, click Configure to start setting up the webhook.

9. Give the webhook a name (e.g. "MikroCloud Notifications") and customize the image if needed.
10. Click Create to finalize the configuration.

11. Copy the webhook URL that is provided.

Step 2: Integrate your Webhook with MikroCloud:

1. From your MikroCloud Dashboard, navigate to Notifications -> Integrations.

2. On the Integrations page, paste the Microsoft Teams webhook URL that you copied earlier into the Teams Notifications textbox.

Step 3: Test your Integration

1. Click on the Test button next to your webhook URL to send a test message to your specified Teams channel.
2. Go to your Microsoft Teams channel and wait for the test message to arrive.
   • If it did arrive, the message will look something like this:
   
   
   • If it did not arrive, refer to this documentation.

Your MS Teams integration is now successfully set up; if any one of your devices experiences a fault, you will be notified from within your Teams channel.

Troubleshooting your MikroCloud-Teams Integration

• Verify that your webhook URL is correct.
• Verify that your MS Teams channel allows external connections.
• Verify that your MS Teams application is updated.
• Contact support should you still experience any issues.