n8n-nodes-wecom 0.1.33 → 0.1.35

package/README.md

@@ -2,7 +2,7 @@
 
 这是一个 n8n 社区节点，让你可以在 [n8n](https://n8n.io/) 工作流中使用企业微信（WeChat Work）API。
 
-## 📦 节点分类
+## 节点分类
 
 本插件按照企业微信官方文档的分类结构，提供以下节点：
 
@@ -34,17 +34,18 @@
 - **会议室管理** - 会议室和会议室预定管理
 - **紧急通知** - 语音电话等紧急通知
 
-### 3. 企业微信消息接收（Trigger）
-
-接收企业微信的消息和事件推送
-
-### 4. 企业微信-连接微信
+### 3. 企业微信-连接微信
 
 包含企业微信连接微信的功能：
 
 - **客户联系** - 客户管理、标签、继承、客户群、朋友圈、群发等
 - **微信客服** - 客服账号、接待人员、消息收发、统计管理
 
+
+### 4. 企业微信消息接收（Trigger）
+
+接收企业微信的消息和事件推送
+
 ## 隐私与安全
 
 **本插件完全基于企业微信官方 API 开发，直连企业微信服务器，不经过任何第三方服务器。**
@@ -69,7 +70,7 @@ npm install n8n-nodes-wecom
 
 ## 凭证配置
 
-### 消息推送功能（群机器人Webhook需要）
+### 消息推送凭证（WebHook URL）
 
 **消息推送**功能用于通过群机器人 Webhook 发送消息到企业微信群聊
 
@@ -80,7 +81,7 @@ npm install n8n-nodes-wecom
 3. 创建一个机器人并复制 Webhook 地址
 4. 在 n8n 中配置"企业微信群机器人 Webhook"凭证，填入 Webhook 地址
 
-### 获取企业微信凭证（消息发送、通讯录、素材管理等功能需要）
+### 获取企业微信请求凭证（消息发送、通讯录、素材管理等功能需要）
 
 1. 登录 [企业微信管理后台](https://work.weixin.qq.com/)
 2. 进入"我的企业" > "企业信息"，复制 **企业ID (CorpID)**
@@ -88,138 +89,23 @@ npm install n8n-nodes-wecom
 4. 复制 **AgentId**（应用ID）
 5. 点击"查看Secret"，复制 **Secret**
 
-### 在 n8n 中配置
-
-根据使用的节点类型选择对应的凭证：
-
-#### 企业微信-基础 节点
-
-1. 添加"企业微信-基础"节点到工作流
-2. 根据选择的资源类型配置凭证：
-
-   **通讯录、应用消息、群聊会话、企业互联、素材管理：**
-   - 点击"Credential to connect with"
-   - 选择"创建新凭证 - 企业微信 API"
-   - 填入以下信息：
-     - **企业 ID** - 你的企业 CorpID
-     - **应用 Secret** - 应用的 Secret
-     - **应用 ID** - 应用的 AgentID
-
-   **消息推送（群机器人）：**
-   - 点击"Credential to connect with"
-   - 选择"创建新凭证 - 企业微信群机器人 Webhook API"
-   - 填入群机器人的 Webhook URL
-
-#### 企业微信-办公 节点
-
-1. 添加"企业微信-办公"节点到工作流
-2. 点击"Credential to connect with"
-3. 选择"创建新凭证 - 企业微信 API"
-4. 填入企业凭证信息（同上）
-
-#### 企业微信-连接微信 节点
-
-1. 添加"企业微信-连接微信"节点到工作流
-2. 点击"Credential to connect with"
-3. 选择"创建新凭证 - 企业微信 API"
-4. 填入企业凭证信息（同上）
-
-#### 企业微信消息接收 Trigger 节点
-
-1. 添加"企业微信消息接收"触发器节点
-2. 点击"Credential to connect with"
-3. 选择"创建新凭证 - 企业微信消息接收 API"
-4. 填入以下信息：
-   - **企业 ID** - 你的企业 CorpID
-   - **Token** - 你将在企业微信后台设置的 Token（两边必须一致）
-   - **EncodingAESKey** - 你将在企业微信后台设置的密钥（两边必须一致，43位字符）
-5. 复制节点的 Webhook URL
-6. 在企业微信应用管理后台配置接收消息时，使用**相同的** Token 和 EncodingAESKey
-
-**被动回复消息配置：**
-
-如果需要在接收到用户消息后自动回复，可以启用"被动回复消息"功能：
-
-1. 在触发器节点中，启用"被动回复消息"选项
-2. 选择回复消息类型（文本、图片、语音、视频、图文）
-3. 配置对应的字段名称
-4. 在工作流中通过后续节点设置回复内容到指定字段
-
-**注意事项：**
-
-- 被动回复消息会自动进行加密和签名，无需手动处理
-- 如果未在工作流中设置相应字段，文本消息会返回默认内容"感谢您的消息，我们已收到！"
-- 媒体类型消息必须先通过素材管理接口上传获得 media_id，否则会报错
-- 图文消息需要提供包含 Title、Url 等字段的数组
-- 被动回复失败时会在输出数据的 `_passiveReplyError` 字段中记录错误信息
-
-## 💡 使用技巧
+### 获取企业微信消息接收凭证
 
-### 动态选项功能
-
-本插件支持动态获取企业微信数据，让配置更加便捷，无需手动查找和输入ID：
-
-#### 企业微信-基础 节点
-
-- ✅ **成员选择**：自动获取企业所有成员列表，可按部门、标签筛选
-- ✅ **部门选择**：自动获取企业部门树结构
-- ✅ **标签选择**：自动获取企业标签列表
-
-**使用方法**：在发送消息、成员管理等操作中，相关字段会显示为下拉列表，直接选择即可，无需手动输入 UserID、部门ID、标签ID。
-
-**示例场景**：
-- 发送应用消息时，选择接收人可以从下拉列表中选择成员姓名
-- 创建成员时，选择所属部门可以从部门树中选择
-- 添加标签成员时，可以先选择标签，再选择要添加的成员
-
-#### 企业微信-连接微信 节点
-
-- ✅ **客服账号选择**：自动获取已创建的客服账号列表
-
-**使用方法**：在客服相关操作中，`客服账号` 字段会显示为下拉列表，显示客服账号名称，选择后自动填入 `open_kfid`。
-
-**支持的操作**：
-- 添加/删除接待人员
-- 获取接待人员列表
-- 发送客服消息
-- 分配客服会话
-- 获取客服账号链接
-- 修改/删除客服账号
-- 获取客服数据统计
-
-**优势**：
-- 🎯 **直观便捷**：显示友好的名称，无需记忆和查找 ID
-- 🚀 **提升效率**：配置时间从 5-10 分钟缩短到 1-2 分钟
-- ✅ **减少错误**：避免手动输入 ID 导致的错误
-- 🔄 **实时同步**：自动获取最新的企业微信数据
-
-**表达式支持**：所有动态选项字段仍支持通过 [n8n 表达式](https://docs.n8n.io/code/expressions/) 输入动态值，确保向后兼容和灵活性。
-
-### 获取ID的方法
-
-对于暂不支持动态选项的字段（如审批模板ID、日历ID等），可通过以下方式获取：
-
-1. **审批模板ID**：
-   - 登录企业微信管理后台
-   - 进入"应用管理" > "自建" > 选择应用 > "审批"
-   - 在模板列表中查看模板ID
-
-2. **日历ID**：
-   - 通过"创建日历"操作获取返回的 `cal_id`
-   - 在后续工作流中使用该ID
-
-3. **文档ID**：
-   - 通过"新建文档"操作获取返回的 `docid`
-   - 在后续工作流中使用该ID
-
-4. **空间ID**：
-   - 通过"创建空间"操作获取返回的 `spaceid`
-   - 在后续工作流中使用该ID
-
-5. **会议室ID**：
-   - 登录企业微信管理后台
-   - 进入"工作台" > "会议室"
-   - 查看会议室列表中的 ID
+1. 登录 [企业微信管理后台](https://work.weixin.qq.com/)
+2. 进入"我的企业" > "企业信息"，复制 **企业ID (CorpID)**
+3. 进入"应用管理" > 选择或创建一个应用
+4. 复制 **AgentId**（应用ID，例如：1000001）
+5. 启用 **API接收消息**，设置Token、EncodingAESKey
+6. 在 n8n 中创建"企业微信消息接收 Trigger"节点：
+   - 配置凭证（企业ID、应用ID、Token、EncodingAESKey）
+   - **Path** 表示 Webhook URL 的路径，建议使用应用 ID
+   - 保存节点后，查看生成的 Webhook URL（例如：`https://your-n8n.com/webhook/1000001`）
+7. 将 Webhook URL 填入企业微信后台的**接收消息服务器配置**中
+
+**重要提示**：
+- 企业微信每个应用只能配置一个接收消息 URL
+- 多个工作流可以使用同一个凭证（同一应用ID），它们会共享同一个 Webhook URL 接收消息
+- 不同应用请创建不同的凭证，使用不同的应用ID
 
 ## 已实现功能
 
@@ -229,9 +115,9 @@ npm install n8n-nodes-wecom
 
 ## 一、基础功能（企业微信-基础 节点）
 
-### 📥 消息接收（Trigger 节点）
+### 消息接收（Trigger 节点）
 
-> 📖 [官方文档：接收消息与事件](https://developer.work.weixin.qq.com/document/path/90238)
+> [官方文档：接收消息与事件](https://developer.work.weixin.qq.com/document/path/90238)
 
 **接收消息功能：**
 
@@ -249,7 +135,7 @@ npm install n8n-nodes-wecom
 
 **被动回复消息功能：**
 
-> 📖 [官方文档：被动回复消息](https://developer.work.weixin.qq.com/document/path/90241)
+> [官方文档：被动回复消息](https://developer.work.weixin.qq.com/document/path/90241)
 
 - ✅ [被动回复文本消息](https://developer.work.weixin.qq.com/document/path/90241)
 - ✅ [被动回复图片消息](https://developer.work.weixin.qq.com/document/path/90241)
@@ -261,12 +147,12 @@ npm install n8n-nodes-wecom
 
 **回调机制参考文档：**
 
-- 📖 [回调机制说明](https://developer.work.weixin.qq.com/document/path/92520)
-- 📖 [回调机制示例代码](https://developer.work.weixin.qq.com/document/path/92521)
+- [回调机制说明](https://developer.work.weixin.qq.com/document/path/92520)
+- [回调机制示例代码](https://developer.work.weixin.qq.com/document/path/92521)
 
-### 📩 消息推送（群机器人）
+### 消息推送（群机器人）
 
-> 📖 [官方文档：消息推送配置说明](https://developer.work.weixin.qq.com/document/path/99110)
+> [官方文档：消息推送配置说明](https://developer.work.weixin.qq.com/document/path/99110)
 
 - ✅ 发送文本消息
 - ✅ 发送 Markdown 消息
@@ -279,9 +165,9 @@ npm install n8n-nodes-wecom
   - 文本通知模板卡片
   - 图文展示模板卡片
 
-### 📨 应用消息发送
+### 应用消息发送
 
-> 📖 [官方文档：发送应用消息](https://developer.work.weixin.qq.com/document/path/90236)
+> [官方文档：发送应用消息](https://developer.work.weixin.qq.com/document/path/90236)
 
 - ✅ 发送文本消息
 - ✅ 发送 Markdown 消息
@@ -299,9 +185,9 @@ npm install n8n-nodes-wecom
 - ✅ [撤回应用消息](https://developer.work.weixin.qq.com/document/path/94867)
 - ✅ [更新模板卡片消息](https://developer.work.weixin.qq.com/document/path/94888)
 
-### 💬 群聊会话
+### 群聊会话
 
-> 📖 [官方文档：应用发送消息到群聊会话](https://developer.work.weixin.qq.com/document/path/90244)
+> [官方文档：应用发送消息到群聊会话](https://developer.work.weixin.qq.com/document/path/90244)
 
 - ✅ [创建群聊会话](https://developer.work.weixin.qq.com/document/path/90245)
 - ✅ [获取群聊会话信息](https://developer.work.weixin.qq.com/document/path/98914)
@@ -313,9 +199,9 @@ npm install n8n-nodes-wecom
   - 发送 Markdown 消息到群聊
   - 发送图文消息到群聊
 
-### 👥 通讯录管理
+### 通讯录管理
 
-> 📖 [官方文档：通讯录管理](https://developer.work.weixin.qq.com/document/path/90193)
+> [官方文档：通讯录管理](https://developer.work.weixin.qq.com/document/path/90193)
 
 #### 成员管理
 
@@ -353,7 +239,7 @@ npm install n8n-nodes-wecom
 
 #### 账号ID转换
 
-> 📖 [官方文档：账号 ID](https://developer.work.weixin.qq.com/document/path/98728)
+> [官方文档：账号 ID](https://developer.work.weixin.qq.com/document/path/98728)
 
 - ✅ [用户ID转OpenID](https://developer.work.weixin.qq.com/document/path/90202)
 - ✅ [OpenID转用户ID](https://developer.work.weixin.qq.com/document/path/90202)
@@ -361,7 +247,7 @@ npm install n8n-nodes-wecom
 
 #### 异步导入接口
 
-> 📖 [官方文档：异步导入接口](https://developer.work.weixin.qq.com/document/path/90979)
+> [官方文档：异步导入接口](https://developer.work.weixin.qq.com/document/path/90979)
 
 - ✅ [增量更新成员](https://developer.work.weixin.qq.com/document/path/90980)
 - ✅ [全量覆盖成员](https://developer.work.weixin.qq.com/document/path/90981)
@@ -370,7 +256,7 @@ npm install n8n-nodes-wecom
 
 #### 异步导出接口
 
-> 📖 [官方文档：异步导出接口](https://developer.work.weixin.qq.com/document/path/94850)
+> [官方文档：异步导出接口](https://developer.work.weixin.qq.com/document/path/94850)
 
 - ✅ [导出成员](https://developer.work.weixin.qq.com/document/path/94849)
 - ✅ [导出成员详情](https://developer.work.weixin.qq.com/document/path/94851)
@@ -378,9 +264,9 @@ npm install n8n-nodes-wecom
 - ✅ [导出标签成员](https://developer.work.weixin.qq.com/document/path/94853)
 - ✅ [获取导出结果](https://developer.work.weixin.qq.com/document/path/94854)
 
-### 📦 素材管理
+### 素材管理
 
-> 📖 [官方文档：素材管理](https://developer.work.weixin.qq.com/document/path/91054)
+> [官方文档：素材管理](https://developer.work.weixin.qq.com/document/path/91054)
 
 - ✅ [上传临时素材](https://developer.work.weixin.qq.com/document/path/90253)
 - ✅ [上传图片](https://developer.work.weixin.qq.com/document/path/90256)
@@ -390,9 +276,9 @@ npm install n8n-nodes-wecom
 - ✅ 上传永久素材
 - ✅ 获取永久素材
 
-### 🔗 企业互联
+### 企业互联
 
-> 📖 [官方文档：企业互联](https://developer.work.weixin.qq.com/document/path/93360)
+> [官方文档：企业互联](https://developer.work.weixin.qq.com/document/path/93360)
 
 #### 企业互联基础接口
 
@@ -402,7 +288,7 @@ npm install n8n-nodes-wecom
 
 #### 上下游基础接口
 
-> 📖 [官方文档：上下游](https://developer.work.weixin.qq.com/document/path/97213)
+> [官方文档：上下游](https://developer.work.weixin.qq.com/document/path/97213)
 
 - ✅ [获取应用共享信息](https://developer.work.weixin.qq.com/document/path/95813)
 - ✅ [获取下级/下游企业的access_token](https://developer.work.weixin.qq.com/document/path/95816)
@@ -427,25 +313,16 @@ npm install n8n-nodes-wecom
 - ✅ [新增对接规则](https://developer.work.weixin.qq.com/document/path/95634)
 - ✅ [更新对接规则](https://developer.work.weixin.qq.com/document/path/95635)
 
-### ⚙️ 系统
+### 系统
 
-> 📖 [官方文档：获取企业微信服务器IP段](https://developer.work.weixin.qq.com/document/path/92520)
+> [官方文档：获取企业微信服务器IP段](https://developer.work.weixin.qq.com/document/path/92520)
 
 - ✅ [获取企业微信接口IP段](https://developer.work.weixin.qq.com/document/path/92520)
 - ✅ [获取企业微信回调IP段](https://developer.work.weixin.qq.com/document/path/92521)
 
-**用途说明：**
-
-这些接口用于获取企业微信服务器的IP地址段，可用于：
-
-- **安全配置**：将获取到的IP段添加到防火墙白名单，只允许企业微信服务器访问
-- **接口调用安全**：配置API接口IP段白名单，防止非法调用
-- **回调安全**：配置回调服务器IP段白名单，确保只接收来自企业微信官方服务器的回调请求
-- **网络隔离**：在专网或VPN环境中，只开放对企业微信服务器IP段的访问权限
-
-### 🤝 客户联系
+### 客户联系
 
-> 📖 [官方文档：客户联系](https://developer.work.weixin.qq.com/document/path/92109)
+> [官方文档：客户联系](https://developer.work.weixin.qq.com/document/path/92109)
 
 #### 企业服务人员管理
 
@@ -498,7 +375,7 @@ npm install n8n-nodes-wecom
 
 #### 客户朋友圈
 
-> 📖 [官方文档：客户朋友圈概述](https://developer.work.weixin.qq.com/document/path/93506)
+> [官方文档：客户朋友圈概述](https://developer.work.weixin.qq.com/document/path/93506)
 
 - ✅ [企业发表内容到客户的朋友圈](https://developer.work.weixin.qq.com/document/path/95094)
 - ✅ [停止发表企业朋友圈](https://developer.work.weixin.qq.com/document/path/97612)
@@ -530,9 +407,9 @@ npm install n8n-nodes-wecom
 - ✅ [获客助手](https://developer.work.weixin.qq.com/document/path/97297)（链接管理、客户信息、额度统计）
 - ✅ [获取已服务的外部联系人](https://developer.work.weixin.qq.com/document/path/99434)
 
-### 💰 电子发票
+### 电子发票
 
-> 📖 [官方文档：电子发票](https://developer.work.weixin.qq.com/document/path/90283)
+> [官方文档：电子发票](https://developer.work.weixin.qq.com/document/path/90283)
 
 - ✅ [查询电子发票](https://developer.work.weixin.qq.com/document/path/90284)
 - ✅ [更新发票状态](https://developer.work.weixin.qq.com/document/path/90285)
@@ -543,9 +420,9 @@ npm install n8n-nodes-wecom
 
 ## 二、办公功能（企业微信-办公 节点）
 
-### 📧 邮件管理
+### 邮件管理
 
-> 📖 [官方文档：邮件](https://developer.work.weixin.qq.com/document/path/95486)
+> [官方文档：邮件](https://developer.work.weixin.qq.com/document/path/95486)
 
 #### 发送邮件
 
@@ -597,7 +474,7 @@ npm install n8n-nodes-wecom
 - ✅ [更改用户功能属性](https://developer.work.weixin.qq.com/document/path/98008)
 - ✅ [获取邮件未读数](https://developer.work.weixin.qq.com/document/path/95514)
 
-### 📄 文档管理
+### 文档管理
 
 #### 管理文档
 
@@ -666,9 +543,9 @@ npm install n8n-nodes-wecom
 
 - ✅ [上传文档图片](https://developer.work.weixin.qq.com/document/path/99933)
 
-### 📅 日程管理
+### 日程管理
 
-> 📖 [官方文档：日程](https://developer.work.weixin.qq.com/document/path/93647)
+> [官方文档：日程](https://developer.work.weixin.qq.com/document/path/93647)
 
 #### 管理日历
 
@@ -688,9 +565,9 @@ npm install n8n-nodes-wecom
 - ✅ [获取日程详情](https://developer.work.weixin.qq.com/document/path/97724)
 - ✅ [取消日程](https://developer.work.weixin.qq.com/document/path/97725)
 
-### 🎥 会议管理
+### 会议管理
 
-> 📖 [官方文档：会议](https://developer.work.weixin.qq.com/document/path/99104)
+> [官方文档：会议](https://developer.work.weixin.qq.com/document/path/99104)
 
 #### 预约会议基础管理
 
@@ -730,9 +607,9 @@ npm install n8n-nodes-wecom
 - ✅ [取消高级功能账号](https://developer.work.weixin.qq.com/document/path/99509)
 - ✅ [获取高级功能账号列表](https://developer.work.weixin.qq.com/document/path/99510)
 
-### 💾 微盘管理
+### 微盘管理
 
-> 📖 [官方文档：微盘](https://developer.work.weixin.qq.com/document/path/93654)
+> [官方文档：微盘](https://developer.work.weixin.qq.com/document/path/93654)
 
 #### 空间管理
 
@@ -765,9 +642,9 @@ npm install n8n-nodes-wecom
 - ✅ [获取文件权限信息](https://developer.work.weixin.qq.com/document/path/97979)
 - ✅ [文件安全设置](https://developer.work.weixin.qq.com/document/path/97980)
 
-### ⏰ 打卡管理
+### 打卡管理
 
-> 📖 [官方文档：打卡](https://developer.work.weixin.qq.com/document/path/90262)
+> [官方文档：打卡](https://developer.work.weixin.qq.com/document/path/90262)
 
 - ✅ [获取企业所有打卡规则](https://developer.work.weixin.qq.com/document/path/93384)
 - ✅ [获取员工打卡规则](https://developer.work.weixin.qq.com/document/path/90263)
@@ -782,9 +659,9 @@ npm install n8n-nodes-wecom
 - ✅ [获取设备打卡数据](https://developer.work.weixin.qq.com/document/path/94126)
 - ✅ [管理打卡规则](https://developer.work.weixin.qq.com/document/path/98041)
 
-### 📝 审批管理
+### 审批管理
 
-> 📖 [官方文档：审批](https://developer.work.weixin.qq.com/document/path/91854)
+> [官方文档：审批](https://developer.work.weixin.qq.com/document/path/91854)
 
 - ✅ [获取审批模板详情](https://developer.work.weixin.qq.com/document/path/91982)
 - ✅ [提交审批申请](https://developer.work.weixin.qq.com/document/path/91853)
@@ -796,26 +673,26 @@ npm install n8n-nodes-wecom
 - ✅ [创建审批模板](https://developer.work.weixin.qq.com/document/path/97437)
 - ✅ [更新审批模板](https://developer.work.weixin.qq.com/document/path/97438)
 
-### 📊 汇报管理
+### 汇报管理
 
-> 📖 [官方文档：汇报](https://developer.work.weixin.qq.com/document/path/93496)
+> [官方文档：汇报](https://developer.work.weixin.qq.com/document/path/93496)
 
 - ✅ [批量获取汇报记录单号](https://developer.work.weixin.qq.com/document/path/93393)
 - ✅ [获取汇报记录详情](https://developer.work.weixin.qq.com/document/path/93394)
 - ✅ [获取汇报统计数据](https://developer.work.weixin.qq.com/document/path/93395)
 - ✅ [下载微盘文件](https://developer.work.weixin.qq.com/document/path/98021)
 
-### 👔 人事助手
+### 人事助手
 
-> 📖 [官方文档：人事助手](https://developer.work.weixin.qq.com/document/path/99130)
+> [官方文档：人事助手](https://developer.work.weixin.qq.com/document/path/99130)
 
 - ✅ [获取员工字段配置](https://developer.work.weixin.qq.com/document/path/99131)
 - ✅ [获取员工花名册信息](https://developer.work.weixin.qq.com/document/path/99132)
 - ✅ [更新员工花名册信息](https://developer.work.weixin.qq.com/document/path/99133)
 
-### 🏢 会议室管理
+### 会议室管理
 
-> 📖 [官方文档：会议室](https://developer.work.weixin.qq.com/document/path/93618)
+> [官方文档：会议室](https://developer.work.weixin.qq.com/document/path/93618)
 
 - ✅ [会议室管理](https://developer.work.weixin.qq.com/document/path/93619)（添加、编辑、删除、查询、列表）
 - ✅ [会议室预定管理](https://developer.work.weixin.qq.com/document/path/93620)（预定、取消、查询、列表）
@@ -823,9 +700,9 @@ npm install n8n-nodes-wecom
 - ✅ [获取申请单详细信息](https://developer.work.weixin.qq.com/document/path/99885)
 - ✅ [设置审批单审批信息](https://developer.work.weixin.qq.com/document/path/99880)
 
-### 📞 紧急通知应用
+### 紧急通知应用
 
-> 📖 [官方文档：紧急通知](https://developer.work.weixin.qq.com/document/path/91623)
+> [官方文档：紧急通知](https://developer.work.weixin.qq.com/document/path/91623)
 
 - ✅ [发起语音电话](https://developer.work.weixin.qq.com/document/path/91627)
 - ✅ [获取接听状态](https://developer.work.weixin.qq.com/document/path/91628)
@@ -834,9 +711,9 @@ npm install n8n-nodes-wecom
 
 ## 三、连接微信功能（企业微信-连接微信 节点）
 
-### 📱 微信客服
+### 微信客服
 
-> 📖 [官方文档：微信客服](https://developer.work.weixin.qq.com/document/path/94638)
+> [官方文档：微信客服](https://developer.work.weixin.qq.com/document/path/94638)
 
 #### 客服账号管理
 
@@ -875,6 +752,8 @@ npm install n8n-nodes-wecom
 ## 参考资源
 
 - [企业微信开发文档](https://developer.work.weixin.qq.com/document/)
+- [企业微信API全局错误码](https://developer.work.weixin.qq.com/document/path/90313)
+- [常见问题 - FAQ](https://developer.work.weixin.qq.com/document/path/90315)
 - [n8n 官方文档](https://docs.n8n.io/)
 - [n8n 社区节点开发文档](https://docs.n8n.io/integrations/creating-nodes/overview/)
 - [n8n 社区节点开发示例](https://docs.n8n.io/integrations/creating-nodes/build/declarative-style-node/)

package/dist/credentials/WeComApi.credentials.js

@@ -14,25 +14,28 @@ class WeComApi {
                 type: 'string',
                 default: '',
                 required: true,
-                description: '企业微信的企业 ID，在"管理后台 - 我的企业 - 企业信息"中查看',
+                description: '企业微信的企业 ID',
+                hint: '在"管理后台 - 我的企业 - 企业信息"中查看'
             },
             {
-                displayName: '应用 Secret',
-                name: 'corpSecret',
+                displayName: '应用 ID (Agent ID)',
+                name: 'agentId',
                 type: 'string',
-                typeOptions: { password: true },
                 default: '',
                 required: true,
-                description: '应用的密钥，在"应用管理 - 自建应用"中查看',
+                description: '应用的唯一标识',
+                hint: '在"应用管理 - 自建应用"中查看'
             },
             {
-                displayName: '应用 ID (Agent ID)',
-                name: 'agentId',
+                displayName: '应用 Secret',
+                name: 'corpSecret',
                 type: 'string',
+                typeOptions: { password: true },
                 default: '',
                 required: true,
-                description: '应用的唯一标识，在"应用管理 - 自建应用"中查看',
-            },
+                description: '应用的密钥',
+                hint: '在"应用管理 - 自建应用"中查看，注意应用需要是启用状态'
+            }
         ];
         this.authenticate = {
             type: 'generic',
@@ -40,6 +43,7 @@ class WeComApi {
         };
         this.test = {
             request: {
+                method: 'GET',
                 baseURL: 'https://qyapi.weixin.qq.com',
                 url: '/cgi-bin/gettoken',
                 qs: {

package/dist/credentials/WeComApi.credentials.js.map

@@ -1 +1 @@
-{"version":3,"file":"WeComApi.credentials.js","sourceRoot":"","sources":["../../credentials/WeComApi.credentials.ts"],"names":[],"mappings":";;;AAQA,MAAa,QAAQ;IAArB;QACC,SAAI,GAAG,UAAU,CAAC;QAElB,gBAAW,GAAG,UAAU,CAAC;QAGzB,SAAI,GAAS,EAAE,KAAK,EAAE,yBAAyB,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC;QAExF,qBAAgB,GAAG,0DAA0D,CAAC;QAE9E,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,iBAAiB;gBAC9B,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,qCAAqC;aAClD;YACD;gBACC,WAAW,EAAE,WAAW;gBACxB,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,yBAAyB;aACtC;YACD;gBACC,WAAW,EAAE,kBAAkB;gBAC/B,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,2BAA2B;aACxC;SACD,CAAC;QAIF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,EAAE;SACd,CAAC;QAGF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,6BAA6B;gBACtC,GAAG,EAAE,mBAAmB;gBACxB,EAAE,EAAE;oBACH,MAAM,EAAE,0BAA0B;oBAClC,UAAU,EAAE,8BAA8B;iBAC1C;aACD;YACD,KAAK,EAAE;gBACN;oBACC,IAAI,EAAE,qBAAqB;oBAC3B,UAAU,EAAE;wBACX,GAAG,EAAE,SAAS;wBACd,KAAK,EAAE,CAAC;wBACR,OAAO,EAAE,2BAA2B;qBACpC;iBACD;aACD;SACD,CAAC;IACH,CAAC;CAAA;AAlED,4BAkEC"}
+{"version":3,"file":"WeComApi.credentials.js","sourceRoot":"","sources":["../../credentials/WeComApi.credentials.ts"],"names":[],"mappings":";;;AAQA,MAAa,QAAQ;IAArB;QACC,SAAI,GAAG,UAAU,CAAC;QAElB,gBAAW,GAAG,UAAU,CAAC;QAGzB,SAAI,GAAS,EAAE,KAAK,EAAE,yBAAyB,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC;QAExF,qBAAgB,GAAG,0DAA0D,CAAC;QAE9E,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,iBAAiB;gBAC9B,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,0BAA0B;aAChC;YACD;gBACC,WAAW,EAAE,kBAAkB;gBAC/B,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,mBAAmB;aACzB;YACD;gBACC,WAAW,EAAE,WAAW;gBACxB,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,OAAO;gBACpB,IAAI,EAAE,+BAA+B;aACrC;SACD,CAAC;QAIF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,EAAE;SACd,CAAC;QAGF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,6BAA6B;gBACtC,GAAG,EAAE,mBAAmB;gBACxB,EAAE,EAAE;oBACH,MAAM,EAAE,0BAA0B;oBAClC,UAAU,EAAE,8BAA8B;iBAC1C;aACD;YACD,KAAK,EAAE;gBACN;oBACC,IAAI,EAAE,qBAAqB;oBAC3B,UAAU,EAAE;wBACX,GAAG,EAAE,SAAS;wBACd,KAAK,EAAE,CAAC;wBACR,OAAO,EAAE,2BAA2B;qBACpC;iBACD;aACD;SACD,CAAC;IACH,CAAC;CAAA;AAtED,4BAsEC"}

package/dist/credentials/WeComReceiveApi.credentials.js

@@ -18,6 +18,16 @@ class WeComReceiveApi {
                 description: '企业微信的企业 ID（CorpID）',
                 hint: '在企业微信管理后台 - 我的企业 - 企业信息中获取',
             },
+            {
+                displayName: '应用 ID (Agent ID)',
+                name: 'agentId',
+                type: 'string',
+                default: '',
+                required: true,
+                placeholder: '1000001',
+                description: '应用的唯一标识',
+                hint: '在"应用管理 - 自建应用"中查看',
+            },
             {
                 displayName: 'Token',
                 name: 'token',
@@ -25,8 +35,8 @@ class WeComReceiveApi {
                 default: '',
                 required: true,
                 placeholder: 'your_token_here',
-                description: 'Used to verify message signatures. Must match the Token configured in WeCom admin panel',
-                hint: '⚠️ 重要：这是你在企业微信后台"接收消息"配置中自己设置的 Token，两边必须完全一致。用于自动验证消息签名，防止伪造请求',
+                description: '企业微信后台"接收消息"配置中自己设置的 Token，两边必须完全一致。用于自动验证消息签名，防止伪造请求',
+                hint: '可由企业任意填写，用于生成签名',
                 typeOptions: { password: true },
             },
             {
@@ -39,8 +49,8 @@ class WeComReceiveApi {
                 default: '',
                 required: true,
                 placeholder: '43位随机字符串（可在企业微信后台点击"随机生成"）',
-                description: 'Used to decrypt messages. Must match the EncodingAESKey configured in WeCom admin panel',
-                hint: '⚠️ 重要：这是你在企业微信后台"接收消息"配置中设置的密钥（43位字符），两边必须完全一致。用于自动解密消息内容',
+                description: '企业微信后台"接收消息"配置中设置的密钥（43位字符），两边必须完全一致。用于自动解密消息内容',
+                hint: '用于消息体的加密，长度固定为43个字符',
             },
         ];
         this.authenticate = {

package/dist/credentials/WeComReceiveApi.credentials.js.map

@@ -1 +1 @@
-{"version":3,"file":"WeComReceiveApi.credentials.js","sourceRoot":"","sources":["../../credentials/WeComReceiveApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,eAAe;IAA5B;QACC,SAAI,GAAG,iBAAiB,CAAC;QAEzB,gBAAW,GAAG,cAAc,CAAC;QAE7B,qBAAgB,GAAG,0DAA0D,CAAC;QAE9E,SAAI,GAAG,EAAE,KAAK,EAAE,yBAAyB,EAAE,IAAI,EAAE,8BAA8B,EAAW,CAAC;QAE3F,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,OAAO;gBACpB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,oBAAoB;gBACjC,WAAW,EAAE,oBAAoB;gBACjC,IAAI,EAAE,4BAA4B;aAClC;YACD;gBACC,WAAW,EAAE,OAAO;gBACpB,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,iBAAiB;gBAC9B,WAAW,EAAE,yFAAyF;gBACtG,IAAI,EAAE,iEAAiE;gBACvE,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;aAC/B;YACD;gBACC,WAAW,EAAE,gBAAgB;gBAC7B,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,4BAA4B;gBACzC,WAAW,EAAE,yFAAyF;gBACtG,IAAI,EAAE,2DAA2D;aACjE;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,EAAE;SACd,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,6BAA6B;gBACtC,GAAG,EAAE,mBAAmB;gBACxB,MAAM,EAAE,KAAK;gBACb,EAAE,EAAE;oBACH,MAAM,EAAE,0BAA0B;oBAClC,UAAU,EAAE,MAAM;iBAClB;aACD;SACD,CAAC;IACH,CAAC;CAAA;AA9DD,0CA8DC"}
+{"version":3,"file":"WeComReceiveApi.credentials.js","sourceRoot":"","sources":["../../credentials/WeComReceiveApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,eAAe;IAA5B;QACC,SAAI,GAAG,iBAAiB,CAAC;QAEzB,gBAAW,GAAG,cAAc,CAAC;QAE7B,qBAAgB,GAAG,0DAA0D,CAAC;QAE9E,SAAI,GAAG,EAAE,KAAK,EAAE,yBAAyB,EAAE,IAAI,EAAE,8BAA8B,EAAW,CAAC;QAE3F,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,OAAO;gBACpB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,oBAAoB;gBACjC,WAAW,EAAE,oBAAoB;gBACjC,IAAI,EAAE,4BAA4B;aAClC;YACD;gBACC,WAAW,EAAE,kBAAkB;gBAC/B,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,SAAS;gBACtB,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,mBAAmB;aACzB;YACD;gBACC,WAAW,EAAE,OAAO;gBACpB,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,iBAAiB;gBAC9B,WAAW,EAAE,uDAAuD;gBACpE,IAAI,EAAE,iBAAiB;gBACvB,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;aAC/B;YACD;gBACC,WAAW,EAAE,gBAAgB;gBAC7B,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,4BAA4B;gBACzC,WAAW,EAAE,iDAAiD;gBAC9D,IAAI,EAAE,qBAAqB;aAC3B;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,EAAE;SACd,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,6BAA6B;gBACtC,GAAG,EAAE,mBAAmB;gBACxB,MAAM,EAAE,KAAK;gBACb,EAAE,EAAE;oBACH,MAAM,EAAE,0BAA0B;oBAClC,UAAU,EAAE,MAAM;iBAClB;aACD;SACD,CAAC;IACH,CAAC;CAAA;AAxED,0CAwEC"}