告警 Webhook

Webhook 是通知组支持的一种通知方式：告警触发时，平台向配置的回调 URL 推送一条包含告警详情的 JSON 消息，便于把告警接入您自己的系统做自动化处理（工单、值班系统、自建大屏等）。

配置方式

在左侧导航「告警」中点击「通知组」，创建或编辑通知组。
在「通知方式」中选择 webhook，填写回调 URL。
在告警规则中关联该通知组（见告警规则）。

告警触发时，平台会向该 URL 推送告警数据，内容包括：

告警规则信息：规则名称、告警级别、触发条件。
告警内容：触发的设备、触发时间、触发时条件命中的实际值。
设备属性快照：触发时刻设备的相关属性值。

与云函数配合

回调地址除了指向您自己的服务，也可以指向平台云函数。使用云函数时，函数入参中同样包含告警规则、告警内容与属性快照，并可在函数中访问项目上下文；函数处理完成需返回一个对象作为处理结果。适合在不搭建外部服务的情况下实现自定义告警逻辑（如按告警级别自动创建工单、联动其它设备）。

使用建议

回调接口应尽快返回，耗时的处理逻辑建议异步执行，避免阻塞重试。
请在接口侧做好幂等处理：同一告警在静默期后重复触发时会再次推送。
Webhook 推送不消耗短信/电话配额，适合作为高频率告警的低成本通知通道。

TIP

验证 Webhook 是否连通，可以在测试环境创建一条必然触发的告警规则（如设备在线触发），观察回调地址是否收到推送。