Uptime Kuma 微信通知怎么配？企业微信群告警与恢复验收

Uptime Kuma 想把网站宕机告警发到微信？这里讲企业微信群机器人 Key 的配置、通知绑定、测试消息与故障恢复演练，以及显示发送成功却没收到的排查顺序。

Uptime Kuma 可以通过 WeCom（企业微信）群机器人发送监控消息。这里的「微信通知」指企业微信群，不是直接向个人微信好友发消息，也不是填一个普通微信群链接就能使用。

配置的主流程是三步：拿到群机器人的 Key，在 Uptime Kuma 创建通知方式，再把通知绑定到监控项。最后必须验证故障与恢复两种消息都能送达。

先确认你有哪种通知入口

Uptime Kuma 的 WeCom 通知配置源码包含 WeCom Bot Key 字段，使用的是企业微信群机器人的 Webhook Key。它不是企业 ID、应用 Secret，也不是长连接智能机器人的 ID。

因此，先在允许添加群机器人的企业微信群中创建一个机器人，复制它的 Webhook 地址。若组织管理策略不允许建机器人，需要由组织管理员处理；不能拿另一种机器人的凭据硬填进去。

Webhook 通常是下面这个形态，示例中的内容只是占位符：

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

Key 就是 key= 后面的参数值。完整链接和 Key 都能用于向群发消息，应像凭据一样保管，别放进代码仓库、文章截图或公开状态页。

进入 Uptime Kuma 的通知设置（不同版本也可从编辑监控项里的「设置通知」打开）：

这一步验证的是「监控服务能向企业微信发消息」。仅看到界面显示成功还不够：目标群里出现测试消息才算通过。

各部署版本提供的通知类型和字段可能不同。本文对照上游 WeCom 配置说明步骤；如果你的控制台没有 WeCom，先核对实例版本和已开放的渠道，不要推断所有托管套餐都已经开放这一项。

创建了通知方式，不代表已有的每一个监控项都会自动发送到这个群。打开需要接收告警的监控项，找到通知区域，选中刚创建的「核心接口告警群」，保存。

以下是可照填的初始配置示例，不是配置导入文件。检查地址要换成你自己的只读健康检查接口；不同版本的字段名称可能有差别。

监控名称：生产 API 健康检查
监控类型：HTTP(s)
URL：https://api.example.com/health
检查间隔：60 秒
请求超时：10 秒
重试次数：2
重试间隔：60 秒
通知：勾选「核心接口告警群」

这里把重试留给短暂抖动，代价是通知会晚于第一次失败。重试次数不是「连续失败总次数」的同义词；实际告警延迟还取决于首次检查时机、超时和重试间隔。请通过测试记录你部署版本的真实时间，不要把 60 秒检查间隔宣传成 60 秒内必定收到告警。

如果接口总是返回 200，但业务内容可能出错，应改用合适的内容检查，见关键字监控配置指南。本篇只解决消息从监控项送到群里的链路。

不要停生产服务来测试。建立一个专用的测试监控项，指向你自己控制的测试地址，保持告警规则与正式监控一致。

暂停监控不等于模拟故障。只点击「测试通知」也不等于完成演练，因为它没有覆盖探测、状态转换、重试和通知绑定。

本文未向真实企业微信群发送测试消息，也没有在生产监控中制造故障；实际接入时应在自己的测试监控项完成上述闭环。

测试消息也收不到： 检查机器人是否仍在目标群、Key 是否复制完整，以及运行 Uptime Kuma 的服务器能否访问企业微信 API。你电脑能打开企业微信，不代表服务器出站网络也畅通。检查日志时隐去 Key。

测试能收到，宕机收不到： 检查具体监控项是否勾选通知、是否暂停或处在维护期间，以及是否真的超过重试条件。单次探测失败未必触发 Down 通知。

群里有告警，手机没提醒： 查看企业微信客户端的群免打扰和系统通知权限；群消息送达与手机推送提示是两层链路。

一会儿掉线一会儿恢复： 先看检测点到目标服务的网络、响应时间和超时，再考虑调整重试。不要只把失败阈值调得很大，那可能掩盖真实故障。

希望短信或电话兜底： 不要把 WeCom 通道当短信服务。其他通道需要各自的账号、配置和可能的费用，应另行核实可用性。

不墨在线监控提供基于 Uptime Kuma 的托管服务。公开产品页确认支持多种探测、通知渠道和公开状态页，由平台负责部署与运维；具体通知类型以开通后的控制台为准，本文不承诺未展示的套餐价格或通知 SLA。

先添加一个关键接口，再跑通一条通知和一次恢复演练，最后扩展到其他站点。真正有用的监控是故障时能提醒负责的人、恢复时能明确告诉团队已经恢复。