wecom

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.

Documentation

n8n-nodes-wecom

npm version GitHub release

这是一个 n8n 社区节点,让你可以在 n8n 工作流中使用企业微信(WeChat Work)API。

⚠️ 重要提示

关于版本更新与稳定性

本插件的设计初衷是提供简单、稳定的企业微信集成体验。我们以 N8N 官方原生节点(如 Telegram、Notion等)为标准,力求交互逻辑清晰直观。

开发原则:
我们会审慎评估每一次代码变更,尽量维持现有节点结构和参数的稳定性,避免对生产环境造成不必要的影响。

注意事项:
在极少数情况下,为了修复重大缺陷或适配企业微信 API 的关键变更,可能会引入必要的调整。

建议:
生产环境更新前,请查看 Release 日志。如果涉及 Breaking Changes(破坏性变更),我们会显著标记。

文档说明:
本文档旨在概括插件支持的核心功能。由于企业微信接口众多且更新频繁,本文档可能无法覆盖所有参数细节。遇有疑问,请优先参考 企业微信官方 API 文档

🤝 交流与支持

遇到问题或有功能建议?欢迎查阅 企业微信官方文档 或加入我们的交流群。

💬 加入社区

方式 1:扫码直接入群 方式 2:联系作者邀请
微信群二维码 作者微信
(推荐) 若群码失效,请备注 n8n 拉你

参与贡献

我们非常欢迎社区贡献!如果你发现了 bug、有新功能建议或想要改进代码:

无论是代码贡献、文档改进还是功能建议,我们都非常感谢!


🧩 节点分类

本插件按照企业微信官方文档的分类结构,提供以下节点:

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 发送消息到企业微信群聊

配置步骤

  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 填入企业微信后台的接收消息服务器配置

重要提示

  • 企业微信每个应用只能配置一个接收消息 URL
  • 多个工作流可以使用同一个凭证(同一应用ID),它们会共享同一个 Webhook URL 接收消息
  • 不同应用请创建不同的凭证,使用不同的应用ID

获取企业微信第三方应用指令回调凭证

  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推送、应用变更等

✨ 已实现功能

以下功能按照企业微信官方文档分类组织:


一、基础功能(企业微信-基础 节点)

消息接收(触发器节点)

官方文档:接收消息与事件

接收消息功能:

被动回复消息功能:

官方文档:被动回复消息

使用「企业微信消息接收(被动回复)触发器」+ 「企业微信-基础」节点的「被动回复」功能实现:

工作流配置示例:

[企业微信消息接收(被动回复)触发器] → [中间处理节点(可选)] → [企业微信-基础 (被动回复)]

⚠️ 重要提示

  • 被动回复节点必须是工作流的最后一个节点
  • 必须在5秒内返回响应,否则企业微信会认为请求失败
  • 请确保工作流处理时间足够快

回调机制参考文档:

第三方应用指令回调功能:

官方文档:第三方应用回调事件

使用「企业微信第三方应用指令回调触发器」接收第三方应用的指令回调事件:

重要提示

  • 第三方应用的指令回调使用SuiteID作为receiveid(而不是CorpID)
  • 服务商收到推送后必须返回字符串 "success",否则企业微信会把返回内容当作错误信息
  • 授权相关事件(create_auth、change_auth、cancel_auth、reset_permanent_code)的响应必须在1000ms内完成
  • 收到取消授权事件后,应当确保删除该企业所有相关的数据

消息推送(群机器人)

官方文档:消息推送配置说明

  • ✅ 发送文本消息
  • ✅ 发送 Markdown 消息
  • ✅ 发送 Markdown V2 消息
  • ✅ 发送图片消息
  • ✅ 发送图文消息
  • ✅ 发送文件消息
  • ✅ 发送语音消息
  • ✅ 发送模板卡片消息
    • 文本通知模板卡片
    • 图文展示模板卡片

应用消息发送

官方文档:发送应用消息

  • ✅ 发送文本消息
  • ✅ 发送 Markdown 消息
  • ✅ 发送图片消息
  • ✅ 发送语音消息
  • ✅ 发送视频消息
  • ✅ 发送文件消息
  • ✅ 发送文本卡片消息
  • ✅ 发送图文消息(news)
  • ✅ 发送图文消息(mpnews)
  • ✅ 发送小程序通知消息
  • ✅ 发送任务卡片消息
  • ✅ 发送模板卡片消息
  • 发送学校通知(家校应用)
  • 撤回应用消息
  • 更新模板卡片消息

群聊会话

官方文档:应用发送消息到群聊会话

通讯录管理

官方文档:通讯录管理

成员管理

部门管理

标签管理

账号ID转换

官方文档:账号 ID

异步导入接口

官方文档:异步导入接口

异步导出接口

官方文档:异步导出接口

素材管理

官方文档:素材管理

企业互联

官方文档:企业互联

企业互联基础接口

上下游基础接口

官方文档:上下游

上下游通讯录管理

上下游规则

系统

官方文档:获取企业微信服务器IP段

电子发票

官方文档:电子发票

第三方应用授权

官方文档:应用授权

第三方应用接口调用许可

官方文档:接口调用许可

第三方应用收银台

官方文档:第三方应用收银台

第三方应用推广二维码

官方文档:第三方应用推广二维码

接口调用许可事件通知:


二、办公功能(企业微信-办公 节点)

邮件管理

官方文档:邮件

发送邮件

获取接收的邮件

管理应用邮箱账号

管理邮件群组

管理公共邮箱

客户端专用密码

邮件高级功能账号管理

其他邮件客户端登录设置

文档管理

管理文档

编辑文档

编辑智能表格内容

获取文档数据

获取智能表格数据

设置文档权限

管理收集表

文档高级功能账号管理

文档素材管理

日程管理

官方文档:日程

管理日历

管理日程

会议管理

官方文档:会议

预约会议基础管理

会议统计管理

预约会议高级管理

会中控制管理

录制管理

会议高级功能账号管理

直播管理

官方文档:直播

微盘管理

官方文档:微盘

空间管理

文件管理

文件权限管理

打卡管理

官方文档:打卡

审批管理

官方文档:审批

汇报管理

官方文档:汇报

人事助手

官方文档:人事助手

会议室管理

官方文档:会议室

紧急通知应用

官方文档:紧急通知


三、连接微信功能(企业微信-连接微信 节点)

客户联系

官方文档:客户联系

企业服务人员管理

客户管理

客户标签管理

在职继承

离职继承

客户群管理

联系我与客户入群方式

客户朋友圈

官方文档:客户朋友圈概述

消息推送

统计管理

其他接口

微信客服

官方文档:微信客服

客服账号管理

接待人员管理

会话分配与消息收发

统计管理

机器人管理

家校应用

健康上报

上课直播

班级收款

家校沟通 - 基础接口

家校沟通 - 网页授权登录

家校沟通 - 学生与家长管理

家校沟通 - 部门管理

家校沟通 - 通讯录变更回调

政民沟通

配置网格结构

配置事件类别

巡查上报

居民上报


📚 参考资源

📄 许可证

MIT

Discussion