Microsoft Teams
Deploy a Runbear agent to a Microsoft Teams team or group chat, where people @mention it for answers. Available on every plan, optionally under your own branding.
On this page
Runbear deploys an agent to Microsoft Teams so people can @mention it in a team or group chat and get the answer in the conversation. Teams is included on every plan and works with every runtime listed on Runtimes, including the default Claude Agent SDK runtime. The same agent can be deployed to Slack and Teams at the same time, and each deployment keeps its own triggers. Teams also supports a branded bot, so the agent can appear under your own name and icon rather than Runbear's.
What you need#
- A Runbear agent. See Getting started.
- Permission to add apps to the team or group chat in Microsoft Teams. If your organization restricts third-party apps, a Teams admin may need to allow the Runbear app first.
How it works#
Setup#
- In the Runbear dashboard, open your agent and go to the Chatbots tab.
- Click the Microsoft Teams tile and choose Use @Runbear (Use @Runbear Bot). If the Runbear app isn't in your Teams organization yet, click Install @Runbear in Teams, or install it directly from Microsoft AppSource. To use a branded bot instead, see Branded bot.
- In MS Teams, click Add to a Team and choose the team or group chat where you want the bot.
- The Runbear bot will post a card with a Complete Setup button. Click it to go to the Runbear dashboard.
- Enter your Teams name and click Add.
- The agent is now active in your selected team or group chat.
Branded bot#
By default, the bot appears as "Runbear" in Teams. If you want a custom name, icon, and description, build a branded bot that works identically but looks like your own app. Start from the Microsoft Teams tile's Create option named after your agent (Create Custom Bot), or from Settings → Integrations → Microsoft Teams → Create Bot. The three-step wizard, installing the bot, and deleting it are described in Integrations.
How the agent responds#
Each team or chat you deploy to is a connection on the agent's Chatbots tab, with its own triggers and preferences. The agent always replies when someone @mentions it or sends it a direct message. On Classic, Anthropic and OpenAI Responses agents, a connection can also keep replying in a thread once it has started, reply to every new message without an @mention, or reply when a message contains a keyword. See Microsoft Teams triggers and Microsoft Teams preferences.
Troubleshooting#
Can't find my team or group chat when connecting#
If your team or group chat doesn't appear during setup, the Runbear app likely isn't installed there yet. Click + Add conversation in the dropdown and install the app in your desired team or group chat. Refresh the connection page afterward.
App installed, but no "Complete Setup" message#
In Teams, you can install the same bot into a team or group chat more than once. If you previously installed the bot, you may not receive another "Complete Setup" message. In that case, skip the setup step and proceed directly to connecting your agent.