Documents

Wework

Name: Wework
Author: zhangifonly

企业微信群机器人工具与服务端 API 指南。Use for: (1) 用附带的零依赖 CLI 向企微群发通知——文本/markdown/图片/文件, (2) CI/监控/日报自动化推送, (3) 企业微信服务端 API（通讯录/应用消息/客户联系）开发指导。WeCom (WeChat Work) group-ro...

What it does

附带零依赖 CLI（，仅 Python 标准库），agent 可直接向企微群发通知，比钉钉机器人多两个实用能力：**直接发图片** （图表截图秒达）和**直接发文件**（日志、报表附件）。

The skill document

企业微信 Skill

附带零依赖 CLI（scripts/wecombot.py，仅 Python 标准库），agent 可直接向企微群发通知，比钉钉机器人多两个实用能力：直接发图片 （图表截图秒达）和直接发文件（日志、报表附件）。

快速开始

# 群右键 → 添加群机器人 → 复制 webhook URL 里的 key= 部分
export WECOM_WEBHOOK_KEY=693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa

python3 scripts/wecombot.py text "部署完成 ✅" @all
python3 scripts/wecombot.py markdown report.md
python3 scripts/wecombot.py image chart.png
python3 scripts/wecombot.py file error.log

脚本行为声明：仅请求 qyapi.weixin.qq.com；image/file/markdown 命令读取指定的本地文件，不写本地文件。

命令手册

命令	作用	限制
`text <内容> [@userid,userid\|@all]`	文本消息	2048 字节
`markdown`	markdown 消息	4096 字节，支持``不支持表格
`image <图片文件>`	发图片（自动 base64+md5）	≤2MB，jpg/png
`file <文件路径>`	先传临时素材再发送	≤20MB

Agent 典型用法

图表直达：数据分析生成 PNG → image 直接发群里，不用先传图床（钉钉机器人做不到这点）
附件送达：异常日志、Excel 报表 → file 直接给到群
CI/监控/日报：与钉钉场景相同，text/markdown 推送
@ 提醒：text 的 mentioned_list 用企微 userid；只知道手机号时可用 mentioned_mobile_list（本脚本 @ 参数传 userid）

实战要点与错误码（实测）

errcode	含义	处理
93000	webhook key 无效	key 拼错或机器人被移除（报错信息会带查询链接）
45009	接口超限	每机器人 20 条/分钟，超限丢弃
40008	消息类型不支持	检查 msgtype 拼写

群机器人免认证免审批——不需要管理员开发权限，是企微自动化阻力最小的入口；服务端 API 则需要管理后台配置
markdown 与钉钉一样不支持表格；企微独有 `` 三色高亮（info 绿/comment 灰/warning 橙），做告警分级很好用
机器人只能发群消息，不能单聊、不能读消息；要读写单聊用服务端 API 的应用消息

服务端 API 速查（超出机器人能力时）

token：GET /cgi-bin/gettoken?corpid=&corpsecret=，7200 秒，中心化缓存； 不同 secret 权限不同（应用/通讯录/客户联系各一把）
应用消息（可单聊）：POST /cgi-bin/message/send，需 agentid，用户须在应用可见范围内
客户联系（外部联系人/客户群/朋友圈）是企微对微信生态的独有打通，也是 SCRM 系统的地基
回调验证：URL 验证用 AES 解密 echostr，消息体加解密用官方 WXBizMsgCrypt 库，别手写
参数以 developer.work.weixin.qq.com 文档为准

与钉钉/飞书机器人对比

能力	企微机器人	钉钉机器人（见 `dingding` skill）
文本/markdown	✅	✅（多 link 卡片）
直接发图片	✅ base64	❌ 只能 markdown 引外链图
直接发文件	✅ ≤20MB	❌
安全机制	key 即凭证	关键词/加签/IP 三选一
频控	20 条/分钟	20 条/分钟

本 skill 不做什么

不含个人微信自动化；企微侧自动化也应使用官方 API 而非协议逆向
群发与 @all 打扰面大，agent 使用前应向用户确认
第三方服务商应用（代开发/应用市场）的授权流程未展开，以官方文档为准

Related skills

diagram-generator

Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.

by nssa.io1.0k installs47 stars

Join meeting

Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.

by johnpatternai22 installs8 stars

Memory

Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.

by Iván559 installs18 stars

Productivity

Find why your productivity system keeps failing, then apply the smallest fix — capacity math, bottleneck routing, durable local notes.

by Iván855 installs69 stars

Git

Run Git operations — commits, branches, merges, rebases, conflict resolution, and recovery — with safety rules enforced.

by Iván535 installs31 stars

AdMapix

Fetch raw ad creative, app, ranking, and revenue data from AdMapix as structured JSON.

by fly0pants4.3k installs296 stars

More from zhangifonly

Browse all skills