Upgrade legacy Thread Teams App deployments before Microsoft’s deprecation deadline to enable full SSO, auto-updates, and uninterrupted client support.
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, upgrade those apps now: Microsoft’s March 31, 2026 MultiTenant deadline has passed, and apps left un-upgraded may stop functioning for your clients.
We are now past the deadline and Microsoft can and will choose to deprecate the legacy app at any time. If you do not upgrade your app, you could lose service at ANY TIME.
You need to upgrade your legacy Teams Apps because Microsoft is deprecating older authentication methods due to security vulnerabilities.The new Teams app includes several new features that will improve your client experience:
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.
Below is a step by step guide on how to update your Teams apps.
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.
If you have lots of Legacy Apps to upgrade we recommend exporting the 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 the 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:
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.
Congrats, you have upgraded your Legacy Teams app in your customer’s Microsoft 365 tenant. After a short wait period, your end users are ready to start using Messenger.
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.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Thread Docs","colors":{"primary":"#00B398","light":"#19D3AB","dark":"#008E78"},"logo":{"light":"https://mintcdn.com/thread/50guKpC0vegpyObR/logo/thread.svg?fit=max\u0026auto=format\u0026n=50guKpC0vegpyObR\u0026q=85\u0026s=86145b5e0fe1e4b555128fc8d8fd9815","dark":"https://mintcdn.com/thread/2AdmqP0mlnyoZLRc/logo/dark.svg?fit=max\u0026auto=format\u0026n=2AdmqP0mlnyoZLRc\u0026q=85\u0026s=be32bb55d8f9cb7540f7c741c3568f92"},"favicon":"https://mintcdn.com/thread/hgBTJ4Ailw9NcSXS/favicon.svg?fit=max\u0026auto=format\u0026n=hgBTJ4Ailw9NcSXS\u0026q=85\u0026s=e5c9cc06837f1f692d72495e146c976a","appearance":{"default":"dark"},"background":{"color":{"light":"#FAF9F6","dark":"#0A0A0B"}},"navbar":{"links":[{"href":"https://www.getthread.com/aisu-community","label":"Community"}],"primary":{"type":"button","label":"Thread Inbox","href":"https://inbox.getthread.com"}},"footer":{"socials":{"website":"https://www.getthread.com","linkedin":"https://www.linkedin.com/company/thread-service","youtube":"https://www.youtube.com/channel/UCAZ535tVfwF94lOE818tVmQ"},"links":[{"header":"Our mission","items":[{"label":"Death to the Ticket","href":"https://www.getthread.com/death-to-ticket"},{"label":"Intelligent Service Delivery","href":"https://www.getthread.com/intelligent-service-delivery-manifesto-the-future-of-msp-operations"}]},{"header":"Popular features","items":[{"label":"AI Agents","href":"https://www.getthread.com/automated-ticket-triage"},{"label":"Automated Triage","href":"https://www.getthread.com/automated-ticket-triage"},{"label":"Service Desk Chatbots","href":"https://www.getthread.com/live-managed-chat-support"},{"label":"Teams Chat Integration","href":"https://www.getthread.com/teams-to-teams"},{"label":"AI for Phone","href":"https://www.getthread.com/voice-ai"}]},{"header":"Company","items":[{"label":"About","href":"https://www.getthread.com/about-thread"},{"label":"Careers","href":"https://www.getthread.com/careers"}]},{"header":"Resources","items":[{"label":"AISU Community","href":"https://www.getthread.com/aisu-community"},{"label":"Thread Crew","href":"https://thread-crew.circle.so/join?invitation_token=8c546a98539fb84b4eb913b8b647a078bb353623-ea2d128e-eaae-42fd-af14-5949e71bf51b"},{"label":"AISU weekly webinar","href":"https://www.getthread.com/aisu-weekly-registration"},{"label":"Events","href":"/events-and-resources"},{"label":"Blog","href":"https://www.getthread.com/service-magic-blog"},{"label":"System Status","href":"https://status.getthread.com/"},{"label":"Feedback","href":"https://feedback.getthread.com/"},{"label":"Contact support","href":"https://help.getthread.com"},{"label":"Trust Center","href":"https://trust.getthread.com"},{"label":"Terms of Service","href":"https://www.getthread.com/terms-of-service"},{"label":"Privacy Policy","href":"https://www.getthread.com/privacy-policy"}]}]},"fonts":{"heading":{"family":"Inter","weight":600},"body":{"family":"Inter"}},"banner":{"content":"Join hundreds of MSPs on the **AI Service Unleashed** weekly call — product releases, beta access, and Super Magic tips. [Register](https://www.getthread.com/aisu-weekly-registration)","dismissible":true},"contextual":{"options":["copy","view","assistant","claude","chatgpt","mcp"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"thread","hasAudioNarration":false,"actualSubdomain":"thread","customDomains":["docs.getthread.com"],"gitSource":{"type":"github","owner":"thread-magic","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"agentFeedback":true,"thumbs":true,"edits":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afa54bf59fc4106fcc66937","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Guides","count":213},{"language":"default","tag":"Super Magic \u0026 Thread MCP","count":34},{"language":"default","tag":"By role","count":28},{"language":"default","tag":"Choose your role","count":28},{"language":"default","tag":"Integrations","count":24},{"language":"default","tag":"Messenger","count":22},{"language":"default","tag":"Super Magic Tools","count":20},{"language":"default","tag":"Voice AI","count":19},{"language":"default","tag":"Thread Inbox","count":19},{"language":"default","tag":"Magic Agents","count":16}],"searchSettings":{"isFiltersEnabled":false}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"type":"email","email":"help@getthread.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/thread/7dad7b024a7096a6/style.css"}],"page":{"pagePath":"messenger/how-to-upgrade-your-legacy-teams-app","slug":"/messenger/how-to-upgrade-your-legacy-teams-app","pageMetadata":{"title":"How to Upgrade your Legacy Teams App","description":"Upgrade legacy Thread Teams App deployments before Microsoft's deprecation deadline to enable full SSO, auto-updates, and uninterrupted client support.","boost":3,"href":"/messenger/how-to-upgrade-your-legacy-teams-app"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Upgrade legacy Thread Teams App deployments before Microsoft’s deprecation deadline to enable full SSO, auto-updates, and uninterrupted client support.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Heading,Note,OptimizedImage,Step,Steps,Warning}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:_jsx(_components.strong,{children:`Overview`})}),`\n`,_jsxs(_components.p,{children:[`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 > `,_jsx(_components.a,{href:`https://admin.getthread.com/dashboard/clients/companies`,children:_jsx(_components.strong,{children:`Clients`})}),`. `,_jsx(_components.strong,{children:`If you see the following banner, upgrade those apps now`}),`: Microsoft’s March 31, 2026 MultiTenant deadline has passed, and apps left un-upgraded may stop functioning for your clients.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`We are now past the deadline and Microsoft can and will choose to deprecate the legacy app at any time. If you do not upgrade your app, you could lose service at ANY TIME.`})}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/670b42bf-2025-12-11-09-29-56.png?fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=8fdc3221aa6540f6734b38e34ed849bf`,alt:`Thread Admin Panel banner prompting a legacy Teams app upgrade`,\"data-og-width\":`1631`,width:`1631`,\"data-og-height\":`402`,height:`402`,\"data-path\":`images/670b42bf-2025-12-11-09-29-56.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/670b42bf-2025-12-11-09-29-56.png?w=280\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=28d1b67810cc7836c9502675a174a3cb 280w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/670b42bf-2025-12-11-09-29-56.png?w=560\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=8ac7d553ecb685bdf2162715682662b7 560w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/670b42bf-2025-12-11-09-29-56.png?w=840\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=bd5341afbe089464de961d089b3ef11a 840w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/670b42bf-2025-12-11-09-29-56.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=f4534d933c2b87257077d5c83be0d8ec 1100w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/670b42bf-2025-12-11-09-29-56.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=07c7379b280fd39a29ec0f23de0005fe 1650w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/670b42bf-2025-12-11-09-29-56.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=62dc72e105058cd6d3c6c2c86a71b779 2500w`})}),`\n`,_jsx(_components.p,{children:`You need to upgrade your legacy Teams Apps because Microsoft is deprecating older authentication methods due to security vulnerabilities.`}),`\n`,_jsx(_components.p,{children:`The new Teams app includes several new features that will improve your client experience:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Full SSO`}),` - Clients will no longer need to sign in with their Microsoft Credentials when opening the application the first time.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Auto-Update Capability`}),` - You shouldn’t need to update your apps again; they will stay up-to-date automatically.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Below is a step by step guide on how to update your Teams apps.`}),`\n`,_jsx(Heading,{level:`3`,id:`preliminary-steps`,children:_jsx(_components.strong,{children:`Preliminary Steps`})}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open an incognito browser session`,children:_jsx(_components.p,{children:`Open a separate browser session in incognito mode to ensure you sign into the correct Microsoft Teams environment.`})}),_jsxs(Step,{title:`Sign in to the Thread Admin Panel`,children:[_jsxs(_components.p,{children:[`Sign in to the `,_jsx(_components.a,{href:`https://admin.getthread.com/`,children:`Thread Admin Panel`}),` and Navigate to the `,_jsx(_components.a,{href:`https://admin.getthread.com/dashboard/clients/companies`,children:`Clients`}),` tab.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/7a4ad904-2025-12-10-15-44-50.png?fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=6a8fc521318eb4724230fddd43fbd365`,alt:`Clients tab in the Thread Admin Panel`,\"data-og-width\":`3826`,width:`3826`,\"data-og-height\":`1610`,height:`1610`,\"data-path\":`images/7a4ad904-2025-12-10-15-44-50.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/7a4ad904-2025-12-10-15-44-50.png?w=280\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=999162b3a9889ec71056e091f28a6775 280w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/7a4ad904-2025-12-10-15-44-50.png?w=560\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=f1d5146a6aa278ba9004f77cc53f2573 560w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/7a4ad904-2025-12-10-15-44-50.png?w=840\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=bcad189a2efbc23a9457a718405ae996 840w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/7a4ad904-2025-12-10-15-44-50.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=f4d9b9457d1869a4fd88acd9ecb2ef6a 1100w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/7a4ad904-2025-12-10-15-44-50.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=2f74c00e1ebe3b4299c0bc065fc3776a 1650w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/7a4ad904-2025-12-10-15-44-50.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=c905cf5305e2b066dc7148ddec687b90 2500w`})})]})]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`If you have lots of Legacy Apps to upgrade we recommend exporting the 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.`})}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/68b33b3c-2025-12-10-15-46-04.png?fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=9650d9264a33aa3dba95ec5e9e35a8ed`,alt:`Exporting the list of legacy apps to CSV`,\"data-og-width\":`378`,width:`378`,\"data-og-height\":`149`,height:`149`,\"data-path\":`images/68b33b3c-2025-12-10-15-46-04.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/68b33b3c-2025-12-10-15-46-04.png?w=280\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=e26fc4387b5cdb2a8b976e565dbd724c 280w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/68b33b3c-2025-12-10-15-46-04.png?w=560\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=caefd3fa58264651bbdf5015def1490f 560w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/68b33b3c-2025-12-10-15-46-04.png?w=840\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=0f6951fdac99bd20c10b3f20895d8e2b 840w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/68b33b3c-2025-12-10-15-46-04.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=ef1c81a30e99f9eee7d1f1edc1280f2a 1100w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/68b33b3c-2025-12-10-15-46-04.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=a69fcfe08814d16b65ced09bf3fb923c 1650w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/68b33b3c-2025-12-10-15-46-04.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=b86fea009274d5bd2c669633c28de6fa 2500w`})}),`\n`,_jsx(Heading,{level:`3`,id:`deployment-process`,children:_jsx(_components.strong,{children:`Deployment Process`})}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open the client's App Deployment page`,children:[_jsx(_components.p,{children:`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:`}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/yMrisProrR453qj0/images/1fae04c6-2025-12-10-15-46-46.png?fit=max\u0026auto=format\u0026n=yMrisProrR453qj0\u0026q=85\u0026s=0136e4a3815670a11804b07ae9f1b3c5`,alt:`Client App Deployment page for the Legacy Service Bot`,\"data-og-width\":`330`,width:`330`,\"data-og-height\":`121`,height:`121`,\"data-path\":`images/1fae04c6-2025-12-10-15-46-46.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/yMrisProrR453qj0/images/1fae04c6-2025-12-10-15-46-46.png?w=280\u0026fit=max\u0026auto=format\u0026n=yMrisProrR453qj0\u0026q=85\u0026s=1a8fd9ddd1ad78bfe721f1dcad3a7dc0 280w, https://mintcdn.com/thread/yMrisProrR453qj0/images/1fae04c6-2025-12-10-15-46-46.png?w=560\u0026fit=max\u0026auto=format\u0026n=yMrisProrR453qj0\u0026q=85\u0026s=c2e69d7fd7b4d182157f86519cbe8e7c 560w, https://mintcdn.com/thread/yMrisProrR453qj0/images/1fae04c6-2025-12-10-15-46-46.png?w=840\u0026fit=max\u0026auto=format\u0026n=yMrisProrR453qj0\u0026q=85\u0026s=dae883d19c54ef9bf5931c92d4e6143b 840w, https://mintcdn.com/thread/yMrisProrR453qj0/images/1fae04c6-2025-12-10-15-46-46.png?w=1100\u0026fit=max\u0026auto=format\u0026n=yMrisProrR453qj0\u0026q=85\u0026s=1f8b4ed63a0e148b73047c4f8c77a29b 1100w, https://mintcdn.com/thread/yMrisProrR453qj0/images/1fae04c6-2025-12-10-15-46-46.png?w=1650\u0026fit=max\u0026auto=format\u0026n=yMrisProrR453qj0\u0026q=85\u0026s=da7b12c2dfba0a399c85dc6e92cc4f63 1650w, https://mintcdn.com/thread/yMrisProrR453qj0/images/1fae04c6-2025-12-10-15-46-46.png?w=2500\u0026fit=max\u0026auto=format\u0026n=yMrisProrR453qj0\u0026q=85\u0026s=ae1bf9657a1a622b81d0c3e36d9be5c5 2500w`})}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/74e78d4b-2025-12-10-15-47-43.png?fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=1e268d230598098f9049900e78d9e861`,alt:`Legacy Service Bot deployment details`,\"data-og-width\":`1251`,width:`1251`,\"data-og-height\":`1417`,height:`1417`,\"data-path\":`images/74e78d4b-2025-12-10-15-47-43.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/74e78d4b-2025-12-10-15-47-43.png?w=280\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=e02450a788f7d0f307b57241265fa199 280w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/74e78d4b-2025-12-10-15-47-43.png?w=560\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=9aece1df4a3c9b57d2129346ec389ae2 560w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/74e78d4b-2025-12-10-15-47-43.png?w=840\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=0dee6284ba6dc4a200b33e49cae5dea1 840w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/74e78d4b-2025-12-10-15-47-43.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=dbadd282c3680b3228693ee4940bf065 1100w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/74e78d4b-2025-12-10-15-47-43.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=545a08d891e5cecc518ec8fbbbd55174 1650w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/74e78d4b-2025-12-10-15-47-43.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=db2c0f27179dab4b0c13f127c3f11a8b 2500w`})})]}),_jsxs(Step,{title:`Click Update Now`,children:[_jsx(_components.p,{children:`Click on the 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.`}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/70a984f4-2025-12-10-15-48-13.png?fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=bc3c678abae3d12f70ff50e82c6c65e1`,alt:`Update Now confirmation pop-up warning of possible downtime`,\"data-og-width\":`1027`,width:`1027`,\"data-og-height\":`405`,height:`405`,\"data-path\":`images/70a984f4-2025-12-10-15-48-13.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/70a984f4-2025-12-10-15-48-13.png?w=280\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=b3f014bbb4da8ad99b9426c93dc3c163 280w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/70a984f4-2025-12-10-15-48-13.png?w=560\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=e8fec16fc736fb21d98c1bddc059bb7f 560w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/70a984f4-2025-12-10-15-48-13.png?w=840\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=6a3add4f0752d9ef10052caf7058a724 840w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/70a984f4-2025-12-10-15-48-13.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=0104588b036d8832428864d47fe23982 1100w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/70a984f4-2025-12-10-15-48-13.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=98c49f52008ed1e1ba627a50917bff5a 1650w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/70a984f4-2025-12-10-15-48-13.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=e7ab466f91ac08f0b4988e869c081c6e 2500w`})}),_jsx(Note,{children:_jsx(_components.p,{children:`We recommend doing this outside of business hours.`})})]}),_jsxs(Step,{title:`Click Continue`,children:[_jsx(_components.p,{children:`Click Continue. You will see the screen below:`}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/c17a644a-2025-12-10-15-48-53.png?fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=0ad908826b31a887e22998e79b1a5bd0`,alt:`Screen shown after clicking Continue on the upgrade`,\"data-og-width\":`1142`,width:`1142`,\"data-og-height\":`924`,height:`924`,\"data-path\":`images/c17a644a-2025-12-10-15-48-53.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/c17a644a-2025-12-10-15-48-53.png?w=280\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=ba6a2c14652f754f75d83e050eaf04a2 280w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/c17a644a-2025-12-10-15-48-53.png?w=560\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=c7c3f7f3975463a71828115eb5fbabb2 560w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/c17a644a-2025-12-10-15-48-53.png?w=840\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=a0dbf22b9aa70e37882267476319f42f 840w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/c17a644a-2025-12-10-15-48-53.png?w=1100\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=36f7247267087572bfadd5f97d405e76 1100w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/c17a644a-2025-12-10-15-48-53.png?w=1650\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=87e2bdd7d4c95b2251b1959476c46192 1650w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/c17a644a-2025-12-10-15-48-53.png?w=2500\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=e55ae54b0432dc021a31090e035f502e 2500w`})})]}),_jsx(Step,{title:`Copy the Magic Link and authenticate`,children:_jsxs(_components.p,{children:[`Click “`,_jsx(_components.strong,{children:`Copy link`}),`” next to the `,_jsx(_components.strong,{children:`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 `,_jsx(_components.strong,{children:`Next`}),`.`]})}),_jsxs(Step,{title:`Enter the password and complete MFA`,children:[_jsx(_components.p,{children:`Enter the password and complete any required MFA (multi-factor authentication).`}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/89622124-2025-12-10-15-50-28.png?fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=63b75b23177f5d0b80b0d6468aa9ab55`,alt:`Microsoft 365 password and MFA prompt`,\"data-og-width\":`1004`,width:`1004`,\"data-og-height\":`773`,height:`773`,\"data-path\":`images/89622124-2025-12-10-15-50-28.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/89622124-2025-12-10-15-50-28.png?w=280\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=8692607e388f8f73362a7af3cd6b5187 280w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/89622124-2025-12-10-15-50-28.png?w=560\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=b20ead7834501f3e9bc031b099c586c2 560w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/89622124-2025-12-10-15-50-28.png?w=840\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=d70128991a13791512e7d52a7cf2519a 840w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/89622124-2025-12-10-15-50-28.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=504e12a6ec99b05dc15a9ae3f753b4ec 1100w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/89622124-2025-12-10-15-50-28.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=4521379dc12ee7a394b779cc359bc95e 1650w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/89622124-2025-12-10-15-50-28.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=fe2343c85a622c38658ed745dda5295b 2500w`})})]}),_jsxs(Step,{title:`Grant permissions for the bot`,children:[_jsxs(_components.p,{children:[`You will be prompted to grant permissions for the bot. Click `,_jsx(_components.strong,{children:`Accept`}),`. If this step was successful, you will see a confirmation screen similar to below:`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/ee043f80-2025-12-10-15-50-51.png?fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=a772b2b810b62044e2fecb536a9c0d26`,alt:`Prompt to grant permissions for the bot`,\"data-og-width\":`604`,width:`604`,\"data-og-height\":`1404`,height:`1404`,\"data-path\":`images/ee043f80-2025-12-10-15-50-51.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/ee043f80-2025-12-10-15-50-51.png?w=280\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=7fd0ed8a97d1906c3b8f8676d0f24b1f 280w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/ee043f80-2025-12-10-15-50-51.png?w=560\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=729aab5de6a38a43b87c1466892a3298 560w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/ee043f80-2025-12-10-15-50-51.png?w=840\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=6b249e80f8449b0a84fa088e7cd7d1d6 840w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/ee043f80-2025-12-10-15-50-51.png?w=1100\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=6f4cbba0d5a11dc672152249354f5227 1100w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/ee043f80-2025-12-10-15-50-51.png?w=1650\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=eba00d028eb277f5cb83d2c7e0c74dd9 1650w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/ee043f80-2025-12-10-15-50-51.png?w=2500\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=510b01d0a16d15f67adf557edbda4ab3 2500w`})}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/d0af102e-2025-12-10-15-51-07.png?fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=22fd6ac3e2cc8bd9661a238336cc69b1`,alt:`Confirmation screen after granting permissions`,\"data-og-width\":`685`,width:`685`,\"data-og-height\":`733`,height:`733`,\"data-path\":`images/d0af102e-2025-12-10-15-51-07.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/d0af102e-2025-12-10-15-51-07.png?w=280\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=d1e130936eccfc6926ba896a71124153 280w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/d0af102e-2025-12-10-15-51-07.png?w=560\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=8999b84019aa46b38fe024ddafa646d9 560w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/d0af102e-2025-12-10-15-51-07.png?w=840\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=34b95879f7a184fea99796c68c65a454 840w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/d0af102e-2025-12-10-15-51-07.png?w=1100\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=7026d54c2b8fed4603101a8edeb836ea 1100w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/d0af102e-2025-12-10-15-51-07.png?w=1650\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=b60f514f6f3095093a5546232fa4e7e9 1650w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/d0af102e-2025-12-10-15-51-07.png?w=2500\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=cf0e80200c3e879d9ea1fe19d7233daa 2500w`})})]}),_jsxs(Step,{title:`Open the Teams Admin Center setup policies`,children:[_jsxs(_components.p,{children:[`Navigate to the `,_jsx(_components.strong,{children:`Teams Admin Center`}),` (`,_jsx(_components.a,{href:`https://admin.teams.microsoft.com`,children:`https://admin.teams.microsoft.com`}),`) -> Teams apps -> `,_jsx(_components.a,{href:`https://admin.teams.microsoft.com/policies/app-setup`,children:`Setup policies`}),`.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/5fd3dd9c-image.png?fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=7edf08874df4bf6ba4aeafd68bed611d`,alt:`Teams Admin Center setup policies page`,\"data-og-width\":`1920`,width:`1920`,\"data-og-height\":`1052`,height:`1052`,\"data-path\":`images/5fd3dd9c-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/5fd3dd9c-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=2c4b3ea718e3212adb2b95ca5caac64f 280w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/5fd3dd9c-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=eaa6123cfea39702ada32c72e6ed75ea 560w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/5fd3dd9c-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=980e655255f407ac2d2aef8ed25e76d0 840w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/5fd3dd9c-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=15f3ef3f5cea0a2b318d81465556db8f 1100w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/5fd3dd9c-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=f0a1bc0cb10c144d7e7019347df70b5a 1650w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/5fd3dd9c-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=070a556b891630f1d575a2ad0852967f 2500w`})})]}),_jsxs(Step,{title:`Select the Global (Org-wide default) policy`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`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 `,_jsx(_components.a,{href:`/messenger/how-to-roll-out-the-teams-service-app-to-specific-users`,children:`How to roll out the Teams Service app to specific users`}),` here.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/6f26c536-image.png?fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=8f4636806b199b9e073e7635b430f6db`,alt:`Global (Org-wide default) setup policy`,\"data-og-width\":`1540`,width:`1540`,\"data-og-height\":`348`,height:`348`,\"data-path\":`images/6f26c536-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/6f26c536-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=21a737b68d438b6345633ea23980d59b 280w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/6f26c536-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=0582df9c29737e5f5da70b0a83ff760d 560w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/6f26c536-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=5f24e714c0e5fc46cf381d2a7071a48b 840w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/6f26c536-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=3317e9484d8d73eb7633f97a5313cada 1100w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/6f26c536-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=0ec600a78a7e4bc7c7e2f629f1508273 1650w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/6f26c536-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=b2345ee0b896b67a8d74477045d46047 2500w`})})]}),_jsxs(Step,{title:`Add the app under Installed apps`,children:[_jsxs(_components.p,{children:[`Under the `,_jsx(_components.strong,{children:`Installed apps`}),` section, click the `,_jsx(_components.strong,{children:`Add apps`}),` button`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/cdfe1460-image.png?fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=965806d88d34e14603b377a006936f92`,alt:`Add apps button under the Installed apps section`,\"data-og-width\":`1920`,width:`1920`,\"data-og-height\":`1052`,height:`1052`,\"data-path\":`images/cdfe1460-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/cdfe1460-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=cc73e2fdf1fec2283f3337e5e9e981f6 280w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/cdfe1460-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=052e77a411b104939ede8792944479e6 560w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/cdfe1460-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=e982086161a92159dd468211d2213692 840w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/cdfe1460-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=ceda4065605c9289308ca2d59a443d31 1100w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/cdfe1460-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=c1097c4696912fa511c4ae2311a4a21a 1650w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/cdfe1460-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=ae20bb4ba26fcf6303395e674f7b807c 2500w`})})]}),_jsxs(Step,{title:`Find and add the installed app`,children:[_jsxs(_components.p,{children:[`An `,_jsx(_components.strong,{children:`Add installed apps`}),` sidebar will appear. Search for the app based on the `,_jsx(_components.strong,{children:`Teams app name`}),` you defined when building your custom Teams app. `,_jsx(_components.strong,{children:`Find the app`}),`, click `,_jsx(_components.strong,{children:`Add`}),` and `,_jsx(_components.strong,{children:`Add`}),` again at the bottom of the panel.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/9d4a5976-image.png?fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=095346c4a5493ec5745d0ba15dbe7282`,alt:`Add installed apps sidebar searching for the custom Teams app`,\"data-og-width\":`474`,width:`474`,\"data-og-height\":`1039`,height:`1039`,\"data-path\":`images/9d4a5976-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/9d4a5976-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=f9a94a1a77de4153525f7034235ebada 280w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/9d4a5976-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=39f442a0d6ac089bdadbb44ee4562087 560w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/9d4a5976-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=68618d971f36b0a63de20b14c9859d7f 840w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/9d4a5976-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=7a4528d22bbc7258b1a31345f9f8ee4b 1100w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/9d4a5976-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=b55fb07f610c15888f4908e33ddc9bbb 1650w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/9d4a5976-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=0511f25da8c153f52a1ed30ae5906431 2500w`})})]}),_jsxs(Step,{title:`Add the app under Pinned apps`,children:[_jsxs(_components.p,{children:[`Under the `,_jsx(_components.strong,{children:`Pinned apps`}),` section, click the `,_jsx(_components.strong,{children:`+ Add apps`}),` button.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/6cd33349-image.png?fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=eba131aabf762f626531791fc34d7a11`,alt:`Add apps button under the Pinned apps section`,\"data-og-width\":`1583`,width:`1583`,\"data-og-height\":`592`,height:`592`,\"data-path\":`images/6cd33349-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/6cd33349-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=9c28512a10a5803eb869c969300fcd89 280w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/6cd33349-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=53606ec847ccb8bc01c5cf2f441fc477 560w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/6cd33349-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=c7f16fa8752d87ab27af1e4b9534734d 840w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/6cd33349-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=1edf8a0770d3e214433ec56e1ac4148e 1100w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/6cd33349-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=07ce2396cce04067a2e943e9a8f5d99a 1650w, https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/6cd33349-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ysyi1-ysJ96KyxOf\u0026q=85\u0026s=cb21423c220a10d0eadee62b9e1692c7 2500w`})})]}),_jsxs(Step,{title:`Pin the app and save`,children:[_jsxs(_components.p,{children:[`Search for the app based on the `,_jsx(_components.strong,{children:`Teams app name`}),` you defined when building your custom Teams app. `,_jsx(_components.strong,{children:`Find the app`}),`, click `,_jsx(_components.strong,{children:`Add`}),` and `,_jsx(_components.strong,{children:`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 `,_jsx(_components.strong,{children:`Save`}),` when done.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/cc8f36ca-image.png?fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=cce6973289a64d261d82fb3152432db2`,alt:`Custom app listed under Pinned apps`,\"data-og-width\":`474`,width:`474`,\"data-og-height\":`1035`,height:`1035`,\"data-path\":`images/cc8f36ca-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/cc8f36ca-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=32c576526f42f41ad4170f6e0140135c 280w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/cc8f36ca-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=168a78ae9536938758e0497aaf2ea59a 560w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/cc8f36ca-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=59da143bed84d10c388d2660ad23c7d8 840w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/cc8f36ca-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=9c8591de451a5b06d924b3962a46eb2d 1100w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/cc8f36ca-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=0b255a63188185fa1b14bab3f10e1a71 1650w, https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/cc8f36ca-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=MmA6qEMELRi-vXeU\u0026q=85\u0026s=ff27193989e8a3d865b75107c214dcad 2500w`})}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/yMrisProrR453qj0/images/177198b9-image.png?fit=max\u0026auto=format\u0026n=yMrisProrR453qj0\u0026q=85\u0026s=818f92785f4b149f36abdaa108d1aa25`,alt:`Saved pinned app order in the setup policy`,\"data-og-width\":`671`,width:`671`,\"data-og-height\":`693`,height:`693`,\"data-path\":`images/177198b9-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/yMrisProrR453qj0/images/177198b9-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=yMrisProrR453qj0\u0026q=85\u0026s=af047eab013f0c9989cc6887a4701467 280w, https://mintcdn.com/thread/yMrisProrR453qj0/images/177198b9-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=yMrisProrR453qj0\u0026q=85\u0026s=e611e0ff15bf71f4ac560261e28e8c9a 560w, https://mintcdn.com/thread/yMrisProrR453qj0/images/177198b9-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=yMrisProrR453qj0\u0026q=85\u0026s=9953f513102d77f0fc3466d55d4f9680 840w, https://mintcdn.com/thread/yMrisProrR453qj0/images/177198b9-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=yMrisProrR453qj0\u0026q=85\u0026s=6c4db2d6d360ce423724315fd7f0f5cd 1100w, https://mintcdn.com/thread/yMrisProrR453qj0/images/177198b9-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=yMrisProrR453qj0\u0026q=85\u0026s=b62df117bada62d9872f33c58336a440 1650w, https://mintcdn.com/thread/yMrisProrR453qj0/images/177198b9-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=yMrisProrR453qj0\u0026q=85\u0026s=fea9b90711ec20304fcea57f8733fe0e 2500w`})})]})]}),`\n`,_jsx(_components.p,{children:`Congrats, you have upgraded your Legacy Teams app in your customer’s Microsoft 365 tenant. After a short wait period, your end users are ready to start using Messenger.`}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`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.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"How to Upgrade your Legacy Teams App","description":"Upgrade legacy Thread Teams App deployments before Microsoft's deprecation deadline to enable full SSO, auto-updates, and uninterrupted client support.","boost":3,"href":"/messenger/how-to-upgrade-your-legacy-teams-app"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[{"title":"Preliminary Steps","slug":"preliminary-steps","depth":3,"children":[]},{"title":"Deployment Process","slug":"deployment-process","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/thread/e9e74bb66602d208/skill-nav-scroll.js"],"subdomain":"thread","siteName":"Thread Docs","title":"How to Upgrade your Legacy Teams App - Thread Docs","relatedPagesConfig":{"enabled":true,"limit":3,"mode":"automatic"},"contextualStarterQuestions":[{"_id":"6aa319add5166b5aa392554c","deploymentId":"6920f01f9d8412afd5a0dff5","questionText":"What happens if I don't upgrade?","status":"active","generatedBy":"contextual","path":"messenger/how-to-upgrade-your-legacy-teams-app","createdAt":"2026-09-10T20:57:17.697Z","updatedAt":"2026-09-10T20:57:17.697Z","__v":0},{"_id":"6aa319add5166b5aa392554b","deploymentId":"6920f01f9d8412afd5a0dff5","questionText":"Where do I check for legacy apps?","status":"active","generatedBy":"contextual","path":"messenger/how-to-upgrade-your-legacy-teams-app","createdAt":"2026-09-10T20:57:17.697Z","updatedAt":"2026-09-10T20:57:17.697Z","__v":0},{"_id":"6aa319add5166b5aa392554a","deploymentId":"6920f01f9d8412afd5a0dff5","questionText":"How do I upgrade my Teams app?","status":"active","generatedBy":"contextual","path":"messenger/how-to-upgrade-your-legacy-teams-app","createdAt":"2026-09-10T20:57:17.697Z","updatedAt":"2026-09-10T20:57:17.697Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-10T20:56:42.062Z","originalFileLocation":"messenger/how-to-upgrade-your-legacy-teams-app.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Upgrade legacy Thread Teams App deployments before Microsoft\u0026#x27;s deprecation deadline to enable full SSO, auto-updates, and uninterrupted client support.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Thread Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"How to Upgrade your Legacy Teams App - Thread Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Upgrade legacy Thread Teams App deployments before Microsoft\u0026#x27;s deprecation deadline to enable full SSO, auto-updates, and uninterrupted client support.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Thread Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.getthread.com/messenger/how-to-upgrade-your-legacy-teams-app\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://thread.mintlify.site/_mintlify/api/og/v2?division=Legacy\u0026amp;title=How+to+Upgrade+your+Legacy+Teams+App\u0026amp;description=Upgrade+legacy+Thread+Teams+App+deployments+before+Microsoft%27s+deprecation+deadline+to+enable+full+SSO%2C+auto-updates%2C+and+uninterrupted+client+support.\u0026amp;theme=f724fa3ec041ff897ae11da2\u0026amp;signature=8a3866059264a37769a4604de1eb056d9b0ec9f990ddc49e5f7c7b71c5d62ab4\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"How to Upgrade your Legacy Teams App - Thread Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Upgrade legacy Thread Teams App deployments before Microsoft\u0026#x27;s deprecation deadline to enable full SSO, auto-updates, and uninterrupted client support.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://thread.mintlify.site/_mintlify/api/og/v2?division=Legacy\u0026amp;title=How+to+Upgrade+your+Legacy+Teams+App\u0026amp;description=Upgrade+legacy+Thread+Teams+App+deployments+before+Microsoft%27s+deprecation+deadline+to+enable+full+SSO%2C+auto-updates%2C+and+uninterrupted+client+support.\u0026amp;theme=f724fa3ec041ff897ae11da2\u0026amp;signature=8a3866059264a37769a4604de1eb056d9b0ec9f990ddc49e5f7c7b71c5d62ab4\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Thread Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00B398\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.getthread.com/messenger/how-to-upgrade-your-legacy-teams-app\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/messenger/how-to-upgrade-your-legacy-teams-app.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.getthread.com/#organization\",\"name\":\"Thread Docs\",\"url\":\"https://docs.getthread.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/thread/50guKpC0vegpyObR/logo/thread.svg?fit=max\u0026auto=format\u0026n=50guKpC0vegpyObR\u0026q=85\u0026s=86145b5e0fe1e4b555128fc8d8fd9815\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.getthread.com#website\",\"name\":\"Thread Docs\",\"url\":\"https://docs.getthread.com\",\"publisher\":{\"@id\":\"https://docs.getthread.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.getthread.com/messenger/how-to-upgrade-your-legacy-teams-app#webpage\",\"url\":\"https://docs.getthread.com/messenger/how-to-upgrade-your-legacy-teams-app\",\"name\":\"How to Upgrade your Legacy Teams App\",\"description\":\"Upgrade legacy Thread Teams App deployments before Microsoft's deprecation deadline to enable full SSO, auto-updates, and uninterrupted client support.\",\"dateModified\":\"2026-09-10T20:56:42.062Z\",\"isPartOf\":{\"@id\":\"https://docs.getthread.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.getthread.com/messenger/how-to-upgrade-your-legacy-teams-app#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.getthread.com/messenger/how-to-upgrade-your-legacy-teams-app#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Messenger\",\"item\":\"https://docs.getthread.com/inbox/messenger\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Teams Service App\",\"item\":\"https://docs.getthread.com/messenger/deploy-the-teams-service-app\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Legacy\",\"item\":\"https://docs.getthread.com/messenger/cloning-a-legacy-teams-app\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"How to Upgrade your Legacy Teams App\",\"item\":\"https://docs.getthread.com/messenger/how-to-upgrade-your-legacy-teams-app\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.getthread.com/messenger/how-to-upgrade-your-legacy-teams-app#article\",\"headline\":\"How to Upgrade your Legacy Teams App\",\"name\":\"How to Upgrade your Legacy Teams App\",\"description\":\"Upgrade legacy Thread Teams App deployments before Microsoft's deprecation deadline to enable full SSO, auto-updates, and uninterrupted client support.\",\"url\":\"https://docs.getthread.com/messenger/how-to-upgrade-your-legacy-teams-app\",\"mainEntityOfPage\":{\"@id\":\"https://docs.getthread.com/messenger/how-to-upgrade-your-legacy-teams-app#webpage\"},\"dateModified\":\"2026-09-10T20:56:42.062Z\",\"publisher\":{\"@id\":\"https://docs.getthread.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.getthread.com#website\"}}]}\u003c/script>","agentPointerHref":"/messenger/how-to-upgrade-your-legacy-teams-app.md","siteName":"Thread Docs","nav":{"global":null,"tabs":[{"tab":"Start here","icon":"compass","pages":[{"title":"Start here","href":""}]},{"tab":"Onboarding","icon":"graduation-cap","hidden":true,"pages":[{"title":"Onboarding","href":"/onboarding/overview"}]},{"tab":"By role","icon":"users","pages":[{"title":"By role","href":"/start-here/roles/overview"}]},{"tab":"Guides","icon":"book-open","groups":[{"group":"Overview","icon":"book-open","root":{"title":"Product guides","sidebarTitle":"Overview","href":"/guides/overview"},"pages":[]},{"group":"Integrations","icon":"plug","pages":[{"group":"ConnectWise PSA","pages":[{"title":"Set Up the ConnectWise PSA Ticketing Integration","href":"/integrations/creating-a-connect-wise-manage-api-user"},{"title":"Add Thread Pods to ConnectWise Service Tickets","href":"/integrations/how-to-enable-a-pod"},{"title":"Quiet customer emails on a ConnectWise board","href":"/integrations/quiet-customer-emails-on-a-connectwise-board"}]},{"group":"Autotask PSA","pages":[{"title":"Set Up the Autotask PSA Ticketing Integration","href":"/integrations/creating-a-autotask-api-user"},{"title":"Enable Thread Chat \u0026 TimePad Insights in Autotask","href":"/integrations/how-to-enable-chat-and-timepad-insights-in-autotask"},{"title":"Install the Thread for Autotask Chrome extension","href":"/integrations/thread-for-autotask-chrome-extension"},{"title":"Configure Autotask Email Workflow for Thread","href":"/integrations/setting-up-an-email-communication-workflow-in-autotask"},{"title":"Turn off Autotask time entry summary note notifications","href":"/integrations/turn-off-autotask-time-entry-summary-note-notifications"}]},{"group":"Halo PSA","pages":[{"title":"Set Up the HaloPSA Ticketing Integration","href":"/integrations/how-to-setup-halo-psa-integration"},{"title":"Configure HaloPSA Action Mapping for Thread","href":"/integrations/action-mapping-configuration-with-thread"},{"title":"HaloPSA Chat Response Options for Thread","href":"/integrations/halo-response-options"},{"title":"HaloPSA Integration FAQ and Troubleshooting","href":"/integrations/halo-faq"},{"title":"Adding and Removing Contacts in Inbox (HaloPSA)","href":"/inbox/adding-removing-contacts-in-halo-psa"}]},{"group":"PSA Settings","pages":[{"title":"Sync Thread Members with Your PSA Automatically","href":"/integrations/keep-members-in-sync-with-psa-toggle"},{"title":"Log emoji reactions in PSA","href":"/integrations/log-emoji-reactions-in-psa"},{"title":"Manage PSA Board Visibility and Exclusions in Thread","href":"/integrations/managing-board-visibility-in-thread-board-exclusion"}]},{"group":"Other Integrations","pages":[{"title":"Connect Hudu Documentation to Super Magic","href":"/integrations/hudu-integration"},{"title":"Connect IT Glue Documentation to Super Magic","href":"/integrations/it-glue-super-magic"},{"title":"Automate PSA Scheduling with Microsoft Bookings","href":"/integrations/microsoft-bookings-integration-for-psa-scheduling"},{"title":"Connect Pia SmartForms to Thread Triage Agent","href":"/integrations/pia-integration"},{"title":"Connect Auvik Network Monitoring to Thread","href":"/integrations/auvik-integration"},{"title":"Connect CloudRadial to Thread for Client Chat","href":"/integrations/how-to-integrate-cloud-radial"},{"title":"Set Up the ConnectWise Automate Integration","href":"/integrations/how-do-i-set-up-connectwise-automate"},{"title":"Integrate TimeZest Scheduling with Thread Inbox","href":"/integrations/integrating-time-zest-with-thread"}]},{"group":"Push Knowledge Base Articles to IT Glue (beta)","hidden":true,"pages":[{"title":"Push Knowledge Base Articles to IT Glue","href":"/integrations/push-knowledge-base-articles-to-it-glue"}]}]},{"group":"Magic AI","icon":"wand-magic-sparkles","pages":[{"group":"Auto Prioritization","pages":[{"title":"Configure Magic Auto Prioritization","href":"/assistive-ai/how-to-set-up-auto-prioritization"}]},{"group":"Auto Categorization","pages":[{"title":"Configure Auto Categorization in Thread","href":"/assistive-ai/getting-started-with-auto-categorization"},{"title":"Configure Ticket Type Categorization in Autotask and Halo","href":"/assistive-ai/configuring-ticket-type-categorization"}]},{"group":"Auto Title","pages":[{"title":"Configure Magic Title in Thread","href":"/assistive-ai/setting-up-magic-title"},{"title":"Magic Title Rule Creation Guide","href":"/assistive-ai/magic-title-rule-creation-guide"}]},{"group":"Recap Templates","pages":[{"title":"Getting Started with Magic Recap","href":"/assistive-ai/magic-recap"},{"title":"Magic Recap Template Library","href":"/assistive-ai/magic-recap-template-library"}]},{"group":"Sentiment Analysis","pages":[{"title":"Configure Magic Sentiment","href":"/assistive-ai/configure-sentiment"},{"title":"Sentiment Flows, Escalations, and Recap Templates","href":"/assistive-ai/configure-automatic-escalations-and-recap-templates-for-sentiment-analysis"}]},{"group":"Magic AI reference","pages":[{"title":"Using Variables in Magic AI and Magic Agents","href":"/assistive-ai/variables"},{"title":"Best Practices for Writing Magic AI Prompts","href":"/assistive-ai/prompt-best-practices"},{"title":"Prompt engineering tips and tricks","href":"/assistive-ai/prompt-tips-and-tricks"},{"title":"Client Access and how AI runs on tickets","href":"/assistive-ai/client-access-and-run-paths"},{"title":"Magic AI FAQ","href":"/assistive-ai/faq"}]}]},{"group":"Magic Agents","icon":"robot","pages":[{"group":"About Magic Agents","pages":[{"title":"From Triage to Resolution: Agent-Driven Outcomes","href":"/ai-agents/agent-driven-resolutions"}]},{"group":"Triage Agent","pages":[{"title":"Getting Started with Triage Agent","href":"/ai-agents/getting-started-with-triage-agent"},{"title":"Triage Agent Setup User Guide","href":"/ai-agents/setting-up-your-triage-agent-user-guide"},{"title":"Create Your First Triage Agent Intents","href":"/ai-agents/create-your-first-intents"},{"title":"Build Your Magic Agents Service Catalog","href":"/ai-agents/building-your-magic-agents-service-catalog"},{"title":"Intent Creation Assistance Intent","href":"/ai-agents/intent-creation-assistance-intent"},{"title":"Triage Agent Custom Rules (Beta)","href":"/ai-agents/custom-rules-beta-partner-guide"},{"title":"Triage Agent Request Blocking for OOO and Noisy Requests","href":"/ai-agents/triage-agent-request-blocking-and-common-use-cases"},{"title":"Listening Mode for Triage Agents","href":"/ai-agents/listening-mode-for-triage-agents"},{"title":"Automate Approvals with Magic Agents","href":"/ai-agents/approvals"},{"title":"Set Up Email Support for Magic Agents and Inbox","href":"/ai-agents/setting-up-email-support-for-magic-agents"},{"title":"Triage Agent Settings","href":"/ai-agents/triage-agent-settings"},{"title":"Track Magic Agent Activity with a Workflow","href":"/ai-agents/creating-a-workflow-to-track-magic-agent-activity"},{"title":"Trigger Automations with the Triage Agent Automation URL","href":"/ai-agents/magic-agents-automation-url"}]},{"group":"Reminder Agent","pages":[{"title":"Configure Reminder Agent","href":"/ai-agents/reminder-agent"},{"title":"How Reminder Agent Works","href":"/ai-agents/reminder-agent-how-it-works"}]}]},{"group":"Voice AI","icon":"phone","pages":[{"group":"Set up Voice AI","pages":[{"title":"Create your first Voice AI agent","href":"/ai-agents/voice-ai-setup-phase-1-initial-configuration"},{"title":"Answer overflow \u0026 after-hours calls","href":"/ai-agents/voice-ai-setup-phase-2-overflow-after-hours"},{"title":"Replace your phone menu with the Auto-Attendant","href":"/ai-agents/voice-ai-setup-phase-3-the-auto-attendant-walk-run"}]},{"group":"Connect your phone system","pages":[{"title":"Forward your phone system to Voice AI","href":"/ai-agents/connect-your-phone-system-to-voice-ai"},{"title":"Phone system forwarding directory","href":"/ai-agents/phone-system-forwarding-directory"},{"title":"Connect your phone system to Voice AI with a SIP trunk","href":"/ai-agents/voice-ai-sip-trunks-and-caller-id"},{"title":"Connect 3CX to Voice AI with a SIP trunk","href":"/ai-agents/connect-3cx-to-voice-ai-with-a-sip-trunk"},{"title":"Add inbound to your existing Thread-3CX SIP trunk","href":"/ai-agents/add-inbound-to-your-3cx-sip-trunk"}]},{"group":"Tune agent behaviour","pages":[{"title":"Minimal vs Advanced AI mode","href":"/ai-agents/voice-ai-attendant-modes"},{"title":"Voice AI Contact Mapping","href":"/ai-agents/contact-mapping"},{"title":"Voice Shield: Safer Existing-Ticket Handling","href":"/ai-agents/voice-ai-voice-shield"},{"title":"Voice AI Pronunciation Guide","href":"/ai-agents/voice-ai-pronunciation-guide"}]},{"group":"Numbers \u0026 calling","pages":[{"title":"Voice AI Outbound Calling Setup","href":"/ai-agents/voice-ai-outbound-calling"},{"title":"Enable Teams Pay-As-You-Go Calling for Resource Accounts","href":"/ai-agents/microsoft-teams-pay-as-you-go-resource-account-calling"},{"title":"Call an on-call technician from a Flow","href":"/ai-agents/voice-ai-on-call-escalation"}]},{"group":"Troubleshoot","pages":[{"title":"Troubleshoot Voice AI","href":"/ai-agents/voice-ai-troubleshooting"},{"title":"Voice AI FAQ","href":"/ai-agents/voice-ai-faq"}]},{"group":"Changelog","pages":[{"title":"Voice AI updates 2026","sidebarTitle":"2026","href":"/ai-agents/voice-ai-changelog"},{"title":"Voice AI updates 2025","sidebarTitle":"2025","href":"/ai-agents/voice-ai-changelog-2025"}]}]},{"group":"Messenger","icon":"comments","pages":[{"group":"Messenger settings","pages":[{"title":"Messenger Settings: Configure Chat, Design, and Hours","href":"/inbox/messenger"},{"title":"Multi-language support in Messenger","href":"/messenger/multi-language-support"}]},{"group":"Teams Service App","pages":[{"title":"Deploy the Teams Service App to a customer","href":"/messenger/deploy-the-teams-service-app"},{"title":"Design a Custom Teams App for Your Customers","href":"/messenger/create-teams-app"},{"title":"How to Roll Out the Teams Service App to Specific Users","href":"/messenger/how-to-roll-out-the-teams-service-app-to-specific-users"},{"title":"Enterprise Teams Support: Shared M365 Tenants","href":"/messenger/enterprise-teamssupport"},{"title":"How to Uninstall the Microsoft Teams Service App","href":"/messenger/how-to-uninstall-the-microsoft-teams-thread-service-app"},{"title":"Microsoft Teams 2.0 FAQs","href":"/messenger/microsoft-teams-2-0-faqs"},{"group":"Legacy","pages":[{"title":"Cloning a Legacy Teams App","description":"Clone a legacy Microsoft Teams app in Thread to duplicate its settings and migrate off MultiTenant — Microsoft's March 2026 deprecation has passed.","href":"/messenger/cloning-a-legacy-teams-app"},{"title":"How to Upgrade your Legacy Teams App","href":"/messenger/how-to-upgrade-your-legacy-teams-app"}]}]},{"group":"Desktop Service App","pages":[{"title":"Deploy Messenger on Windows via command line","description":"Install Thread Messenger on Windows with msiexec: get your App ID, pick per-user or system context, PowerShell examples, and uninstall scripts.","href":"/messenger/deploying-messenger-on-windows"},{"title":"Deploying Messenger to Mac","href":"/messenger/deploying-messenger-to-mac"},{"title":"How to Deploy Desktop Messenger with SSO","href":"/messenger/how-to-deploy-desktop-messenger-with-sso"},{"title":"Kiosk Mode","href":"/messenger/kiosk-mode"}]},{"group":"Web Service App","pages":[{"title":"Embedding Messenger on a Landing Page","href":"/messenger/embedding-messenger-on-landing-page"},{"title":"Messenger Portal Auto Authentication","href":"/messenger/messenger-identity-verification"},{"title":"Emoji reactions in Messenger","href":"/messenger/emoji-reactions"}]},{"group":"Slack Service App","pages":[{"title":"Deploy the Slack Service App to a customer","href":"/messenger/deploy-the-slack-service-app"}]},{"group":"Messenger FAQ","pages":[{"title":"How Configurations and Assets Work in Messenger Chat","href":"/messenger/configurations-in-messenger"}]},{"group":"Chat routing \u0026 entry points","pages":[{"title":"Add a Chat Now Button to PSA Ticket Emails","href":"/messenger/add-chat-now-button-email"},{"title":"Route chats to the right board","href":"/messenger/route-chats-to-the-right-board"},{"title":"Show All Tickets in Chat and Excluded Boards","href":"/messenger/show-all-tickets-in-chat-and-excluded-board-source"}]},{"group":"Client Portal (Beta)","hidden":true,"pages":[{"title":"Give a client's site contacts a Client Portal","href":"/messenger/client-portal-for-site-contacts"}]}]},{"group":"Thread Inbox","icon":"inbox","pages":[{"group":"Tour Inbox","pages":[{"title":"Inbox Navigation: Rail, Side Panel, and Views","href":"/inbox/inbox-navigation"},{"title":"Inside a View: Inbox vs. List Display Modes","href":"/inbox/inside-a-view"},{"title":"Navigating a Thread in Inbox","href":"/inbox/navigating-a-thread"},{"title":"Thread Control Panel: Contact, TimePad, and AI Insights","href":"/inbox/thread-control-panel"}]},{"group":"Set up teams \u0026 dispatch","pages":[{"title":"Set Up Thread Inbox by Service Team Structure","href":"/inbox/service-team-structure"},{"title":"Inbox Teams: Group Members and Share Views at Scale","href":"/inbox/inbox-teams"},{"title":"Views and Insights in Thread Inbox","href":"/inbox/views-and-insights"},{"title":"Set up XLA Profiles in Thread","href":"/inbox/sla-timers-and-response-settings"}]},{"group":"Work tickets","pages":[{"title":"Create an Email Signature Using Thread Snippets","hidden":true,"href":"/inbox/how-to-create-an-email-signature-using-snippets"},{"title":"Set Up a SmileBack CSAT Survey with Snippets","href":"/inbox/how-to-setup-a-csat-survey"},{"title":"Approvals in Inbox: Request and Manage Decisions","href":"/inbox/approvals-in-inbox"},{"title":"Configure Autotask UDFs for Thread Approvals","href":"/inbox/autotask-approval-configuration"},{"title":"Default Work Role and Type Logic in Time Entries","href":"/inbox/default-work-role-type-logic"},{"title":"Track your time with TimePad","href":"/inbox/track-your-time-with-timepad"}]},{"group":"Plan work","pages":[{"title":"Planner and Outlook Calendar Integration","href":"/inbox/planner-outlook-calendar-integration"},{"title":"Schedule work in Planner","href":"/inbox/using-planner"}]},{"group":"Business hours","pages":[{"title":"Business Hours, Holidays, and Custom Closures","href":"/inbox/holidays-and-custom-closures"}]},{"group":"Email channel (Beta)","hidden":true,"pages":[{"title":"Turn a Microsoft 365 mailbox into a ticket channel","href":"/inbox/turn-a-microsoft-365-mailbox-into-a-ticket-channel"}]},{"group":"What's new (Beta)","hidden":true,"pages":[{"title":"See what's new in Thread from Inbox and Admin Panel","href":"/inbox/see-whats-new-in-thread"}]},{"group":"Global search","pages":[{"title":"Global search","sidebarTitle":"Global search","icon":"magnifying-glass","href":"/inbox/global-search"},{"title":"Find a ticket by its ticket number in Inbox","href":"/inbox/find-a-ticket-by-its-number"}]},{"group":"Status colors","pages":[{"title":"Customize PSA status colors in Thread","href":"/inbox/customize-status-colors"}]}]},{"group":"Flows","icon":"diagram-project","pages":[{"group":"Flows","pages":[{"title":"Flows: Automate Thread Routing and Actions in Inbox","href":"/inbox/flows"},{"title":"Flows Audit Log: Review Every Run","sidebarTitle":"Flows Audit Log","href":"/inbox/flows-audit-log"},{"title":"See what an agent did during a flow run","href":"/inbox/see-what-a-super-magic-agent-did-during-a-flow-run"},{"title":"Status Automations: Auto-Update Thread Statuses","href":"/inbox/status-automations"}]},{"group":"Workflows (Beta)","hidden":true,"pages":[{"title":"Build an automation with Workflows in Thread Admin","href":"/inbox/build-automations-with-workflows"}]},{"group":"CSAT survey action (Beta)","hidden":true,"pages":[{"title":"Send a CSAT survey from a Flow","sidebarTitle":"Send CSAT survey action","href":"/inbox/send-a-csat-survey-from-a-flow"},{"title":"Crewhu CSAT Survey Integration","href":"/crewhu-csat-survey-integration"}]},{"group":"Thread CSAT surveys (Beta)","hidden":true,"pages":[{"title":"Send Thread's built-in CSAT survey when a ticket closes","sidebarTitle":"Thread CSAT surveys","href":"/inbox/send-thread-csat-surveys"}]},{"group":"CSAT ratings report (Beta)","hidden":true,"pages":[{"title":"Review and export CSAT ratings in Thread Admin","sidebarTitle":"CSAT ratings report","href":"/inbox/review-csat-ratings-in-thread-admin"}]},{"group":"Status mapping","pages":[{"title":"Configure Status Mapping in Thread","href":"/get-started/status-mapping-in-thread"}]}]},{"group":"Agent Builder","icon":"robot","pages":[{"title":"Build an agent with Agent Builder","href":"/super-magic/build-a-super-magic-agent"},{"title":"Chaining skills","href":"/super-magic/chaining-skills"}]},{"group":"Auto Dispatch","icon":"route","pages":[{"group":"Auto-dispatch","hidden":false,"pages":[{"title":"Auto-dispatch profiles","hidden":false,"href":"/inbox/auto-dispatch-profiles"},{"title":"Set your availability for auto-dispatch","hidden":false,"href":"/inbox/available-for-dispatch"},{"title":"Team Home for Auto-dispatch","hidden":false,"href":"/inbox/team-home"},{"title":"Scheduling and work schedules for Auto-dispatch","sidebarTitle":"Scheduling and work schedules","hidden":false,"href":"/inbox/scheduling-and-work-schedules"}]},{"group":"Work schedules (Beta)","pages":[{"title":"Create and manage work schedules","href":"/inbox/create-and-manage-work-schedules"}]},{"group":"Dispatch scenarios","pages":[{"title":"Tiered dispatch","href":"/inbox/dispatch-scenarios/tiered-dispatch-on-a-shared-board"}]}]},{"group":"Super Magic \u0026 Thread MCP","icon":"sparkles","pages":[{"group":"Using Super Magic","pages":[{"title":"Meet Super Magic: Your AI Agent in Inbox","href":"/super-magic/meet-super-magic-your-ai-assistant-in-the-inbox"},{"title":"Super Magic Admin Guide: Setup, Access \u0026 Safety","href":"/super-magic/super-magic-admin-guide-setup-access-safety"},{"title":"Proactive Suggestions in Super Magic","href":"/super-magic/proactive-suggestions"},{"title":"Share Super Magic chats with teammates","href":"/super-magic/share-super-magic-chats-with-teammates"},{"title":"Tag teammates in ticket notes with Super Magic","href":"/super-magic/tag-teammates-in-ticket-notes-with-super-magic"},{"title":"Connect Knowledge Sources to Super Magic","href":"/super-magic/connect-it-glue-hudu-time-zest-knowledge-sources-to-super-magic"},{"title":"Super Magic prompting 101","href":"/super-magic/prompting-101"},{"title":"Super Magic FAQ","href":"/super-magic/faq"}]},{"group":"Super Magic Tools","pages":[{"title":"Add External Tools to Super Magic with Connectors","href":"/super-magic/add-external-tools-to-super-magic-with-connectors-super-mcp"},{"title":"Add a custom MCP connector to Super Magic","href":"/super-magic/add-a-custom-mcp-connector-to-super-magic"},{"title":"Connect Halo MCP to Super Magic","href":"/super-magic/connect-halo-mcp-to-super-magic"},{"title":"Connect NinjaOne to Super Magic","href":"/super-magic/connecting-ninja-one-to-super-magic"},{"title":"Use Hudu with Super Magic","href":"/super-magic/use-hudu-with-super-magic"},{"title":"Use ImmyBot with Super Magic","href":"/super-magic/use-immybot-with-super-magic"},{"title":"Use IT Glue with Super Magic","href":"/super-magic/use-it-glue-with-super-magic"},{"title":"Use Linear with Super Magic","href":"/super-magic/use-linear-with-super-magic"},{"title":"Use Liongard with Super Magic","href":"/super-magic/use-liongard-with-super-magic"},{"title":"Use Notion with Super Magic","href":"/super-magic/use-notion-with-super-magic"},{"title":"Use TimeZest with Super Magic","href":"/super-magic/use-time-zest-with-super-magic"},{"title":"Use Zapier with Super Magic","href":"/super-magic/use-zapier-with-super-magic"},{"title":"Use Atlassian (Jira and Confluence) with Super Magic","href":"/super-magic/use-atlassian-with-super-magic"},{"title":"Use CIPP with Super Magic","href":"/super-magic/use-cipp-with-super-magic"},{"title":"Use Lexful with Super Magic (beta)","href":"/super-magic/use-lexful-with-super-magic"},{"title":"Use ClickUp with Super Magic","href":"/super-magic/use-clickup-with-super-magic"},{"title":"Use Cloudflare with Super Magic","href":"/super-magic/use-cloudflare-with-super-magic"},{"title":"Use monday.com with Super Magic","href":"/super-magic/use-monday-with-super-magic"},{"title":"Use Vanta with Super Magic","href":"/super-magic/use-vanta-with-super-magic"},{"title":"Use ConnectWise RMM with Super Magic","href":"/super-magic/connect-connectwise-rmm"}]},{"group":"Thread MCP","pages":[{"title":"Thread MCP Server: Developer Guide","href":"/super-magic/thread-mcp-server-developer-guide"},{"title":"Control who can connect AI apps to Thread MCP","sidebarTitle":"Control who can connect AI apps","href":"/super-magic/control-who-can-connect-ai-apps-to-thread-mcp"},{"title":"Super Magic Tool Reference","href":"/super-magic/super-magic-tool-reference"}]},{"group":"MCP automation keys","hidden":false,"pages":[{"title":"Issue MCP automation keys for team members","href":"/super-magic/issue-mcp-automation-keys-for-team-members"}]},{"group":"Personal service agents (Beta)","hidden":true,"pages":[{"title":"Create a personal service agent in Super Magic","href":"/super-magic/create-a-personal-service-agent-in-super-magic"}]},{"group":"Auto mode (Beta)","hidden":true,"pages":[{"title":"Let Super Magic make changes without asking (Auto mode)","href":"/super-magic/let-super-magic-make-changes-without-asking-auto-mode"}]},{"group":"Developer reference","pages":[{"title":"Webhooks \u0026 APIs: How Thread Talks to Your PSA","href":"/get-started/webhooks-apis-how-thread-talks-to-your-psa"},{"title":"Trigger Rewst Workflows from Thread Magic Intents","href":"/integrations/thread-rewst-integration"}]}]},{"group":"Companion Apps","icon":"puzzle-piece","pages":[{"group":"Teams Companion App","pages":[{"title":"Install the Teams Companion App","href":"/companion-apps/install-the-teams-companion-app"}]},{"group":"Slack Companion App","pages":[{"title":"Install the Slack Companion App","href":"/companion-apps/install-the-slack-companion-app"},{"title":"How to Use the Slack Companion App for Service Teams","href":"/companion-apps/how-to-use-the-slack-companion-app-for-service-teams"}]},{"group":"Channel settings","pages":[{"title":"Choose which ticket updates post to a channel","href":"/companion-apps/choose-which-ticket-updates-post-to-channel"}]},{"group":"Super Magic in Companion Apps (Beta)","hidden":true,"pages":[{"title":"Use Super Magic in Microsoft Teams and Slack","href":"/companion-apps/use-super-magic-in-teams-and-slack"}]}]},{"group":"Service Intelligence","icon":"brain","pages":[{"group":"Contact Intelligence","pages":[{"title":"Contact Intelligence Overview","href":"/ai-agents/contact-intelligence"},{"title":"Contact Intelligence FAQ","href":"/ai-agents/contact-intelligence-faq"}]},{"group":"Knowledge Intelligence","pages":[{"title":"Getting Started with Client Intelligence","href":"/ai-agents/getting-started-with-knowledge"},{"title":"Client Intelligence Service Tech Guide","href":"/ai-agents/knowledge-intelligence-service-tech-guide"}]}]},{"group":"Magic Analytics","icon":"chart-line","pages":[{"group":"Get started","pages":[{"title":"Getting Started with Magic Analytics","href":"/analytics/getting-started-with-magic-analytics"},{"title":"Magic Analytics Topics You Can Explore","href":"/analytics/topics-you-can-explore"}]},{"group":"Dashboards","pages":[{"title":"ROI Value Realization Dashboard","href":"/analytics/roi-value-realization-dashboard"},{"title":"Assistive AI Accuracy Dashboard","href":"/analytics/assistive-ai-accuracy-dashboard"},{"title":"Triage Agent Summary Dashboard","href":"/analytics/triage-agent-dashboard"},{"title":"Voice AI Analytics dashboard","href":"/analytics/voice-ai-dashboard"},{"title":"Messenger Analytics Dashboard","href":"/analytics/messenger-analytics-dashboard"},{"title":"Service Team Performance \u0026 AI Usage Dashboard","href":"/analytics/service-team-performance-dashboard"},{"title":"Super Magic Usage Dashboard","href":"/analytics/super-magic-usage-dashboard"}]},{"group":"Work with your data","pages":[{"title":"Dashboard Agent: query Magic Analytics in plain English","href":"/analytics/dashboard-agent"},{"title":"Downloads, Alerts, and Scheduled Delivery","href":"/analytics/downloading-alerts-scheduling"}]},{"group":"Reference","pages":[{"title":"Magic Analytics: Things to Know and Gotchas","href":"/analytics/things-to-know-and-gotchas"},{"title":"Magic Analytics FAQs","href":"/analytics/faqs"}]}]},{"group":"Workspace administration","icon":"sliders","pages":[{"group":"Workspace \u0026 branding","pages":[{"title":"Workspace Defaults: Time Zone and TimePad Settings","href":"/inbox/workspace"},{"title":"Member and Contact Avatars in Inbox and Messenger","href":"/inbox/avatars"},{"title":"Dark mode and themes","sidebarTitle":"Dark mode and themes","href":"/inbox/dark-mode-and-themes"}]},{"group":"Members \u0026 access","pages":[{"title":"Managing Members in Thread Admin","href":"/inbox/members-management"},{"title":"Team Admin Role: Scoped Admin Permissions","href":"/inbox/team-admin-role"},{"title":"Restrict a member's access to specific clients","href":"/inbox/restrict-member-access-to-specific-clients"},{"title":"Set Up Single Sign-On (SSO) with Microsoft 365","href":"/inbox/how-to-setup-single-sign-on-sso"}]},{"group":"Clients","pages":[{"title":"Clients Tab: Managing Companies and Messenger Deployment","href":"/inbox/clients-tab"}]},{"group":"End-user verification","pages":[{"title":"Thread Verify","sidebarTitle":"Thread Verify","href":"/inbox/verify"}]}]},{"group":"Notifications","icon":"bell","pages":[{"group":"For your Team","pages":[{"title":"How Notifications Work for your Team","href":"/notifications/how-will-notifications-work-internally"},{"title":"How to Manage Your Inbox Notifications","href":"/notifications/managing-your-inbox-notifications"}]},{"group":"For your Customers","pages":[{"title":"How Notifications Work for your Customers","href":"/notifications/how-notifications-work-externally"}]}]},{"group":"Security \u0026 compliance","icon":"shield-halved","pages":[{"group":"Security reviews","pages":[{"title":"Thread Trust Center","href":"/security-billing/soc-2-and-compliance-status"}]},{"group":"Data \u0026 AI handling","pages":[{"title":"Data \u0026 Encryption","href":"/security-billing/data-encryption"},{"title":"Magic AI Privacy \u0026 Security Overview","href":"/security-billing/magic-ai-privacy-security"},{"title":"Claude on AWS Bedrock","href":"/security-billing/claude-on-aws-bedrock"},{"title":"Thread Sub-Processors List","href":"/security-billing/list-of-sub-processors"}]},{"group":"Network \u0026 app permissions","pages":[{"title":"Thread IP Addresses and Domains to Allowlist","href":"/security-billing/what-if-my-organization-has-ip-restrictions"},{"title":"Microsoft Teams App Permissions Reference","href":"/security-billing/microsoft-teams-app-permissions"},{"title":"Slack App Permissions Guide","href":"/security-billing/slack-permissions-guide"}]}]},{"group":"Plans \u0026 billing","icon":"credit-card","pages":[{"group":"Plans \u0026 licensing","pages":[{"title":"Access Your Thread Billing Portal","href":"/security-billing/how-to-access-your-thread-billing-portal"},{"title":"Plans and Licenses: AI and Chat License Management","href":"/inbox/plans-licenses"}]}]},{"group":"Automagically","icon":"wand-magic-sparkles","pages":[{"group":"Get started","pages":[{"title":"Automagically: Getting Started","sidebarTitle":"Getting started","href":"/automagically/automagically-getting-started"},{"group":"Running Runbooks","pages":[{"title":"Automagically: Running Runbooks","sidebarTitle":"Running Runbooks","href":"/automagically/automagically-running-runbooks"},{"title":"Running from Automagically","href":"/automagically/running-runbooks/running-from-automagically"},{"title":"Running from the ticket","href":"/automagically/running-runbooks/running-from-the-ticket"},{"title":"Running from Super Magic","href":"/automagically/running-runbooks/running-from-super-magic"},{"title":"Runbook Execution Results","href":"/automagically/running-runbooks/runbook-execution-results"}]},{"title":"Automagically: Approving Runbooks","sidebarTitle":"Approving Runbooks","href":"/automagically/automagically-approving-runbooks"},{"title":"Modifying a Runbook","sidebarTitle":"Modifying a Runbook","href":"/automagically/modifying-a-runbook"},{"title":"Connect Microsoft 365 clients","sidebarTitle":"Connect Microsoft 365 clients","href":"/automagically/connect-microsoft-365-clients"},{"title":"Automagically: Building a Runbook","sidebarTitle":"Building a Runbook","href":"/automagically/building-a-runbook"}]},{"group":"Configure","hidden":true,"pages":[{"title":"Automagically: Client Access","href":"/automagically/automagically-client-access"},{"title":"Managing Microsoft 365 client connections","href":"/automagically/automagically-microsoft-365-integrations"},{"title":"Microsoft 365 permissions reference","href":"/automagically/automagically-microsoft-365-permissions"}]},{"group":"Security \u0026 compliance","pages":[{"title":"Automagically security and compliance controls","href":"/automagically/automagically-security-controls"}]}]}]},{"tab":"Magic Library","icon":"https://mintlify.s3.us-west-1.amazonaws.com/thread/logo/stars.svg","pages":[{"title":"Magic Library","href":"/skill-library/overview"}]},{"tab":"Resources","icon":"folder-open","pages":[{"title":"Resources","href":"/events-and-resources"}]}]},"basePath":"","title":"How to Upgrade your Legacy Teams App - Thread Docs","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["10e4515597","07c022d89b","a74be98ba7"],"chunks":["BannerMarkdown-Dlc3Qr3h.js","dist-D2J8knkn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-Dq9TQuNi.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","Frame-D2acuaLg.js","DynamicMarkdown-Co5nikxh.js","zoom-image-lightbox-BbK2OBGL.js","lightbox-handle-r17bVUz3.js"]}