Description
n8n-nodes-wecom
这是一个 n8n 社区节点,让你可以在 n8n 工作流中使用企业微信(WeChat Work)API。
节点分类
本插件按照企业微信官方文档的分类结构,提供以下节点:
1. 企业微信-基础
包含企业微信的基础通信和管理功能:
- 通讯录管理 – 成员、部门、标签管理
- 应用消息 – 发送各类应用消息
- 群聊会话 – 群聊管理和消息发送
- 消息推送 – 群机器人 Webhook 推送
- 企业互联 – 企业互联和上下游管理
- 素材管理 – 素材上传和管理
- 电子发票 – 电子发票查询和状态管理
- 日程管理 – 日历和日程管理
- 会议管理 – 会议预约、会议控制、录制管理
- 邮件管理 – 企业邮箱、邮件群组、公共邮箱
- 文档管理 – 在线文档、表格、智能表格
- 微盘管理 – 微盘空间和文件管理
- 打卡管理 – 打卡规则、打卡记录、排班管理
- 审批管理 – 审批模板、审批申请、假期管理
- 汇报管理 – 汇报记录、汇报统计
- 人事助手 – 员工花名册信息管理
- 会议室管理 – 会议室和会议室预定管理
- 紧急通知 – 语音电话等紧急通知
- 客户联系 – 客户管理、标签、继承、客户群、朋友圈、群发等
- 微信客服 – 客服账号、接待人员、消息收发、统计管理
- ✅ 数据直连:所有 API 请求直接发送到企业微信官方服务器 (
qyapi.weixin.qq.com) - ✅ 无数据缓存:插件不存储、不缓存任何企业数据或用户信息
- ✅ 无第三方依赖:不依赖任何第三方数据服务或分析服务
- ✅ 开源透明:源代码完全开源,可随时审查和验证
- ✅ 本地运行:所有数据处理均在你的 n8n 实例中进行
2. 企业微信-办公
包含企业微信的协同办公功能:
3. 企业微信-连接微信
包含企业微信连接微信的功能:
4. 企业微信消息接收触发器
接收企业微信的消息和事件推送(支持普通接收和被动回复两种模式)
隐私与安全
本插件完全基于企业微信官方 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. 复制 AgentId(应用ID,例如:1000001)
5. 启用 API接收消息,设置Token、EncodingAESKey
6. 在 n8n 中创建”企业微信消息接收触发器”节点:
– 配置凭证(企业ID、应用ID、Token、EncodingAESKey)
– Path 表示 Webhook URL 的路径,建议使用应用 ID
– 保存节点后,查看生成的 Webhook URL(例如:https://your-n8n.com/webhook/1000001)
7. 将 Webhook URL 填入企业微信后台的接收消息服务器配置中
重要提示:
已实现功能
以下功能按照企业微信官方文档分类组织:
—
一、基础功能(企业微信-基础 节点)
消息接收(触发器节点)
接收消息功能:
被动回复消息功能:
使用「企业微信消息接收(被动回复)触发器」+ 「企业微信-基础」节点的「被动回复」功能实现:
工作流配置示例:
[企业微信消息接收(被动回复)触发器] → [中间处理节点(可选)] → [企业微信-基础 (被动回复)]
> ⚠️ 重要提示:
> – 被动回复节点必须是工作流的最后一个节点
> – 必须在5秒内返回响应,否则企业微信会认为请求失败
> – 请确保工作流处理时间足够快
回调机制参考文档:
消息推送(群机器人)
– 文本通知模板卡片
– 图文展示模板卡片
应用消息发送
群聊会话
– 发送文本消息到群聊
– 发送图片消息到群聊
– 发送文件消息到群聊
– 发送 Markdown 消息到群聊
– 发送图文消息到群聊
通讯录管理
#### 成员管理
#### 部门管理
#### 标签管理
#### 账号ID转换
#### 异步导入接口
#### 异步导出接口
素材管理
企业互联
#### 企业互联基础接口
#### 上下游基础接口
> 官方文档:上下游
#### 上下游通讯录管理
#### 上下游规则
系统
客户联系
#### 企业服务人员管理
#### 客户管理
#### 客户标签管理
#### 在职继承
#### 离职继承
#### 客户群管理
#### 联系我与客户入群方式
#### 客户朋友圈
#### 消息推送
#### 统计管理
#### 其他接口
电子发票
—
二、办公功能(企业微信-办公 节点)
邮件管理
> 官方文档:邮件
#### 发送邮件
#### 获取接收的邮件
#### 管理应用邮箱账号
#### 管理邮件群组
#### 管理公共邮箱
#### 客户端专用密码
#### 邮件高级功能账号管理
#### 其他邮件客户端登录设置
文档管理
#### 管理文档
#### 编辑文档
#### 编辑智能表格内容
#### 获取文档数据
#### 获取智能表格数据
#### 设置文档权限
#### 管理收集表
#### 文档高级功能账号管理
#### 文档素材管理
日程管理
> 官方文档:日程
#### 管理日历
#### 管理日程
会议管理
> 官方文档:会议
#### 预约会议基础管理
#### 会议统计管理
#### 预约会议高级管理
#### 会中控制管理
#### 录制管理
#### 会议高级功能账号管理
微盘管理
> 官方文档:微盘
#### 空间管理
#### 文件管理
#### 文件权限管理
打卡管理
> 官方文档:打卡
审批管理
> 官方文档:审批
汇报管理
> 官方文档:汇报
人事助手
会议室管理
> 官方文档:会议室
紧急通知应用
—
三、连接微信功能(企业微信-连接微信 节点)
微信客服
#### 客服账号管理
#### 接待人员管理
#### 会话分配与消息收发
#### 统计管理
#### 机器人管理
—