> ## Documentation Index
> Fetch the complete documentation index at: https://developer.watson-orchestrate.ibm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Teams

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:**

```yaml theme={null}
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:**

```python theme={null}
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

| Field             | Required | Format | Description                                     |
| ----------------- | -------- | ------ | ----------------------------------------------- |
| `app_id`          | Yes      | String | Microsoft application client ID                 |
| `app_password`    | Yes      | String | Client secret created in Azure App registration |
| `teams_tenant_id` | No       | String | Microsoft Entra tenant ID                       |