n8n-nodes-wxwork-notification

这是一个用于n8n的节点包，提供企业微信群机器人消息推送功能。

该节点包含两个主要组件：

1. 企业微信群机器人通知：用于发送各种类型的消息到企业微信群聊
2. 企业微信文件上传：用于上传文件获取media_id，配合"文件"类型消息使用

安装

在n8n中安装

1. 打开您的n8n实例
2. 转到"设置" -> "社区节点"
3. 选择"安装"
4. 输入n8n-nodes-wxwork-notification
5. 单击"安装"

手动安装

将此存储库克隆到您的n8n自定义扩展目录中：

cd /YOUR_N8N_CUSTOM_EXTENSIONS_DIRECTORY
git clone https://github.com/USERNAME/n8n-nodes-wxwork-notification
cd n8n-nodes-wxwork-notification
# 使用pnpm安装依赖
pnpm install
# 构建项目
pnpm build

重启您的n8n实例，新节点就会被加载。

使用方法

前提条件

使用此节点前，您需要：

1. 在企业微信中创建一个群聊
2. 在群聊中添加机器人
3. 获取机器人的Webhook URL

配置凭证

1. 打开n8n工作流编辑器
2. 添加"企业微信群机器人通知"节点或"企业微信文件上传"节点
3. 创建新的凭证，输入您的Webhook URL

企业微信群机器人通知节点

该节点支持以下消息类型：

1. 文本消息：

   • 基本文本内容
   • 支持@特定用户或@所有人

2. Markdown消息：

   • 使用Markdown格式的文本
   • 支持标题、列表、加粗、引用等

3. 图片消息：

   • 上传Base64编码的图片数据
   • 自动计算MD5值

4. 图文消息：

   • 含标题、描述、链接和图片的图文卡片
   • 支持点击跳转到指定URL

5. 文件消息：

   • 发送已上传到企业微信的文件
   • 需要提供文件的media_id（可通过企业微信文件上传节点获取）

企业微信文件上传节点

此节点用于上传文件到企业微信，获取media_id用于发送文件消息。

支持的功能：

• 上传普通文件或语音文件
• 支持通过二进制数据或本地文件路径上传
• 可自定义文件显示名称
• 返回文件的media_id及相关信息

注意：

• 普通文件大小不超过20MB
• 语音文件大小不超过2MB，长度不超过60秒，仅支持AMR格式
• media_id仅三天内有效

典型工作流示例

1. 文件上传并发送：

   • 触发器 -> 读取文件 -> 企业微信文件上传 -> 企业微信群机器人通知(文件消息)

2. 定时发送报告：

   • 定时触发器 -> 数据库查询 -> 转换为Markdown -> 企业微信群机器人通知(Markdown消息)

3. 事件通知：

   • 自定义事件触发 -> 格式化文本 -> 企业微信群机器人通知(文本消息)

注意事项

• 企业微信群机器人消息发送频率限制为每分钟不超过20条
• 文件、语音等类型需要先通过"企业微信文件上传"节点获取media_id
• media_id仅三天内有效，且只能被相应的机器人使用

文档

• 企业微信群机器人开发文档

支持

如有问题或建议，请提交Issue到GitHub仓库。