Microsoft Teams

Overview

Integrate with Microsoft Teams to:

  • Be notified of Datadog alerts and events in Microsoft Teams.
  • Manage incidents from within Microsoft Teams.
  • Mute triggered monitors directly from Microsoft Teams.

  • Be notified of Datadog alerts and events in Microsoft Teams.
  • Mute triggered monitors directly from Microsoft Teams.

Setup

    Send monitor notifications to a Microsoft Teams channel

    Connect your Microsoft tenant to Datadog.

    1. In Datadog, navigate to Integrations > Microsoft Teams.
    2. Click Add Tenant, which redirects you to Microsoft.
    3. Follow the prompts and click OK.

    Ensure you have added the Datadog app to all teams where you want to receive Datadog notifications.

    Ensure you have added the Datadog for Government app to all teams where you want to receive Datadog notifications.

    1. Open Microsoft Teams.
    2. In the vertical toolbar, click Apps.
    3. Search for “Datadog” and click on Open.
    4. In the modal that opens, select the primary channel of the team where the app should be added. Click Go to complete the installation.

    1. Open Microsoft Teams.
    2. In the vertical toolbar, click Apps.
    3. Search for “Datadog for Government” and click on Open.
    4. In the modal that opens, select the primary channel of the team where the app should be added. Click Go to complete the installation.

    Microsoft Teams Add App to Team

    Microsoft Teams Add App to Team

    Once the bot has been added to the team, configure the notification handle in Datadog.

    1. Under a configured tenant, click Add Handle. Give the handle a name, select the desired team and channel from the drop-down menus, and click Save.

    Migrate legacy connectors to tenant-based integration

    Microsoft has announced that Office 365 connectors for Microsoft Teams are being deprecated. This has the following effects:

    • All Datadog Connectors will stop working on January 31, 2025.
    • Incoming Webhook Connectors without updated URLs will stop working on January 31, 2025.
    • All connectors will stop working on December 31, 2025 (previously October 1, 2024).

    See Microsoft’s blog post for more information.

    To migrate all notification handles currently using the legacy Office 365 connectors over to Datadog’s tenant-based integration:

    1. Follow the setup steps to connect your Microsoft tenant to Datadog.
    2. Add the Datadog app to all teams where you have a legacy Office 365 connector configured.
    3. For each legacy notification connector handle in the Microsoft Teams Integration Tile:
      1. Under the configured tenant, click Add Handle.
      2. Give the new handle the same name as the connector handle. For example, if your legacy connector handle is named channel-123, create a new handle in the tenant configuration with the name channel-123.
      3. Select the desired team and channel from the drop-down menus that the legacy connector handle was sending the message to, and click Save. This new handle overrides the existing legacy connector handle.

    1. Follow the setup steps to connect your Microsoft tenant to Datadog.
    2. Add the Datadog for Government app to all teams where you have a legacy Office 365 connector configured.
    3. For each legacy notification connector handle in the Microsoft Teams Integration Tile:
      1. Under the configured tenant, click Add Handle.
      2. Give the new handle the same name as the connector handle. For example, if your legacy connector handle is named channel-123, create a new handle in the tenant configuration with the name channel-123.
      3. Select the desired team and channel from the drop-down menus that the legacy connector handle was sending the message to, and click Save. This new handle overrides the existing legacy connector handle.

    Usage

    From a Datadog monitor, send a notification to Microsoft Teams using the @-notification feature. Send the notification to the address @teams-<HANDLE>, replacing <HANDLE> with the name of your Microsoft Teams handle. To mute a triggered monitor from Microsoft Teams, click Mute Monitor, select a Mute Duration, and click Mute.

    Dashboards

    You can post dashboard widget snapshots on any team or chat. For a list of supported widgets, see [Scheduled Reports][7].

    To share a dashboard widget in Teams:

    1. In Datadog, hover over a dashboard widget and press CMD + C or CTRL + C, or click the Copy button from the share menu.
    2. Paste the link into Teams.

    Sharing a dashboard widget in Microsoft Teams

    Sharing a dashboard widget in Microsoft Teams

    Limit edit access

    By default, all users have full access to connected Microsoft Teams tenants.

    Use Granular Access Control to limit which roles can edit a specific tenant:

    1. While viewing a tenant, click the gear icon in the upper-right corner to open the settings menu.
    2. Select Permissions.
    3. Click Restrict Access. The dialog box updates to show that members of your organization have Viewer access by default.
    4. Use the dropdown to select one or more roles, teams, or users that can edit the Microsoft Teams tenant.
    5. Click Add. The dialog box updates to show that the role you selected has the Editor permission.
    6. Click Save.

    Note: To maintain your edit access to the tenant, you must include at least one role you belong to before saving.

    If you have edit access, you can restore general access to a restricted tenant by completing the following steps:

    1. While viewing the tenant, click the gear icon in the upper-right corner to open the settings menu.
    2. Select Permissions.
    3. Click Restore Full Access.
    4. Click Save.

    To edit tenant permissions through the API:

    1. Navigate to the Microsoft Teams integration tile.
    2. Click the Tenants tab.
    3. Copy the tenant ID shown for the selected tenant.
    4. Use the Restriction Policies API, where the Resource Type is integration-account and the id is microsoft-teams:<tenant_id>.

    What are Microsoft Workflows Webhooks?

    Workflows / Power Automate is a Microsoft product for creating automated workflows. Microsoft Workflows can be used to send notifications with incoming webhooks. If you are unable to install the Datadog app in your Microsoft Teams tenant (recommended), or you want to send notifications to private channels, you can configure Datadog handles to send notifications to Microsoft Teams channels through Microsoft Workflows. This integration is intended for use with the following Microsoft Workflows template: Post to a channel when a webhook request is received

    Post to a channel when a webhook request is received template

    Are you migrating legacy connectors to the Microsoft Workflows Webhooks integration?

    Microsoft has announced that Office 365 connectors for Microsoft Teams are being deprecated, and existing connector URLs will stop working on January 31, 2025. Microsoft promotes using incoming webhooks from Microsoft Workflows as a replacement for legacy connectors. Follow the steps below to migrate all notification handles currently using legacy Office 365 connectors over to Datadog’s Microsoft Workflows webhooks integration.

    For each legacy notification connector handle in the Microsoft Teams Integration Tile:

    1. Follow the setup steps to create a workflow webhook handle for the desired Microsoft Teams channel.
    2. Under the Microsoft Workflows Webhooks section, give the new handle the same name as the connector handle it should replace. For example, if your legacy connector handle is named channel-123, name your new handle in the Microsoft Workflows Webhooks section with the name channel-123. This new handle overrides the existing legacy connector handle.

    Create a Microsoft Workflows Webhook

    Prerequisites

    • When creating a new workflow, a Microsoft account is required for both ownership of the workflow and sending notifications to channels (these do not need to be the same Microsoft account).
    • The account that owns the workflow (configured in step 2 below) is the account that can edit and renew the workflow. For easier shared access, use a service account.
    • The account that sends notifications to channels (configured in step 8 below) posts as the user of the account. This account must be part of the team that you want to send notifications to. If sending notifications to a private channel, then this account must be also be added to the channel. If you want to give this account a name like “Datadog Notifications,” use a service account.

    Instructions

    Note: Most of these steps are in Microsoft Workflows. As Microsoft makes changes to Workflows, the steps below may not reflect the most recent changes.

    1. In Microsoft Teams, add the Workflows app to all teams you want to notify. If you are unable to add the app to your team, follow the instructions in the “Private channels” section below.

      Instructions step 1

    2. Create a new workflow in Power Automate from Microsoft’s Post to a channel when a webhook request is received template.

    3. Choose the Microsoft account that you would like to use to own the workflow (use a service account for easier shared access), then click Continue.

      Instructions step 3

    4. Click Edit in advanced mode.

      Instructions step 4

    5. Expand Send each adaptive card, then click Post card in a chat or channel.

      Instructions step 5

    6. Use the Post As dropdown to set Post as to Flow bot. Notifications will appear to be sent by “<NAME> via Workflows”. To receive these notifications, the Workflows application must be added to the desired team. If sending notifications to a private channel, Post As must be set to a user in the channel. See the “Private channels” section below for more information. Note: Changing Post as will reset the Post in field.

      Instructions step 6

    7. To access the team and channel drop-downs, remove the @ symbols by deleting them or clicking the X icons.

      Instructions step 7

    8. Use the drop-downs to select the desired team and channel.

      Instructions step 8

    9. Ensure that the workflow is connected to the desired Microsoft account for sending notifications (such as a service account named “Datadog Notifications”). Notifications will appear to be sent by “<NAME> via Workflows”. This account must have access to the configured Microsoft Teams channel. To change the account, click Change connection and follow the prompts to configure another Microsoft account.

      Instructions step 9

    10. Click the Save button.

      Instructions step 10

    11. To find your webhook link, click the first block of the workflow.

      Instructions step 11

    12. Make sure that Anyone can trigger the flow, and then copy the link.

      Instructions step 12

    13. Click the Back button to navigate to the dashboard for the workflow.

      Instructions step 13

    14. Ensure that the workflow is on by checking the dashboard. If it is off, click the “Turn on” button.

      Instructions step 14

    15. In Datadog, navigate to Integrations > Microsoft Teams.

    16. On the Configuration tab, go to the Microsoft Workflows Webhooks section and click Add Handle. Give the handle a name (if migrating from a legacy connector handle, use the same name as the corresponding connector handle), and paste the webhook URL.

    17. Click Save.

    Private channels

    To send notifications to private channels, the account configured within the Post Card to chat or channel block must have access to the channel. This enables the workflow to send notifications on behalf of that user account.

    1. Within the Post Card to chat or channel block, change Post as to User.

      Private channels instructions step 1

    2. Then to choose the account, click Change connection and follow the prompts to change the account.

      Private channels instructions step 2

    Limitations

    • If you are a Microsoft 365 customer, workflows will automatically turn off after 90 days of no successful triggers. When a workflow is nearing expiration, Microsoft sends an email to the account that owns the workflow. This 90 day timer can be reset by running a test within Microsoft Workflows.

    • When using the template, all messages are appended with a line of text stating who created the workflow along with a link to the template.

      User used a template

      To remove this, go to your workflow and click Save As to make a copy, navigate to the copy by finding it within My Flows, and use the new webhook from the copied workflow instead of the original workflow.

    • Microsoft Workflows does not support interactive features for the messages that it posts (such as muting monitors directly from Microsoft Teams).

    • Microsoft Workflows does not support shared channels.

    Usage

    From a Datadog monitor, send a notification to Microsoft Teams using the @-notification feature. Send the notification to the address @teams-<HANDLE>, replacing <HANDLE> with the name of your Microsoft Teams handle.

    Limit edit access

    By default, all users have full access to each Microsoft Workflows webhook handle.

    Use Granular Access Control to limit which roles can edit a specific Workflows webhook handle:

    1. While viewing the Workflows Webhooks, hover over a handle to reveal actions on the right side of the row.
    2. Click the lock icon labeled Permissions.
    3. Click Restrict Access. The dialog box updates to show that members of your organization have Viewer access by default.
    4. Use the dropdown to select one or more roles, teams, or users that can edit the Workflows webhook handle.
    5. Click Add. The dialog box updates to show that the role you selected has the Editor permission.
    6. Click Save.

    Note: To maintain your edit access to the Workflows webhook handle, you must include at least one role you belong to before saving.

    If you have edit access, you can restore general access to a restricted Workflows webhook handle by completing the following steps:

    1. While viewing the Workflows Webhooks, hover over the restricted handle to reveal actions on the right side of the row.
    2. Click the lock icon labeled Permissions.
    3. Click Restore Full Access.
    4. Click Save.

    To edit Workflows Webhooks permissions through the API:

    1. Fetch the Workflows Webhooks IDs using the Microsoft Teams Integration API.
    2. Use the Restriction Policies API, where the Resource Type is integration-webhook and the id is microsoft-teams:<workflows_webhook_id>.

    Migrate legacy connectors to tenant-based integration

    Microsoft has announced that Office 365 connectors for Microsoft Teams are being deprecated. This has the following effects:

    • All Datadog Connectors will stop working on January 31, 2025.
    • Incoming Webhook Connectors without updated URLs will stop working on January 31, 2025.
    • All connectors will stop working on December 31, 2025 (previously October 1, 2024).

    See Microsoft’s blog post for more information.

    To migrate all notification handles currently using the legacy Office 365 connectors over to the tenant-based Datadog app:

    1. Follow the setup steps to connect your Microsoft tenant to Datadog.
    2. Add the Datadog app to all teams where you have a legacy Office 365 connector configured.
    3. For each legacy notification connector handle in the Microsoft Teams Integration Tile:
      1. Under the configured tenant, click Add Handle.
      2. Give the new handle the same name as the connector handle. For example, if your legacy connector handle is named channel-123, create a new handle in the tenant configuration with the name channel-123.
      3. Select the desired team and channel from the drop-down menus that the legacy connector handle was sending the message to, and click Save. This new handle overrides the existing legacy connector handle.

    1. Follow the setup steps to connect your Microsoft tenant to Datadog.
    2. Add the Datadog for Government app to all teams where you have a legacy Office 365 connector configured.
    3. For each legacy notification connector handle in the Microsoft Teams Integration Tile:
      1. Under the configured tenant, click Add Handle.
      2. Give the new handle the same name as the connector handle. For example, if your legacy connector handle is named channel-123, create a new handle in the tenant configuration with the name channel-123.
      3. Select the desired team and channel from the drop-down menus that the legacy connector handle was sending the message to, and click Save. This new handle overrides the existing legacy connector handle.

    Migrate from legacy connectors to the Microsoft Workflows Webhooks integration

    Microsoft has announced that Office 365 connectors for Microsoft Teams are being deprecated. This has the following effects:

    • All Datadog Connectors will stop working on January 31, 2025.
    • Incoming Webhook Connectors without updated URLs will stop working on January 31, 2025.
    • All connectors will stop working on December 31, 2025 (previously October 1, 2024).

    See Microsoft’s blog post for more information.

    To migrate all notification handles currently using the legacy Office 365 connectors over to Datadog’s Microsoft Workflows webhooks integration, see Microsoft Workflows Webhooks.

    Connector setup (deprecated)

    Legacy notification handles are not affected by the new setup unless you use the same @teams-HANDLE_NAME, in which case the new configuration overrides the legacy configuration.

    1. Choose the ... button next to the channel name in the list of channels and then choose Connectors.

      Microsoft Teams step 1

    2. Search for Datadog and click Configure.

      Microsoft Teams step 2

    3. In the connector configuration modal, copy the webhook URL.

    4. In Datadog, navigate to Integrations > Microsoft Teams.

    5. On the Configuration tab, click Add Handle, give the handle a name, and paste the webhook URL.

    6. In the connector configuration modal, click Save.

    Datadog Incident Management in Microsoft Teams

    Account setup

    First, install the Datadog App in Microsoft Teams:

    1. Open Microsoft Teams.

    2. In the vertical toolbar, click Apps.

    3. Search for “Datadog” and click on Open.

    4. In the modal that opens, select the primary channel of the team where the app should be added. Click Go to complete the installation.

      Microsoft Teams Add App to Team

    Next, connect your Microsoft tenant to Datadog:

    1. In Datadog, navigate to the Microsoft Teams Integration Tile.
    2. Click Add Tenant, which redirects you to Microsoft.
    3. Follow the prompts and click OK.

    Some Datadog Incident Management features need permission to perform actions on your tenant, for example, creating a new team for an incident. You need someone who is authorized to consent on behalf of the Microsoft organization to grant tenant-wide admin consent, such as a user assigned the Global Admin role. View Microsoft Entra ID documentation for more information on who can grant tenant-wide admin consent to the Datadog application.

    To grant consent:

    1. Navigate to the Microsoft Teams Integration Tile in Datadog.
    2. For the tenant in which you want to use Incident Management, click the gear icon on the right-hand side.
    3. Click Authorize Tenant, which redirects you to Microsoft. A user who can grant tenant-wide admin consent must perform this step. This user must have a Datadog account, but the email used for their Datadog account does not need to match the email for their Microsoft account.
    4. Follow the prompts and click OK.

    User setup

    Performing actions in Datadog from Microsoft Teams requires you to connect your Datadog and Microsoft Team accounts.

    To connect your account from Microsoft Teams:

    1. Open Microsoft Teams.

    2. Start a chat with the Datadog bot by clicking on the ... button in the vertical toolbar and selecting Datadog.

    3. Type “accounts” and hit enter.

      Connect accounts from Microsoft Teams

    4. The Datadog bot will respond with instructions on how to connect your accounts. Click Connect Datadog Account.

    5. The Datadog bot will then send a message containing a link to connect your accounts. Click the link and follow the prompts.

    6. You will be redirected back to the Microsoft Teams Integration Tile.

    7. Create an application key by clicking Create in the prompt on the Microsoft Teams Integration Tile.

    You can also connect your accounts from Datadog:

    1. In Datadog, navigate to the Microsoft Teams Integration Tile.
    2. Click Connect in the tenant listed.
    3. Follow the prompts and click OK.
    4. From the Microsoft Teams Integration Tile, create an application key by clicking Create in the above prompt.
    Connect accounts from Datadog Microsoft Teams integration tile

    Incident Usage

    Incidents

    To declare a new incident from Microsoft Teams:

    1. Start a conversation in any team.
    2. Type @Datadog or use the ... button to open the Messaging extensions menu and select the Datadog App.
    3. Select Create an Incident.
    4. Complete the form with your desired information.
    5. Click Create.

    Anyone in your Microsoft Teams tenant can declare an incident, regardless of whether they have access to Datadog.

    When a new incident is created, a corresponding team named incident-(unique number ID) is created.

    To update an incident, follow a similar process as creation:

    1. Start a conversation while in an incident team.
    2. Type @Datadog or use the ... button to open the Messaging extensions menu and select the Datadog App.
    3. Select Update Incident.
    4. Complete the form with your desired information.
    5. Click Update.

    List all open (active and stable) incidents with:

    @Datadog list incidents

    Use the “More actions” menu on any message inside an incident team on the far right to send that message to the incident Timeline.

    Incident updates channel

    Using an incident updates channel provides your stakeholders with organization-wide visibility into the status of all incidents directly from Microsoft Teams. Select which team and channel in your account to post these updates to, and the channel receives the following posts:

    • Newly declared incidents.
    • Changes to severity, status transition, and incident commander.
    • Links to the incident’s overview page in App.
    • Link to join the dedicated incident team.

    Once the Microsoft Teams App has been installed, you can navigate to the Incident Settings page. From this, you can scroll down to the Incident Updates Channel section and begin the set-up flow.

    How to set up an incident channel:

    1. Navigate to Incidents Settings.
    2. Under the Microsoft Teams section, select your connected Microsoft Teams tenant.
    3. Toggle on Automatically create a Microsoft Teams channel for every incident.
    4. Select the Team in which you want to automatically create new channels.
    5. Save your settings.
    Microsoft Teams Incident Update Channel Settings.

    Data collected

    Metrics

    The Microsoft Teams integration does not provide any metrics.

    Events

    The Microsoft Teams integration does not include any events.

    Service checks

    The Microsoft Teams integration does not include any service checks.

    Permissions

    The Microsoft Teams integration receives the following permissions for Teams it has been added to. For more information, see Microsoft App permission reference.

    Permission descriptionRequest Reason
    Receive messages and data that I provide to it.Users can interact with the Datadog app in personal chat.
    Send me messages and notifications.Users can interact with the Datadog app in personal chat.
    Access my profile information such as my name, email address, company name, and preferred language.Enable users to configure Microsoft Teams notifications and workflows within the Datadog UI.
    Receive messages and data that team or chat members provide to it in a channel or chat.Users can interact with Datadog through @Datadog commands.
    Send messages and notifications in a channel or chat.Send Datadog notifications to configured targets.
    Access information from this team or chat such as team or chat name, channel list, and roster (including team or chat member’s names and email addresses) - and use this to contact them.Enable users to configure Microsoft Teams notifications and workflows within Datadog.

    Additional permissions are needed to use Incident Management features in the Microsoft Teams integration. These must be authorized by a user with tenant-wide permissions (see Datadog Incident Management in Microsoft Teams: Account setup for detailed instructions). For more information on these permissions, see the Microsoft Graph permission reference.

    API / Permissions nameTypeRequest Reason
    Channel.CreateApplicationCreate channels to manage and remediate incidents using Datadog Incident Management.
    Channel.Delete.AllApplicationAuto Archive incident channels after a specified time period.
    ChannelMessage.Read.AllApplicationAutomatically sync timeline messages to the incident timeline from an incident channel.
    ChannelSettings.ReadWrite.AllApplicationCreate and modify channels to remediate incidents using Datadog Incident Management.
    Directory.Read.All,GroupMember.Read.AllApplicationProvides team and channel name auto-complete suggestions for Datadog Incident Management configuration.
    TeamsTab.CreateApplicationCreate a tab in a team for the Datadog app (this permission is required for an upcoming Microsoft Teams incident declaration experience).
    User.ReadDelegatedProvide details about the signed-in user to connect a Microsoft Teams account with a corresponding Datadog account.

    Troubleshooting

    Using SSO

    Use the following steps to set new channel connectors:

    1. Login to Datadog, then complete setup steps 1 and 2.

    2. After setup step 3 redirects you to Datadog from the MS Teams page, open a new tab and log into Datadog with your SSO. Then perform setup step 4 separately.

    Why doesn’t my team show up in the integration tile?

    If you added the bot to the team before adding the tenant to Datadog, then Datadog would have missed the team join event to know that the team exists. You can try to either:

    • Synchronize your team standard channels to Datadog by posting @Datadog sync on any standard channel for that team:
    1. Navigate to a standard channel in the Team that you want to synchronize.
    2. Start a post on the channel.
    3. Post @Datadog sync to the channel and wait for a confirmation message in the thread indicating the operation’s success.
    • Remove the Datadog app from the team, then add it back again. Note: This removes configured connectors for that team. Perform this action only when you are ready to migrate all connectors for that team to Datadog’s tenant-based integration:
    1. Click the three dots next to the team name in the left sidebar.
    2. Click Manage Team.
    3. Go to the tab labelled Apps.
    4. Click the three dots next to the Datadog app.
    5. Click Remove.
    6. Re-add the Datadog app by following the setup steps.

    If you added the bot to the team before adding the tenant to Datadog, then Datadog would have missed the team join event to know that the team exists. You can:

    • Synchronize your team standard channels to Datadog by posting @Datadog for Government sync on any standard channel for that team:
    1. Navigate to a standard channel in the Team that you want to synchronize.
    2. Start a post on the channel.
    3. Post @Datadog for Government sync to the channel and wait for a confirmation message in the thread indicating the operation’s success.
    • Remove the Datadog for Government app from the team, then add it back. Note: This removes configured connectors for that team. Perform this action only when you are ready to migrate all connectors for that team to Datadog’s tenant-based integration.
    1. Click the three dots next to the team name in the left sidebar.
    2. Click Manage Team.
    3. Go to the tab labelled Apps.
    4. Click the three dots next to the Datadog for Government app.
    5. Click Remove.
    6. Re-add the Datadog for Government app by following the setup steps.

    Are private channels supported by the bot?

    Due to the private channel limitations in Microsoft Teams, private channels are not supported by the bot. If you want to send notifications to private channels, see Microsoft Workflows Webhooks

    Is the Datadog for Government app supported in GCC or GCC High?

    Currently, the Datadog for Government app only supports Datadog US1-FED customers who are trying to connect to their commercial Microsoft Teams tenant. GCC and GCC High tenants are not supported by the app.

    Need help? Contact Datadog support.