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

# Install in Microsoft Teams

> Add the Topicflow bot to your organization's Microsoft Teams

Topicflow connects to Microsoft Teams as a custom app that you upload directly to your organization, rather than installing from the public Teams app store. Setup has two parts: a Teams administrator turns on custom app uploads for your organization, then someone uploads the Topicflow app package we provide.

## Before you start

* The **Topicflow app package** — [download the `.zip` file](https://s3.us-west-2.amazonaws.com/www.topicflow.com/assets/topicflow-bot-prod.zip). You'll upload this to Teams in the steps below.
* A **Microsoft Teams administrator** to enable custom app uploads (the first step below). Once that's on, uploading the app doesn't require admin permissions.

## Step 1: Enable custom app uploads

A Teams administrator only needs to do this once for your whole organization.

1. Go to the [Teams admin center](https://admin.teams.microsoft.com/).
2. Open **Teams apps → Setup policies → Global (Org-wide default)**.
3. Turn **Upload custom apps** on.
4. Select **Save**. Allow a few minutes for the change to take effect across your organization.

If your organization already allows custom app uploads, you can skip straight to uploading the app.

## Step 2: Upload the Topicflow app

1. In Microsoft Teams, go to **Apps → Manage your apps → Upload an app**.
2. Choose **Upload a custom app** and select the Topicflow `.zip` file.
3. Confirm the installation when Teams prompts you.

## Step 3: Start using Topicflow

Open a chat with the **Topicflow** bot and send a message to get started.

<CardGroup cols={2}>
  <Card title="Integrations" icon="plug" href="/settings/integrations">
    Connect Topicflow to your other work tools
  </Card>

  <Card title="Roles and permissions" icon="shield" href="/settings/roles-and-permissions">
    Understand what each user can see and do
  </Card>
</CardGroup>
