飞书传信 当前执行时按这个顺序取发送内容到飞书指定群里：

1. 先模拟 Ctrl+C
2. 如果剪贴板里是文本，直接发送文本
3. 如果是图片，先上传图片再发送图片消息
4. 如果是文件，逐个上传并发送
5. 如果都没有，再弹输入框让用户手工输入文本

一、先准备什么

你最终要拿到三项配置：

• AppID
• AppSecret
• ChatID

其中：

• AppID / AppSecret 来自飞书开放平台里的自建应用
• ChatID 是目标会话 ID，群一般是 oc_xxx

如果后面还要配合 飞书收信 使用，那么这里的应用、权限和发布也会被复用。

二、进入飞书后台创建应用

1）打开飞书开放平台

在浏览器进入飞书开放平台，登录你的企业管理员或有应用配置权限的账号。

2）创建企业自建应用

进入：

• 开发者后台
• 创建企业自建应用

创建时建议这样填：

• 应用名称：飞书传信
• 应用描述：例如“给指定群或单聊发送文本、图片、文件”
• 应用图标：可先随便上传，后续不影响 Quicker

创建完成后，先记下：

• App ID
• App Secret

这两个值后面要填进 Quicker 动作配置。

三、给应用添加机器人能力

进入应用后台后，先确认已经启用：

• 机器人

如果没有启用，先在：

• 添加应用能力

里把 机器人 加进去。

原因很直接：

• 飞书传信 现在走的是机器人发消息
• 没有机器人能力，后面的消息发送接口不会按当前方案工作

四、配置权限

1）进入权限管理

打开：

• 权限管理

然后分别检查 应用身份 和 用户身份 权限。

这套动作当前实际依赖的是：

• 应用身份权限

用户身份权限不是 飞书传信 主链路必需，但你当前项目里已经存在一套经过验证的权限集合，可以一并保留。

2）当前项目已验证权限清单

下面这份是你本地 权限.json 中保存的权限集合，可直接作为核对清单。

{
  "scopes": {
    "tenant": [
      "application:application.contacts_range:write",
      "contact:contact",
      "contact:contact.base:readonly",
      "contact:department.organize:readonly",
      "docs:document.media:upload",
      "im:chat.members:read",
      "im:chat:read",
      "im:chat:readonly",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:message:send_multi_depts",
      "im:message:send_multi_users",
      "im:resource"
    ],
    "user": [
      "aily:file:write",
      "contact:contact",
      "contact:contact.base:readonly",
      "contact:department.organize:readonly",
      "docs:document.media:upload",
      "im:message",
      "im:message.p2p_msg:get_as_user"
    ]
  }
}

3）对 飞书传信 最关键的权限

如果只从“发送文本 / 图片 / 文件”出发，优先确认这些：

• docs:document.media:upload
  • 上传图片、文件时需要
• im:message
  • 消息相关基础权限
• im:message:send_as_bot
  • 机器人身份发消息核心权限
• im:chat:read
  • 某些会话信息读取场景会用到
• im:resource
  • 后续若和收信动作共用，会涉及消息资源读取

如果你后续还要继续使用 飞书收信，建议直接按上面的整份 tenant 权限清单配置，避免后续重复补权限。

4）权限开通后要注意

不是勾上就结束，还要确认：

• 权限状态已经是 已开通
• 如果企业需要审批，已经审批通过
• 当前版本发布后，这些权限才会真正生效

五、配置机器人进入目标群

如果你要发到群里，还需要这一步。

1）把机器人加入目标群

在飞书客户端中：

• 打开目标群
• 添加该应用机器人进群

2）确认机器人确实已在群中

如果机器人不在群里：

• 文本消息可能发不进去
• 图片 / 文件消息也不会按当前群路由成功

六、获取 ChatID

飞书传信 发消息需要 ChatID。

你当前项目里用的是：

• 进入群，点击右上角，进入设置，拉到最下面有id
• 
  

七、发布应用版本

这一步是最容易漏掉的。

权限、机器人能力或事件配置发生变化后，要到：

• 版本管理与发布

执行：

• 发布最新版本

如果不发布，最常见的结果就是：

• Quicker 里已经填了 AppID/AppSecret
• 但调用接口还是报权限不足或能力未生效

所以顺序必须是：

1. 创建应用
2. 添加机器人
3. 开通权限
4. 需要时加入群
5. 发布版本
6. 再回到 Quicker 配置动作

八、在 Quicker 中配置飞书传信

1）运行动作

动作名：

• 飞书传信

2）第一次配置

第一次使用时，直接运行一次动作，或者打开菜单：

• 配置飞书

然后填入：

• AppID
• AppSecret
• ChatID

3）保存后写入位置

当前版本会同时写两份：

• 本地配置：C:\Users\Administrator\AppData\Roaming\QuickerSkill\FeishuDeliver.config.json
• 云状态：QuickerSkill_FeishuDeliver_Config_v1

另外为了兼容旧版本，也会回写旧键名：

• FeishuSendMessage.config.json
• QuickerSkill_FeishuSendMessage_Config_v1

读取优先级是：

1. 新本地配置
2. 旧本地配置
3. 新云状态
4. 旧云状态
5. 都没有则弹配置窗口