串接對話平台：Microsoft Teams
串接前確認
MaiAgent 準備
已在 MaiAgent 平台上建立好一個「AI 助理」
Microsoft Teams 權限準備
擁有 Microsoft 365 帳號（企業版或教育版）
擁有 Microsoft Entra ID（舊稱 Azure Active Directory）的管理權限
已建立或可存取 Microsoft Teams 團隊
開發者帳號準備
已註冊 Microsoft Azure Portal 帳號
擁有建立應用程式註冊的權限
開始串接
1. 在 Azure Portal 註冊應用程式
a. 登入 Azure Portal
b. 搜尋並進入「Microsoft Entra ID」（或「Azure Active Directory」）
c. 在左側選單中點選「應用程式註冊」
d. 點選「新增註冊」
e. 填寫應用程式資訊：
名稱：輸入您的 Bot 名稱（例如：MaiAgent Bot）
支援的帳戶類型：選擇「任何組織目錄中的帳戶」
重新導向 URI：暫時留空，稍後設定
f. 點選「註冊」完成建立
2. 取得應用程式 ID 和密碼
a. 在應用程式註冊完成後，複製「應用程式（用戶端）ID」
b. 點選左側選單「憑證及祕密」
c. 點選「新增用戶端密碼」
d. 輸入描述並選擇到期時間
e. 點選「新增」後，立即複製「值」（用戶端密碼）
用戶端密碼只會顯示一次，請務必立即複製並妥善保存
3. 建立 Bot Channel Registration
a. 在 Azure Portal 搜尋「Bot Services」或「Azure Bot」
b. 點選「建立」
c. 選擇「Azure Bot」
d. 填寫以下資訊：
Bot 控制代碼：輸入唯一的 Bot 名稱
訂用帳戶：選擇您的 Azure 訂用帳戶
資源群組：選擇現有或建立新的資源群組
定價層：選擇適合的定價層（可選擇免費的 F0）
Microsoft 應用程式 ID：選擇「使用現有的應用程式註冊」，並貼上步驟 2 取得的應用程式 ID
e. 點選「檢閱 + 建立」，然後點選「建立」
4. 設定 Bot Messaging Endpoint
a. 在 Azure Portal 中進入剛建立的 Azure Bot
b. 點選「組態」
c. 在「訊息端點」欄位中，填入您從 MaiAgent 取得的 Webhook URL（下一步驟會取得）
d. 點選「套用」儲存設定
5. 在 MaiAgent 平台建立 Teams 對話平台
a. 登入 MaiAgent 平台
b. 進入您的 AI 助理管理頁面
c. 點選右上角「串接對話平台」
d. 選擇「Microsoft Teams」作為串接平台
e. 填寫以下資訊：
名稱：期望在平台上呈現的 AI 助理名稱
AI 助理：選擇要串接的 AI 助理
Microsoft App ID：貼上步驟 2 取得的「應用程式（用戶端）ID」
Microsoft App Password：貼上步驟 2 取得的「用戶端密碼」
f. 點選「串接對話平台」完成建立
6. 取得 Webhook URL 並回到 Azure 設定
a. 在 MaiAgent 的對話平台列表中，找到剛建立的 Teams 平台
b. 點選「操作」，在 API 區塊複製 Webhook URL
c. 回到 Azure Portal 的 Azure Bot「組態」頁面
d. 將複製的 Webhook URL 貼入「訊息端點」欄位
e. 點選「套用」儲存
7. 啟用 Microsoft Teams 頻道
a. 在 Azure Bot 的左側選單中，點選「頻道」
b. 在可用頻道清單中，點選「Microsoft Teams」圖示
c. 選擇「Microsoft Teams Commercial」（商業版）
d. 點選「同意」接受 Microsoft 服務條款
e. 點選「套用」完成啟用
8. 將 Bot 新增到 Teams
a. 在 Azure Bot 的「頻道」頁面，點選 Microsoft Teams 旁的「開啟」連結
b. Teams 應用程式會自動開啟，並顯示 Bot 的新增頁面
c. 點選「新增」將 Bot 加入您的 Teams
9. 確認串接是否成功
a. 在 Microsoft Teams 中開啟與 Bot 的對話
b. 傳送測試訊息給 Bot
c. 如果 Bot 能正常回應，表示串接成功
d. 您也可以在 MaiAgent 平台的「所有對話」中查看對話記錄
進階設定
將 Bot 新增到團隊或頻道
除了一對一對話，您也可以將 Bot 新增到 Teams 團隊或特定頻道：
進入您要新增 Bot 的團隊或頻道
點選「...」（更多選項）
選擇「管理團隊」或「管理頻道」
在「應用程式」標籤中搜尋您的 Bot 名稱
點選「新增」
自訂 Bot 圖示和描述
您可以在 Azure Bot 的「組態」頁面自訂以下設定：
顯示名稱：Bot 在 Teams 中顯示的名稱
描述：Bot 的簡短說明
圖示：上傳自訂的 Bot 圖示（建議大小：32x32 像素）
API 權限設定（選用）
如果您的 Bot 需要存取其他 Microsoft 服務（如 Microsoft Graph API），您可以在 Microsoft Entra ID 的應用程式註冊中新增 API 權限：
進入「Microsoft Entra ID」>「應用程式註冊」
選擇您的應用程式
點選「API 權限」
點選「新增權限」
選擇所需的 API 和權限範圍
點選「授與管理員同意」（需要管理員權限）
⚠️ 重要注意事項
安全性
請妥善保管您的「用戶端密碼」（Microsoft App Password），切勿公開或分享
定期更新用戶端密碼以確保安全性
建議設定用戶端密碼的到期時間
定價
Azure Bot Service 提供免費層級（F0），每月可處理 10,000 則訊息
超過免費額度後，將依據使用量計費
詳細定價資訊請參考 Azure Bot Service 定價
限制說明
Bot 在團隊頻道中必須被 @ 提及才會回應（一對一對話不需要）
每個 Bot 在同一個 Microsoft Entra ID 租用戶中必須有唯一的 Bot 控制代碼
免費層級的 Bot 可能會有輕微的回應延遲
疑難排解
Bot 無法回應：請確認 Webhook URL 設定正確，且 MaiAgent 平台的 AI 助理運作正常
無法新增到團隊：請確認您有該團隊的管理權限
訊息端點錯誤：請確認 Webhook URL 格式正確，並包含 https://
相關資源
Last updated
Was this helpful?