渠道

连接 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 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 是否已启用，且应用已安装

相关内容

连接飞书 / Lark

通过持久 WebSocket 把飞书（Lark）机器人连接到 Buda 智能体——只需 App ID 和 Secret，无需公网 webhook。

嵌入网页聊天挂件

在你自己的网站上放置一个公开的 AI 聊天挂件——创建网页渠道、嵌入一段脚本，并选择会话、登录和只读行为。

On this page

连接机器人创建 Azure Bot获取凭据在 Buda 中添加渠道设置消息端点启用 Teams 渠道并安装应用测试故障排查相关内容