企业官网建设流程全解析

企业微信告警消息太零散？用we-work-bot三行代码跑通群机器人推送

【免费下载链接】we-work-botA lite framework for wechat work bot. 轻量级企业微信群聊机器人框架。项目地址: https://gitcode.com/gh_mirrors/we/we-work-bot

we-work-bot 是一个面向 Python 工程师的轻量级企业微信群聊机器人消息推送框架，把群聊机器人 webhook 封装成链式调用，覆盖文本、Markdown、图片消息发送，以及定时推送和@提醒。过去从脚本里推一条群消息，要自己拼请求体、自己处理图片的 Base64 编码，脚本一复杂，发送逻辑就被埋在一堆样板代码里。

📍 定位与边界：we-work-bot 做什么、不做什么

we-work-bot 是一个出站消息推送工具：封装企业微信群聊机器人 webhook，支持 text、markdown、image 三种消息类型，并内置定时发送与发送计数。它不是完整的机器人服务，不做消息接收与回调处理，只负责往群里发消息。

• 适用：监控脚本、日报任务需要周期性把消息推到项目群
• 不适用：需要接收并回复群成员消息的交互式问答机器人

项目 README 中提到了另外两个"加料版"机器人项目，we-work-bot 走的是轻量路线：一个 Bot 类、仅依赖 requests 一个库，全部源码几百行，一遍就能读完。

🚀 安装并发送第一条企业微信机器人消息

环境要求 Python 3.5+，安装只需一条命令：

pip3 install weworkbot

from weworkbot import Bot as wBot # 替换为你的群聊机器人 webhook 地址 url = "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=XXX" wBot(url).set_text("hello world").send()

把 url 换成群机器人设置页里拿到的 webhook 地址即可发送。发送成功后，把最后一行换成.set_text("...").every(minute=30).run()就变成每 30 分钟定时发送。

🛠️ 三个常用推送场景

让日报按点自动推到项目群

如果日报需要固定时间进群、不依赖人手动触发，只要设置间隔并调用run()：

wBot(url).set_text("今日数据已更新").every(minute=30).run()

Bot 内部以线程循环执行，不需要再引入额外的调度器。

指标超阈值才发告警

监控任务不能每次轮询都刷屏，只在异常时发声。用一个返回布尔值的回调函数挂到check()上，决定本轮是否发送：

wBot(url).set_text("磁盘使用率超过 80%").check(check_disk).every(30).run()

再配上set_check_counter(5)，检查满 5 次后自动停止，避免故障持续期间不断刷屏。

紧急消息直接@到人

告警只有被责任人看到才有意义，可以按用户名或手机号指定@对象，也支持@all：

wBot(url).set_text("部署失败").set_mentioned_list(["zhangsan", "@all"]).send()

注意 markdown 类型消息不支持@，需要@提醒时使用 text 类型。

🏭 落地参考：监控告警群推送

背景：一个服务需要周期性检查服务器负载和数据库连接数。做法：把取指标、判断阈值写成一个函数，通过check()挂到机器人上，用every()设定轮询间隔；再设set_send_counter给发送次数封顶，连续异常也不会把群刷屏；如果需要通知多个群，用BotMgr集中登记多个 webhook 地址，一次性run()拉起所有机器人。效果：阈值越过的那一刻告警自动发出，不需要人工盯盘。

📚 示例、源码与求助入口

更多定时任务、计数器、多机器人组合用法可参考 example.py，核心发送逻辑在 weworkbot/bot.py，多机器人管理在 weworkbot/bot_mgr.py；接口规范以企业微信官方文档为准，CLI 工具和图文消息类型在开发计划中。遇到使用问题或发现 bug，可以在项目 issue 系统里反馈，也欢迎直接提交 PR。

一个高频问题：发送失败时，先核对 webhook 地址是否正确、网络能否访问 qyapi.weixin.qq.com 域名，再检查 markdown 语法是否合法。

we-work-bot 用克制的功能面换来低的理解成本：出站推送、定时发送、@提醒，都在几百行代码里。先运行pip3 install weworkbot，再照抄 example.py 里的第一段例子，第一条群消息几分钟内就能进群。

【免费下载链接】we-work-botA lite framework for wechat work bot. 轻量级企业微信群聊机器人框架。项目地址: https://gitcode.com/gh_mirrors/we/we-work-bot