--- title: "Microsoft Teams app" canonical_url: "https://docs.getdx.com/microsoft-teams-app/" md_url: "https://docs.getdx.com/microsoft-teams-app.md" last_updated: "2026-06-18" --- # Microsoft Teams app The **Microsoft Teams app** lets DX send Teams notifications and feedback requests to your users. This page covers the required setup in Microsoft Teams so notifications can be delivered reliably. ## Prerequisites ### Admin consent Before installing the DX app, have an Azure AD admin grant consent to user-delegated permissions at the URL below: ``` http://app.getdx.com/microsoft/consent ``` The above URL is an [admin consent URL](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/grant-admin-consent?pivots=portal), meaning once an admin has consented individuals in the tenant will not need an admin's consent to sign in to DX. ### Optional team creation If you do not already have a Team that includes all participants that will need to sign into DX, please create a new team in your Microsoft Teams tenant. DX recommends a team name like `dx-engineering` and a channel name like `dx-general`. ![](https://docs.getdx.com/assets/images/administration/ms-teams-app/team-and-channel-creation.png){class="max-w-lg"} ## Teams app installation To install the DX MS Teams app, search for DX in the Microsoft store or [open it directly](https://teams.microsoft.com/l/app/0e4c8bdb-6f32-446e-b3c1-a841015450b6?source=app-details-dialog). Then, click **Add**: ![](https://docs.getdx.com/assets/images/administration/ms-teams-app/add-app-from-store.png){class="max-w-lg"} Select the team that you would like to install the app to: ![](https://docs.getdx.com/assets/images/administration/ms-teams-app/choose-team-for-install.png){class="max-w-lg"} If you receive an error that an IT admin needs to provide permission or install it, please have an admin follow the process above. Alternatively, an admin can go to the [App Management](https://admin.teams.microsoft.com/policies/manage-apps) console to find and install the DX app to a team by searching for DX and then selecting **Add to team**. ![](https://docs.getdx.com/assets/images/administration/ms-teams-app/installation-4.png){class="max-w-lg"} Search for your team and after selecting the team, click **Apply**. ![](https://docs.getdx.com/assets/images/administration/ms-teams-app/installation-5.png){class="max-w-lg"} Navigate to [app.getdx.com/signin](https://app.getdx.com/signin) and click on the "Microsoft" button ![](https://docs.getdx.com/assets/images/administration/ms-teams-app/ms-teams-sign-in.png){class="max-w-lg"} ### App centric management If you have migrated to use App Centric Management in Microsoft, you'll need to have the app available either to **Everyone** or **Specific users and groups**. You'll be able to select the users or groups (including teams) you plan to install the app to. If users are not included or are not part of a team that is included, DX receives a _BotDisabledByAdmin_ error, which DX cannot detect until it attempts to send a message. > **Note**: Microsoft may delay updates that allow users to receive messages. ![](https://docs.getdx.com/assets/images/administration/ms-teams-app/installation-6.png){class="max-w-lg"} ![](https://docs.getdx.com/assets/images/administration/ms-teams-app/installation-7.png){class="max-w-lg"} > **Note**: After setup, contact your DX representative to validate that Teams notifications are being delivered. ## Troubleshooting - If users are not included in app availability, DX may receive `BotDisabledByAdmin` when attempting to send notifications. See how to configure this above in the **App Centric Management** section. Microsoft policy and availability changes can take time to propagate. ## Appendix ### App architecture and functionality The DX app is a chatbot-style integration built with Microsoft Bot Framework and Teams extensibility APIs. The app is hosted by DX on Amazon Web Services (AWS), and all communication between Teams and the DX app occurs over HTTPS. Key functionality includes: - **Survey delivery**: The app sends users direct messages in Teams that include secure links to DX-hosted surveys. - **User provisioning**: - DX creates users only for Microsoft Teams where the app is installed. - Teams with the app installed remain automatically synced with DX. The app does not provide an embedded tab or in-Teams UI surface; it delivers messages and links. ### Microsoft partner verification The DX app has completed Microsoft's Partner App Verification process, including checks for security, compliance, and data handling. DX has also completed the following components of Microsoft's App Compliance Program: 1. App Validation 1. Publisher Verification 1. Publisher Attestation ### Permissions required by the DX app > **Note**: DX does not access or read message content within your Microsoft Teams tenant. #### User-delegated permissions | **Permission** | **Description** | |---|---| | [email](https://learn.microsoft.com/en-us/graph/permissions-reference#email) | This permission allows read access to users' email addresses. DX uses this permission for user authentication. | | [offline_access](https://learn.microsoft.com/en-us/graph/permissions-reference#offline_access) | This permission allows read access to users' profiles without user reauthorization. DX uses this permission to keep user information up to date. | | [openid](https://learn.microsoft.com/en-us/graph/permissions-reference#openid) | This permission allows users to sign in to DX using their Microsoft account. DX uses this permission for user authentication. | | [profile](https://learn.microsoft.com/en-us/graph/permissions-reference#profile) | This permission allows read access to a user's basic profile. DX uses this permission to display user names and photos. | | [User.read](https://learn.microsoft.com/en-us/graph/permissions-reference#userread) | This permission allows read access to a user's basic profile. DX uses this permission to display user names and photos. | #### Resource-specific permissions | **Permission** | **Description** | |---|---| | [TeamMember.Read.Group](https://learn.microsoft.com/en-us/microsoftteams/platform/graph-api/rsc/resource-specific-consent) | This permission allows read access to member IDs for a team. DX uses this permission to provision users who are members of a team where the DX app is installed. | --- ## Sitemap [Overview of all docs pages](/llms.txt)