npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

n8n-nodes-wecom

v0.4.10

Published

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.

Readme

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