3、Webhook基础：Webhook概念解析、企业微信群机器人Webhook地址获取、消息格式概览

3.1 什么是Webhook？说白了就是“反向回调”

很多刚接触自动化的朋友，一上来就被“Webhook”这个词唬住了。其实没那么玄乎。

我习惯这么解释：Webhook 就是“主动推送”。你想想看，我们平时写程序，通常是客户端去轮询服务器，“嘿，有新消息吗？”——这叫拉模式。而 Webhook 反过来，服务器一有动静，直接往你指定的 URL 丢一条数据过来——这叫推模式。

举个例子。你在企业微信群里配了一个机器人。当你的监控系统发现服务器 CPU 飙到 95%，它不需要你去查，而是直接通过 Webhook 把告警消息“推”到群里。这就是 Webhook 的典型场景。

我在项目中遇到过不少团队，还在用定时脚本轮询 API 来获取状态变更。其实完全没必要。用 Webhook 的话，实时性更好，而且省掉了大量无效请求。说白了，Webhook 就是让系统自己“说话”。

3.2 企业微信群机器人 Webhook 地址获取

好，理论说完了，咱们直接上手。怎么拿到一个群机器人的 Webhook 地址？

步骤其实很简单，我带你走一遍：

1. 打开企业微信，进入你要添加机器人的群聊
2. 点击右上角的“...”菜单，选择“群机器人”
3. 点击“添加机器人”，给它起个名字，比如“运维告警机器人”
4. 添加成功后，你会看到一个 Webhook 地址

这个地址长什么样？大概是这样：

https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=693a91f6-7f1e-4b2c-8e4a-abc123def456

嗯，这里要注意：这个 key 是唯一的，也是机器人的身份凭证。一旦泄露，别人就能往你的群里发消息了。我曾经见过有同事把 Webhook 地址直接硬编码在代码里，还上传到了公开的 GitHub 仓库……结果群里半夜被刷了一堆垃圾广告。所以，请务必把 Webhook 地址当作密码一样保管。

3.3 消息格式概览：企业微信机器人能发什么？

拿到 Webhook 地址后，我们就可以往群里发消息了。企业微信机器人支持多种消息类型，我挑最常用的几种给你讲讲。

3.3.1 文本消息（最常用）

文本消息是最基础的类型。你只需要构造一个 JSON，POST 到 Webhook 地址就行。

{
    "msgtype": "text",
    "text": {
        "content": "服务器 CPU 使用率已超过 90%，请及时处理！"
    }
}

我个人习惯在文本消息里加一些特殊标记，比如 @所有人：

{
    "msgtype": "text",
    "text": {
        "content": "【紧急】服务器 CPU 使用率已超过 90%，请及时处理！",
        "mentioned_list": ["@all"]
    }
}

这样消息发出去，群里所有人都会收到提醒。不过别滥用，不然容易被踢出群……

3.3.2 Markdown 消息（推荐）

如果你想让消息看起来更专业，Markdown 格式是更好的选择。它支持标题、列表、加粗、引用等。

{
    "msgtype": "markdown",
    "markdown": {
        "content": "# 系统告警通知\n" +
                   "> **服务器**: web-01\n" +
                   "> **指标**: CPU 使用率\n" +
                   "> **当前值**: 95%\n" +
                   "> **阈值**: 80%\n" +
                   "\n" +
                   "请相关同事立即排查！"
    }
}

我在项目中做过一个统计：使用 Markdown 格式后，告警的响应速度平均提升了 30%。为什么？因为信息结构清晰，值班人员一眼就能看到关键信息，不用在一堆纯文本里找重点。

3.3.3 图文消息（适合展示数据）

有时候你需要展示一些结构化的数据，比如日报、周报。图文消息（news）可以做到：

{
    "msgtype": "news",
    "news": {
        "articles": [
            {
                "title": "今日系统运行报告",
                "description": "整体运行平稳，无重大告警",
                "url": "https://example.com/report",
                "picurl": "https://example.com/pic.png"
            }
        ]
    }
}

不过说实话，图文消息在企业微信机器人里用得不多。我一般只在发送“周报汇总”这类场景才用。日常告警，文本和 Markdown 完全够用。

3.3.4 其他消息类型

企业微信机器人还支持图片、语音、文件等类型。但说实话，日常自动化运维中，90% 的场景用文本和 Markdown 就能搞定。图片和文件类型需要先上传到企业微信的临时素材库，流程稍微复杂一些，我们后面章节再细讲。

3.4 消息格式对比：选哪个？

我整理了一个表格，方便你快速对比：

消息类型	适用场景	优点	缺点
text	简单通知、告警	实现简单，支持 @成员	格式单一，不美观
markdown	结构化告警、日报	格式丰富，信息清晰	不支持 @所有人（需特殊处理）
news	周报、链接分享	可展示图片和链接	字段较多，配置稍复杂
image/file	截图、日志文件	直观展示	需先上传素材，流程繁琐

我的建议是：日常告警用 Markdown，简单通知用 text，特殊场景再用其他类型。这样既保证了效率，又不会让代码变得过于复杂。

3.5 实战：用 Python 发送第一条消息

说了这么多，咱们来写点代码。用 Python 发送一条文本消息到企业微信群，其实就几行：

import requests
import json

webhook_url = "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY_HERE"

data = {
    "msgtype": "text",
    "text": {
        "content": "Hello，这是来自 Python 的第一条消息！"
    }
}

response = requests.post(webhook_url, json=data)
print(response.json())

运行后，如果返回 {"errcode":0, "errmsg":"ok"}，恭喜你，第一条消息已经成功发送到群里了。

嗯，这里有个坑我要提醒你：企业微信对 Webhook 调用有频率限制。每个机器人每分钟最多发 20 条消息。我曾经在测试时写了个死循环，结果直接把机器人给封了……所以，生产环境中一定要加限流逻辑。

下一章，我们会深入讲解如何用 Python 封装一个通用的消息发送模块，让你能一键发送各种格式的消息。到时候，你会发现自动化运维其实没那么难。