Description
n8n-nodes-wecom
 
这是一个 n8n 社区节点,让你可以在 n8n 工作流中使用企业微信(WeChat Work)API。
⚠️ 重要提示
> 关于版本更新与稳定性
>
> 本插件的设计初衷是提供简单、稳定的企业微信集成体验。我们以 N8N 官方原生节点(如 Telegram、Notion等)为标准,力求交互逻辑清晰直观。
>
> 开发原则:
> 我们会审慎评估每一次代码变更,尽量维持现有节点结构和参数的稳定性,避免对生产环境造成不必要的影响。
>
> 注意事项:
> 在极少数情况下,为了修复重大缺陷或适配企业微信 API 的关键变更,可能会引入必要的调整。
>
> 建议:
> 生产环境更新前,请查看 Release 日志。如果涉及 Breaking Changes(破坏性变更),我们会显著标记。
>
> 文档说明:
> 本文档旨在概括插件支持的核心功能。由于企业微信接口众多且更新频繁,本文档可能无法覆盖所有参数细节。遇有疑问,请优先参考 企业微信官方 API 文档。
🤝 交流与支持
遇到问题或有功能建议?欢迎查阅 企业微信官方文档 或加入我们的交流群。
💬 加入社区
| 方式 1:扫码直接入群 | 方式 2:联系作者邀请 |
| :——————————————————————–: | :———————————————————-: |
|
|
| (推荐) | 若群码失效,请备注 n8n 拉你 |
参与贡献
我们非常欢迎社区贡献!如果你发现了 bug、有新功能建议或想要改进代码:
- 提交 Issue:GitHub Issues – 报告问题或提出功能建议
- 提交 Pull Request:GitHub Pull Requests – 贡献代码改进
- 通讯录管理 – 成员、部门、标签管理
- 应用消息 – 发送各类应用消息
- 群聊会话 – 群聊管理和消息发送
- 消息推送 – 群机器人 Webhook 推送
- 企业互联 – 企业互联和上下游管理
- 素材管理 – 素材上传和管理
- 电子发票 – 电子发票查询和状态管理
- 第三方应用授权 – 获取第三方应用凭证
- 第三方应用接口调用许可 – 接口调用许可管理
- 第三方应用收银台 – 第三方应用收银台
- 第三方应用推广二维码 – 第三方应用推广二维码
- 账号 ID – 自建应用与第三方应用的对接
- 日程管理 – 日历和日程管理
- 会议管理 – 会议预约、会议控制、录制管理
- 直播管理 – 直播创建、观看、统计管理
- 邮件管理 – 企业邮箱、邮件群组、公共邮箱
- 文档管理 – 在线文档、表格、智能表格
- 微盘管理 – 微盘空间和文件管理
- 打卡管理 – 打卡规则、打卡记录、排班管理
- 审批管理 – 审批模板、审批申请、假期管理
- 汇报管理 – 汇报记录、汇报统计
- 人事助手 – 员工花名册信息管理
- 会议室管理 – 会议室和会议室预定管理
- 紧急通知 – 语音电话等紧急通知
- 客户联系 – 客户管理、标签、继承、客户群、朋友圈、群发等
- 微信客服 – 客服账号、接待人员、消息收发、统计管理
- 家校应用 – 健康上报、上课直播、班级收款
- ✅ 数据直连:默认所有 API 请求直接发送到企业微信官方服务器 (
qyapi.weixin.qq.com) - ✅ API 代理:支持配置自定义 API Base URL,适用于需要通过代理访问企业微信 API 的网络环境(默认直连)
- ✅ 无数据缓存:插件不存储、不缓存任何企业数据或用户信息
- ✅ 无第三方依赖:不依赖任何第三方数据服务或分析服务
- ✅ 开源透明:源代码完全开源,可随时审查和验证
- ✅ 本地运行:所有数据处理均在你的 n8n 实例中进行
无论是代码贡献、文档改进还是功能建议,我们都非常感谢!
—
🧩 节点分类
本插件按照企业微信官方文档的分类结构,提供以下节点:
1. 企业微信-基础
包含企业微信的基础通信和管理功能:
2. 企业微信-办公
包含企业微信的协同办公功能:
3. 企业微信-连接微信
包含企业微信连接微信的功能:
4. 企业微信消息接收触发器
接收企业微信的消息和事件推送(支持普通接收和被动回复两种模式)
5. 企业微信第三方应用指令回调触发器
接收企业微信第三方应用的指令回调事件(授权、通讯录变更、ticket变化等)
🔒 隐私与安全
本插件完全基于企业微信官方 API 开发,直连企业微信服务器,不经过任何第三方服务器。
你的企业数据安全完全由你的 n8n 实例和企业微信官方平台保障。
📦 安装
在 n8n 中通过社区节点管理界面搜索 n8n-nodes-wecom 进行安装,或使用命令行:
npm install n8n-nodes-wecom
详细安装指南请参考 n8n 社区节点文档。
🔑 凭证配置
消息推送凭证(WebHook URL)
消息推送功能用于通过群机器人 Webhook 发送消息到企业微信群聊
#### 配置步骤
1. 在企业微信群聊中,点击右上角”…”菜单
2. 选择”群机器人” > “添加机器人”
3. 创建一个机器人并复制 Webhook 地址
4. 在 n8n 中配置”企业微信群机器人 Webhook”凭证,填入 Webhook 地址
获取企业微信请求凭证(消息发送、通讯录、素材管理等功能需要)
1. 登录 企业微信管理后台
2. 进入”我的企业” > “企业信息”,复制 企业ID (CorpID)
3. 进入”应用管理” > 选择或创建一个应用
4. 复制 AgentId(应用ID)
5. 点击”查看Secret”,复制 Secret
获取企业微信消息接收凭证
1. 登录 企业微信管理后台
2. 进入”我的企业” > “企业信息”,复制 企业ID (CorpID)
3. 进入”应用管理” > 选择或创建一个应用
4. 启用 API接收消息,设置Token、EncodingAESKey
5. 在 n8n 中创建”企业微信消息接收触发器”节点:
– 配置凭证(企业ID、Token、EncodingAESKey)
– Path 表示 Webhook URL 的路径,建议使用应用 ID
– 保存节点后,查看生成的 Webhook URL(例如:https://your-n8n.com/webhook/1000001)
6. 将 Webhook URL 填入企业微信后台的接收消息服务器配置中
重要提示:
获取企业微信第三方应用指令回调凭证
1. 登录 企业微信服务商后台
2. 进入”应用管理” > “第三方应用”,选择或创建一个第三方应用
3. 复制 第三方应用ID (SuiteID)(以ww或wx开头)
4. 在”应用详情” > “开发信息”中,设置指令回调URL,配置Token、EncodingAESKey
5. 在 n8n 中创建”企业微信第三方应用指令回调触发器”节点:
– 配置凭证(第三方应用ID、Token、EncodingAESKey)
– Path 表示 Webhook URL 的路径,建议使用应用相关的唯一标识(例如:suite/receive)
– 保存节点后,查看生成的 Webhook URL(例如:https://your-n8n.com/webhook/suite/receive)
6. 将 Webhook URL 填入企业微信服务商后台的指令回调URL配置中
重要提示:
✨ 已实现功能
以下功能按照企业微信官方文档分类组织:
—
一、基础功能(企业微信-基础 节点)
消息接收(触发器节点)
接收消息功能:
被动回复消息功能:
使用「企业微信消息接收(被动回复)触发器」+ 「企业微信-基础」节点的「被动回复」功能实现:
工作流配置示例:
[企业微信消息接收(被动回复)触发器] → [中间处理节点(可选)] → [企业微信-基础 (被动回复)]
> ⚠️ 重要提示:
>
> – 被动回复节点必须是工作流的最后一个节点
> – 必须在5秒内返回响应,否则企业微信会认为请求失败
> – 请确保工作流处理时间足够快
回调机制参考文档:
第三方应用指令回调功能:
使用「企业微信第三方应用指令回调触发器」接收第三方应用的指令回调事件:
重要提示:
消息推送(群机器人)
– 文本通知模板卡片
– 图文展示模板卡片
应用消息发送
群聊会话
– 发送文本消息到群聊(支持 @群成员 / @所有人)
– 发送图片消息到群聊
– 发送文件消息到群聊
– 发送 Markdown 消息到群聊
– 发送图文消息到群聊
通讯录管理
#### 成员管理
#### 部门管理
#### 标签管理
#### 账号ID转换
#### 异步导入接口
#### 异步导出接口
素材管理
企业互联
#### 企业互联基础接口
#### 上下游基础接口
> 官方文档:上下游
#### 上下游通讯录管理
#### 上下游规则
系统
电子发票
第三方应用授权
第三方应用接口调用许可
第三方应用收银台
第三方应用推广二维码
接口调用许可事件通知:
—
二、办公功能(企业微信-办公 节点)
邮件管理
> 官方文档:邮件
#### 发送邮件
#### 获取接收的邮件
#### 管理应用邮箱账号
#### 管理邮件群组
#### 管理公共邮箱
#### 客户端专用密码
#### 邮件高级功能账号管理
#### 其他邮件客户端登录设置
文档管理
#### 管理文档
#### 编辑文档
#### 编辑智能表格内容
#### 获取文档数据
#### 获取智能表格数据
#### 设置文档权限
#### 管理收集表
#### 文档高级功能账号管理
#### 文档素材管理
日程管理
> 官方文档:日程
#### 管理日历
#### 管理日程
会议管理
> 官方文档:会议
#### 预约会议基础管理
#### 会议统计管理
#### 预约会议高级管理
#### 会中控制管理
#### 录制管理
#### 会议高级功能账号管理
直播管理
> 官方文档:直播
微盘管理
> 官方文档:微盘
#### 空间管理
#### 文件管理
#### 文件权限管理
打卡管理
> 官方文档:打卡
审批管理
> 官方文档:审批
汇报管理
> 官方文档:汇报
人事助手
会议室管理
> 官方文档:会议室
紧急通知应用
—
三、连接微信功能(企业微信-连接微信 节点)
客户联系
#### 企业服务人员管理
#### 客户管理
#### 客户标签管理
#### 在职继承
#### 离职继承
#### 客户群管理
#### 联系我与客户入群方式
#### 客户朋友圈
#### 消息推送
#### 统计管理
#### 其他接口
微信客服
#### 客服账号管理
#### 接待人员管理
#### 会话分配与消息收发
#### 统计管理
#### 机器人管理
家校应用
#### 健康上报
#### 上课直播
#### 班级收款
#### 家校沟通 – 基础接口
#### 家校沟通 – 网页授权登录
#### 家校沟通 – 学生与家长管理
#### 家校沟通 – 部门管理
#### 家校沟通 – 通讯录变更回调
政民沟通
#### 配置网格结构
#### 配置事件类别
#### 巡查上报
#### 居民上报
—