Webhook 日志
Webhook日志记录每一次出站Webhook投递记录,用于监控投递成功率、排查对接故障。入口:集成 → Webhook 日志。
#日志列表字段
| 列 | 说明 |
|---|---|
| Webhook | 触发本次投递的出站Webhook配置项 |
| 事件 | 事件类型,如lead.created |
| URL | 目标接收地址 |
| 状态 | 成功(2xx) / 失败(非2xx、超时) |
| 响应码 | 外部接口返回HTTP状态码 |
| 尝试次数 | 已经执行的投递重试次数 |
| 传递时间 | 最后一次投递的时间戳 |
#筛选条件
支持多维度过滤日志记录:
- 状态:成功 / 失败
- Webhook:指定某一条出站Webhook配置
- 日期范围:限定查询时间段
#查看完整详情
点击单条日志条目,展开完整信息:
- 请求原始JSON载荷
- 外部接口完整响应正文
- 每一次重试记录与对应时间戳
便于定位请求发送内容、外部系统返回的具体报错。
#手动重试失败投递
针对失败的日志条目,点击重试,使用原始载荷立即重新推送Webhook。适合外部服务临时宕机恢复之后补推数据。
#常见失败原因及处理方案
| 现象 | 解决方案 |
|---|---|
| 返回401 | 核对两端HMAC签名密钥是否完全一致 |
| 返回404 | 确认Webhook目标URL正确、接口服务正常 |
| 返回500 | 外部接口程序异常,查看对方服务日志 |
| 请求超时 | 外部接口处理过慢,调大接口侧超时时间 |
| 完全没有日志条目 | 检查Cron定时任务是否正常运行,Webhook投递依赖队列 |