Webhook Robot

🤖 Webhook 消息一键推送企业微信

通过 webhook 向企业微信等群聊机器人推送消息,支持命令行快速发送文本通知,适用于 CI/CD 告警、自动化脚本集成场景。

收藏
5.2k
安装
1.8k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

webhook-robot 是一个轻量级的 webhook 消息推送技能,目前主要支持企业微信(WeCom)群机器人。用户可通过 Python 脚本 send_wecom.py 发送文本消息到指定的群聊,支持两种参数方式:

  • --key:仅传入机器人 key,脚本自动拼接完整 URL
  • --url:直接传入完整的 webhook 地址

典型使用场景包括:

  • CI/CD 流水线构建结果通知
  • 服务器告警自动推送
  • 定时任务执行状态汇报

显著优点

1. 零依赖集成:仅需 Python3 和标准库,无需额外安装复杂 SDK
2. 命令行友好:适合脚本化调用,便于嵌入 Shell、Makefile 或 CI 配置

3. 多平台扩展性:架构设计预留了 DingTalk、Feishu 等平台的扩展接口

4. 配置灵活:支持命令行传参或配置文件(待实现)管理多个 webhook

潜在缺点与局限性

  • 功能单一:当前仅实现文本消息推送,不支持 Markdown、图文卡片、@人等富媒体格式
  • WeCom 独占:DingTalk、Feishu 等平台尚未实现,需用户自行扩展
  • 无重试机制:网络波动时可能丢消息,缺乏内置的指数退避或兜底逻辑
  • 安全风险:Webhook URL/Key 若硬编码在脚本中,存在泄露风险;建议配合环境变量或密钥管理工具使用

适合人群

  • DevOps 工程师、运维人员需要快速搭建轻量级通知通道
  • 开发者希望在自动化脚本中集成 IM 告警,但不想引入官方 SDK 的重度依赖
  • 小型团队或临时项目,对消息格式要求不高的场景

常规风险

| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 密钥泄露 | webhook key 泄露可能导致垃圾消息或钓鱼 | 使用环境变量或密钥管理系统,避免提交到版本库 |
| 网络不可达 | 企业微信 API 受网络环境影响 | 增加超时设置和重试逻辑(需自行实现) |
| 频率限制 | 企业微信有调用频次限制(20次/秒) | 高并发场景需增加队列或限速机制 |
| 消息伪造 | 无身份校验,知晓 key 即可发送 | 定期轮换 key,监控异常消息模式 |

Webhook Robot 内容

scripts文件夹
手动下载zip · 5.1 kB
send_dingtalk.pytext/plain
请选择文件