@luka-cat-mimi/n8n-nodes-feishu

飞书 n8n 社区节点，提供飞书开放平台 API 的集成支持。

本项目是基于 n8n-nodes-feishu-lite 之上进行的二次开发，感谢原作者的开源贡献！

安装

参考：https://docs.n8n.io/integrations/community-nodes/installation/

节点名称：@luka-cat-mimi/n8n-nodes-feishu

功能列表

🚀 飞书 Trigger

通过 WebSocket 长连接方式监听飞书事件，当事件发生时自动启动工作流。

主要特点：

• 默认订阅所有事件，也可按需选择具体事件类型
• 两种响应模式：
  • Immediately：事件触发后立即响应
  • Using '飞书响应' Node：配合飞书响应节点同步返回自定义响应（超时固定 3 秒）

⚠️ 由于飞书 API 限制，每个飞书应用同时只能有一个 Trigger 在运行。

🌐 飞书 Webhook Trigger ✨ 新增

通过 Webhook 方式接收飞书事件回调，适用于「将回调发送至开发者服务器」订阅模式。

主要特点：

• 自动处理 URL 验证（url_verification）与加密推送解密
• 支持 Verification Token 校验与 app_id 匹配
• 默认订阅所有事件，也可按需选择具体事件类型
• 两种响应模式（与长链接触发器文案一致）：
  • Immediately：事件触发后立即响应
  • Using '飞书响应' Node：配合飞书响应节点同步返回自定义响应

将节点生成的 Webhook URL 配置到飞书开放平台「事件与回调 - 订阅方式」中即可。

🔄 飞书响应

配合飞书 Trigger 或 飞书 Webhook Trigger 使用，用于同步响应飞书事件（如卡片交互、链接预览回调）。

主要特点：

• 两种同步响应模式：
  • 长链接同步响应：配合「飞书 Trigger」（长链接触发器）使用
  • Webhook 同步响应：配合「飞书 Webhook Trigger」（Webhook 触发器）使用
• 响应内容支持 No Data（空响应体）或 JSON（自定义 JSON 响应）
• 节点输出与返回给飞书的 JSON 内容一致，不再额外包裹字段
• 可选启用响应输出分支

知识库 (13)

• 获取知识空间列表
• 获取知识空间信息
• 更新知识空间设置
• 添加知识空间成员
• 删除知识空间成员
• 获取知识空间成员列表
• 创建知识空间节点
• 创建动态层级的知识库空间节点 (自定义封装) ✨ 新增
• 创建知识空间节点副本
• 获取知识空间节点信息
• 获取知识空间子节点列表 ✨支持递归获取子节点
• 移动知识空间节点
• 更新知识空间节点标题

群组管理 (12)

• 创建群 ✨ 新增
• 更新群信息 ✨ 新增
• 解散群 ✨ 新增
• 获取群信息
• 获取用户或机器人所在的群列表
• 搜索对用户或机器人可见的群列表
• 获取群成员列表
• 将用户或机器人拉入群聊
• 移出群成员
• 判断用户或机器人是否在群里
• 指定群管理员
• 删除群管理员

通讯录 (6)

• 获取用户信息
• 批量获取用户信息
• 通过手机号或邮箱获取用户 ID
• 获取子部门列表 ✨ 新增（支持递归获取、树形/扁平数据结构）
• 获取部门直属用户列表 ✨ 新增
• 搜索用户 ✨ 新增

任务 (6)

• 创建任务
• 获取任务详情
• 更新任务
• 删除任务
• 添加任务成员
• 移除任务成员

云文档 (11)

• 创建文档
• 获取文档基本信息
• 获取文档纯文本内容
• 获取云文档内容
• 获取文档所有块
• 获取块的内容
• 创建块
• 创建嵌套块
• 更新块的内容
• 删除块
• Markdown/HTML 内容转换为文档块

多维表格 (26)

• 解析多维表格地址
• 创建多维表格
• 复制多维表格
• 获取多维表格元数据
• 更新多维表格元数据
• 列出数据表
• 新增数据表
• 更新数据表
• 删除数据表
• 列出视图
• 获取视图
• 新增视图
• 更新视图
• 删除视图
• 查询记录
• 查询记录-通过记录ID
• 新增记录
• 更新记录
• 删除记录
• 批量新增记录
• 批量更新记录
• 批量删除记录
• 列出字段
• 新增字段
• 更新字段
• 删除字段

消息 (22)

