串接對話平台：Microsoft Teams

串接 Microsoft Teams：在 Azure 建立 Bot 資源、取得 App ID 與密碼、設定 API 權限與訊息端點，並在 Teams 安裝 Bot。

串接前確認

• 已在 MaiAgent 平台上建立好一個「AI 助理」

• 擁有 Microsoft 365 帳號（企業版或教育版）

• 擁有 Microsoft Azure Portal 帳號與管理權限

• 擁有 Microsoft Entra ID（舊稱 Azure AD）的應用程式註冊權限

Teams Bot 需要組織等級的 Microsoft 365 帳號，個人帳號無法使用。

---

步驟一：在 Azure 建立 Bot 資源

1. 建立 Azure Bot

登入 Azure Portal，搜尋 AI Foundry（或 Bot Services），找到 Azure Bot 並點擊 建立。

AI Foundry 中選擇 Azure Bot

選擇訂閱方案並建立 Azure Bot

2. 填寫 Bot 建立表單

欄位	說明
Bot 控制代碼	輸入唯一的 Bot 名稱（例如 MaiAgentTeamsBot）
訂用帳戶	選擇您的 Azure 訂用帳戶
資源群組	選擇現有或建立新的資源群組
定價層	建議選擇 F0（免費）
Microsoft App ID	選擇「建立新的 Microsoft App ID」或使用現有的

填寫 Azure Bot 建立表單

點擊 檢閱 + 建立，確認後點擊 建立。

---

步驟二：取得 App ID 與密碼

1. 取得 Microsoft App ID

建立完成後，進入 Azure Bot 資源，點選 組態，可看到 Microsoft App ID，複製備用。

Azure Bot 組態 — 取得 Microsoft App ID

2. 建立用戶端密碼

點選 憑證及祕密（或在 Microsoft Entra ID → 應用程式註冊中找到對應的 App），點擊 新增用戶端密碼，設定描述和到期時間後點擊 新增。

建立用戶端密碼（Signing Secret）

用戶端密碼的「值」只會顯示一次，請務必立即複製並妥善保存。

---

步驟三：設定 API 權限

1. 進入應用程式註冊

在 Azure Portal 搜尋 Microsoft Entra ID，進入 應用程式註冊，找到與 Bot 對應的應用程式。

2. 新增 API 權限

點選左側選單 API 權限，點擊 新增權限。

API 權限頁面

3. 選擇 Microsoft Graph

選擇 Microsoft Graph → 應用程式權限，搜尋 User.Read.All 並勾選，點擊 新增權限。

選擇應用程式權限

新增 User.Read.All 權限

4. 授與管理員同意

回到 API 權限頁面，點擊 代表 {組織名稱} 授與管理員同意。

授與管理員同意後，狀態顯示綠色勾號

---

步驟四：在 MaiAgent 建立 Teams 對話平台

1. 進入串接對話平台

在 MaiAgent 左側選單點選 對話平台，點擊 串接對話平台，選擇 Azure Bot（即 Microsoft Teams）。

2. 填寫基本設定

欄位	說明
名稱	為此串接取一個名稱（必填）
AI 助理	選擇要綁定的 Agent
Microsoft App ID	貼上步驟二取得的應用程式 ID（必填）
Microsoft App Password	貼上步驟二取得的用戶端密碼（必填）

3. 儲存並取得 Webhook URL

點擊 串接對話平台 完成建立。系統會產生 Webhook URL，複製備用。

---

步驟五：回到 Azure 設定訊息端點與頻道

1. 設定訊息端點

回到 Azure Bot 資源，進入 Bot 設定檔（組態），將 MaiAgent 產生的 Webhook URL 貼入 訊息端點 欄位，點擊 套用。

Bot 設定檔 — 填入訊息端點（Webhook URL）

2. 啟用 Microsoft Teams 頻道

在左側選單點選 頻道，確認 Microsoft Teams 頻道已啟用且狀態為 Healthy。

頻道設定 — Microsoft Teams 頻道已連接

---

步驟六：在 Teams 中安裝 Bot

方法一：透過 Teams Admin Center 上傳

如果需要讓組織內的所有使用者使用，可透過 Teams Admin Center 上傳 App Manifest：

1. 登入 Teams Admin Center，進入 Manage apps

2. 點擊 Upload new app，上傳 Teams App Manifest（.zip 檔案）

上傳的 App 詳細資訊

Teams App Manifest 範本可從 Google Drive 下載，需修改其中的 Bot ID 為您的 Microsoft App ID。

方法二：透過 Teams 應用程式搜尋

1. 開啟 Microsoft Teams，點選左側 應用程式

2. 搜尋您的 Bot 名稱

3. 點擊 開啟 或 新增 安裝 Bot

在 Teams 應用程式中搜尋並安裝 Bot

確認安裝 Bot 並查看權限

---

開始使用

安裝完成後，在 Teams 聊天列表中可找到 Bot，直接傳送訊息即可與 Agent 互動。

Teams 對話示範 — Agent 自動回覆

---

重要注意事項

安全性

• 用戶端密碼請妥善保管，切勿公開分享

• 建議定期更新用戶端密碼

限制說明

• Bot 在團隊頻道中須被 @ 提及才會回應（一對一私訊不需要）

• Azure Bot Service 免費層（F0）每月可處理 10,000 則訊息

疑難排解

• Bot 無法回應：確認 Webhook URL（訊息端點）設定正確

• 無法在 Teams 找到 Bot：確認已在 Teams Admin Center 上傳 Manifest 並核准

• 權限錯誤：確認 API 權限已授與管理員同意