飞书消息转发教程

飞书消息转发有两个方向：把飞书里的新消息转出去，或把其他平台的消息汇集到飞书。本教程分开说明，先按你的方向选择配置；个人号来源与群机器人目标不能互相代替。

准备一个转发方案

打开转发控制台，创建并进入方案。确认账号具有飞书来源权限、执行节点可用；本地执行时，需要保持电脑和客户端在线。来源账号应当能在飞书里打开需要监听的群聊或私聊。

第一步：扫码连接飞书个人号

1. 在“来源账号 → 添加来源”选择“飞书个人号”。
2. 填写便于识别的账号备注，确认使用提示，点击“创建飞书来源”。
3. 等执行环境准备好后进入“扫码登录”，使用自己的飞书 App 扫码，在手机上确认。
4. 如页面显示“开始轮询扫码结果”，点击它获取验证结果；二维码过期时使用“重新生成二维码”。
5. 确认显示“已验证”，再继续配置频道。

当前接入流程不要求填写手机号、密码、验证码或手工粘贴 Cookie。没有可用执行节点时，先解决节点状态；反复生成二维码不会让节点就绪。

第二步：选定来源群聊或私聊

进入“频道配置 → 新建规则”，选择刚连接的飞书来源，点击“刷新列表”或“选择飞书会话”，按群名、会话类型或 Chat ID 查找。

每条规则只监听选中的一个会话。“私聊”是会话类型，不代表所有私聊。手工填写时，应使用该个人号来源可访问的数字会话 ID，不能填写群邀请链接，也不能把应用机器人使用的 oc_... Chat ID 直接当成个人号来源 ID。

会话列表可能不完整；找不到时先核对个人账号访问权限，必要时使用已经核实的来源会话 ID。没有确认 ID 时不要猜测，也不要因此开放无关权限。

第三步：转发到 Discord 或 Telegram

以飞书群公告转 Discord 为例：

保存并启用规则，启动来源。Discord Webhook 创建方法见Discord教程。

转到 Telegram 时，改选“Telegram Bot”，填写目标机器人 Token 与 Chat ID，并确保机器人在目标群且能发言；详见Telegram目标配置。

第四步：检查真实收件

等来源显示“已登录 · 监听中”后，请另一位有权成员在选定飞书群发送“飞书 FS-TEST-001”。到“投递记录”和目标群核对同一编号。

如果用自己的账号发消息，在“监听设置”检查“同时接收本账号发出的消息”；测试其他机器人消息时，检查“同时接收机器人账号发送的消息”。当前来源不扫描旧历史，应使用连接后的新消息。

把其他平台消息转发到飞书

这个方向不需要把飞书个人号当成来源。先连接 Discord、Telegram等实际来源，再在对应规则里选择飞书目标。

**Webhook 配置：**在目标飞书群添加自定义机器人，复制完整 Webhook。规则目标选“飞书 Webhook”，填入地址；机器人开启签名校验时填写匹配的密钥。关键词及 IP 安全设置也需要与实际投递相符。参见飞书自定义机器人说明。

**应用机器人配置：**在飞书开发者后台创建或选用自己的企业应用，开启机器人能力，按实际需要配置消息发送、图片和文件上传权限，并按组织流程发布应用、批准权限。把机器人加入接收群并允许发言。通过开放平台调试工具的机器人所在群列表接口核对目标群及其 Chat ID，不要使用个人号来源的数字会话 ID 代替。

回到 EasyForward，目标选“飞书 Bot（Open API）”，依次填写“飞书 App ID”“飞书 App Secret”“目标群 Chat ID”。三项必须属于同一应用与该机器人可访问的群。保存时的凭据校验不等于已经向群发送成功。

先用文本测试；再在规则中开启附件转发，使用一张小图和一个小文件分别核对。应用权限、文件大小、格式及来源资源可用性都可能影响投递。当前飞书 Webhook 无法原生上传附件，出现附件需应用机器人的错误时应切换目标类型。

常见问题

• 已验证但等待配置会话：登录完成，仍需建立启用的规则并选择会话。
• 已登录但监听异常：查看该来源状态和错误；登录有效与监听就绪是不同状态。
• 自己发的消息没转发：检查接收本账号消息开关，并用另一成员的新消息复测。
• Webhook 签名失败：确认地址和签名密钥属于同一个机器人。
• 应用凭据有效但群拒收：检查应用发布、授权范围、机器人加群、发言及上传权限。
• 要同步编辑或撤回：取决于来源事件和目标能力；本教程先验证新消息，不能把开关理解为所有目标都完整支持。

进入转发控制台配置飞书，或返回七个平台教程。