Package Information
Available Nodes
Documentation
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 - 贡献代码改进
无论是代码贡献、文档改进还是功能建议,我们都非常感谢!
🧩 节点分类
本插件按照企业微信官方文档的分类结构,提供以下节点:
1. 企业微信-基础
包含企业微信的基础通信和管理功能:
- 通讯录管理 - 成员、部门、标签管理
- 应用消息 - 发送各类应用消息
- 群聊会话 - 群聊管理和消息发送
- 消息推送 - 群机器人 Webhook 推送
- 企业互联 - 企业互联和上下游管理
- 素材管理 - 素材上传和管理
- 电子发票 - 电子发票查询和状态管理
- 第三方应用授权 - 获取第三方应用凭证
- 第三方应用接口调用许可 - 接口调用许可管理
- 第三方应用收银台 - 第三方应用收银台
- 第三方应用推广二维码 - 第三方应用推广二维码
- 账号 ID - 自建应用与第三方应用的对接
2. 企业微信-办公
包含企业微信的协同办公功能:
- 日程管理 - 日历和日程管理
- 会议管理 - 会议预约、会议控制、录制管理
- 直播管理 - 直播创建、观看、统计管理
- 邮件管理 - 企业邮箱、邮件群组、公共邮箱
- 文档管理 - 在线文档、表格、智能表格
- 微盘管理 - 微盘空间和文件管理
- 打卡管理 - 打卡规则、打卡记录、排班管理
- 审批管理 - 审批模板、审批申请、假期管理
- 汇报管理 - 汇报记录、汇报统计
- 人事助手 - 员工花名册信息管理
- 会议室管理 - 会议室和会议室预定管理
- 紧急通知 - 语音电话等紧急通知
3. 企业微信-连接微信
包含企业微信连接微信的功能:
- 客户联系 - 客户管理、标签、继承、客户群、朋友圈、群发等
- 微信客服 - 客服账号、接待人员、消息收发、统计管理
- 家校应用 - 健康上报、上课直播、班级收款
4. 企业微信消息接收触发器
接收企业微信的消息和事件推送(支持普通接收和被动回复两种模式)
5. 企业微信第三方应用指令回调触发器
接收企业微信第三方应用的指令回调事件(授权、通讯录变更、ticket变化等)
🔒 隐私与安全
本插件完全基于企业微信官方 API 开发,直连企业微信服务器,不经过任何第三方服务器。
- ✅ 数据直连:默认所有 API 请求直接发送到企业微信官方服务器 (
qyapi.weixin.qq.com) - ✅ API 代理:支持配置自定义 API Base URL,适用于需要通过代理访问企业微信 API 的网络环境(默认直连)
- ✅ 无数据缓存:插件不存储、不缓存任何企业数据或用户信息
- ✅ 无第三方依赖:不依赖任何第三方数据服务或分析服务
- ✅ 开源透明:源代码完全开源,可随时审查和验证
- ✅ 本地运行:所有数据处理均在你的 n8n 实例中进行
你的企业数据安全完全由你的 n8n 实例和企业微信官方平台保障。
📦 安装
在 n8n 中通过社区节点管理界面搜索 n8n-nodes-wecom 进行安装,或使用命令行:
npm install n8n-nodes-wecom
详细安装指南请参考 n8n 社区节点文档。
🔑 凭证配置
消息推送凭证(WebHook URL)
消息推送功能用于通过群机器人 Webhook 发送消息到企业微信群聊
配置步骤
- 在企业微信群聊中,点击右上角"..."菜单
- 选择"群机器人" > "添加机器人"
- 创建一个机器人并复制 Webhook 地址
- 在 n8n 中配置"企业微信群机器人 Webhook"凭证,填入 Webhook 地址
获取企业微信请求凭证(消息发送、通讯录、素材管理等功能需要)
- 登录 企业微信管理后台
- 进入"我的企业" > "企业信息",复制 企业ID (CorpID)
- 进入"应用管理" > 选择或创建一个应用
- 复制 AgentId(应用ID)
- 点击"查看Secret",复制 Secret
获取企业微信消息接收凭证
- 登录 企业微信管理后台
- 进入"我的企业" > "企业信息",复制 企业ID (CorpID)
- 进入"应用管理" > 选择或创建一个应用
- 启用 API接收消息,设置Token、EncodingAESKey
- 在 n8n 中创建"企业微信消息接收触发器"节点:
- 配置凭证(企业ID、Token、EncodingAESKey)
- Path 表示 Webhook URL 的路径,建议使用应用 ID
- 保存节点后,查看生成的 Webhook URL(例如:
https://your-n8n.com/webhook/1000001)
- 将 Webhook URL 填入企业微信后台的接收消息服务器配置中
重要提示:
- 企业微信每个应用只能配置一个接收消息 URL
- 多个工作流可以使用同一个凭证(同一应用ID),它们会共享同一个 Webhook URL 接收消息
- 不同应用请创建不同的凭证,使用不同的应用ID
获取企业微信第三方应用指令回调凭证
- 登录 企业微信服务商后台
- 进入"应用管理" > "第三方应用",选择或创建一个第三方应用
- 复制 第三方应用ID (SuiteID)(以ww或wx开头)
- 在"应用详情" > "开发信息"中,设置指令回调URL,配置Token、EncodingAESKey
- 在 n8n 中创建"企业微信第三方应用指令回调触发器"节点:
- 配置凭证(第三方应用ID、Token、EncodingAESKey)
- Path 表示 Webhook URL 的路径,建议使用应用相关的唯一标识(例如:
suite/receive) - 保存节点后,查看生成的 Webhook URL(例如:
https://your-n8n.com/webhook/suite/receive)
- 将 Webhook URL 填入企业微信服务商后台的指令回调URL配置中
重要提示:
- 第三方应用的指令回调使用SuiteID作为receiveid(而不是CorpID)
- 服务商收到推送后必须返回字符串 "success",否则企业微信会把返回内容当作错误信息
- 支持的事件类型:授权变更、通讯录变更、Suite Ticket推送、应用变更等
✨ 已实现功能
以下功能按照企业微信官方文档分类组织:
一、基础功能(企业微信-基础 节点)
消息接收(触发器节点)
接收消息功能:
- ✅ 接收企业微信应用消息回调
- ✅ 接收文本消息(包含 Content 字段)
- ✅ 接收图片消息(包含 PicUrl、MediaId 字段)
- ✅ 接收语音消息(包含 MediaId、Format 字段)
- ✅ 接收视频消息(包含 MediaId、ThumbMediaId 字段)
- ✅ 接收位置消息(包含 Location_X、Location_Y、Scale、Label、AppType 字段)
- ✅ 接收链接消息(包含 Title、Description、Url、PicUrl 字段)
- ✅ 接收事件推送(成员变更、部门变更等)
- ✅ 接口许可失效通知(当许可账号失效的企业成员访问应用时触发)
- ✅ URL 验证
- ✅ 消息加解密
- ✅ 签名验证
被动回复消息功能:
使用「企业微信消息接收(被动回复)触发器」+ 「企业微信-基础」节点的「被动回复」功能实现:
工作流配置示例:
[企业微信消息接收(被动回复)触发器] → [中间处理节点(可选)] → [企业微信-基础 (被动回复)]
⚠️ 重要提示:
- 被动回复节点必须是工作流的最后一个节点
- 必须在5秒内返回响应,否则企业微信会认为请求失败
- 请确保工作流处理时间足够快
回调机制参考文档:
第三方应用指令回调功能:
使用「企业微信第三方应用指令回调触发器」接收第三方应用的指令回调事件:
- ✅ 接收授权成功通知
- ✅ 接收变更授权通知
- ✅ 接收取消授权通知
- ✅ 接收Suite Ticket推送
- ✅ 接收成员通知事件
- ✅ 接收部门通知事件
- ✅ 接收标签通知事件
- ✅ 接收共享应用事件回调
- ✅ 接收重置永久授权码通知
- ✅ 接收应用管理员变更通知
- ✅ 接收授权组织架构权限通知
- ✅ 接收获客助手权限变更通知
- ✅ 接收支付成功通知
- ✅ 接收退款结果通知
- ✅ 接收自动激活回调通知
- ✅ 接收下单成功通知
- ✅ 接收改单通知
- ✅ 接收支付成功通知
- ✅ 接收退款通知
- ✅ 接收应用版本变更通知
- ✅ 接收取消订单通知
- ✅ 接收注册完成回调事件
- ✅ 接收扫描推广二维码事件
- ✅ URL 验证
- ✅ 消息加解密(使用SuiteID作为receiveid)
- ✅ 签名验证
- ✅ 自动返回 "success" 响应(授权相关事件需在1000ms内响应)
重要提示:
- 第三方应用的指令回调使用SuiteID作为receiveid(而不是CorpID)
- 服务商收到推送后必须返回字符串 "success",否则企业微信会把返回内容当作错误信息
- 授权相关事件(create_auth、change_auth、cancel_auth、reset_permanent_code)的响应必须在1000ms内完成
- 收到取消授权事件后,应当确保删除该企业所有相关的数据
消息推送(群机器人)
- ✅ 发送文本消息
- ✅ 发送 Markdown 消息
- ✅ 发送 Markdown V2 消息
- ✅ 发送图片消息
- ✅ 发送图文消息
- ✅ 发送文件消息
- ✅ 发送语音消息
- ✅ 发送模板卡片消息
- 文本通知模板卡片
- 图文展示模板卡片
应用消息发送
- ✅ 发送文本消息
- ✅ 发送 Markdown 消息
- ✅ 发送图片消息
- ✅ 发送语音消息
- ✅ 发送视频消息
- ✅ 发送文件消息
- ✅ 发送文本卡片消息
- ✅ 发送图文消息(news)
- ✅ 发送图文消息(mpnews)
- ✅ 发送小程序通知消息
- ✅ 发送任务卡片消息
- ✅ 发送模板卡片消息
- ✅ 发送学校通知(家校应用)
- ✅ 撤回应用消息
- ✅ 更新模板卡片消息
群聊会话
通讯录管理
成员管理
- ✅ 创建成员
- ✅ 读取成员信息
- ✅ 更新成员
- ✅ 删除成员
- ✅ 批量删除成员
- ✅ 获取部门成员列表
- ✅ 获取部门成员详情
- ✅ 获取成员ID列表
- ✅ userid与openid互换
- ✅ 登录二次验证
- ✅ 邀请成员
- ✅ 获取加入企业二维码
- ✅ 手机号获取userid
- ✅ 邮箱获取userid
- ✅ 临时外部联系人ID转换
部门管理
标签管理
账号ID转换
- ✅ 用户ID转OpenID
- ✅ OpenID转用户ID
- ✅ 临时外部联系人ID转换
- ✅ corpid转换(第三方应用)
- ✅ userid转换(第三方应用)
- ✅ external_userid转换(第三方应用)
- ✅ external_userid转换(客户群成员)
- ✅ unionid转换(第三方应用)
- ✅ external_userid查询pending_id(第三方应用)
- ✅ 客户标签ID转换(第三方应用)
- ✅ 微信客服ID转换(第三方应用)
- ✅ ID迁移完成状态设置(第三方应用)
异步导入接口
异步导出接口
素材管理
企业互联
企业互联基础接口
上下游基础接口
上下游通讯录管理
- ✅ 获取上下游信息
- ✅ 批量导入上下游联系人
- ✅ 获取异步任务结果
- ✅ 移除企业
- ✅ 查询成员自定义id
- ✅ 获取下级企业加入的上下游
上下游规则
- ✅ 获取对接规则id列表
- ✅ 删除对接规则
- ✅ 获取对接规则详情
- ✅ 新增对接规则
- ✅ 更新对接规则
系统
电子发票
第三方应用授权
- ✅ 获取第三方应用凭证
- ✅ 获取预授权码
- ✅ 设置授权配置
- ✅ 获取企业永久授权码
- ✅ 获取企业授权信息
- ✅ 获取企业凭证
- ✅ 获取应用二维码
- ✅ 明文corpid转换为加密corpid
- ✅ 获取应用权限详情
- ✅ 获取应用管理员列表
- ✅ 获取订单列表
- ✅ 获取订单详情
- ✅ 延长试用期
第三方应用接口调用许可
第三方应用收银台
第三方应用推广二维码
- ✅ 获取注册码
- ✅ 查询注册状态
- ✅ 设置授权应用可见范围
- ✅ 设置通讯录同步完成
- ✅ 激活账号
- ✅ 获取激活码详情
- ✅ 获取企业的账号列表
- ✅ 获取成员的激活详情
- ✅ 账号继承
- ✅ 分配激活码给下游/下级企业
- ✅ 获取应用的接口许可状态
- ✅ 设置企业的许可自动激活状态
- ✅ 查询企业的许可自动激活状态
- ✅ 充值账户余额查询
- ✅ 民生优惠条件查询
接口调用许可事件通知:
二、办公功能(企业微信-办公 节点)
邮件管理
发送邮件
获取接收的邮件
管理应用邮箱账号
管理邮件群组
管理公共邮箱
客户端专用密码
- ✅ 获取客户端专用密码列表
- ✅ 删除客户端专用密码
邮件高级功能账号管理
- ✅ 分配高级功能账号
- ✅ 取消高级功能账号
- ✅ 获取高级功能账号列表
- ✅ 禁用/启用邮箱账号
其他邮件客户端登录设置
文档管理
管理文档
编辑文档
编辑智能表格内容
获取文档数据
获取智能表格数据
设置文档权限
- ✅ 获取文档权限信息
- ✅ 修改文档查看规则
- ✅ 修改文档通知范围及权限
- ✅ 修改文档安全设置
- ✅ 管理智能表格内容权限
管理收集表
- ✅ 创建收集表
- ✅ 编辑收集表
- ✅ 获取收集表信息
- ✅ 收集表的统计信息查询
- ✅ 读取收集表答案
文档高级功能账号管理
- ✅ 分配高级功能账号
- ✅ 取消高级功能账号
- ✅ 获取高级功能账号列表
文档素材管理
- ✅ 上传文档图片
日程管理
管理日历
管理日程
会议管理
预约会议基础管理
- ✅ 创建预约会议
- ✅ 修改预约会议
- ✅ 取消预约会议
- ✅ 获取会议详情
- ✅ 获取成员会议ID列表
会议统计管理
- ✅ 获取会议发起记录
预约会议高级管理
- ✅ 创建预约会议(高级)
- ✅ 修改预约会议(高级)
- ✅ 获取会议受邀成员列表
- ✅ 更新会议受邀成员列表
- ✅ 获取实时会中成员列表
- ✅ 获取已参会成员列表
会中控制管理
录制管理
会议高级功能账号管理
- ✅ 分配高级功能账号
- ✅ 取消高级功能账号
- ✅ 获取高级功能账号列表
直播管理
- ✅ 创建预约直播
- ✅ 修改预约直播
- ✅ 取消预约直播
- ✅ 删除直播回放
- ✅ 在微信中观看直播或回放
- ✅ 获取成员直播ID列表
- ✅ 获取直播详情
- ✅ 获取直播观看明细
- ✅ 获取跳转小程序商城的直播观众信息
微盘管理
空间管理
文件管理
文件权限管理
打卡管理
- ✅ 获取企业所有打卡规则
- ✅ 获取员工打卡规则
- ✅ 获取打卡记录数据
- ✅ 获取打卡日报数据
- ✅ 获取打卡月报数据
- ✅ 获取打卡人员排班信息
- ✅ 为打卡人员排班
- ✅ 为打卡人员补卡
- ✅ 添加打卡记录
- ✅ 录入打卡人员人脸信息
- ✅ 获取设备打卡数据
- ✅ 管理打卡规则
审批管理
汇报管理
- ✅ 批量获取汇报记录单号
- ✅ 获取汇报记录详情
- ✅ 获取汇报统计数据
- ✅ 下载微盘文件
人事助手
会议室管理
紧急通知应用
三、连接微信功能(企业微信-连接微信 节点)
客户联系
企业服务人员管理
客户管理
客户标签管理
在职继承
- ✅ 分配在职成员的客户
- ✅ 查询客户接替状态
- ✅ 分配在职成员的客户群
离职继承
- ✅ 获取待分配的离职成员列表
- ✅ 分配离职成员的客户
- ✅ 查询客户接替状态
- ✅ 分配离职成员的客户群
客户群管理
- ✅ 获取客户群列表
- ✅ 获取客户群详情
- ✅ 客户群opengid转换
联系我与客户入群方式
- ✅ 配置客户联系「联系我」方式
- ✅ 获取企业已配置的「联系我」方式
- ✅ 更新企业已配置的「联系我」方式
- ✅ 删除企业已配置的「联系我」方式
- ✅ 配置客户群进群方式
- ✅ 获取客户群进群方式配置
- ✅ 更新客户群进群方式配置
- ✅ 删除客户群进群方式配置
客户朋友圈
消息推送
统计管理
其他接口
- ✅ 管理商品图册
- ✅ 管理聊天敏感词
- ✅ 上传附件资源
- ✅ 获客助手
- ✅ 获取已服务的外部联系人
微信客服
客服账号管理
接待人员管理
会话分配与消息收发
统计管理
机器人管理
家校应用
健康上报
- ✅ 获取健康上报使用统计
- ✅ 获取健康上报任务ID列表
- ✅ 获取健康上报任务详情
- ✅ 获取用户填写答案
上课直播
- ✅ 获取老师直播ID列表
- ✅ 获取直播详情
- ✅ 获取观看直播统计(旧版)
- ✅ 获取未观看直播统计(旧版)
- ✅ 删除直播回放
- ✅ 获取观看直播统计V2
- ✅ 获取未观看直播统计V2
班级收款
家校沟通 - 基础接口
- ✅ 获取「学校通知」二维码
- ✅ 管理「学校通知」的关注模式
- ✅ 发送「学校通知」
- ✅ 管理「班级群创建方式」
- ✅ 外部联系人openid转换
- ✅ 获取可使用的家长范围
家校沟通 - 网页授权登录
- ✅ 开始开发
- ✅ 构造网页授权链接
- ✅ 获取访问用户身份
- ✅ 获取家校访问用户身份
家校沟通 - 学生与家长管理
- ✅ 创建学生
- ✅ 删除学生
- ✅ 更新学生
- ✅ 批量创建学生
- ✅ 批量删除学生
- ✅ 批量更新学生
- ✅ 创建家长
- ✅ 删除家长
- ✅ 更新家长
- ✅ 批量创建家长
- ✅ 批量删除家长
- ✅ 批量更新家长
- ✅ 读取学生或家长
- ✅ 获取部门学生详情
- ✅ 设置家校通讯录自动同步模式
- ✅ 获取部门家长详情
家校沟通 - 部门管理
家校沟通 - 通讯录变更回调
政民沟通
配置网格结构
- ✅ 添加网格
- ✅ 编辑网格
- ✅ 删除网格
- ✅ 获取网格列表
- ✅ 获取用户负责及参与的网格列表
配置事件类别
巡查上报
- ✅ 概述
- ✅ 获取配置的网格及网格负责人
- ✅ 获取单位巡查上报数据统计
- ✅ 获取个人巡查上报数据统计
- ✅ 获取上报事件分类统计
- ✅ 获取巡查上报事件列表
- ✅ 获取巡查上报的事件详情信息
居民上报
- ✅ 概述
- ✅ 获取配置的网格及网格负责人
- ✅ 获取单位居民上报数据统计
- ✅ 获取个人居民上报数据统计
- ✅ 获取上报事件分类统计
- ✅ 获取居民上报事件列表
- ✅ 获取居民上报的事件详情信息








