> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getthread.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the Teams Companion App

> Connect the Thread Companion App to your own Microsoft Teams tenant: authorise Microsoft 365, upload the app manifest, add it to a setup policy, and add it to a team.

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.

<Note>
  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](/messenger/create-teams-app) instead — they are different apps with different audiences.
</Note>

## 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.

## Before you start

You need administrator credentials for your company's Microsoft 365 environment, and access to
the [Microsoft Teams admin center](https://admin.teams.microsoft.com).

## Connect Microsoft 365

<Steps>
  <Step title="Open the Microsoft 365 & Teams integration">
    In the Thread Admin Panel, go to **Integrations → Microsoft 365 & Teams app**.

    <Frame>
      <img src="https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/1ce9704d-image.png?fit=max&auto=format&n=Jg2rOU2buvgqyCn8&q=85&s=67e48559c727c1d13ff00b231f014e27" alt="Microsoft 365 and Teams app tile on the Integrations page of the Thread Admin Panel" width="3024" height="1350" data-path="images/1ce9704d-image.png" />
    </Frame>
  </Step>

  <Step title="Click Connect">
    <Frame>
      <img src="https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/0099af95-image.png?fit=max&auto=format&n=Jg2rOU2buvgqyCn8&q=85&s=bfbb31e521ffe8511cc5501f0ded0cd4" alt="Connect button on the Microsoft 365 and Teams integration panel" width="3024" height="1350" data-path="images/0099af95-image.png" />
    </Frame>
  </Step>

  <Step title="Choose Connect with Microsoft Teams">
    <Frame>
      <img src="https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/38f2fdf9-image.png?fit=max&auto=format&n=Jg2rOU2buvgqyCn8&q=85&s=4ed7f9a58da6167ce82ce0e7f633783d" alt="Connect with Microsoft Teams option in the Thread Admin Panel" width="3024" height="1350" data-path="images/38f2fdf9-image.png" />
    </Frame>
  </Step>

  <Step title="Sign in as an administrator">
    Sign in to your company's Microsoft 365 environment with administrator credentials.

    <Frame>
      <img src="https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/5e86723e-image.png?fit=max&auto=format&n=lk7VGePXuM-aMlwA&q=85&s=d2285633dbd18908442d754ef37ce644" alt="Microsoft Online sign-in page requesting administrator credentials" width="1170" height="1070" data-path="images/5e86723e-image.png" />
    </Frame>
  </Step>

  <Step title="Accept the requested permissions">
    Review the permissions the app requests and click **Accept**. The full list is documented in the [Microsoft Teams app permissions reference](/security-billing/microsoft-teams-app-permissions).

    <Frame>
      <img src="https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/756b85e7-image.png?fit=max&auto=format&n=lk7VGePXuM-aMlwA&q=85&s=150dfc86f52e7ad15a479925149ff68a" alt="Microsoft consent screen listing the permissions requested by the Thread Teams app" width="3024" height="1890" data-path="images/756b85e7-image.png" />
    </Frame>
  </Step>

  <Step title="Land on the setup instructions">
    After consent you're redirected to the Teams app setup instructions.

    <Frame>
      <img src="https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4b6eda95-image.png?fit=max&auto=format&n=lk7VGePXuM-aMlwA&q=85&s=63c8807b779a718192e050d2060f4433" alt="Teams app setup instructions shown after granting Microsoft consent" width="3024" height="1890" data-path="images/4b6eda95-image.png" />
    </Frame>
  </Step>
</Steps>

## Upload the app to your tenant

<Steps>
  <Step title="Download the manifest">
    Download the Teams Companion App manifest from the setup instructions screen. Upload it as a **`.zip`** — do not extract it.
  </Step>

  <Step title="Open the Teams admin center">
    In the same browser session, sign in to [admin.teams.microsoft.com](https://admin.teams.microsoft.com) and go to **Teams Apps → Manage Apps**.

    <Frame>
      <img src="https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4e4a1755-image.png?fit=max&auto=format&n=lk7VGePXuM-aMlwA&q=85&s=25427063c01ce5cfbb925d493f83dc9d" alt="Manage Apps page under Teams Apps in the Microsoft Teams admin center" width="3024" height="1130" data-path="images/4e4a1755-image.png" />
    </Frame>
  </Step>

  <Step title="Upload the .zip">
    Choose to upload a custom app, then select the `.zip` you downloaded.

    <Frame>
      <img src="https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/4e8c069a-image.png?fit=max&auto=format&n=lk7VGePXuM-aMlwA&q=85&s=63e208a804f18cb484da00d88a33b1d1" alt="Upload custom app dialog in the Teams admin center with a zip file selected" width="3024" height="1490" data-path="images/4e8c069a-image.png" />
    </Frame>
  </Step>

  <Step title="Confirm the app was added">
    <Frame>
      <img src="https://mintcdn.com/thread/yBHr9ZQ4DwAmm2_J/images/fb6ce768-image.png?fit=max&auto=format&n=yBHr9ZQ4DwAmm2_J&q=85&s=97cf8da35d5894c51d0dbab23b6388a2" alt="Confirmation that the Thread app was added to the Teams tenant" width="3024" height="1490" data-path="images/fb6ce768-image.png" />
    </Frame>
  </Step>
</Steps>

## Add it to a setup policy

Uploading makes the app available; a setup policy installs it for your users.

<Steps>
  <Step title="Open Setup Policies">
    Close the **New app added** prompt, then go to **Teams Apps → Setup Policies** and select **Global (Org-wide default)**.

    <Frame>
      <img src="https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/21d08f37-image.png?fit=max&auto=format&n=Jg2rOU2buvgqyCn8&q=85&s=5d8bcd748075352231310619bd60bd03" alt="Global org-wide default setup policy in the Teams admin center" width="3024" height="1490" data-path="images/21d08f37-image.png" />
    </Frame>
  </Step>

  <Step title="Add the Thread app">
    Under **Installed apps**, click **Add apps**, search for "Thread", select it and click **Add**.

    <Frame>
      <img src="https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/409666e0-image.png?fit=max&auto=format&n=Jg2rOU2buvgqyCn8&q=85&s=69da13a7dd50bbf5180c5d414d6aa543" alt="Add apps panel with the Thread app selected for the setup policy" width="3024" height="1890" data-path="images/409666e0-image.png" />
    </Frame>
  </Step>

  <Step title="Optionally pin it, then save">
    You can pin Thread to the Teams app bar, though it isn't required. Click **Save**.

    <Frame>
      <img src="https://mintcdn.com/thread/NJfDJnwFcUQr-x-h/images/cd2f286d-image.png?fit=max&auto=format&n=NJfDJnwFcUQr-x-h&q=85&s=52315853c7455593ef7c67f27e4129dc" alt="Pinned apps list in the Teams setup policy with Thread added" width="3036" height="1490" data-path="images/cd2f286d-image.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  The app appears faster in Teams on the web. Give the desktop client up to **24 hours**.
</Tip>

## 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.

<Steps>
  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/thread/Jg2rOU2buvgqyCn8/images/47bb0148-image.png?fit=max&auto=format&n=Jg2rOU2buvgqyCn8&q=85&s=67a7786f9a769c61684b5706e475e455" alt="Thread Companion App located in the Manage Apps list" width="682" height="342" data-path="images/47bb0148-image.png" />
    </Frame>
  </Step>

  <Step title="Click Add to a team">
    Type the team you want to add it to.

    <Warning>
      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.
    </Warning>
  </Step>

  <Step title="Choose whether to post about Thread, then save">
    Decide whether to announce Thread in the channel, then click **Save**.
  </Step>

  <Step title="Confirm the integration">
    The integration now shows as connected on the [Admin Panel integrations page](https://admin.getthread.com/dashboard/integrations).

    <Frame>
      <img src="https://mintcdn.com/thread/yBHr9ZQ4DwAmm2_J/images/f8264e6b-image.png?fit=max&auto=format&n=yBHr9ZQ4DwAmm2_J&q=85&s=e357118ef2022c3409728a247fafe1ae" alt="Thread Admin Panel integrations page showing the Teams integration connected" width="1273" height="516" data-path="images/f8264e6b-image.png" />
    </Frame>
  </Step>
</Steps>

You can now create a Flow in Inbox and get notified about those threads in Teams.

<Frame>
  <img src="https://mintcdn.com/thread/lk7VGePXuM-aMlwA/images/7093b5a3-2023-03-23-20-31-14.png?fit=max&auto=format&n=lk7VGePXuM-aMlwA&q=85&s=98e635791c6f9a99bcbc81fb2b990d3b" alt="Thread notification for a service thread posted in a Microsoft Teams channel" width="1920" height="1012" data-path="images/7093b5a3-2023-03-23-20-31-14.png" />
</Frame>

## FAQ

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="I get a “no permissions” message. What now?">
    Check your permissions in the Teams admin center. The permissions Thread requests, and why, are listed in the [Microsoft Teams app permissions reference](/security-billing/microsoft-teams-app-permissions).
  </Accordion>
</AccordionGroup>

## Next step

Choose [which ticket updates post to a channel](/companion-apps/choose-which-ticket-updates-post-to-channel) so the channel stays useful rather than noisy.


## Related topics

- [Install the Slack Companion App](/companion-apps/install-the-slack-companion-app.md)
- [How Notifications Work for your Team](/notifications/how-will-notifications-work-internally.md)
- [How to Use the Slack Companion App for Service Teams](/companion-apps/how-to-use-the-slack-companion-app-for-service-teams.md)