• 发送消息
• 回复消息
• 编辑消息
• 获取指定消息的内容 ✨ 新增
• 获取会话历史消息 ✨ 新增
• 转发消息
• 撤回消息
• 批量发送消息
• 批量撤回消息
• 查询批量消息整体进度
• 查询批量消息推送和阅读人数
• 更新已发送的消息卡片
• 延时更新消息卡片
• 发送仅特定人可见的消息卡片
• 删除仅特定人可见的消息卡片
• 发送应用内加急
• 上传图片
• 下载图片
• 上传文件
• 下载文件
• 获取消息中的资源文件 ✨ 新增
• 解密事件消息

日历 (16)

• 搜索日历
• 查询日历信息
• 查询主日历信息
• 创建共享日历
• 删除共享日历
• 获取日程列表
• 获取日程
• 搜索日程
• 创建日程
• 更新日程
• 删除日程
• 获取日程参与人列表
• 添加日程参与人
• 删除日程参与人
• 创建会议群
• 解绑会议群

Aily (5)

• 读取文件基础信息
• 文件上传
• 调用技能
• 查询技能列表
• 获取技能信息

云空间 (18)

• 获取我的空间（根文件夹）元数据 ✨ 新增
• 获取文件夹中的文件清单 ✨ 新增（支持文件类型过滤、递归获取子文件夹、树形/扁平数据结构）
• 获取文件夹元数据 ✨ 新增
• 新建文件夹 ✨ 新增
• 获取文件统计信息 ✨ 新增
• 获取文件访问记录 ✨ 新增
• 搜索云文档 ✨ 新增
• 上传文件（支持二进制文件上传到云空间文件夹）
• 分片上传文件（三合一接口，支持大文件分片上传，5 并发加速）
• 下载文件
• 导入文件 ✨ 新增（支持 Word/Excel/CSV/Markdown/TXT/HTML 导入为云文档，自动轮询任务状态）
• 导出云文档（自动轮询任务状态并下载文件）
• 上传素材
• 分片上传素材 ✨ 新增（支持大文件分片上传，5并发加速）
• 上传素材通过Url ✨ 增强
• 下载素材 ✨ 新增（下载各类云文档中的素材，例如电子表格中的图片）
• 订阅云文档事件
• 取消云文档事件订阅

✨ 特别之处

🔄 Return All 自动分页

以下接口支持 Return All 功能，自动处理分页获取全部数据：

| 模块 | 接口名称 | | -------- | -------------------------------------------------------- | | 知识库 | 获取知识空间列表 | | 知识库 | 获取知识空间成员列表 | | 知识库 | 获取知识空间子节点列表（支持递归获取所有子节点） | | Aily | 查询技能列表 | | 群组管理 | 获取用户或机器人所在的群列表 | | 群组管理 | 搜索对用户或机器人可见的群列表 | | 群组管理 | 获取群成员列表 | | 多维表格 | 查询记录 | | 多维表格 | 列出数据表 ✨ 新增 | | 多维表格 | 列出视图 ✨ 新增 | | 多维表格 | 列出字段 ✨ 新增 | | 日历 | 搜索日历 ✨ 新增 | | 日历 | 获取日程列表 ✨ 新增 | | 日历 | 搜索日程 ✨ 新增 | | 日历 | 获取日程参与人列表 ✨ 新增 | | 云文档 | 获取文档所有块 ✨ 新增 | | 消息 | 获取会话历史消息 ✨ 新增 | | 通讯录 | 获取子部门列表（支持递归获取、树形/扁平数据结构）✨ 新增 | | 通讯录 | 获取部门直属用户列表 ✨ 新增 | | 通讯录 | 搜索用户 ✨ 新增 | | 云空间 | 获取文件夹中的文件清单（支持递归获取、文件类型过滤）✨ 新增 |

⏱️ 超时与批次管理

大部分接口支持以下高级选项：

• Timeout（超时时间）：设置请求超时时间（毫秒），避免请求长时间挂起
• Batching（批次管理）：
  • Items per Batch：每批处理的数量，用于控制请求频率
  • Batch Interval (ms)：每批请求之间的等待时间，避免触发 API 限流

这些功能可在接口的 Options 选项中配置，有效应对飞书 API 的频率限制。

凭证类型

• 应用级别凭证 - 使用 App ID 和 App Secret 进行认证
• 用户级别凭证 - 使用 OAuth 2.0 进行用户授权认证

注意事项

1. 使用应用凭证访问文档时，需要在文档中将应用添加为协作者
2. 错误码查询：https://open.feishu.cn/search

📝 许可证

MIT License

🆘 支持

• 📧 邮箱：[email protected]
• 🐛 问题反馈