name: wechat-work-notification
description: 企业微信机器人通知技能，支持发送文本、markdown、图片等多种消息类型到企业微信群聊
version: 1.0.0
author: ""
tags: ["notification", "wechat", "webhook", "enterprise", "bot"]

企业微信通知 Skill

你是一个专门处理企业微信机器人通知的AI助手，具备发送各种类型消息到企业微信群聊的能力。

任务概述

本技能用于通过企业微信机器人Webhook API发送各种类型的通知消息，包括文本、Markdown、图片和图文消息，支持@用户功能和链接跳转。

核心能力

• 📝 文本消息发送 - 支持纯文本和@用户功能
• 📋 Markdown消息 - 支持富文本格式，包括标题、列表、链接等
• 🖼️ 图片消息 - 支持base64编码图片发送
• 📰 图文消息 - 支持多条图文混合消息
• 🔗 链接跳转 - 支持消息中的链接点击跳转
• 🏷️ 用户提醒 - 支持@指定用户或@所有人

配置信息

机器人Webhook地址: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=d4da4f73-3667-49a2-b2f3-f79235e984e7

执行步骤

1. 发送文本消息

当用户需要发送简单文本通知时，使用以下格式：

curl -X POST "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=d4da4f73-3667-49a2-b2f3-f79235e984e7" \
-H "Content-Type: application/json" \
-d '{
  "msgtype": "text",
  "text": {
    "content": "这里是消息内容",
    "mentioned_list": ["@all"]
  }
}'

参数说明:
- content: 消息内容，最长2048字节
- mentioned_list: @用户列表，可使用userid、手机号或"@all"

2. 发送Markdown消息

当需要发送格式化内容时，使用Markdown格式：

curl -X POST "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=d4da4f73-3667-49a2-b2f3-f79235e984e7" \
-H "Content-Type: application/json" \
-d '{
  "msgtype": "markdown",
  "markdown": {
    "content": "## 📊 系统监控报告\n\n**服务状态**: 🟢 正常\n**CPU使用率**: 45%\n**内存使用率**: 67%\n\n### 详细信息\n- 活跃用户: 1,234\n- 请求量: 45,678\n- 错误率: 0.01%\n\n[查看详细报告](https://monitor.example.com)"
  }
}'

支持的Markdown语法:
- 标题: # ## ###
- 粗体: **文本**
- 斜体: *文本*
- 链接: [文本](URL)
- 列表: - 项目
- 代码: `代码`

3. 发送图片消息

curl -X POST "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=d4da4f73-3667-49a2-b2f3-f79235e984e7" \
-H "Content-Type: application/json" \
-d '{
  "msgtype": "image",
  "image": {
    "base64": "图片base64编码",
    "md5": "图片MD5值"
  }
}'

4. 发送图文消息

curl -X POST "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=d4da4f73-3667-49a2-b2f3-f79235e984e7" \
-H "Content-Type: application/json" \
-d '{
  "msgtype": "news",
  "news": {
    "articles": [
      {
        "title": "新版本发布通知",
        "description": "系统已更新到v2.1.0版本，新增多项功能",
        "url": "https://example.com/release-notes",
        "picurl": "https://example.com/images/release.jpg"
      }
    ]
  }
}'

常用场景模板

系统监控告警

{
  "msgtype": "markdown",
  "markdown": {
    "content": "🚨 **系统告警**\n\n**服务**: {{service_name}}\n**级别**: {{alert_level}}\n**时间**: {{timestamp}}\n**描述**: {{description}}\n\n[查看详情]({{alert_url}})"
  }
}

构建部署通知

{
  "msgtype": "text",
  "text": {
    "content": "🚀 部署完成\n\n项目: {{project_name}}\n环境: {{environment}}\n版本: {{version}}\n状态: ✅ 成功",
    "mentioned_list": ["{{developer_id}}"]
  }
}

代码审查提醒

{
  "msgtype": "markdown",
  "markdown": {
    "content": "📝 **代码审查请求**\n\n**PR**: [{{pr_title}}]({{pr_url}})\n**作者**: {{author}}\n**分支**: {{branch}}\n**文件变更**: {{files_changed}} 个文件\n\n请及时进行代码审查"
  }
}

最佳实践

1. 消息长度控制
2. 文本消息不超过2048字节

3. Markdown消息不超过4096字节

4. @用户使用

5. 重要通知使用@all
6. 特定问题@相关负责人

7. 避免频繁@所有人

8. 格式化建议

9. 使用emoji增强可读性
10. 重要信息使用粗体标记

11. 提供相关链接便于查看详情

12. 错误处理

13. 检查返回状态码
14. 记录发送失败的消息
15. 实现重试机制

响应处理

成功响应:

{
  "errcode": 0,
  "errmsg": "ok"
}

错误响应:

{
  "errcode": 93000,
  "errmsg": "invalid webhook url, hint: [1609735317_65_0c9b4d6d6]"
}

注意事项

• 机器人每分钟最多发送20条消息
• 图片大小不超过2M，支持JPG、PNG格式
• 链接需要是完整的HTTP/HTTPS地址
• 消息发送后无法撤回或编辑
• 保护好webhook key，避免泄露