消息渠道
为外部消息服务建立连接,分别管理实例、凭证、模型和收发范围。连接一个渠道不等于授权读取该服务中的全部会话。
入口与准备
打开 设置 > 连接管理,选择要连接的渠道。准备该渠道要求的账号、应用或机器人凭证;扫码、登录和手动凭证入口各自对应具体连接方式,不互相替代。
主要渠道使用以下接入资料,先区分机器人凭证与个人账号连接:
| 渠道 | 接入资料或方式 | 配置要点 |
|---|---|---|
| 飞书 / Lark | 对应应用的凭证 | 选择正确品牌与应用,不能把两者账号配置混用 |
| Telegram、Discord | Bot Token | 使用目标机器人的令牌,并配置服务端会话权限 |
| Slack | Bot Token 与 App Token | 两类令牌分别填入,不互相替代 |
| 钉钉 | App Key、App Secret、Robot Code | 三项对应同一应用与机器人 |
| QQ Bot | API Base 与 Access Token | 接入机器人接口,不是个人账号扫码 |
| LINE | Channel Access Token 与 Channel Secret | 核对渠道身份与服务端权限 |
| Facebook Messenger | Page Token | 核对要连接的主页 |
| WhatsApp 个人账号 | 手机连接引导 | 按引导关联设备,不套用机器人凭证表单 |
| WhatsApp 商业接口 | Phone Number ID 与 Access Token | 与个人账号的手机连接分别配置 |
| 企业微信 | Bot ID、Bot Secret、WebSocket URL | 核对机器人与连接地址 |
| 微信 | 手机扫码连接;桥接配置使用 Listen Addr 与 Bridge Secret | 扫码登录与桥接回调接收配置分别检查 |
| Microsoft Teams | Client ID 与 Tenant | 核对应用与租户 |
一个渠道能有多个实例。为工作账号和个人账号设置不同名称,修改、重连或移除前核对目标实例。
添加与认证
- 从添加渠道入口选择目标服务。
- 按引导登录、扫码,或填写服务要求的凭证。
- 检查实例名称、账号和所需服务权限,保存配置。
- 等待连接结果;需要重连时执行对应入口。
- 从外部渠道发送一条简短消息,再检查实际回复。
例如连接 Slack:添加 Slack 实例,将机器人令牌填入 Bot Token,将应用令牌填入 App Token,保存后核对运行状态,再从已授权的会话发送一条消息。不要把令牌本身发到聊天中,也不要用另一个实例的回复验证本实例。
“凭证可用”只说明保存与校验成功;运行连接和消息收发还需分别验证。配置读取失败时先重试,不在不完整列表上重复添加实例。
模型与收发范围
在目标实例中设置模型及运行选项。桌面默认模型和渠道默认模型分别管理,修改桌面设置不能代替渠道验证。
收发范围按渠道提供的权限与选项配置。只开放需要的会话或群组;服务端账号权限仍然限制读取与发送。先验证一条明确消息,不用广泛群发作为连接测试。
群组监听与归档
连接消息渠道和监听群聊是两项操作。需要读取群组时,在对应监控入口完成读取源授权,核对同步状态、目标群组和归档位置。没有读到消息时检查读取源和同步,不重复添加同一个渠道连接。
归档保存读取到的消息资料,不替代外部服务的历史备份。移除前检查确认框是否涉及本地历史,并区分连接配置、归档和外部服务数据。
条件选项
QQ 官方机器人扫码入口默认关闭,仅预发布构建在实验室启用对应开关后显示;它不同于填写 API 地址与令牌的 QQ Bot 渠道。
WhatsApp 个人账号的“重连后补回复”默认关闭,仅预发布构建启用对应实验开关后显示。时间范围接受 0–1440 的整数分钟,0 只处理重连后的新消息;修改在下次启动 WhatsApp 连接时生效。
重连、移除与检查
| 现象或操作 | 检查重点 |
|---|---|
| 认证失败 | 凭证、扫码结果、服务端授权和目标实例 |
| 凭证可用但无回复 | 运行连接、模型可用性、收发范围与渠道错误 |
| 群组未同步 | 读取源授权、同步状态和选定群组 |
| 移除实例 | 名称、账号、确认框中的本地历史处理选择 |
| 停止使用账号 | 断开本地连接,并在服务端检查授权与凭证 |
移除本地连接不自动删除远端消息。网络问题见网络与后台运行。