Overview
This guide will walk you through the process of upgrading your Legacy Teams App deployments. You can check to see if you have Legacy Teams apps deployed by navigating to Thread Admin Panel > Clients. If you see the following banner, you need to upgrade all Teams apps before March 31st, 2026, or they will could functioning for your clients**.**
- Full SSO - Clients will no longer need to sign in with their Microsoft Credentials when opening the application the first time.
- Auto-Update Capability - You shouldn’t need to update your apps again; they will stay up-to-date automatically.
Preliminary Steps
1
Open an incognito browser session
Open a separate browser session in incognito mode to ensure you sign into the correct Microsoft Teams environment.
2
Sign in to the Thread Admin Panel
Sign in to the Thread Admin Panel and Navigate to the Clients tab.
If you have lots of Legacy Apps to upgrade we recommend exporting list to CSV to share the upgrade work to multiple people. The csv will give you Client Name and direct link to App Deployment page of that client.
Deployment Process
1
Open the client's App Deployment page
You can click on the Legacy Service Bot from the Clients page or use the direct link from the csv if you downloaded it.Both ways will end you up on the following page below:
2
Click Update Now
Click on Update Now button You will get the following pop-up just warning you that if you do the upgrade during your clients business hours they may lose the ability to use the Teams Support app for a few hours.
We recommend doing this outside of business hours
3
Click Continue
Click Continue you will see the screen below:
4
Copy the Magic Link and authenticate
Click “Copy link” next to the Magic Link and paste it into a new tab in your current incognito browser session. When you navigate to the Magic Link, you’ll be prompted to authenticate with an Administrator account in the customer’s Microsoft 365 tenant. Enter the username for that account and click Next.
5
Enter the password and complete MFA
Enter the password and complete any required MFA (multi-factor authentication).
6
Grant permissions for the bot
You will be prompted to grant permissions for the bot. Click Accept.If this step was successful, you will see a confirmation screen similar to below:
7
Open the Teams Admin Center setup policies
Navigate to the Teams Admin Center ( https://admin.teams.microsoft.com) -> Teams apps -> Setup policies.
8
Select the Global (Org-wide default) policy
Click Global (Org-wide default). The Global policy will apply to all users in the environment, but if you want to limit who in your customer’s environment can use and interact with the application, you can set up your own policy assignment here. Follow our guide on How to roll out the Teams Service app to specific users here.
9
Add the app under Installed apps
Under the Installed apps section, click the Add apps button
10
Find and add the installed app
An Add installed apps sidebar will appear. Search for the app based on the Teams app name you defined when building your custom teams app. Find the app, click Add and Add again at the bottom of the panel.
11
Add the app under Pinned apps
Under the Pinned apps section, click the + Add apps button.
12
Pin the app and save
Search for the app based on the Teams app name you defined when building your custom teams app. Find the app, click Add and Add again at the bottom of the panel.You will see the app under Pinned apps. If you want the app to feature prominently in your users Teams, you can move it up or down and click Save when done.
It may take time for the app to show up in users’ Teams environment, due to Microsoft internal publishing process. Allow up to 24 hours for these changes to complete.