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

# Use DeskMate in Microsoft Teams

> Install the DeskMate bot in your Teams workspace.

DeskMate works inside Microsoft Teams as a chat bot. Your team can `@mention` it in a channel or DM it directly. Replies include rich Adaptive Cards for approvals, search results, and file attachments.

## Prerequisites

You must have the [Microsoft 365 connector](/connectors/microsoft-365) set up first. The Teams bot can't function without it.

## Step 1 — Receive the Teams manifest

Your BrightPath account manager will send you a `.zip` file containing the DeskMate Teams app manifest. The same manifest works for every customer — DeskMate's bot is multi-tenant.

## Step 2 — Install the app in Teams

You can install at the **organisation** level (everyone gets the bot) or at the **personal** level (just you).

### Organisation-wide install

1. Sign in to <a href="https://admin.teams.microsoft.com" target="_blank">admin.teams.microsoft.com</a> as a Teams Administrator
2. Go to **Teams apps → Manage apps**
3. Click **+ Upload new app → Upload**
4. Select the `.zip` file from Step 1
5. Once uploaded, find **DeskMate** in the list and set **Status: Allowed**
6. Optional: go to **Setup policies** to pin DeskMate to the Teams sidebar for everyone

### Personal install (testing)

1. In Teams, click **Apps** in the sidebar
2. Click **Manage your apps → Upload an app → Upload a custom app**
3. Select the `.zip` file from Step 1
4. Click **Add**

## Step 3 — Talk to the bot

In any channel where DeskMate is installed, type:

```
@DeskMate hello
```

Or open a direct chat with DeskMate from the **Chat** sidebar.

If you don't get a reply within \~5 seconds, email <a href="mailto:support@brightpathaisolutions.com">[support@brightpathaisolutions.com](mailto:support@brightpathaisolutions.com)</a> with your tenant slug and a screenshot.

## Features

### Adaptive Cards

Approvals, search results, and file attachments are rendered as **Adaptive Cards** — interactive cards with buttons. For example, an approval card lets you click **Approve** or **Reject** directly in chat without leaving Teams.

### File uploads

You can drag a file (PDF, DOCX, XLSX, CSV, image) into a chat with DeskMate. The bot will download it, parse it, and use it as context for whatever you ask next. Example:

> *(drag in invoice.pdf)*
>
> What's the total amount and due date?

## Uninstalling

In Teams Admin Center → Teams apps → Manage apps → DeskMate → **Status: Blocked**. To fully remove, also delete the M365 connector in DeskMate and revoke the Enterprise application in Azure AD.