---
title: Troubleshooting Microsoft Teams
description: >-
  Troubleshooting steps and solutions for issues with the Microsoft Teams
  integration.
breadcrumbs: Docs > Integrations > Integration Guides > Troubleshooting Microsoft Teams
---

# Troubleshooting Microsoft Teams

## Overview{% #overview %}

This guide addresses common issues and FAQs for the Datadog Microsoft Teams integration, including missing teams, syncing channels, private channel support, user mentions, incident troubleshooting, and prompt resolution.

## The team doesn't show up in the integration tile{% #the-team-doesnt-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 running a sync command from any standard channel for that team
- Remove the  app from the team, then add it back again

### Synchronize your team standard channels to Datadog{% #synchronize-your-team-standard-channels-to-datadog %}

1. Navigate to a standard channel in the Team that you want to synchronize.
1. Start a post on the channel.
1. Type `@   sync`, select the `` app, and then choose the `sync` command.
1. Post the message to the channel and wait for a confirmation in the thread indicating success.

### Remove and re-add  app{% #remove-and-re-add-hahahugoshortcode28627s3hbhb-app %}

{% alert level="danger" %}
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.
{% /alert %}

1. Click the three dots next to the Team name in the left sidebar.
1. Click **Manage Team**.
1. Go to the tab labelled **Apps**.
1. Click the three dots next to the  app.
1. Click **Remove**.
1. Re-add the  app by following the [setup steps](https://docs.datadoghq.com/integrations/microsoft-teams.md?tab=datadogapprecommended#setup).

## Troubleshooting Incident features when using delegated permissions{% #troubleshooting-incident-features-when-using-delegated-permissions %}

First, ensure that the service account user is a member of the team that the feature is being used in.

- If an incident **tab** is *not* being created, ensure that you have allowed members to create, update, and remove **tabs** in channels in that team.
- If new incident **channels** are *not* being created or renamed, ensure that you have allowed members to create and update **channels** in that team.
- If incident channels are not being archived, ensure that you have allowed members to delete and restore channels in that team.

Lastly, it is possible that the delegated user's token has expired or been revoked. If that's the case, re-connect the delegated user.

## App configuration prompts when declaring an incident{% #app-configuration-prompts-when-declaring-an-incident %}

If you are seeing a prompt when decalring an incident, verify the following:

- Your app version is 3.1.23 or higher. See instructions on how to [update your app version](https://support.microsoft.com/office/update-an-app-in-microsoft-teams-3d53d136-5c5d-4dfa-9602-01e6fdd8015b).
- If you're using application permissions, ensure you have granted the `TeamsTab.Create` application permission
- If you're using delegated permissions, ensure you have granted the `TeamsTab.Create` and `TeamsTab.Read.All` delegated permissions.
- If you're using delegated permissions, ensure that the service account is a member of the team you're running the `@Datadog incident` command in.

You can also declare an incident by clicking the `+` sign at the top of a channel and searching for the Datadog app.

## Limitations for US1-FED{% #limitations-for-us1-fed %}

- Government Community Cloud (GCC) and GCC High tenants are not supported by the app. The Datadog for Government app only supports Datadog US1-FED customers who are trying to connect to their `commercial` Microsoft Teams tenant.
- Datadog Incident management features are not supported.

## Further reading{% #further-reading %}

- [Datadog Microsoft Teams Integration](https://docs.datadoghq.com/integrations/microsoft-teams.md?tab=datadogapprecommended)
- [Microsoft Teams Integration Tile](https://app.datadoghq.com/integrations?integrationId=microsoft-teams)