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.

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.
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:
- Open Teams Admin Center.
- Go to Teams apps → Manage apps → Upload new app.
- Upload the
biel-teams-app.zipfile. - Under Permission policies, configure which users or groups can install the app.
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.
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.
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.