渠道配置（Integrations）
渠道配置（Integrations）
概述
Integrations 让你把 Agent 接入外部 IM 平台，这样你和团队可以直接在 Telegram、WhatsApp、Slack 等工具里与 Agent 对话。来自渠道的消息由本 APP（你的工作节点）执行，回复再推送回平台。
渠道在 Integrations 页配置（左侧导航 → Integrations）。
支持的渠道
| 渠道 | 类型 | 说明 |
|---|---|---|
| Telegram | 全球 IM | 支持 Bot 的跨平台消息工具；群聊与私聊 |
| 全球 IM | 使用最广泛的个人消息应用 | |
| Discord | 社区 | 面向社区的语音 / 文字服务器 |
| Slack | 企业协作 | 基于频道的团队协作 |
| Teams | 企业协作 | 内置于 Microsoft 365 的团队协作 |
| WeChat（微信） | 国内 IM | 国内主流的个人消息应用 |
| DingTalk（钉钉） | 企业协作 | 阿里的企业与组织协作平台 |
Integrations 页每一行显示平台图标、名称、简介和状态点（灰色 = 未连接，绿色 = 已连接）。点击某一行进入其配置页。
各渠道的多模态能力矩阵见 渠道列表。
通用配置流程
每个渠道页的结构相同：
| 元素 | 说明 |
|---|---|
| 启用开关（右上角） | 开启或关闭该渠道 |
| Test Connection | 校验凭证；渠道名旁的状态标签从 Disconnected 变为已连接 |
| 凭证字段 | Bot Token / App Key / 二维码——视平台而定 |
| Allowed Senders | 允许通过该渠道与 Agent 对话的用户白名单（@用户名 或数字 ID）。留空表示允许所有人；用 Add 添加条目 |
- 打开 Integrations → 点击渠道
- 填写平台要求的凭证
- （推荐）添加 Allowed Senders，只让可信用户触发 Agent
- 点击 Test Connection，然后打开启用开关
- 在平台上给 Bot 发消息，Agent 即回复
Telegram 配置步骤
- 在 Telegram 搜索 @BotFather，发送
/newbot - 按提示设置 Bot 名称，获得形如
123456789:ABCdefGHIjklMNOpqrsTUVwxyz的 Bot Token - 打开 APP → Integrations → Telegram
- 把 Token 粘贴到 Bot Token（眼睛图标可显示 / 隐藏）
- 在 Allowed Senders 填入你的 Telegram
@用户名或数字 ID，点击 Add - 点击 Test Connection；状态显示已连接后，打开开关
- 在 Telegram 找到你的 Bot 发送消息，Agent 会自动回复
提示：Telegram Bot 同时支持群聊和私聊。把 Bot 加入群后，用 @BotName 提及即可触发 Agent 回复。
WhatsApp 配置步骤
- 打开 APP → Integrations → WhatsApp
- 按页面上的配对流程操作（关联设备模式，扫描二维码）
- 打开手机 WhatsApp → 设置 → 已关联的设备 → 关联设备，扫描二维码
- 配对成功后，APP 会自动保持连接（断开后自动重连）
注意：关联设备模式要求手机上的 WhatsApp 保持登录状态。手机退出登录后连接会断开。
钉钉配置步骤
- 在钉钉开放平台创建企业内部应用
- 获取应用的 AppKey 和 AppSecret
- 打开 APP → Integrations → DingTalk，填写凭证，并按页面提供的信息配置消息回调
- 点击 Test Connection 并打开开关
多模态消息支持
部分渠道支持收发多模态消息：
| 能力 | 说明 |
|---|---|
| 接收图片 | 用户在 IM 中发送的图片会传给 Agent |
| 接收文件 | 用户发送的文档 / 文件会传给 Agent |
| 发送文本 | Agent 的文本回复推送到 IM |
| 发送图片 | Agent 生成的图片推送到 IM |
| 发送文件 | Agent 生成的文件推送到 IM |
各渠道的具体多模态能力差异见 渠道多模态能力矩阵。
对话展示
来自渠道的对话会在 APP 的项目 / 任务列表中带平台图标显示，便于区分消息来源。产出的文件出现在 My Files 中。
渠道消息注意事项
| 事项 | 说明 |
|---|---|
| APP 必须运行 | 渠道消息由本 APP 执行；APP 关闭或离线时消息不会被回复 |
| 消息延迟 | 消息经 IM 平台 → Agent → IM 平台，通常有数秒延迟 |
| 文本长度限制 | 各平台的单条消息长度上限不同（如 Telegram 4096 字符）；过长的回复会被拆分发送 |
| 格式限制 | 部分渠道不支持 Markdown，回复会降级为纯文本 |
| 文件发送 | 不支持文件的渠道会收到下载链接 |
| 权限 | 渠道任务触发的工具权限卡片遵循同样的 P0/P1/P2 规则；对渠道任务常用的工具，使用 Always Allow 或调整 Tool Level |
| 对话上下文 | 每个渠道用户的对话是独立会话，Agent 会记住同一用户的历史对话 |