Install the Thread Teams Companion App in your own Microsoft 365 tenant: connect the integration, upload the app manifest, and add a setup policy.
The Teams Companion App puts your service threads inside Microsoft Teams for your own
technicians — notifications when you’re assigned a thread, ticket updates in-line in a channel,
and full thread management without leaving Teams.
This guide connects the Companion App to your own Microsoft 365 tenant, for your service
team. To deploy a Teams app to a customer’s tenant, use the Teams Service App instead — they are different apps with different audiences.
What you get
Notifications when you’re assigned as owner of a thread.
Custom Flows that route threads to a Teams channel you choose.
Real-time updates: replies, internal notes, status and board changes, as they happen in your PSA or Inbox.
Thread management: collaborate internally, sync notes to the PSA, reply to the customer, and change status, priority, board and contact from Teams.
Ticket mention cards: when someone writes “Thread #123” in a channel, the app posts a live card for that ticket. To stop this, go to Integrations → Microsoft 365 & Teams app and turn off Ticket mention cards on the Companion App card. It’s on by default.
Before you start
You need administrator credentials for your company’s Microsoft 365 environment, and access to
the Microsoft Teams admin center.
Connect Microsoft 365
1
Open the Microsoft 365 & Teams integration
In the Thread Admin Panel, go to Integrations → Microsoft 365 & Teams app.
2
Click Connect
3
Choose Connect with Microsoft Teams
4
Sign in as an administrator
Sign in to your company’s Microsoft 365 environment with administrator credentials.
After consent you’re redirected to the Teams app setup instructions.
Upload the app to your tenant
1
Download the manifest
On the Teams Companion App Installation screen, click Download Teams Companion App. Upload it as a .zip. Do not extract it.Thread shows this screen only until the app is installed in a team. If the integration already shows Connected, see Download the manifest after the integration is connected.
2
Open the Teams admin center
In the same browser session, sign in to admin.teams.microsoft.com and go to Teams Apps → Manage Apps.
3
Upload the .zip
Choose to upload a custom app, then select the .zip you downloaded.
4
Confirm the app was added
Add it to a setup policy
Uploading makes the app available; a setup policy installs it for your users.
1
Open Setup Policies
Close the New app added prompt, then go to Teams Apps → Setup Policies and select Global (Org-wide default).
2
Add the Thread app
Under Installed apps, click Add apps, search for “Thread”, select it and click Add.
3
Optionally pin it, then save
You can pin Thread to the Teams app bar, though it isn’t required. Click Save.
The app appears faster in Teams on the web. Give the desktop client up to 24 hours.
Add the app to a team
Adding the app to a team is what lets you route threads to that team’s channels and interact with
the bot from inside it.
1
Find the app in Manage Apps
In the Teams admin center, go to Teams Apps → Manage Apps and search for the Thread Companion App you just installed.
2
Click Add to a team
Type the team you want to add it to.
The team matters more than the channel — when you build a Flow in Thread you can create new channels under that team from inside Thread. The bot cannot interact with private channels.
3
Choose whether to post about Thread, then save
Decide whether to announce Thread in the channel, then click Save.
You can now create a Flow in Inbox and get notified about those threads in Teams.
FAQ
How do I add the app to another team?
Repeat Add the app to a team for each team you want. You only need to add the app to a given team once — after that the bot can reach any public channel created under it, and you can create new channels under that team from Thread’s Flow builder.
Do I associate the Companion App to a team from Microsoft 365 or from Thread?
You associate the Companion App to a team Microsoft 365-side, not from Thread. In the Microsoft Teams admin center, go to Teams Apps → Manage Apps, find the Thread Companion App you uploaded, and click Add to a team. Once the app is attached to that team, the bot can reach any public channel under it, and you can create new channels under that team from Thread’s Flow builder. The bot cannot interact with private channels.
How do I uninstall and redeploy the Companion App?
The Companion App uses the same manifest-based install as the Teams Service App, so the Teams admin-center mechanics are the same — the difference is that the Companion App is internal to your own tenant, so there’s no per-customer step in Thread Admin.To remove it:
If you also want to stop the app being auto-installed for users, open Teams Apps → Setup Policies → Global (Org-wide default) and remove Thread from Installed apps before you save.
Download the manifest after the integration is connected
Once the Teams Companion App shows Connected under Integrations → Microsoft 365 & Teams app, the Thread Admin Panel no longer shows a download button. The card offers Reintegrate and Disconnect instead. You don’t need either one to get the manifest.The Companion App manifest is the same file for every Thread workspace. Download it directly from this link, which is the same file the Download Teams Companion App button serves during setup. Then follow Upload the app to your tenant and Add it to a setup policy.
How do I re-authorize the Companion App?
Go to Integrations → Microsoft 365 & Teams app and click Reintegrate, next to Disconnect. Reintegrate re-authorizes the Companion App in place: same Microsoft tenant, same channels, flows and settings. Nothing is removed, and the app keeps working throughout.You can’t reintegrate into a different Microsoft tenant. To switch tenants, click Disconnect first. If the attempt is cancelled or fails, you return to the integration page with an explanation. Reintegrating doesn’t affect the Teams Service Apps you deploy to your customers’ tenants.
{"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":"companion-apps/install-the-teams-companion-app","slug":"/companion-apps/install-the-teams-companion-app","pageMetadata":{"title":"Install the Teams Companion App","description":"Install the Thread Teams Companion App in your own Microsoft 365 tenant: connect the integration, upload the app manifest, and add a setup policy.","keywords":"teams companion app, install, microsoft teams, setup policy, manifest, upload custom app, internal facing, service team","boost":3,"href":"/companion-apps/install-the-teams-companion-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: \"Install the Thread Teams Companion App in your own Microsoft 365 tenant: connect the integration, upload the app manifest, and add a setup policy.\"\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`,code:`code`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Frame,Heading,Note,OptimizedImage,Step,Steps,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);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(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Teams Companion App`}),` puts your service threads inside Microsoft Teams for your own\ntechnicians — notifications when you’re assigned a thread, ticket updates in-line in a channel,\nand full thread management without leaving Teams.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`This guide connects the Companion App to `,_jsx(_components.strong,{children:`your own`}),` Microsoft 365 tenant, for your service\nteam. To deploy a Teams app to a `,_jsx(_components.strong,{children:`customer’s`}),` tenant, use the `,_jsx(_components.a,{href:`/messenger/create-teams-app`,children:`Teams Service App`}),` instead — they are different apps with different audiences.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`what-you-get`,children:`What you get`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Notifications`}),` when you’re assigned as owner of a thread.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Custom Flows`}),` that route threads to a Teams channel you choose.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Real-time updates`}),`: replies, internal notes, status and board changes, as they happen in your PSA or Inbox.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Thread management`}),`: collaborate internally, sync notes to the PSA, reply to the customer, and change status, priority, board and contact from Teams.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Ticket mention cards`}),`: when someone writes “Thread #123” in a channel, the app posts a live card for that ticket. To stop this, go to `,_jsx(_components.strong,{children:`Integrations → Microsoft 365 \u0026 Teams app`}),` and turn off `,_jsx(_components.strong,{children:`Ticket mention cards`}),` on the Companion App card. It’s on by default.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsxs(_components.p,{children:[`You need administrator credentials for your company’s Microsoft 365 environment, and access to\nthe `,_jsx(_components.a,{href:`https://admin.teams.microsoft.com`,children:`Microsoft Teams admin center`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`connect-microsoft-365`,children:`Connect Microsoft 365`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open the Microsoft 365 \u0026 Teams integration`,children:[_jsxs(_components.p,{children:[`In the Thread Admin Panel, go to `,_jsx(_components.strong,{children:`Integrations → Microsoft 365 \u0026 Teams app`}),`.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/1ce9704d-image.png?fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=67e48559c727c1d13ff00b231f014e27`,alt:`Microsoft 365 and Teams app tile on the Integrations page of the Thread Admin Panel`,\"data-og-width\":`3024`,width:`3024`,\"data-og-height\":`1350`,height:`1350`,\"data-path\":`images/1ce9704d-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/1ce9704d-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=4cee7f209e813d0e8320cf2c3f87fb95 280w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/1ce9704d-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=fc7ba40eb4232b8d66e60ff925477b59 560w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/1ce9704d-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=62488631ed05932c9ae408ec26298088 840w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/1ce9704d-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=c1e3c6fb26ff55cb095bf06f8cad6f7a 1100w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/1ce9704d-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=bdcdab0271dead9476a3e2c86fe68254 1650w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/1ce9704d-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=45ac6149b8e890768078bfeef17d6e4f 2500w`})})]}),_jsx(Step,{title:`Click Connect`,children:_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/0099af95-image.png?fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=bfbb31e521ffe8511cc5501f0ded0cd4`,alt:`Connect button on the Microsoft 365 and Teams integration panel`,\"data-og-width\":`3024`,width:`3024`,\"data-og-height\":`1350`,height:`1350`,\"data-path\":`images/0099af95-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/0099af95-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=5cff9a5ab7038eac8ddcd620aebaeb7c 280w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/0099af95-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=184a3f5ed5694af9433bb5ff6be04ad0 560w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/0099af95-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=29585c7ef85698f358a5d2fbcf3d99a8 840w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/0099af95-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=d6332f22271600365c1bc2d9459f9f54 1100w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/0099af95-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=a15e01ea4e10e6b846bd57b6b221eb05 1650w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/0099af95-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=6b703329bc856deaea2e1e955b806e20 2500w`})})}),_jsx(Step,{title:`Choose Connect with Microsoft Teams`,children:_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/38f2fdf9-image.png?fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=4ed7f9a58da6167ce82ce0e7f633783d`,alt:`Connect with Microsoft Teams option in the Thread Admin Panel`,\"data-og-width\":`3024`,width:`3024`,\"data-og-height\":`1350`,height:`1350`,\"data-path\":`images/38f2fdf9-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/38f2fdf9-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=930d92faf53014017ad528634d15bf7a 280w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/38f2fdf9-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=b427d0d46158fc96346d8a4bdea6d717 560w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/38f2fdf9-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=82955e8b9057d26cc0a8e23d266786ab 840w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/38f2fdf9-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=fbc4e69590f412e0f8f28dbf1dc1fa53 1100w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/38f2fdf9-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=1056bf18fd4ccbd58cd658c1da985300 1650w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/38f2fdf9-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=cb35b6d312d3f8607ebd2d1b7af61903 2500w`})})}),_jsxs(Step,{title:`Sign in as an administrator`,children:[_jsx(_components.p,{children:`Sign in to your company’s Microsoft 365 environment with administrator credentials.`}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/5e86723e-image.png?fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=d2285633dbd18908442d754ef37ce644`,alt:`Microsoft Online sign-in page requesting administrator credentials`,\"data-og-width\":`1170`,width:`1170`,\"data-og-height\":`1070`,height:`1070`,\"data-path\":`images/5e86723e-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/5e86723e-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=1b9a9b99e91443228c4143b7b231fd80 280w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/5e86723e-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=78dddad24b41f4306b0c775f8a695edc 560w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/5e86723e-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=bedbbd95b58bbcde49f5fec0a6c116c0 840w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/5e86723e-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=38955586eacdd4a6a0693708186e1de3 1100w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/5e86723e-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=f0e10ba6c441e9d4933b79e85eb8ae40 1650w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/5e86723e-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=932c555e9a4082b4671d3e54d2f13388 2500w`})})]}),_jsxs(Step,{title:`Accept the requested permissions`,children:[_jsxs(_components.p,{children:[`Review the permissions the app requests and click `,_jsx(_components.strong,{children:`Accept`}),`. The full list is documented in the `,_jsx(_components.a,{href:`/security-billing/microsoft-teams-app-permissions`,children:`Microsoft Teams app permissions reference`}),`.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/756b85e7-image.png?fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=150dfc86f52e7ad15a479925149ff68a`,alt:`Microsoft consent screen listing the permissions requested by the Thread Teams app`,\"data-og-width\":`3024`,width:`3024`,\"data-og-height\":`1890`,height:`1890`,\"data-path\":`images/756b85e7-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/756b85e7-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=3340b6d56797e8aa781f1b5dccc33020 280w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/756b85e7-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=3b48b402a1ba5630b78a2544a13aee67 560w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/756b85e7-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=c56edc67199d079cf44ebca7eda693b5 840w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/756b85e7-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=37f6e94f6b15d807b2a80e0e5803fefa 1100w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/756b85e7-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=ccce782521ab6ecaa409734834ef8e96 1650w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/756b85e7-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=95c74647882a11e87ed991fbbd73f595 2500w`})})]}),_jsxs(Step,{title:`Land on the setup instructions`,children:[_jsx(_components.p,{children:`After consent you’re redirected to the Teams app setup instructions.`}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4b6eda95-image.png?fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=63c8807b779a718192e050d2060f4433`,alt:`Teams app setup instructions shown after granting Microsoft consent`,\"data-og-width\":`3024`,width:`3024`,\"data-og-height\":`1890`,height:`1890`,\"data-path\":`images/4b6eda95-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4b6eda95-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=9c7d2b07caf9a0f066f316e1fe795d03 280w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4b6eda95-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=c99a4ec884cb9c70c792dec3c1139e90 560w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4b6eda95-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=32ed346dd65fa2208684f58d2583a6e6 840w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4b6eda95-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=bd7a7ff69f50f6cc29cc58c6e4239813 1100w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4b6eda95-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=8dc318e06666fdb88f4e74e3f0cb4f7e 1650w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4b6eda95-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=912376fd3087f789ae886c730659be51 2500w`})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`upload-the-app-to-your-tenant`,children:`Upload the app to your tenant`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Download the manifest`,children:[_jsxs(_components.p,{children:[`On the `,_jsx(_components.strong,{children:`Teams Companion App Installation`}),` screen, click `,_jsx(_components.strong,{children:`Download Teams Companion App`}),`. Upload it as a `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`.zip`})}),`. Do not extract it.`]}),_jsxs(_components.p,{children:[`Thread shows this screen only until the app is installed in a team. If the integration already shows `,_jsx(_components.strong,{children:`Connected`}),`, see `,_jsx(_components.a,{href:`#download-the-manifest-after-the-integration-is-connected`,children:`Download the manifest after the integration is connected`}),`.`]})]}),_jsxs(Step,{title:`Open the Teams admin center`,children:[_jsxs(_components.p,{children:[`In the same browser session, sign in to `,_jsx(_components.a,{href:`https://admin.teams.microsoft.com`,children:`admin.teams.microsoft.com`}),` and go to `,_jsx(_components.strong,{children:`Teams Apps → Manage Apps`}),`.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4e4a1755-image.png?fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=25427063c01ce5cfbb925d493f83dc9d`,alt:`Manage Apps page under Teams Apps in the Microsoft Teams admin center`,\"data-og-width\":`3024`,width:`3024`,\"data-og-height\":`1130`,height:`1130`,\"data-path\":`images/4e4a1755-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4e4a1755-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=89494f4b015b63c1019fdfb3a25493c7 280w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4e4a1755-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=eb1e11058722b23e4f977a4bd0460ed0 560w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4e4a1755-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=af55b557ed153a66f56da994c145436c 840w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4e4a1755-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=589f87eb7035341a70ed1c60e1a1fdb9 1100w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4e4a1755-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=624d84888b0579a3c44fcda508f95eeb 1650w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4e4a1755-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=a0bc7e87a9c93ee32d6f96477d0f8503 2500w`})})]}),_jsxs(Step,{title:`Upload the .zip`,children:[_jsxs(_components.p,{children:[`Choose to upload a custom app, then select the `,_jsx(_components.code,{children:`.zip`}),` you downloaded.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4e8c069a-image.png?fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=63e208a804f18cb484da00d88a33b1d1`,alt:`Upload custom app dialog in the Teams admin center with a zip file selected`,\"data-og-width\":`3024`,width:`3024`,\"data-og-height\":`1490`,height:`1490`,\"data-path\":`images/4e8c069a-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4e8c069a-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=c607bd39dda76ab74fd3773baf999288 280w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4e8c069a-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=636c003987c8b994d53df48af6c07605 560w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4e8c069a-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=8932ef2af389e134fe1319dec0574d55 840w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4e8c069a-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=f689f30c83688e77bb5b12fc413afce6 1100w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4e8c069a-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=22265ce0c8b6b4e038798d8a1af391b8 1650w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4e8c069a-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=457637613faba1f0d0de61bc883d7850 2500w`})})]}),_jsx(Step,{title:`Confirm the app was added`,children:_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/yBHr9ZQ4DwAmm2_J/images/fb6ce768-image.png?fit=max\u0026auto=format\u0026n=yBHr9ZQ4DwAmm2_J\u0026q=85\u0026s=97cf8da35d5894c51d0dbab23b6388a2`,alt:`Confirmation that the Thread app was added to the Teams tenant`,\"data-og-width\":`3024`,width:`3024`,\"data-og-height\":`1490`,height:`1490`,\"data-path\":`images/fb6ce768-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/yBHr9ZQ4DwAmm2_J/images/fb6ce768-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=yBHr9ZQ4DwAmm2_J\u0026q=85\u0026s=1367114587599d9a06f5e1190c212ea0 280w, https://mintcdn.com/thread/yBHr9ZQ4DwAmm2_J/images/fb6ce768-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=yBHr9ZQ4DwAmm2_J\u0026q=85\u0026s=644eb80f57adb8b09e79d1ebb6d114d5 560w, https://mintcdn.com/thread/yBHr9ZQ4DwAmm2_J/images/fb6ce768-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=yBHr9ZQ4DwAmm2_J\u0026q=85\u0026s=7e209d221579ce19f282702524802bb1 840w, https://mintcdn.com/thread/yBHr9ZQ4DwAmm2_J/images/fb6ce768-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=yBHr9ZQ4DwAmm2_J\u0026q=85\u0026s=4cd3d5f49a22afce8487ec5276194c10 1100w, https://mintcdn.com/thread/yBHr9ZQ4DwAmm2_J/images/fb6ce768-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=yBHr9ZQ4DwAmm2_J\u0026q=85\u0026s=cbe07e3deacab7e7a89445a9bbf4dbf4 1650w, https://mintcdn.com/thread/yBHr9ZQ4DwAmm2_J/images/fb6ce768-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=yBHr9ZQ4DwAmm2_J\u0026q=85\u0026s=5e59c860f289681118b8f73670a2798c 2500w`})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`add-it-to-a-setup-policy`,children:`Add it to a setup policy`}),`\n`,_jsx(_components.p,{children:`Uploading makes the app available; a setup policy installs it for your users.`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open Setup Policies`,children:[_jsxs(_components.p,{children:[`Close the `,_jsx(_components.strong,{children:`New app added`}),` prompt, then go to `,_jsx(_components.strong,{children:`Teams Apps → Setup Policies`}),` and select `,_jsx(_components.strong,{children:`Global (Org-wide default)`}),`.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/21d08f37-image.png?fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=5d8bcd748075352231310619bd60bd03`,alt:`Global org-wide default setup policy in the Teams admin center`,\"data-og-width\":`3024`,width:`3024`,\"data-og-height\":`1490`,height:`1490`,\"data-path\":`images/21d08f37-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/21d08f37-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=34b51c0fa27bcbfb091aec50bc71ade6 280w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/21d08f37-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=03efe4e1a0c8b038cb1734d59ff70bf1 560w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/21d08f37-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=4fd001a0612ca70d5642c90caaad6e2c 840w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/21d08f37-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=3e342d8db5f97ffd27820ebda9748330 1100w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/21d08f37-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=0ab9d69d3b0bdbc5a5cf4ae719bc16e8 1650w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/21d08f37-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=52f5eb57b5c6e1e265ae850f6c8d31f4 2500w`})})]}),_jsxs(Step,{title:`Add the Thread app`,children:[_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Installed apps`}),`, click `,_jsx(_components.strong,{children:`Add apps`}),`, search for “Thread”, select it and click `,_jsx(_components.strong,{children:`Add`}),`.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/409666e0-image.png?fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=69da13a7dd50bbf5180c5d414d6aa543`,alt:`Add apps panel with the Thread app selected for the setup policy`,\"data-og-width\":`3024`,width:`3024`,\"data-og-height\":`1890`,height:`1890`,\"data-path\":`images/409666e0-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/409666e0-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=058e58cdf85e6cd13d7e99019da6aeb9 280w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/409666e0-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=96ce47e23f6c8c9c441cee1aa597c914 560w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/409666e0-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=1da2ca7ed34757818fcdc35a5451f5f5 840w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/409666e0-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=caa2ba95542b2cb68543346486e95bbd 1100w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/409666e0-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=1c24a349332121d59c39ccf5296861ce 1650w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/409666e0-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=78bfc3824baca43473edceecab81f56e 2500w`})})]}),_jsxs(Step,{title:`Optionally pin it, then save`,children:[_jsxs(_components.p,{children:[`You can pin Thread to the Teams app bar, though it isn’t required. Click `,_jsx(_components.strong,{children:`Save`}),`.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/NJfDJnwFcUQr-x-h/images/cd2f286d-image.png?fit=max\u0026auto=format\u0026n=NJfDJnwFcUQr-x-h\u0026q=85\u0026s=52315853c7455593ef7c67f27e4129dc`,alt:`Pinned apps list in the Teams setup policy with Thread added`,\"data-og-width\":`3036`,width:`3036`,\"data-og-height\":`1490`,height:`1490`,\"data-path\":`images/cd2f286d-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/NJfDJnwFcUQr-x-h/images/cd2f286d-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=NJfDJnwFcUQr-x-h\u0026q=85\u0026s=114e2f06e5015c6af3d265adf1747b35 280w, https://mintcdn.com/thread/NJfDJnwFcUQr-x-h/images/cd2f286d-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=NJfDJnwFcUQr-x-h\u0026q=85\u0026s=38758830fe678a5f33435416d39bb57f 560w, https://mintcdn.com/thread/NJfDJnwFcUQr-x-h/images/cd2f286d-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=NJfDJnwFcUQr-x-h\u0026q=85\u0026s=7c2d3b23f83231b9fb4076949ff6081d 840w, https://mintcdn.com/thread/NJfDJnwFcUQr-x-h/images/cd2f286d-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NJfDJnwFcUQr-x-h\u0026q=85\u0026s=e97428d6a7e0f8e8179e8fb524e34842 1100w, https://mintcdn.com/thread/NJfDJnwFcUQr-x-h/images/cd2f286d-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NJfDJnwFcUQr-x-h\u0026q=85\u0026s=607581cb68763c04a9519881a5b7ebdc 1650w, https://mintcdn.com/thread/NJfDJnwFcUQr-x-h/images/cd2f286d-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NJfDJnwFcUQr-x-h\u0026q=85\u0026s=7694a680a7de8b759337ed24784f607d 2500w`})})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`The app appears faster in Teams on the web. Give the desktop client up to `,_jsx(_components.strong,{children:`24 hours`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`add-the-app-to-a-team`,children:`Add the app to a team`}),`\n`,_jsx(_components.p,{children:`Adding the app to a team is what lets you route threads to that team’s channels and interact with\nthe bot from inside it.`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Find the app in Manage Apps`,children:[_jsxs(_components.p,{children:[`In the Teams admin center, go to `,_jsx(_components.strong,{children:`Teams Apps → Manage Apps`}),` and search for the Thread Companion App you just installed.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/47bb0148-image.png?fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=67a7786f9a769c61684b5706e475e455`,alt:`Thread Companion App located in the Manage Apps list`,\"data-og-width\":`682`,width:`682`,\"data-og-height\":`342`,height:`342`,\"data-path\":`images/47bb0148-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/47bb0148-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=fd740a3303bb85cb8ba30a2b1bfe3e53 280w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/47bb0148-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=1be8324356fe709aa6ba5a27e8d06051 560w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/47bb0148-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=1d9b61720b9600316fe838451f5a561d 840w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/47bb0148-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=20523abeb7c7687fab269257b956687b 1100w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/47bb0148-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=0aa986907ed0d04e2c00d8041923a1b7 1650w, https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/47bb0148-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Jg2rOU2buvgqyCn8\u0026q=85\u0026s=7883174ca4ded3377a9204f919b92da1 2500w`})})]}),_jsxs(Step,{title:`Click Add to a team`,children:[_jsx(_components.p,{children:`Type the team you want to add it to.`}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`team`}),` matters more than the channel — when you build a Flow in Thread you can create new channels under that team from inside Thread. The bot `,_jsx(_components.strong,{children:`cannot`}),` interact with private channels.`]})})]}),_jsx(Step,{title:`Choose whether to post about Thread, then save`,children:_jsxs(_components.p,{children:[`Decide whether to announce Thread in the channel, then click `,_jsx(_components.strong,{children:`Save`}),`.`]})}),_jsxs(Step,{title:`Confirm the integration`,children:[_jsxs(_components.p,{children:[`The integration now shows as connected on the `,_jsx(_components.a,{href:`https://admin.getthread.com/dashboard/integrations`,children:`Admin Panel integrations page`}),`.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/yBHr9ZQ4DwAmm2_J/images/f8264e6b-image.png?fit=max\u0026auto=format\u0026n=yBHr9ZQ4DwAmm2_J\u0026q=85\u0026s=e357118ef2022c3409728a247fafe1ae`,alt:`Thread Admin Panel integrations page showing the Teams integration connected`,\"data-og-width\":`1273`,width:`1273`,\"data-og-height\":`516`,height:`516`,\"data-path\":`images/f8264e6b-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/yBHr9ZQ4DwAmm2_J/images/f8264e6b-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=yBHr9ZQ4DwAmm2_J\u0026q=85\u0026s=2840728b821af9e8bd4dfb21119c82a4 280w, https://mintcdn.com/thread/yBHr9ZQ4DwAmm2_J/images/f8264e6b-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=yBHr9ZQ4DwAmm2_J\u0026q=85\u0026s=e0a2a917a5f11d5d27a2eadce5ccec99 560w, https://mintcdn.com/thread/yBHr9ZQ4DwAmm2_J/images/f8264e6b-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=yBHr9ZQ4DwAmm2_J\u0026q=85\u0026s=e10b58330e888d3db406edd1caa6a357 840w, https://mintcdn.com/thread/yBHr9ZQ4DwAmm2_J/images/f8264e6b-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=yBHr9ZQ4DwAmm2_J\u0026q=85\u0026s=f3b5cb013cc435d704adac8a650019bc 1100w, https://mintcdn.com/thread/yBHr9ZQ4DwAmm2_J/images/f8264e6b-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=yBHr9ZQ4DwAmm2_J\u0026q=85\u0026s=d012ffdb70147a3977dfacac63f092d3 1650w, https://mintcdn.com/thread/yBHr9ZQ4DwAmm2_J/images/f8264e6b-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=yBHr9ZQ4DwAmm2_J\u0026q=85\u0026s=798a15586978f5f92c048f0229ef87a6 2500w`})})]})]}),`\n`,_jsx(_components.p,{children:`You can now create a Flow in Inbox and get notified about those threads in Teams.`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/7093b5a3-2023-03-23-20-31-14.png?fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=98e635791c6f9a99bcbc81fb2b990d3b`,alt:`Thread notification for a service thread posted in a Microsoft Teams channel`,\"data-og-width\":`1920`,width:`1920`,\"data-og-height\":`1012`,height:`1012`,\"data-path\":`images/7093b5a3-2023-03-23-20-31-14.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/7093b5a3-2023-03-23-20-31-14.png?w=280\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=9aa5df48fee7abab3e52c9edc581445d 280w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/7093b5a3-2023-03-23-20-31-14.png?w=560\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=efe9c18ed54a294b900dee153643ccc9 560w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/7093b5a3-2023-03-23-20-31-14.png?w=840\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=8aa5da361897158d1b5feb65db7d399f 840w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/7093b5a3-2023-03-23-20-31-14.png?w=1100\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=2dae453c6e46f6fa8a0ba1f2cb1beb7c 1100w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/7093b5a3-2023-03-23-20-31-14.png?w=1650\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=91f4a57af9a00870315735c26e76fd99 1650w, https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/7093b5a3-2023-03-23-20-31-14.png?w=2500\u0026fit=max\u0026auto=format\u0026n=lk7VGePXuM-aMlwA\u0026q=85\u0026s=852416875d74ce252c5ab927c17a6d36 2500w`})}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`How do I add the app to another team?`,id:`how-do-i-add-the-app-to-another-team`,children:_jsxs(_components.p,{children:[`Repeat `,_jsx(_components.strong,{children:`Add the app to a team`}),` for each team you want. You only need to add the app to a given team once — after that the bot can reach any public channel created under it, and you can create new channels under that team from Thread’s Flow builder.`]})}),_jsx(Accordion,{title:`Do I associate the Companion App to a team from Microsoft 365 or from Thread?`,id:`do-i-associate-the-companion-app-to-a-team-from-microsoft-365-or-from-thread`,children:_jsxs(_components.p,{children:[`You associate the Companion App to a team `,_jsx(_components.strong,{children:`Microsoft 365-side`}),`, not from Thread. In the `,_jsx(_components.a,{href:`https://admin.teams.microsoft.com`,children:`Microsoft Teams admin center`}),`, go to `,_jsx(_components.strong,{children:`Teams Apps → Manage Apps`}),`, find the Thread Companion App you uploaded, and click `,_jsx(_components.strong,{children:`Add to a team`}),`. Once the app is attached to that team, the bot can reach any public channel under it, and you can create new channels under that team from Thread’s Flow builder. The bot cannot interact with private channels.`]})}),_jsxs(Accordion,{title:`How do I uninstall and redeploy the Companion App?`,id:`how-do-i-uninstall-and-redeploy-the-companion-app`,children:[_jsxs(_components.p,{children:[`The Companion App uses the same manifest-based install as the `,_jsx(_components.a,{href:`/messenger/create-teams-app`,children:`Teams Service App`}),`, so the Teams admin-center mechanics are the same — the difference is that the Companion App is internal to your own tenant, so there’s no per-customer step in Thread Admin.`]}),_jsx(_components.p,{children:`To remove it:`}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`In the `,_jsx(_components.a,{href:`https://admin.teams.microsoft.com`,children:`Microsoft Teams admin center`}),`, go to `,_jsx(_components.strong,{children:`Teams Apps → Manage Apps`}),` and search for the Thread Companion App.`]}),`\n`,_jsxs(_components.li,{children:[`Open the app, then click `,_jsx(_components.strong,{children:`Actions → Delete`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`If you also want to stop the app being auto-installed for users, open `,_jsx(_components.strong,{children:`Teams Apps → Setup Policies → Global (Org-wide default)`}),` and remove Thread from `,_jsx(_components.strong,{children:`Installed apps`}),` before you save.`]}),`\n`]}),_jsxs(_components.p,{children:[`To redeploy, `,_jsx(_components.a,{href:`#download-the-manifest-after-the-integration-is-connected`,children:`download the manifest`}),` and follow `,_jsx(_components.a,{href:`#upload-the-app-to-your-tenant`,children:`Upload the app to your tenant`}),` and `,_jsx(_components.a,{href:`#add-it-to-a-setup-policy`,children:`Add it to a setup policy`}),` again. Give the Teams desktop client up to 24 hours to pick up the new version.`]})]}),_jsxs(Accordion,{title:`Download the manifest after the integration is connected`,id:`download-the-manifest-after-the-integration-is-connected`,children:[_jsxs(_components.p,{children:[`Once the Teams Companion App shows `,_jsx(_components.strong,{children:`Connected`}),` under `,_jsx(_components.strong,{children:`Integrations → Microsoft 365 \u0026 Teams app`}),`, the Thread Admin Panel no longer shows a download button. The card offers `,_jsx(_components.strong,{children:`Reintegrate`}),` and `,_jsx(_components.strong,{children:`Disconnect`}),` instead. You don’t need either one to get the manifest.`]}),_jsxs(_components.p,{children:[`The Companion App manifest is the same file for every Thread workspace. Download it directly from `,_jsx(_components.a,{href:`https://s3.amazonaws.com/app.chat-genie.com/downloads/thread.zip`,children:`this link`}),`, which is the same file the `,_jsx(_components.strong,{children:`Download Teams Companion App`}),` button serves during setup. Then follow `,_jsx(_components.a,{href:`#upload-the-app-to-your-tenant`,children:`Upload the app to your tenant`}),` and `,_jsx(_components.a,{href:`#add-it-to-a-setup-policy`,children:`Add it to a setup policy`}),`.`]})]}),_jsxs(Accordion,{title:`How do I re-authorize the Companion App?`,id:`how-do-i-re-authorize-the-companion-app`,children:[_jsxs(_components.p,{children:[`Go to `,_jsx(_components.strong,{children:`Integrations → Microsoft 365 \u0026 Teams app`}),` and click `,_jsx(_components.strong,{children:`Reintegrate`}),`, next to `,_jsx(_components.strong,{children:`Disconnect`}),`. Reintegrate re-authorizes the Companion App in place: same Microsoft tenant, same channels, flows and settings. Nothing is removed, and the app keeps working throughout.`]}),_jsxs(_components.p,{children:[`You can’t reintegrate into a different Microsoft tenant. To switch tenants, click `,_jsx(_components.strong,{children:`Disconnect`}),` first. If the attempt is cancelled or fails, you return to the integration page with an explanation. Reintegrating doesn’t affect the Teams Service Apps you deploy to your customers’ tenants.`]})]}),_jsx(Accordion,{title:`I get a “no permissions” message. What now?`,id:`i-get-a-no-permissions-message-what-now`,children:_jsxs(_components.p,{children:[`Check your permissions in the Teams admin center. The permissions Thread requests, and why, are listed in the `,_jsx(_components.a,{href:`/security-billing/microsoft-teams-app-permissions`,children:`Microsoft Teams app permissions reference`}),`.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`next-step`,children:`Next step`}),`\n`,_jsxs(_components.p,{children:[`Choose `,_jsx(_components.a,{href:`/companion-apps/choose-which-ticket-updates-post-to-channel`,children:`which ticket updates post to a channel`}),` so the channel stays useful rather than noisy.`]})]})}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":"Install the Teams Companion App","description":"Install the Thread Teams Companion App in your own Microsoft 365 tenant: connect the integration, upload the app manifest, and add a setup policy.","keywords":"teams companion app, install, microsoft teams, setup policy, manifest, upload custom app, internal facing, service team","boost":3,"href":"/companion-apps/install-the-teams-companion-app"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What you get","slug":"what-you-get","depth":2,"children":[]},{"title":"Before you start","slug":"before-you-start","depth":2,"children":[]},{"title":"Connect Microsoft 365","slug":"connect-microsoft-365","depth":2,"children":[]},{"title":"Upload the app to your tenant","slug":"upload-the-app-to-your-tenant","depth":2,"children":[]},{"title":"Add it to a setup policy","slug":"add-it-to-a-setup-policy","depth":2,"children":[]},{"title":"Add the app to a team","slug":"add-the-app-to-a-team","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[]},{"title":"Next step","slug":"next-step","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/thread/e9e74bb66602d208/skill-nav-scroll.js"],"subdomain":"thread","siteName":"Thread Docs","title":"Install the Teams Companion App - Thread Docs","relatedPagesConfig":{"enabled":true,"limit":3,"mode":"automatic"},"contextualStarterQuestions":[{"_id":"6af4a516b7c363c4d0e7eab5","deploymentId":"6920f01f9d8412afd5a0dff5","questionText":"How do I install the Teams app?","status":"active","generatedBy":"contextual","path":"companion-apps/install-the-teams-companion-app","createdAt":"2026-11-11T17:25:42.619Z","updatedAt":"2026-11-11T17:25:42.619Z","__v":0},{"_id":"6af4a516b7c363c4d0e7eab6","deploymentId":"6920f01f9d8412afd5a0dff5","questionText":"What notifications will I receive?","status":"active","generatedBy":"contextual","path":"companion-apps/install-the-teams-companion-app","createdAt":"2026-11-11T17:25:42.619Z","updatedAt":"2026-11-11T17:25:42.619Z","__v":0},{"_id":"6af4a516b7c363c4d0e7eab7","deploymentId":"6920f01f9d8412afd5a0dff5","questionText":"Do I need admin access?","status":"active","generatedBy":"contextual","path":"companion-apps/install-the-teams-companion-app","createdAt":"2026-11-11T17:25:42.619Z","updatedAt":"2026-11-11T17:25:42.619Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-11T17:25:36.024Z","originalFileLocation":"companion-apps/install-the-teams-companion-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=\"Install the Thread Teams Companion App in your own Microsoft 365 tenant: connect the integration, upload the app manifest, and add a setup policy.\">\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=\"Install the Teams Companion App - Thread Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Install the Thread Teams Companion App in your own Microsoft 365 tenant: connect the integration, upload the app manifest, and add a setup policy.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Thread Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.getthread.com/companion-apps/install-the-teams-companion-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=Teams+Companion+App\u0026amp;title=Install+the+Teams+Companion+App\u0026amp;description=Install+the+Thread+Teams+Companion+App+in+your+own+Microsoft+365+tenant%3A+connect+the+integration%2C+upload+the+app+manifest%2C+and+add+a+setup+policy.\u0026amp;theme=f724fa3ec041ff897ae11da2\u0026amp;signature=9a3b6086a7b1d77038c4ecef0da9ab0a1f77c5d6cabc46535d408cb3202189f8\">\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=\"Install the Teams Companion App - Thread Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Install the Thread Teams Companion App in your own Microsoft 365 tenant: connect the integration, upload the app manifest, and add a setup policy.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://thread.mintlify.site/_mintlify/api/og/v2?division=Teams+Companion+App\u0026amp;title=Install+the+Teams+Companion+App\u0026amp;description=Install+the+Thread+Teams+Companion+App+in+your+own+Microsoft+365+tenant%3A+connect+the+integration%2C+upload+the+app+manifest%2C+and+add+a+setup+policy.\u0026amp;theme=f724fa3ec041ff897ae11da2\u0026amp;signature=9a3b6086a7b1d77038c4ecef0da9ab0a1f77c5d6cabc46535d408cb3202189f8\">\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/companion-apps/install-the-teams-companion-app\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/companion-apps/install-the-teams-companion-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/companion-apps/install-the-teams-companion-app#webpage\",\"url\":\"https://docs.getthread.com/companion-apps/install-the-teams-companion-app\",\"name\":\"Install the Teams Companion App\",\"description\":\"Install the Thread Teams Companion App in your own Microsoft 365 tenant: connect the integration, upload the app manifest, and add a setup policy.\",\"dateModified\":\"2026-11-11T17:25:36.024Z\",\"isPartOf\":{\"@id\":\"https://docs.getthread.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.getthread.com/companion-apps/install-the-teams-companion-app#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.getthread.com/companion-apps/install-the-teams-companion-app#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Thread Docs\",\"item\":\"https://docs.getthread.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Install the Teams Companion App\",\"item\":\"https://docs.getthread.com/companion-apps/install-the-teams-companion-app\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.getthread.com/companion-apps/install-the-teams-companion-app#article\",\"headline\":\"Install the Teams Companion App\",\"name\":\"Install the Teams Companion App\",\"description\":\"Install the Thread Teams Companion App in your own Microsoft 365 tenant: connect the integration, upload the app manifest, and add a setup policy.\",\"url\":\"https://docs.getthread.com/companion-apps/install-the-teams-companion-app\",\"mainEntityOfPage\":{\"@id\":\"https://docs.getthread.com/companion-apps/install-the-teams-companion-app#webpage\"},\"dateModified\":\"2026-11-11T17:25:36.024Z\",\"publisher\":{\"@id\":\"https://docs.getthread.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.getthread.com#website\"}}]}\u003c/script>","agentPointerHref":"/companion-apps/install-the-teams-companion-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","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","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","description":"Use the Thread Automations Crate to send Magic AI intent data, like employee onboarding fields, to Rewst workflows via secure shared-secret webhooks.","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","description":"Connect the Thread Companion App to your own Slack workspace so technicians can work threads from Slack, with the /thread commands, Actions, and time entries.","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":"Install the Teams Companion 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"]}