# wecom_rebot_api

> 使用企业微信机器人api，发送企业微信群聊通知

- Author: Kurok1
- Repository: Kurok1/my-agent-skills
- Version: 20260129093659
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/Kurok1/my-agent-skills
- Web: https://mule.run/skillshub/@@Kurok1/my-agent-skills~wecom_rebot_api:20260129093659

---

---
name: wecom_rebot_api
version: v1.0
description: 使用企业微信机器人api，发送企业微信群聊通知
---

## 1) 能力描述（What）

从用户对话中获取企业微信群聊机器人的 webhook key（形如：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx）

调用企业微信机器人 API：https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=KEY

支持发送：

* text（纯文本）

* markdown（企业微信支持的 Markdown 语法子集）

## 2) 触发条件（When）

**用户说“发到企业微信/发到群机器人/用企业微信机器人发消息/推送到群”等**

**或用户提供了 key=... / “我的 key 是 ...” 并要求发送内容**

## 3) 输入与参数（Inputs）

* key：由用户在对话中提供（必需，但允许首次缺省后再追问）

* msgtype：text 或 markdown（默认 text）

* content：要发送的内容（必需）

* mentions（可选，仅 text 常用）：

* mentioned_list：要 @ 的成员 userid 列表（可选）

* mentioned_mobile_list：要 @ 的手机号列表（可含 "@all"）

## 4) 输出（Outputs）

发送成功：返回“已发送”并回显企业微信返回的 errmsg

发送失败：返回可操作的错误解释（常见：key 无效、内容格式不对、频率限制）

## 5) 状态管理（State）

* session.wecom_key：仅在当前会话有效（建议不要持久化到磁盘/数据库）

安全建议：

1. 不在日志中打印完整 key（只保留前后各 3~4 位用于排查）

2. 用户可以随时说“更新 key / 换 key”来覆盖

# 对话流程（推荐）

A. 第一次发送（用户未给 key）

* 助手：请提供企业微信群机器人 webhook 的 key（不是完整 URL 也可以）

* 用户：key 是 xxxx...

* 助手：收到。你要发送的内容是？（可选：让用户选 text/markdown）

* 用户：发送“xxx”

* 助手：调用 API，返回结果

B. 用户直接给 key + 内容

* 用户：用企业微信机器人发消息，key=xxx，内容：今天 18:00 发布

* 助手：解析参数→发送→回结果

C. 更新 key

* 用户：换一个 key=yyy

* 助手：覆盖 session key，并提示“已更新”

# 发送指令

## 发送text
```
KEY='用户提供的key'
CONTENT='这里是要发送的内容'

curl -sS "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=${KEY}" \
  -H 'Content-Type: application/json' \
  -d "{\"msgtype\":\"text\",\"text\":{\"content\":\"${CONTENT}\"}}"
```

## 发送markdown
```
KEY='你的key'
MD='**标题**\n> 引用内容\n- 列表1\n- 列表2'

curl -sS "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=${KEY}" \
  -H 'Content-Type: application/json' \
  -d "{\"msgtype\":\"markdown\",\"markdown\":{\"content\":\"${MD}\"}}"
```