飞书-云讯通消息转发部署文档

一、产品定位

二、业务价值

1. 消除双 IM 系统信息孤岛，无需频繁切换平台查看工作消息。
2. 实现消息全自动同步，替代人工转发，降低运维及办公人力成本。
3. 保障业务通知、运维告警、团队沟通消息实时流转，提升整体工作响应效率。

三、前置条件

1. 飞书企业管理员权限，可登录飞书开放平台创建自建应用。
2. 业务服务器环境，已安装 Node.js、npm 运行环境。
3. 云讯通群管理员权限，支持新增第三方机器人接入配置。

四、部署配置流程

4.1 飞书开放平台配置

1. 登录飞书开放平台，创建企业自建应用并开启机器人基础能力。

2. 申请对应接口权限：读取机器人群消息、接收消息事件权限。

3. 事件订阅选择长连接模式，添加消息接收事件。

4. 将应用发布至本企业，并将机器人账号添加至需要同步的飞书目标群。
5. 复制留存应用 App ID、App Secret 凭证，用于后续对接配置。

4.2 云讯通系统配置

1. 进入需要接收消息的云讯通目标群，打开群管理设置页面。

2. 选择新增机器人，选定飞书机器人接入类型。

3. 填写飞书应用 App ID、App Secret 凭证，完成机器人绑定对接。

4.3 桥接服务部署启动

1. 登录业务服务器，进入项目目录，执行依赖安装命令。

2. 复制配置模板，生成正式环境配置文件，填写飞书凭证、云讯通群 ID、机器人密钥等全部参数。

3. 启动桥接同步服务，生产环境配置进程常驻，保证服务稳定运行。

五、功能验证

1. 在飞书同步源群发送任意测试消息。

2. 查看云讯通目标群，确认消息自动同步转发成功。

3. 核查服务运行日志无报错，即代表整体部署配置完成、功能正常。

六、常见问题排查

6.1 飞书端无法接收群消息

• 机器人未成功加入飞书同步群聊
• 开放平台权限未审批生效
• 长连接事件订阅未正常连接

6.2 可接收消息但无法转发至云讯通

• 云讯通群 ID 配置错误
• 机器人对接密钥参数不匹配
• 环境配置文件参数缺失、填写错误