企微群机器人 Webhook 推送
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_dca6a55a/qw-push-skill。
技能介绍
要解决什么问题
CI 跑完、监控告警或值班通知往往要落到企业微信群里,而不是只堆在邮件或控制台。企微群机器人走的是 webhook:给一个 https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=... 地址就能 POST JSON。难点在于不同类型消息的载荷字段不同(msgtype、@人、mentioned_mobile_list、模版卡片的 template_card 等),手写很容易错,文件类还要先 upload 拿 media_id。
技能如何工作
本技能提供自包含的入口脚本,仅依赖 python3 标准库,统一形如 python3 "$QW_PUSH" [webhook] <子命令> [options]。webhook 可作为第一个参数传入,或设置环境变量 QW_WEBHOOK。
- text / markdown:正文与 @ 规则(
userid、@all、手机号列表)按企微限制封装。 - image:本地 JPG/PNG 自动算 base64 与 md5。
- news / card / raw:支持从文件、字符串或 stdin 读 JSON;
-t/--template可加载templates/下完整载荷,配合-n/--dry-run先预览再改值发送。 - file:先
upload(stdout 输出media_id)再file发送;注意 3 天有效期且绑定本机器人。
非 2xx 或 errcode!=0 时脚本非零退出并在 stderr 打印企微原始响应,便于流水线判失败。
边界与注意
普通 webhook 群机器人是只发不收:button_interaction、vote_interaction、multiple_interaction 会因无回调返回 errcode=41106,连展示都不行;text_notice / news_notice 可正常发。频率约每分钟 20 条(45009 限流)。webhook 等同发消息密钥,勿进 git 或公开渠道。
使用场景
- CI 流水线在构建失败时用 markdown 子命令带颜色标记,把日志摘要推到发布群
- 监控告警触发后,用 text 的 `-m` 按 userid @ 值班人,避免群里漏看
- 周报需要 1~8 条外链摘要时,用 news 子命令从 JSON 文件或 stdin 组装图文消息
- 要把截图或二维码发到群验证时,用 image 子命令上传本地 JPG/PNG 并自动处理 base64
适合人员
- 负责 Jenkins/GitLab CI 脚本、需要在企微群同步构建红绿状态的发布工程师
- 值班 SRE 要把 Prometheus/自定义告警文本推到值班群并 @ 指定 userid 的运维
- 用 cron 跑周报脚本、要把多篇文章标题与链接收成一条企微图文消息的编辑或运营
- 需要把报告 PDF 先 upload 再 file 发到项目群、且要在 shell 里捕获 media_id 的后端或数据同学