Integrate with Platform: Microsoft Teams

Pre-Connection Checklist

• An "AI Assistant" has been created on the MaiAgent platform

• You have a Microsoft 365 account (Enterprise or Education edition)

• You have an Microsoft Azure Portal account with admin permissions

• You have application registration permissions in Microsoft Entra ID (formerly Azure AD)

Teams Bot requires an organization-level Microsoft 365 account; personal accounts cannot be used.

---

Step 1: Create a Bot Resource in Azure

1. Create an Azure Bot

Sign in to the Azure Portal, search for AI Foundry (or Bot Services), find Azure Bot, and click Create.

2. Fill in the Bot Creation Form

Field	Description
Bot handle	Enter a unique Bot name (e.g., MaiAgentTeamsBot)
Subscription	Select your Azure subscription
Resource group	Select an existing or create a new resource group
Pricing tier	F0 (Free) is recommended
Microsoft App ID	Select "Create new Microsoft App ID" or use an existing one

Click Review + create, then confirm and click Create.

---

Step 2: Obtain the App ID and Password

1. Obtain the Microsoft App ID

After creation, go to the Azure Bot resource and click Configuration to find the Microsoft App ID. Copy it for later use.

2. Create a Client Secret

Click Certificates & secrets (or find the corresponding App in Microsoft Entra ID → App registrations), click New client secret, set the description and expiration, then click Add.

The client secret "Value" is displayed only once. Copy and securely store it immediately.

---

Step 3: Configure API Permissions

1. Go to App Registrations

Search for Microsoft Entra ID in the Azure Portal, go to App registrations, and find the application corresponding to the Bot.

2. Add API Permissions

Click API permissions in the left menu, then click Add a permission.

3. Select Microsoft Graph

Select Microsoft Graph → Application permissions, search for User.Read.All, check it, and click Add permissions.

4. Grant Admin Consent

Return to the API permissions page and click Grant admin consent for {Organization Name}.

---

Step 4: Create a Teams Chat Platform in MaiAgent

1. Go to Connect Chat Platform

Click Chat Platforms in the MaiAgent left menu, click Connect Chat Platform, and select Azure Bot (i.e., Microsoft Teams).

2. Enter Basic Settings

Field	Description
Name	Give this connection a name (required)
AI Assistant	Select the AI Assistant to bind
Microsoft App ID	Paste the Application ID obtained in Step 2 (required)
Microsoft App Password	Paste the client secret obtained in Step 2 (required)

3. Save and Obtain the Webhook URL

Click Connect Chat Platform to complete the setup. The system will generate a Webhook URL — copy it for later use.

---

Step 5: Return to Azure to Configure the Messaging Endpoint and Channel

1. Configure the Messaging Endpoint

Return to the Azure Bot resource, go to Bot profile (Configuration), paste the Webhook URL generated by MaiAgent into the Messaging endpoint field, and click Apply.

2. Enable the Microsoft Teams Channel

Click Channels in the left menu and confirm that the Microsoft Teams channel is enabled and the status is Healthy.

---

Step 6: Install the Bot in Teams

Method 1: Upload via Teams Admin Center

To make the Bot available to all users in the organization, upload the App Manifest through the Teams Admin Center:

1. Sign in to the Teams Admin Center and go to Manage apps

2. Click Upload new app and upload the Teams App Manifest (.zip file)

Download the Teams App Manifest template from Google Drive. You need to replace the Bot ID with your Microsoft App ID.

Method 2: Search in Teams Apps

1. Open Microsoft Teams and click Apps in the left menu

2. Search for your Bot name

3. Click Open or Add to install the Bot

---

Getting Started

After installation, find the Bot in the Teams chat list and send a message to start interacting with the AI Assistant.

---

Important Notes

Security

• Keep the client secret secure and never share it publicly

• Regularly rotate the client secret

Limitations

• The Bot must be @ mentioned in team channels to respond (not required in one-on-one chats)

• Azure Bot Service free tier (F0) can process 10,000 messages per month

Troubleshooting

• Bot not responding: Verify the Webhook URL (messaging endpoint) is configured correctly

• Cannot find Bot in Teams: Verify the Manifest has been uploaded and approved in Teams Admin Center

• Permission errors: Verify API permissions have been granted admin consent