Package Information
Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 1.1.0
Documentation
飞书事件触发器
此 n8n 节点通过飞书长连接接收配置的 v2.0 事件。节点从 n8n 凭证读取飞书自建应用的 App ID 和 App Secret。工作流激活后开始监听,停用时关闭连接。编辑器手动执行会提示先启用工作流,避免同时开启第二个长连接分走事件。
安装到 n8n 1.16.0
- 将 npm 安装包放到 n8n 主进程所在的服务器或容器,在该实例的持久化
.n8n/nodes目录运行npm install --omit=dev --ignore-scripts /path/to/<PACKAGE_FILE>.tgz。 - 重启 n8n 主进程。Docker 部署须保留安装目录所在的数据卷。打开编辑器,查找「飞书事件触发器」。
配置 n8n 工作流
- 在飞书应用的事件与回调中启用长连接,订阅所需事件并配置相应权限。
- 在
<WORKFLOW_NAME>中添加「飞书事件触发器」。创建「飞书长连接应用凭证」,将<FEISHU_APP_ID>和<FEISHU_APP_SECRET>替换为实际值。 - 将「事件类型」设置为飞书文档中的
<EVENT_TYPE>。默认示例contact.user.created_v3对应员工入职。每个触发器接收一个事件类型。 - 将触发器连接到
<PROCESS_EVENT_NODE>。节点输出body.schema、body.header中的事件 ID、事件类型、应用 ID,以及body.event中完整的事件数据。例如,入职事件的姓名和 Open ID 分别在body.event.object.name和body.event.object.open_id。字段映射、查重和写入<DESTINATION_TABLE>由下游节点配置。 - 激活工作流,验证飞书长连接和真实事件的执行结果。如果同一应用有多个长连接,飞书会将同一个事件投递给其中一个连接。
本地构建和打包使用 npm ci、npm test、npm pack。安装包不包含应用凭证或事件数据。