渠道
连接钉钉（DingTalk）
通过 Stream 模式把钉钉机器人连接到 Buda 智能体——可以扫码自动创建应用，也可以手动填写 Client ID 和 Secret。
在钉钉里给团队配一位 AI 同事，让同事在私信和群聊中都能找它对话。Buda 通过钉钉的 Stream 模式（一条持久的出站 WebSocket 连接）接入，因此无需托管公网 URL。
连接机器人
Buda 提供两种连接方式：扫码让钉钉自动创建应用，或使用你已有应用的凭据手动填写。
打开添加渠道
在 Buda 中打开 Settings → Channels，点击 Add Channel，选择 DingTalk。
扫码连接（推荐）
在 Scan to connect（扫码连接） 标签页点击 Start scan（开始扫码）。Buda 会显示一个二维码——打开钉钉扫描它，并在钉钉中确认授权。钉钉会在你的组织内自动创建一个应用，并把应用凭据直接返回给 Buda，你完全不需要打开钉钉开放平台。
或手动填写凭据
如果你已经有一个应用，切换到 Enter manually（手动输入） 标签页。前往钉钉开放平台创建（或复用）一个已启用机器人能力并开启 Stream 模式的企业内部应用，然后复制：
- Client ID（AppKey）
- Client Secret（AppSecret）
把两者粘贴到 Buda 中，可选地设置标签和目标智能体，然后点击 Connect。
测试
在钉钉中找到该机器人并发送一条私信，例如 Hi。在群聊中，需要 @ 机器人才能收到回复。
在群聊中使用
把机器人加入钉钉群聊，并 @ 它以触发回复——群里没有 @ 机器人的消息会被忽略。私信则无需 @。
目前只处理文本消息——钉钉的其他消息类型（图片、文件、卡片等）会被忽略。
故障排查
| 现象 | 解决办法 |
|---|---|
| 机器人无响应 | 确认渠道显示 Active；如果是手动连接，重新核对 Client ID / Client Secret |
| 群聊中没有回复 | 群聊中必须 @ 机器人 |
| 二维码已过期 | 回到 Add Channel 重新开始扫码 |
| 凭据泄露 | 在钉钉开放平台重置 AppSecret，然后在 Buda 的渠道设置中更新 |