# Microsoft Teams

> Deploy an agent to Microsoft Teams, optionally under your own branding.

Source: https://docs.runbear.io/channels/microsoft-teams

Last updated: 2026-08-26

Microsoft Teams covers the same internal use as Slack for organizations standardized on Microsoft 365. It also supports a branded bot, so the agent can appear under your own name and icon rather than Runbear's.

## How it works

[Video](/video/integration-channel-teams.mp4)

## Setup

1. In the Runbear dashboard, open your agent and go to the **Chatbots** tab.
2. Click **Connect** on the MS Teams tile — or install directly from [Microsoft AppSource](https://teams.microsoft.com/l/app/99783ae9-6345-4245-aa1d-fd7d78749f11).
3. In MS Teams, click **Add to a Team** and choose the team or group chat where you want the bot.
4. The Runbear bot will post a card with a **Complete Setup** button. Click it to go to the Runbear dashboard.
5. Enter your Teams name and click **Add**.
6. That's it — the agent is now active in your selected team or group chat.

## Branded bot

By default, the bot appears as "Runbear" in Teams. If you want a custom name, icon, and description, you can build a **branded bot** that works identically but looks like your own app.

### Building a branded bot

1. In the Runbear dashboard, go to the **Chatbots** tab and click **Branded Bots** on the MS Teams tile.

![Branded Bots button on Microsoft Teams card](/img/team-agent/chatbots/teams-branded-bot-entrypoint.png)

2. Click **Build Bot** at the top of the bot management page.
3. Fill in the customization form — bot name, icon, and description. Select an agent in the **Pre-Connected Agents** section so it responds after installation. A live preview shows your customizations.

![Customization form](/img/team-agent/chatbots/teams-branded-bot-customization.png)

4. Click **Create**. After a few seconds, a dialog appears with a **Download** button. Download the installation file (zip).

![Installation file dialog](/img/team-agent/chatbots/teams-branded-bot-installation-file-dialog.png)

### Installing the branded bot

Unzip the downloaded file. Inside you'll find the bot installation file and a detailed installation guide. Follow the guide to install the bot in your Teams organization.

### Deleting a branded bot

On the bot management page, click **Delete** on the bot you want to remove. This action is permanent — the bot will be removed from all Teams organizations where it was installed, and all Runbear connections linked to it will also be deleted.

## Troubleshooting

### Can't find my team or group chat when connecting

![Teams not found](/img/integration-channel-teams-add-app.png)

If your team or group chat doesn't appear during setup, the Runbear app likely isn't installed there yet. Click **+ Add conversation** in the dropdown and install the app in your desired team or group chat. Refresh the connection page afterward.

### App installed, but no "Complete Setup" message

In Teams, you can install the same bot into a team or group chat more than once. If you previously installed the bot, you may not receive another "Complete Setup" message. In that case, skip the setup step and proceed directly to connecting your agent.