渠道

連線 Microsoft Teams

註冊 Azure Bot、安裝 Teams 應用,並將其連線到 Buda 智慧體,實現雙向 AI 對話。

把你的智慧體帶進 Microsoft Teams,讓同事能在私信和頻道中與之對話。Teams 是唯一使用訊息端點而非持久連線的渠道,因此設定需要通過 Azure 完成——預計約需 10–15 分鐘。

由 Buda 智慧體回覆的 Teams 訊息

連線機器人

建立 Azure Bot

Azure 門戶中搜索 Azure Bot 並開啟建立頁面。設定:

欄位取值
Bot handle例如 buda-bot
Pricing tierFree(開發用足夠)
Type of AppSingle Tenant
Creation typeCreate 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 IDApp 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 是否已啟用,且應用已安裝

相關內容

On this page