Integrate with Microsoft Teams
On this page
- OAuth 2.0 authentication for programmatic access to Cloud Manager is available as a Preview feature.
- The feature and the corresponding documentation might change at any time during the Preview period. To use OAuth 2.0 authentication, create a service account to use in your requests to the Cloud Manager Public API.
You can integrate Cloud Manager with Microsoft Teams to receive alerts in your Microsoft Teams channel.
Prerequisites
To integrate Cloud Manager with Microsoft Teams and receive alerts in your Microsoft Teams channel, you must have a Microsoft Teams account.
Procedure
To integrate Cloud Manager with Microsoft Teams and receive alerts in your Microsoft Teams channel:
Important
Required Privileges
To manage all organization alerts, you must have the
Organization Owner role for the organization.
The Organization Billing Admin role grants a
limited authorization to manage billing alerts.
Create the Microsoft Teams incoming webhook.
Navigate to the Microsoft Teams channel where you want to add the webhook.
Select from the top navigation bar. A dropdown menu of available options displays.
Select Connectors from the dropdown menu. A modal with available connectors displays.
Search for Incoming Webhook and select Add. A modal with information about the Incoming Webhook connector displays.
Click Add. The modal closes.
Select from the top navigation bar. A dropdown menu of available options displays.
Select Connectors from the dropdown menu. The modal with available connectors displays.
Search for Incoming Webhook and select Configure. A configuration modal displays.
In the modal, enter a name for your webhook. Optionally, you can upload a unique image to help you identify your webhook.
Click Create.
Copy the incoming webhook URL.
Important
Cloud Manager requires this URL to configure the integration.
Click Done.
In MongoDB Cloud Manager, go to the Organization Settings page.
If it's not already displayed, select your desired organization from the Organizations menu in the navigation bar.
Click the Organization Settings icon next to the Organizations menu.
The Organization Settings page displays.
Go to the Organization Alerts page.
Click Alerts in the sidebar.
The Organization Alerts page displays.
Configure the Microsoft Teams integration.
Under the Add Notification Method heading, click the button for Microsoft Teams.
Enter the incoming webhook URL in the provided text box.
To test the integration, click Post Test Alert.
Under Recurrence, set the recurrence conditions in the provided text boxes.
Click Add.
Important
Required Privileges
To manage project alerts, you must have the
Project Owner role for the project.
Create the Microsoft Teams incoming webhook.
Navigate to the Microsoft Teams channel where you want to add the webhook.
Select from the top navigation bar. A dropdown menu of available options displays.
Select Connectors from the dropdown menu. A modal with available connectors displays.
Search for Incoming Webhook and select Add. A modal with information about the Incoming Webhook connector displays.
Click Add. The modal closes.
Select from the top navigation bar. A dropdown menu of available options displays.
Select Connectors from the dropdown menu. The modal with available connectors displays.
Search for Incoming Webhook and select Configure. A configuration modal displays.
In the modal, enter a name for your webhook. Optionally, you can upload a unique image to help you identify your webhook.
Click Create.
Copy the incoming webhook URL.
Important
Cloud Manager requires this URL to configure the integration.
Click Done.
In MongoDB Cloud Manager, go to the Project Integrations page.
If it's not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
If it's not already displayed, select your desired project from the Projects menu in the navigation bar.
Next to the Projects menu, expand the Options menu, then click Integrations.
The Project Integrations page displays.
In MongoDB Cloud Manager, go to the Project Alerts page.
If it's not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
If it's not already displayed, select your desired project from the Projects menu in the navigation bar.
Do one of the following steps:
Click the Project Alerts icon in the navigation bar.
Next to the Projects menu, expand the Options menu, click Project Settings, and click Alerts in the sidebar.
The Project Alerts page displays.
Choose whether to create a new alert setting or clone an existing one.
To create a new alert without cloning an existing setting:
Click Add.
Select New Alert.
To clone an existing alert setting:
Click the Alert Settings tab.
Locate the alert setting you want to clone.
Click then Clone in that alert setting's row.
Select the alert recipients and delivery methods. In the Send to section:
(Optional) To help reduce the false positives that Cloud Manager sends, in the send if condition lasts at least field, specify the minutes to elapse before the condition sends the alert. The next alert check that runs after the specified time elapses sends the alert.
(Optional) In the resend after field, specify the minutes to elapse before the condition resends the alert.
Click Add and select Microsoft Teams.