接入 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 的频道设置中更新。