接入 Microsoft Teams 機器人
如何在 Buda 中建立並連接 Microsoft Teams 機器人，實現雙向 AI 對話。
接入 Microsoft Teams 機器人
Buda 支援透過 Microsoft Teams 機器人與團隊成員直接對話。設定需要在 Azure 建立一個 Bot 資源，整個過程大約需要 10-15 分鐘。
步驟 1：在 Azure 建立 Bot
開啟 Azure Portal，搜尋並進入 Azure Bot 建立頁面。
填寫以下資訊：
| 欄位 | 填寫內容 |
|---|---|
| Bot handle | 機器人名稱，例如 buda-bot |
| Subscription | 選擇你的 Azure 訂閱 |
| Resource group | 新建或選擇已有的資源群組 |
| Pricing tier | Free（開發測試夠用） |
| Type of App | Single Tenant |
| Creation type | Create new Microsoft App ID |
點擊 Review + create → Create，等待約 1-2 分鐘建立完成。
步驟 2：取得憑證
建立完成後，進入剛建立的 Azure Bot 資源：
取得 App ID：
- 進入 Configuration
- 複製 Microsoft App ID
取得 App Password：
- 點擊 Manage Password，跳轉到 App Registration 頁面
- 進入 Certificates & secrets → New client secret
- 填寫描述，選擇有效期，點擊 Add
- 複製產生的 Value（只顯示一次，請立即儲存）
取得 Tenant ID：
- 在 App Registration 頁面點擊 Overview
- 複製 Directory (tenant) ID
步驟 3：在 Buda 中新增頻道
- 開啟 Buda 的頻道設定（Channels）
- 點擊新增頻道，選擇 Microsoft Teams
- 填入以下三個憑證：
- App ID
- App Password（即 Client Secret）
- Tenant ID
- 點擊連接
步驟 4：設定 Webhook 地址
回到 Azure Bot 資源，進入 Configuration，將 Messaging endpoint 設定為：
https://buda.im/api/channels/msteams/webhook點擊 Apply 儲存。
步驟 5：啟用 Teams 頻道
在 Azure Bot 資源中，進入 Channels，點擊 Microsoft Teams，接受服務條款後點擊 Save。
步驟 6：建立並安裝 Teams App
Teams 需要安裝一個 App 套件才能使用機器人。
6.1 建立 App 套件
- 點擊 + New app
- 填寫應用程式名稱、描述等基本資訊
- 進入 App features → Bot
- 選擇 Enter a bot ID manually，貼上你的 App ID
- 勾選使用範圍：Personal、Team、Group Chat
- 點擊 Distribute → Download app package，下載 ZIP 檔案
6.2 安裝到 Teams
在 Teams 中：
- 點擊左側 Apps → Manage your apps
- 點擊 Upload a custom app
- 選擇剛才下載的 ZIP 檔案
- 依提示完成安裝
步驟 7：測試
在 Teams 中找到剛安裝的機器人，傳送一條私訊，例如：你好。
收到 Buda 的回覆後，即可正常使用 🎉
在頻道中使用時，需要 @提及 機器人才會觸發回覆。
常見問題
機器人沒有回覆
| 可能原因 | 解決方案 |
|---|---|
| Messaging endpoint 填寫有誤 | 確認填寫的是 https://buda.im/api/channels/msteams/webhook |
| App Password 已過期 | 在 Azure 重新產生 Client Secret，更新 Buda 中的設定 |
| Teams 頻道未啟用 | 檢查 Azure Bot → Channels 中 Microsoft Teams 是否已啟用 |
| App 未安裝到 Teams | 確認已完成步驟 6 |
App Password 洩露了怎麼辦
在 Azure App Registration → Certificates & secrets 中刪除舊的 Secret，重新產生一個，然後在 Buda 的頻道設定中更新。