# Microsoft Teams Integration for Biel.ai

> For the complete documentation index, see [llms.txt](/llms.txt)

> Deploy the Biel.ai bot in Microsoft Teams so your team can ask questions to your documentation directly from any channel or chat.

# Microsoft Teams integration

Deploy the Biel.ai bot in Microsoft Teams so your team can ask questions to your documentation directly from any channel, group chat, or direct message, without leaving Teams.

![Microsoft Teams Integration](./images/microsoft-teams-integration.png)

## What you can do

- **Channels and chats**: works in team channels, group chats, and personal chats.
- **Conversation context**: the bot maintains context within the same conversation thread.
- **Reset the conversation**: send `/clear` to start a fresh conversation context.

## Prerequisites

- A [Biel.ai account](https://app.biel.ai) with documentation indexed.
- **Teams Administrator** access to your Microsoft 365 organization.

## Setup

### 1. Download the app package

In your project settings, open **Integrations** in the left sidebar. On the Microsoft Teams card, click **Download manifest**.

This downloads a `biel-teams-app.zip` file containing the bot manifest and icons, ready to upload to your Teams Admin Center.

### 2. Upload the app to your Teams Admin Center

A Teams administrator in your organization must upload the package:

1. Open [Teams Admin Center](https://admin.teams.microsoft.com).
2. Go to **Teams apps** → **Manage apps** → **Upload new app**.
3. Upload the `biel-teams-app.zip` file.
4. Under **Permission policies**, configure which users or groups can install the app.

:::tip
If your organization has strict app permission policies, you may need to explicitly allow the Biel app for the relevant users or groups before it becomes discoverable in the Teams app store.
:::

### 3. Generate a setup token

Back in **Settings** → **Integrations**, expand the Microsoft Teams card and click **Generate token**.

Copy the setup token that appears.

### 4. Connect the bot

Open a chat with the Biel bot in Teams (search for **Biel** in the Teams app store and click **Add**) and send the setup token as your first message.

The bot will confirm the connection:

```text
Connected! This Teams workspace is now linked to the [Project Name] project.
You can start asking questions.
```

From this point on, all messages from your Teams organization are routed to the linked Biel project.

:::note
The setup token is single-use. It is consumed when the connection is established. If you ever need to reconnect or link a different project, generate a new token from the project settings page.
:::

## Usage

### Asking questions

Send any message to the bot and it will respond with an answer sourced from your documentation.

```text
You: How do I reset my password?
Biel: To reset your password, go to Settings → Security → Reset Password and follow the steps shown.
```

You can ask follow-up questions and the bot will maintain context within the same conversation thread:

```text
You: What permissions do I need for that?
Biel: You need the Account Owner or Admin role to access the Security settings.
```

### Starting a new conversation

To reset the context in the current conversation, send:

```text
/clear
```

The bot replies with a confirmation, and your next message starts a fresh conversation.

:::tip[Not getting answers?]
Make sure your Biel.ai project has indexed content. You can check this from the **Sources** tab in your project settings.
:::

## Troubleshooting

**The bot doesn't appear in the app store**

Check that the app has been approved and that the user is covered by the configured permission policy in Teams Admin Center.

**The bot asks for a setup token instead of answering questions**

The Teams workspace has not been connected to a Biel project yet. In **Settings** → **Integrations**, expand the Microsoft Teams card, generate a token, and send it to the bot as described in step 4.

**The bot doesn't respond after sending the token**

Make sure you are sending the token exactly as shown (no extra spaces or characters). If the problem persists, generate a new token and try again.

**The bot doesn't respond to questions**

Ensure your Biel.ai project has documentation indexed. Contact [Biel support](https://biel.ai) if the issue persists.

**Responses are incorrect or outdated**

Re-index your documentation in the [Biel.ai dashboard](https://app.biel.ai) to make sure the bot is querying the latest content.

---

Need help? [Contact us](https://biel.ai/contact) or visit the [support page](https://docs.biel.ai/support.md).