Skip to main content
Deploy your Agent to Microsoft Teams so team members can chat with it in channels and direct messages — no need to leave their daily communication tool.
Prerequisites:

​
Set up the deployment

1

Select your Agent

Navigate to Agents, find the Agent you want to deploy, click … and select Edit.
Agent card context menu showing Edit option
2

Open the Deployments tab

In the Agent editor, click the Deployments tab.
Agent editor showing the Deployments tab
3

Configure the Microsoft Teams app

Fill in the app details for your Teams deployment:
  • App Color Icon and App Outline Icon — The icons displayed in Teams
  • Short Name and Long Name — How the app appears in Teams
  • Short Description and Long Description — What the app does
Once you’ve entered the information, click Create Microsoft Teams Deployment.
Microsoft Teams deployment configuration showing icon, name, and description fields
Microsoft Teams app details showing where Short Name, Long Name, and descriptions appear
4

Authorize the deployment

Click Deploy to Microsoft Teams. If you’re not already logged in to Microsoft Teams, you’ll be prompted to sign in.
Deploy to Microsoft Teams button in the deployment dialog
You can also click Deploy Manually to download the app package and install it yourself through the Teams admin center.
Manual deployment option with instructions to download and install the app package
5

Select the team and deploy

Choose which team to install the Agent app in and click Deploy to Microsoft Teams.
Team selection dialog for deploying the Agent
6

Configure optional settings

Optionally enable Show Knowledge Base References to include source citations in the Agent’s responses.

​
Chat with your Agent in Teams

​
In a channel

To use the Agent in a Microsoft Teams channel, mention the app using @ followed by its short name. Start a new post and @mention the Agent — it will respond in that post’s thread. The Agent only has access to that specific post’s conversation history.
Microsoft Teams channel showing an Agent mentioned with @ in a post

​
In a direct message

Start a new direct message to the Agent for a private, ongoing conversation. The Agent has access to the full chat history in DMs, giving it more context for follow-up questions.
Microsoft Teams direct message conversation with a deployed Agent
For any user to DM the Agent, they need to manually add the app first. Otherwise they may see “You cannot send messages to this bot.” To add the app:
  1. Click Apps in the left sidebar
  2. Search for the app by name and click on it
  3. Click Add
  4. Start a new chat addressed to the app
Known limitations:
  • Archived channels won’t appear in the team selection
  • After adding or removing the Agent, the Teams app list may take a moment to update — but you can @mention it immediately
  • Bots in private channels are not supported
  • Bots cannot see the subject line of messages

​
Next steps

Deploy to Slack

Make your Agent available in Slack channels and DMs.

Deploy to Google Chat

Add your Agent to Google Chat spaces.