Skip to main content
Deploy your agent to Microsoft Teams by using the Teams channel integration.

​
Prerequisites

  • A Microsoft Azure account
  • An Azure Bot or App registration that is configured for Microsoft Teams
  • Microsoft credentials:
    • Application client ID
    • Client secret
  • A Microsoft Teams tenant ID (optional)

​
Create a Microsoft Teams channel

Use one of the following methods to define the channel: Using YAML: 
spec_version: v1
kind: channel

# Required: Channel type identifier
channel: teams

# Required: Name for this channel instance
name: production_teams_channel

# Optional: Description of this channel
description: Main customer support Microsoft Teams channel for production environment

# Required: Microsoft App Client secret (from Certificates & secrets)
app_password: ${TEAMS_APP_PASSWORD}

# Required: Microsoft Application (client) ID
app_id: ${TEAMS_APP_ID}

# Optional: Microsoft Teams tenant ID (also called Directory ID)
teams_tenant_id: ${TEAMS_TENANT_ID}
Using Python: 
import os
from ibm_watsonx_orchestrate.agent_builder.channels import TeamsChannel
from dotenv import load_dotenv
load_dotenv()

channel = TeamsChannel(
    name="production_teams_channel",
    description="Main customer support Microsoft Teams channel for production environment",
    app_password=os.getenv("TEAMS_APP_PASSWORD"),
    app_id=os.getenv("TEAMS_APP_ID"),
    teams_tenant_id=os.getenv("TEAMS_TENANT_ID")
)

​
Configuration requirements

FieldRequiredFormatDescription
app_idYesStringMicrosoft application client ID
app_passwordYesStringClient secret created in Azure App registration
teams_tenant_idNoStringMicrosoft Entra tenant ID