Microsoft Teams Connector

The Microsoft Teams connector lets users interact with your deployed agent directly from Teams chats and channels. This connector requires manual webhook setup after deployment.

Prerequisites

You need a Microsoft Azure Bot resource:

1. Go to the Azure Portal and create an Azure Bot resource
2. Under Configuration, copy the Microsoft App ID
3. Under Certificates & secrets, create a new client secret and copy the value
4. Under Channels, enable the Microsoft Teams channel
5. Install the bot in your Teams workspace and invite it to channels or chats

Setup

Step 1: Create the Connector

1. Open your agent in Agent Studio
2. In the Connectors panel, click Add Connector
3. Select Microsoft Teams as the provider
4. Enter a Connector Name (lowercase with underscores, e.g., production_teams_bot)
5. Fill in the connector parameters:
   • App ID — The application ID from your Azure Bot registration
   • App Password — The client secret from your Azure Bot registration
6. Configure access:
   • Toggle Onboarding on to require approval for new users, or leave it off for open access
   • If onboarding is enabled, set an Onboarding Message
7. Use the Test button to validate your credentials

Step 2: Configure the Inbound Route

The inbound route filters which Teams messages reach your agent. All parameters are optional — leave them empty to accept all messages.

Step 3: Configure the Outbound Route

The outbound route controls where your agent sends responses.

• Enable use sender as receiver to reply in the same chat/channel that triggered the message (recommended)
• If disabled, specify:
  • Conversation ID — The target conversation
  • Service URL — The Bot Framework service URL for the target conversation

Step 4: Save

Save the agent revision to persist the connector configuration.

Deploy and Webhook Setup

Microsoft Teams requires manual webhook setup after deployment.

1. Click Deploy to publish the agent revision
2. The connector status will show Manual Setup — this is expected
3. Copy the Webhook URL (messaging endpoint) provided by Fruxon
4. In the Azure Portal, go to your bot registration
5. Under Configuration, set the Messaging endpoint to the Fruxon webhook URL
6. Save the bot configuration
7. Once the webhook is verified, the connector status changes to Connected

How Users Interact

Once the connector is connected, Teams users can interact with your agent:

• Direct message — Start a 1:1 chat with the bot
• Mention in a channel — Type @YourBotName followed by a message in a Teams channel
• Group chats — Add the bot to a group chat and mention it

The agent processes each message and responds in the same chat or channel.

Viewing Conversations

All Teams conversations are tracked in your agent's Conversations tab:

• Filter by Teams provider to see only Teams conversations
• View full message history including user messages and agent responses
• Each message links back to its execution record for debugging

Next Steps

• Access Control — Manage who can interact with your agent
• Slack Connector — Connect to another platform
• Conversations — Browse all conversations