核心用法
webhook-robot 是一个通用的 webhook 机器人消息推送技能,目前主要支持企业微信(WeCom)群组机器人。用户可通过命令行快速发送文本消息到指定群聊,无需登录客户端。
基础调用方式:
- 使用
--key参数传入企业微信机器人的 key - 或直接传入完整的 webhook
--url - 通过
--content指定消息内容
scripts/send_wecom.py --key <KEY> --content "告警信息" scripts/send_wecom.py --url <FULL_URL> --content "部署完成"
显著优点
1. 轻量无依赖:仅需 Python3 环境,无需额外库安装
2. 即开即用:支持命令行直接调用,方便脚本集成
3. CI/CD 友好:适合接入 Jenkins、GitHub Actions 等流水线,实现构建结果自动通知
4. 扩展潜力:架构预留多平台支持(钉钉、飞书等),未来可横向扩展
潜在缺点与局限性
- 平台覆盖有限:当前仅实现企业微信,钉钉、飞书等平台暂未支持
- 功能单一:仅支持纯文本消息,不支持 Markdown、卡片消息、@人等高级特性
- 配置待完善:
config.json持久化配置标记为 "to be implemented",当前需每次传参 - 无消息模板:缺乏预置消息格式,复杂内容需手动拼接字符串
适合人群
- 使用企业微信作为办公 IM 的中小技术团队
- 需要简单群通知能力的运维/开发人员
- 希望快速接入 webhook 告警的 DevOps 工程师
- 对消息格式要求不高的自动化场景
常规风险
1. Webhook URL 泄露:key 或完整 URL 若暴露在日志、代码仓库中,可能导致消息被恶意推送
2. 频率限制:企业微信对单机器人有调用频次上限(默认 20 次/秒),高频场景需控制节奏
3. IP 白名单:部分企业微信配置可能限制服务器出口 IP,需提前确认网络策略
4. 无确认回执:发送后无读取确认,重要告警建议配合其他通知渠道冗余备份