# 你的 Webhook 不再是 黑盒 。

> 在 Pocket Alert 中查看每一次传入的 Webhook 调用：请求头、Payload、渲染后的消息和失败原因。最长保留一年的历史记录，轻松调试 Webhook 通知集成。

<!-- source: https://pocketalert.app/zh/features/webhook-history -->

最后更新：2026-08-11

记录每一次传入调用的请求头、负载、渲染后的消息和处理结果。当集成方信誓旦旦地说已经发出请求时，你可以亲自核实。

文档：https://info.pocketalert.app/api/webhooks/history.html

## 确认究竟收到了什么

1. **将服务指向它** — 像平时一样创建一个 Webhook，并把你的服务指向它的 URL。
2. **打开调用历史** — 在控制台中打开该 Webhook，点击进入它的调用历史。
3. **展开具体调用** — 展开任意一次调用，查看请求头、请求体、渲染后的消息以及失败原因。

## 失败的 Webhook 不会告诉你的一切

推送通知没有到达时，问题总是一样的：发送方到底有没有调用？如果调用了，我们这边哪里出了问题？

- **每个请求的日志** — 记录每一次调用，按最新排序，支持内联展开。方法、来源 IP、大小和内容类型一目了然。
- **完整的请求头与负载** — 按原样展示完整请求头和原始请求体，方便你对比服务声称发送的内容与实际发送的内容。
- **模板生成的内容** — 在负载旁边查看模板根据负载渲染出的消息。模板出错不再靠猜。
- **明确的失败原因** — 失败时会给出具体原因：JSON 无效、缺少 %path% 导致消息为空，或 Webhook 未启用。
- **脱敏与加密** — Authorization、Cookie 和 API 密钥相关的请求头在存储前会被脱敏，负载则使用你的密钥加密存储。
- **筛选、翻页或获取** — 在控制台中按结果筛选并翻页查看历史，也可以通过 API 获取数据，自行分析。

## Webhook 调用历史的工作原理

    
每个到达你 Webhook URL 的请求都会在处理前被记录，处理完成后再附上结果。这意味着失败的调用和成功的调用同样清晰可见，包括发送到你已禁用并早已忘记的 Webhook 的调用。

    
在控制台中打开某个 Webhook，即可看到它的调用历史，按最新排序。每一行都可以展开，查看查询字符串、完整请求头，以及经过 JSON 格式化的请求体。同样的数据也可以通过 REST API 获取，并按 `success` 和 `error` 进行筛选。

    
## 排查模板问题

    
最常见的失败通常不是网络问题，而是 `%path%` 占位符指向了发送方实际并未发送的字段。调用历史会把原始负载和模板生成的消息并排展示，通常几秒钟就能发现问题所在。

    
## 隐私

    
负载中往往包含敏感信息，因此负载会使用你的专属密钥加密存储，Authorization、Cookie 和 API 密钥相关的请求头在存储前会被替换为 `[redacted]`。保留期从免费套餐的 7 天到大型版的完整 1 年不等。

## 常见问题

### 每次 Webhook 调用会记录哪些内容？

时间戳、HTTP 方法、来源 IP、内容类型、查询字符串、完整请求头、原始请求体、负载大小、模板生成的消息、是否创建了推送通知；如果没有创建，还会记录失败原因，以及处理耗时。

### Webhook 调用历史保存多久？

免费套餐保留 7 天，入门版 30 天，中级版 90 天，大型版 365 天。超出保留期的调用会被自动删除；单个 Webhook 的记录超过 1,000 条时，最早的记录也会被自动删除。

### 存储的负载安全吗？

是的。负载会使用你的专属密钥加密存储，与消息内容的加密方式相同；Authorization、Cookie 和 API 密钥相关的请求头在存储前会被替换为 [redacted]。

### 服务显示已发送 Webhook，但什么都没收到，怎么办？

调用历史会告诉你具体原因。如果完全没有记录，说明发送方的请求没有到达我们这里。如果某次调用有错误记录，你会看到具体原因：JSON 无效、%path% 在负载中不存在导致消息为空，或 Webhook 已被禁用。

### 在哪里查看调用历史？

在控制台中打开对应的 Webhook，就能看到它的调用历史，按最新排序，每条调用都可以展开查看。如果你更想通过程序获取，也可以使用 REST 端点，并按成功或错误进行筛选。

### 免费套餐支持 Webhook 调用历史吗？

可以。免费套餐的保留期为 7 天。如果需要更长的保留期，可以升级到付费套餐。
