Agent Skills
返回列表
企微群机器人 Webhook 推送

企微群机器人 Webhook 推送

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 的后端或数据同学