Navigation
You were redirected from a different version of the documentation. Click here to go back.

Integrate with Microsoft Teams

On this page

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.

1

Create the Microsoft Teams incoming webhook.

  1. Navigate to the Microsoft Teams channel where you want to add the webhook.

  2. Select ellipsis h icon from the top navigation bar. A dropdown menu of available options displays.

  3. Select Connectors from the dropdown menu. A modal with available connectors displays.

  4. Search for Incoming Webhook and select Add. A modal with information about the Incoming Webhook connector displays.

  5. Click Add. The modal closes.

  6. Select ellipsis h icon from the top navigation bar. A dropdown menu of available options displays.

  7. Select Connectors from the dropdown menu. The modal with available connectors displays.

  8. Search for Incoming Webhook and select Configure. A configuration modal displays.

  9. In the modal, enter a name for your webhook. Optionally, you can upload a unique image to help you identify your webhook.

  10. Click Create.

  11. Copy the incoming webhook URL.

    Important

    Cloud Manager requires this URL to configure the integration.

  12. Click Done.

2

Navigate to the Alerts page for your organization.

  1. If it is not already displayed, select your desired organization from the office icon Organizations menu in the navigation bar.
  2. Click Alerts in the sidebar.
3

Choose whether to create a new alert setting or clone an existing one.

To create a new alert:

  1. Click Add Alert.

To clone an existing alert setting:

  1. Click the Alert Settings tab.
  2. Locate the alert setting you want to clone.
  3. Click ellipsis h icon then Clone in that alert setting’s row.
4

Choose the Target.

Click one of the options under Select a Target.

5

Choose the Condition.

6

Configure the Microsoft Teams integration.

  1. Under the Add Notification Method heading, click the button for Microsoft Teams.
  2. Enter the incoming webhook URL in the provided text box.
  3. To test the integration, click Post Test Alert.
  4. Under Recurrence, set the recurrence conditions in the provided text boxes.
  5. Click Add.

Important

Required Privileges

To manage project alerts, you must have the Project Owner role for the project.

1

Create the Microsoft Teams incoming webhook.

  1. Navigate to the Microsoft Teams channel where you want to add the webhook.

  2. Select ellipsis h icon from the top navigation bar. A dropdown menu of available options displays.

  3. Select Connectors from the dropdown menu. A modal with available connectors displays.

  4. Search for Incoming Webhook and select Add. A modal with information about the Incoming Webhook connector displays.

  5. Click Add. The modal closes.

  6. Select ellipsis h icon from the top navigation bar. A dropdown menu of available options displays.

  7. Select Connectors from the dropdown menu. The modal with available connectors displays.

  8. Search for Incoming Webhook and select Configure. A configuration modal displays.

  9. In the modal, enter a name for your webhook. Optionally, you can upload a unique image to help you identify your webhook.

  10. Click Create.

  11. Copy the incoming webhook URL.

    Important

    Cloud Manager requires this URL to configure the integration.

  12. Click Done.

2

Navigate to the Integrations page for your project.

  1. If it is not already displayed, select the organization that contains your desired project from the office icon Organizations menu in the navigation bar.
  2. If it is not already displayed, select your desired project from the Projects menu in the navigation bar.
  3. Next to the Projects menu, expand the Options menu, then click Integrations.
3

Configure the Microsoft Teams integration.

  1. Search for Microsoft Teams and click Configure. A configuration modal displays.
  2. Enter the incoming webhook URL in the provided text box.
  3. To test the integration, click Test Integration.
  4. Click Activate.
4

Navigate to the Alerts page for your project.

  1. If it is not already displayed, select the organization that contains your desired project from the office icon Organizations menu in the navigation bar.
  2. If it is not already displayed, select your desired project from the Projects menu in the navigation bar.
  3. Click the bell icon Project Alerts icon in the navigation bar, or click Alerts in the sidebar.
5

Choose whether to create a new alert setting or clone an existing one.

To create a new alert without cloning an existing setting:

  1. Click Add.
  2. Select New Alert.

To clone an existing alert setting:

  1. Click the Alert Settings tab.
  2. Locate the alert setting you want to clone.
  3. Click ellipsis h icon then Clone in that alert setting’s row.
6

Select the condition that triggers the alert.

In the Alert if section, select the target component and the condition.

7

Apply the alert only to specific targets. (Optional)

If the options in the For section are available, you can optionally filter the alert to apply only to a subset of the targets.

The matches field can use regular expressions.

8

Select the alert recipients and delivery methods.

In the Send to section:

  1. (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.
  2. (Optional) In the resend after field, specify the minutes to elapse before the condition resends the alert.
  3. Click Add and select Microsoft Teams.
9

Click Save.

© MongoDB, Inc 2008-present. MongoDB, Mongo, and the leaf logo are registered trademarks of MongoDB, Inc.