---
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. 发送文本消息

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

```bash
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格式：

```bash
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. 发送图片消息

```bash
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. 发送图文消息

```bash
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"
      }
    ]
  }
}'
```

## 常用场景模板

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

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

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

## 最佳实践

1. **消息长度控制**
   - 文本消息不超过2048字节
   - Markdown消息不超过4096字节

2. **@用户使用**
   - 重要通知使用@all
   - 特定问题@相关负责人
   - 避免频繁@所有人

3. **格式化建议**
   - 使用emoji增强可读性
   - 重要信息使用粗体标记
   - 提供相关链接便于查看详情

4. **错误处理**
   - 检查返回状态码
   - 记录发送失败的消息
   - 实现重试机制

## 响应处理

成功响应:
```json
{
  "errcode": 0,
  "errmsg": "ok"
}
```

错误响应:
```json
{
  "errcode": 93000,
  "errmsg": "invalid webhook url, hint: [1609735317_65_0c9b4d6d6]"
}
```

## 注意事项

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