---
title: "Microsoft Teams bot for Onboarding"
canonical_url: "https://docs.getdx.com/onboarding/ms-teams-bot/"
md_url: "https://docs.getdx.com/onboarding/ms-teams-bot.md"
last_updated: "2026-05-08"
---

# Microsoft Teams bot for Onboarding
DX [Onboarding](https://docs.getdx.com/onboarding/) sends developers a short survey 90 days after their start date. Follow these steps to configure the Microsoft Teams bot for sending surveys.

## Step 1: Download the bot configuration

Download the DX Onboarding bot file from the [Onboarding setup](https://app.getdx.com/onboarding/setup) page. This file contains the configuration to set up a [notification-only bot](https://learn.microsoft.com/en-us/microsoftteams/platform/resources/bot-v3/bots-notification-only) in Microsoft Teams.

## Step 2: Upload the custom app

1. In Microsoft Teams, go to **Apps** settings for your team.
2. Click **Upload a custom app** and select DX's configuration file.

![Upload Custom App Screenshot](https://docs.getdx.com/assets/images/onboarding/custom-app.png)

> **Note**: If "Upload a custom app" is unavailable, [check your permission policies](https://learn.microsoft.com/en-us/microsoftteams/teams-custom-app-policies-and-settings#allow-users-to-upload-custom-apps) to ensure you have the required permissions.

## Step 3: Configure app availability

If you use App centric management, ensure the app is available to **Everyone** or **Specified users and groups** that includes your team.

Once installed, you can manage the app at:
[Teams Admin Center - DX Onboarding](https://admin.teams.microsoft.com/policies/manage-apps/7e3b54dd-af24-4a21-93e8-7717bc40e629/assignments)

![App Management Screenshot](https://docs.getdx.com/assets/images/onboarding/app-availability.png)

> **Note**: If your organization requires custom applications to be allowlisted under "Permission policies", add "DX Onboarding" to the allowlist.

## Step 4: Verify installation

If the bot was installed correctly, the "Configure bot" step will be marked as complete on the [Onboarding setup](https://app.getdx.com/onboarding/setup) page.
---

## Sitemap

[Overview of all docs pages](/llms.txt)