Skip to main content

Microsoft Teams integration

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

Microsoft Teams Integration

Prerequisites​

  • A Biel.ai account with documentation indexed.
  • Teams Administrator access to your Microsoft 365 organization.

Setup​

Download the app package​

Open your project, click Settings, then select Integrations in the settings sidebar.

(Optional) Customize the bot name. By default the bot appears as Biel in Teams. To use your own name, click Customize bot name on the Microsoft Teams card, enter the name, and save. Leave it blank to keep the default.

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.

Note

Set the bot name before downloading the manifest. Customize bot name is unavailable after installation. To rename an installed app, upload a new app version through Teams Admin Center.

Upload the app to your Teams Admin Center​

A Teams administrator in your organization must upload the package:

  1. Open Teams Admin Center.
  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.

Generate a setup token​

Back in Settings → Integrations, click Generate token under Setup token on the Microsoft Teams card.

Copy the setup token that appears.

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:

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. Generate a new token to reconnect or link a different project.

Usage​

Asking questions​

Send any message to the bot.

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:

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

In a channel, mentioning the bot from the channel root opens a new thread anchored to your message, and replies inside that thread share context. To start a fresh conversation, post a new message from the channel root.

Starting a new conversation​

Send /clear to reset the current thread or chat. The bot confirms, and your next message starts a fresh conversation.

Not getting answers?

Make sure your Biel.ai project has indexed content. Open the project dashboard and check that it shows Sources loaded.

To disconnect, open your project’s Settings > Integrations, click Disconnect on the Microsoft Teams card, and confirm Disconnect. To reconnect, generate a new setup token and send it to the bot.

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, generate a token on the Microsoft Teams card, and send it to the bot as described in Connect the bot.

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 if the issue persists.

Responses are incorrect or outdated

In your project’s dashboard, click Refresh sources and wait for Sources loaded. Check Logs if indexing fails.


Need help? Contact us or visit the support page.