Complete n8n integration for WeCom (企业微信/WeChat Work). Send messages, manage contacts, departments, customer relations, meetings, documents, email, calendar, approvals, and more. Full-featured enterprise WeChat automation node.
npm install n8n-nodes-wecom
|
|
qyapi.weixin.qq.com)
n8n-nodes-wecom 进行安装,或使用命令行:
bash
npm install n8n-nodes-wecom
`
详细安装指南请参考 n8n 社区节点文档。
🔑 凭证配置
$3
消息推送功能用于通过群机器人 Webhook 发送消息到企业微信群聊
#### 配置步骤
1. 在企业微信群聊中,点击右上角"..."菜单
2. 选择"群机器人" > "添加机器人"
3. 创建一个机器人并复制 Webhook 地址
4. 在 n8n 中配置"企业微信群机器人 Webhook"凭证,填入 Webhook 地址
$3
1. 登录 企业微信管理后台
2. 进入"我的企业" > "企业信息",复制 企业ID (CorpID)
3. 进入"应用管理" > 选择或创建一个应用
4. 复制 AgentId(应用ID)
5. 点击"查看Secret",复制 Secret
$3
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 填入企业微信后台的接收消息服务器配置中
重要提示:
- 企业微信每个应用只能配置一个接收消息 URL
- 多个工作流可以使用同一个凭证(同一应用ID),它们会共享同一个 Webhook URL 接收消息
- 不同应用请创建不同的凭证,使用不同的应用ID
$3
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配置中
重要提示:
- 第三方应用的指令回调使用SuiteID作为receiveid(而不是CorpID)
- 服务商收到推送后必须返回字符串 "success",否则企业微信会把返回内容当作错误信息
- 支持的事件类型:授权变更、通讯录变更、Suite Ticket推送、应用变更等
✨ 已实现功能
以下功能按照企业微信官方文档分类组织:
---
一、基础功能(企业微信-基础 节点)
$3
> 官方文档:接收消息与事件
接收消息功能:
- ✅ 接收企业微信应用消息回调
- ✅ 接收文本消息(包含 Content 字段)
- ✅ 接收图片消息(包含 PicUrl、MediaId 字段)
- ✅ 接收语音消息(包含 MediaId、Format 字段)
- ✅ 接收视频消息(包含 MediaId、ThumbMediaId 字段)
- ✅ 接收位置消息(包含 Location_X、Location_Y、Scale、Label、AppType 字段)
- ✅ 接收链接消息(包含 Title、Description、Url、PicUrl 字段)
- ✅ 接收事件推送(成员变更、部门变更等)
- ✅ 接口许可失效通知(当许可账号失效的企业成员访问应用时触发)
- ✅ URL 验证
- ✅ 消息加解密
- ✅ 签名验证
被动回复消息功能:
> 官方文档:被动回复消息
使用「企业微信消息接收(被动回复)触发器」+ 「企业微信-基础」节点的「被动回复」功能实现:
- ✅ 被动回复文本消息
- ✅ 被动回复图片消息
- ✅ 被动回复语音消息
- ✅ 被动回复视频消息
- ✅ 被动回复图文消息
- ✅ 被动回复模板卡片更新消息
- ✅ 自动加密和签名
- ✅ 支持从工作流输出中读取回复内容
工作流配置示例:
`
[企业微信消息接收(被动回复)触发器] → [中间处理节点(可选)] → [企业微信-基础 (被动回复)]
``