Microsoft Teams

Monte Carlo integrates directly with Microsoft Teams through an app available in the Microsoft Teams Store. It allows anomaly detections to be sent to any public channel in your workspace for quick triage and collaboration. This guide explains how to receive notifications from Monte Carlo in Microsoft Teams — see Permissions for alert actions to control who can act on them.

More context about this app is available in Microsoft's documentation.

Integration Setup

1. Go to Settings > Integrations to Add a new Integration.

2. Scroll down to the Notifications and Collaboration section. Click Create and select Microsoft Teams. You will be redirected to the Teams Store to install the Monte Carlo app for Teams.

3. In the Monte Carlo Data app (in the Microsoft Teams Store), press the Add to team button.

   🚧

   The app may require approval from your IT Admin. If that’s the case, press the Request approval button, and your IT Admin will need to approve it (you can refer to this guide from Microsoft).

   You can review the permissions that will be granted to the app in the Permissions tab. The app’s manifest requests the following permissions: ChannelMessage.Read.Group, TeamsActivity.Send.Group, and ChannelSettings.Read.Group.

4. Then, select a channel within the team where you want to integrate Monte Carlo. This channel will only be used to send a welcome message, which is necessary to complete the integration.

   📘

   Note 1: The welcome message will only be sent if the app is not already installed for the team. If it is already installed, you will need to uninstall it and then add it again to receive the welcome message.

   Note 2: You can repeat this process multiple times to install the app in multiple teams.

   Note 3: To ensure Monte Carlo can send the welcome message, the channel’s moderation settings should allow anyone to post messages.

5. You will receive the welcome message in the selected channel. To complete the integration, press the Complete Setup button at the bottom of the message. It’ll open Monte Carlo and associate the Teams app with your Monte Carlo account.

   

6. After completing the linking process, you will see the new Microsoft Teams integration in the Notifications and Collaboration section (in Settings > Integrations)

7. Now you can use it as a recipient channel to send notifications to your audience there

Configure Microsoft Teams as Recipient Channel

1. Go to Settings > Notifications.

2. Create an audience or edit an existing one.

3. Define a new recipient channel and select Microsoft Teams.

4. Select the channel where you want to send notifications to the audience.

   📘

   Duplicate channel names

   If you have multiple teams integrated, you will see all the channels. If there is a channel with the same name in different teams, a suffix is added to the channel name to indicate the team it belongs to.

5. Finally, you can send a Test Notification and check if it is received on the channel; or you can add the recipient channel and save the audience.

Permissions for alert actions

Alerts in Microsoft Teams are interactive — a user can change status, assign an owner, change severity, snooze, or troubleshoot. By default, any user in a connected channel can do this, even without a Monte Carlo account.

To limit alert actions to Monte Carlo users — and to only the actions each user's role permits — an Account Owner can enable permission enforcement. When enabled, it applies account-wide, to all Microsoft Teams and Slack integrations.

Enable permission enforcement

1. Go to Settings > Integrations.
2. Open your Microsoft Teams integration.
3. Turn on Require Monte Carlo permissions for alert actions.

Once enabled, acting on an alert requires:

• A Microsoft account with an email Monte Carlo can read.
• An active Monte Carlo user with that same email.
• A role that permits the action — the same check Monte Carlo applies in the app.

Guests, external users, and bots are always blocked. If a user is unexpectedly blocked, check that their Monte Carlo email matches their Microsoft email.

Triage results on your alerts

When the Triage Agent is enabled for your account, alerts sent to Microsoft Teams carry their assessment directly on the alert card:

• Priority on the title — a colored dot marks the alert's priority: 🔴 high, 🟠 medium, 🔵 low.
• Agent summary in the thread — the agent posts a reply with the incident likelihood, the impact, and a short read on the likely cause.

If an alert is later re-assessed into a new priority, the dot updates in place and a short reply explains what changed; nothing is posted when the priority is unchanged. See the Triage Agent for how scoring and re-assessment work.

Migrate old integrations using Incoming Webhooks

Previously, Microsoft Teams was integrated using the Incoming Webhook connector. Microsoft has deprecated these connectors (more information with dates here). If you have recipient channels defined with the previous Microsoft Teams integration, you will see a message indicating that they must be migrated as shown below (however, you will still receive notifications through that channel while Microsoft keeps this functionality working).

To migrate, follow the guide above to configure the new app in Microsoft Teams. Then, update the defined Microsoft Teams recipient channels in the audiences by selecting the new Microsoft Teams integration (you need to change Microsoft Teams (deprecated) to Microsoft Teams in Recipient channel). Finally, choose the channel where you want to send notifications. Once you save these changes, new notifications will use the new integration.