---
title: "How to Install the Garba Bot in Microsoft Teams"
description: "Step-by-step guide for Microsoft Teams administrators to upload and install the Garba bot using the manual app package."
url: https://help.garba.ai/en/articles/10742504-how-to-install-the-garba-bot-in-microsoft-teams
collection: "Microsoft Teams"
updated: 2026-11-02
language: en
---

# How to Install the Garba Bot in Microsoft Teams

Step-by-step guide for Microsoft Teams administrators to upload and install the Garba bot using the manual app package.

Once you’ve connected Microsoft Teams in Garba (admin consent), the next step is to install the Garba bot into your Teams environment. This guide is for Microsoft Teams administrators.

### Prerequisites

-   Microsoft Teams admin role
    
-   The Garba app package (garba-for-microsoft-teams.zip) — request from your account manager, email support@garba.ai, or use the chat widget inside Garba (click the chat icon in the bottom-right corner)
    

### Step 1: Request the Garba App Package

You can request the app package in any of the following ways:

-   Contact your Garba account manager
    
-   Email support@garba.ai
    
-   Use the chat widget inside Garba — click the chat icon in the bottom-right corner and ask for the package
    

You will receive garba-for-microsoft-teams.zip. **Do not extract the file.**

### Step 2: Upload the App to Teams Admin Center

Follow these steps to upload the app package to your Microsoft Teams environment:

-   Open [admin.teams.microsoft.com](https://admin.teams.microsoft.com/)
    
-   Go to Teams apps > Manage apps
    
-   Click Actions > "Upload new app" > "Upload"
    
-   Select the garba-for-microsoft-teams.zip file
    
-   The app will appear under "Built for your org"
    

![](https://staticfiles.gleap.io/ghelpcenter/PXzLXXV3PKXOlzW0qZfYZqJqKXoumEZIJb44MXFDetd3JpRYFqutOatulsci8YZGuhT47oJBj6h.png)

![](https://staticfiles.gleap.io/ghelpcenter/TEsy7FFEYytoKfEHHOnkd9vrHppV2bPXaoJut4s8RWK5KZAUmg1AHc9pY0ZaR484L1OlOy7fT91.png)

### Step 3: Add the Garba Bot to a Team

After uploading, install the bot into the team where you want Garba to be active:

-   Open Microsoft Teams
    
-   Go to the team where you want Garba
    
-   Click “+” or go to Apps and search for “Garba” under “Built for your org”
    
-   Click Add or Add to a team
    
-   Select the team and confirm
    

![](https://staticfiles.gleap.io/ghelpcenter/wza9uWYvxaVKbZcw3x3HEFChv2RbhthtNvIbL1FV22ax3O1kEcDO4K8FThV5xUO21FO9yvGwLcR.png)

### Step 4: What Happens After Installation

Once the bot is installed in a team, Garba will automatically set up the integration:

-   Garba automatically discovers all standard channels in the team
    
-   DM references are created for team members who have Garba accounts
    
-   The bot is ready to receive @mentions in channels and DMs
    
-   Private and shared channels are not registered automatically
    

You can verify the installation by going to **Settings > Account Integrations** in Garba — the channel and chat counts should update.

_To reach Account Integrations: click the settings icon (_⚙_) at the bottom of the left sidebar, then under Account click Integrations._

### Troubleshooting

-   "Upload custom apps" must be enabled in your Teams admin policies
    
-   Some organisations block custom or third-party apps — check with your IT team if the upload option is unavailable
    
-   If the app does not appear after upload, try refreshing the Teams Admin Center page
    
-   If channel counts do not update in Garba, the bot may not have been installed in any team yet