Webhook 监控

快速阅读

Webhook 监控看平台向客户系统推送事件是否送达、是否被正确响应、失败后是否重试。它不是话单：推送失败不代表通话事实丢失。

• 关注推送事件、推送时间、目标地址、响应结果、失败原因、重试次数和响应耗时。
• 排查先确认推送配置，再看推送结果、客户响应、重试记录和话单事实。
• API 是客户主动调用；Webhook 是平台主动推送。

阅读地图

• 是什么：读「二」。
• 字段与失败分类：读「六」和附录 B。
• 联调与上线：读「七」和附录 C。

一、文档说明

平台可能在通话开始、响铃、接听、挂断、话单生成、机器人转人工、满意度完成等节点向客户系统推送事件，供 CRM 弹屏、工单关联、订单更新、数据同步和质检等使用。本文给技术负责人、实施、产品和运营说明 Webhook 监控的口径与排障路径。

本文主要说明事件推送监控。完整推送配置、客户侧接口开发和内部重试实现见对应专题或联调方案。

二、产品总览

Webhook 监控展示推送时间、事件类型、目标、结果、响应、失败原因和重试情况，帮助确认「平台有没有推、客户系统有没有收、收了之后有没有正确响应」。

主要回答：某通话事件是否推送、推到哪个地址、客户返回什么、是否重试及是否成功、失败是否影响业务流程、如何用通话标识与话单核对。

三、核心概念

四、对象关系与数据流

通话 / 机器人 / 满意度 / 业务事件发生
↓
平台生成推送事件
↓
向客户系统 Webhook 地址推送
↓
客户系统接收并返回响应
↓
Webhook 监控记录结果、耗时、失败原因和重试情况
↓
结合话单、客户系统记录和日志完成核对

推送是对业务事件的通知，不是业务事实本身。推送失败时，通话话单仍可能正常生成。

五、能力地图

六、产品功能说明

概览指标

明细字段与筛选

明细常见字段：推送时间、事件类型、推送目标、推送结果、响应状态、失败原因、响应耗时、重试次数、最后一次推送时间、通话标识、业务标识。

常见筛选：时间范围、事件类型、推送结果、失败原因、推送目标、通话标识、业务标识、是否重试。

失败原因分类

七、典型业务场景

未收到通话结束事件：按通话标识查是否产生推送、目标是否正确、客户是否响应成功；推送成功但客户仍称未收到，由客户侧排查接收和业务处理。

连续失败：按目标地址筛失败记录，判断地址不可达、超时或客户返回失败，通知客户系统负责人处理。

重试后成功：展示首次失败与后续重试结果，说明是否延迟送达。

上线联调：触发测试通话或事件，观察是否记录推送、客户是否按约定响应、字段能否与客户业务记录关联。

八、上线准备与运营建议

上线前确认：接收地址、推送事件范围、鉴权或签名、成功响应标准、失败重试策略、通话标识与业务标识对账方式；准备成功、失败、超时、重试等验收用例。

运营建议：联调看明细和客户响应；上线初期看失败率、耗时和重试；稳定期关注连续失败、地址变更和客户系统发布。推送失败后同时查看话单，确认通话事实是否沉淀。

九、与周边能力的关系

十、FAQ

推送失败是否代表通话失败？
不代表。只表示事件通知未成功送达或响应异常；通话事实以话单为准。

推送成功是否代表客户业务处理成功？
不一定。通常表示客户系统返回了约定成功响应；内部业务是否完成需客户侧确认。

是否可以重新推送？
是否支持人工重推取决于实际产品能力和项目配置。若支持，应受权限控制并记录操作。

十一、总结

Webhook 监控是事件推送链路的排障入口，用于确认是否送达、是否响应成功、是否重试成功；通话事实仍以话单为准。

附录 A：入口与权限

附录 B：关键字段口径

附录 C：实施检查清单

• 推送目标、事件范围、成功/失败/超时响应与重试策略已确认并验证。
• 通话标识可与话单关联；敏感字段脱敏已确认。

附录 D：常见问题速查