v2.1.7+Configuring a Microsoft Teams channel for an AI agent chatbot (Preview)

In the Graphical Designer, you can add a Microsoft Teams channel to an AI agent chatbot to route messages between the agent and a Microsoft Teams bot through an Azure Service Bus queue managed by the Event Manager.

Before you begin

To add a Microsoft Teams channel, the following conditions must be met:

  • The target AI agent must be configured as a chatbot. The Published as Chatbot option must be enabled in the General Information section of the AI agent definition.
  • An Azure Service Bus namespace and queue must be provisioned, and an application must be registered in Microsoft Entra ID with a client secret generated for the bot integration.

About this task

The Channels panel in the Graphical Designer lists all external messaging integrations registered for the AI agent. Each channel entry specifies a plug-in type and the connection properties required by the Event Manager to route messages.

Important: The Microsoft Teams channel is a preview feature. The configuration and behavior described in this task may change in a future release, and the channel is not supported for production chatbot deployments.

Procedure

  1. Open your target AI agent block in the Graphical Designer.
  2. Locate the Channels collapsible panel.
  3. Click Add new + inside the Channels panel.
  4. In the Channel Name field, type a unique descriptive identifier for this integration endpoint.

    For example: MSTEAMS_CHANNEL.

  5. In the Type dropdown, select MSTeamsBOT.
  6. Complete the plug-in definition fields using the connection attributes for your Service Bus queue and registered application.

    For the full list of required and optional parameters, see MSTeamsBOT plug-in configuration parameters (Preview).

  7. Save the AI agent definition.
    The Microsoft Teams channel entry appears in the Channels panel. The Event Manager registers the endpoint and begins routing inbound Microsoft Teams messages to the AI agent.

Results

The AI agent chatbot is now reachable through the configured Microsoft Teams bot endpoint. End users who send a message to that bot for the first time receive an authentication link. After they authenticate, their session remains valid for 30 days.

What to do next

To understand the authentication lifecycle and session management for external channel users, see Communication channels for AI agent chatbots. To configure the channel programmatically using Orchestration CLI, see Managing an AI agent using Orchestration CLI.