渠道
連線 Microsoft Teams
註冊 Azure Bot、安裝 Teams 應用,並將其連線到 Buda 智慧體,實現雙向 AI 對話。
把你的智慧體帶進 Microsoft Teams,讓同事能在私信和頻道中與之對話。Teams 是唯一使用訊息端點而非持久連線的渠道,因此設定需要通過 Azure 完成——預計約需 10–15 分鐘。

連線機器人
建立 Azure Bot
在 Azure 門戶中搜索 Azure Bot 並開啟建立頁面。設定:
| 欄位 | 取值 |
|---|---|
| Bot handle | 例如 buda-bot |
| Pricing tier | Free(開發用足夠) |
| Type of App | Single Tenant |
| Creation type | Create new Microsoft App ID |
點選 Review + create → Create。
獲取憑據
從 Azure Bot 資源中收集三個值:
- App ID —— Configuration → Microsoft App ID
- App Password —— Manage Password → Certificates & secrets → New client secret,然後複製 Value(僅顯示一次)
- Tenant ID —— 應用註冊的 Overview → Directory (tenant) ID
在 Buda 中新增渠道
開啟 Settings → Channels,點選 Add Channel,選擇 Microsoft Teams。輸入 App ID、App Password(client secret)和 Tenant ID,然後點選 Connect。
設定訊息端點
回到 Azure Bot 資源,開啟 Configuration 並將 Messaging endpoint 設定為:
https://buda.im/api/channels/msteams/webhook點選 Apply。
啟用 Teams 渠道並安裝應用
在 Azure Bot 資源中開啟 Channels → Microsoft Teams,接受條款並點選 Save。然後在 Teams 開發者門戶中建立一個新應用,新增 Bot 功能並手動填入你的 App ID,勾選 Personal / Team / Group Chat 範圍,再點選 Download app package。在 Teams 中前往 Apps → Manage your apps → Upload a custom app,安裝該 ZIP。
測試
在 Teams 中找到已安裝的機器人並給它傳送私信,例如 Hi。在頻道中,@提及機器人來觸發回覆。
故障排查
| 現象 | 解決辦法 |
|---|---|
| 機器人無響應 | 確認訊息端點為 https://buda.im/api/channels/msteams/webhook |
| App Password 過期 | 在 Azure 中重新生成 client secret,並更新 Buda 的渠道設定 |
| Teams 渠道未啟用 | 檢查 Azure Bot → Channels 下 Microsoft Teams 是否已啟用,且應用已安裝 |
相關內容
- 渠道總覽 —— 渠道如何把訊息路由給智慧體
- Azure Bot 註冊指南