# 任意 Webhook， 直达手机 ，即时送达。

> 把任意 Webhook 变成手机推送通知。从 Stripe、GitHub、Zapier 或 n8n 向 Pocket Alert 的 URL 发送 POST 请求，不到一秒就能在手机上看到事件。

<!-- source: https://pocketalert.app/zh/use-cases/webhook-notifications -->

最后更新：2026-08-11

Pocket Alert 可以把任意 HTTP Webhook 变成你 iPhone 或 Android 上的推送通知。将 Stripe、GitHub、n8n 或你自己的后端指向你的接收地址，事件就会在一秒内出现在手机上，无需中间件，也无需邮件摘要。

## 三步完成你的第一条 Webhook 推送

1. **创建 Webhook** — 在 Webhooks 页面使用 GJSON 消息模板创建一个 Webhook。
2. **发送事件** — 复制接收地址，然后用任意服务或 curl 向它发送 JSON 请求体。
3. **接收推送** — 手机震动提醒。GJSON 占位符会把载荷中的嵌套字段放入推送内容。

## 让 Webhook 直达手机

Pocket Alert 可以把你已经在发出的 Webhook 变成手机上的推送通知。

- **纯 HTTP，无需 SDK** — 只需一次 HTTP POST 请求，载荷到达后即刻变为推送通知。
- **连接任意服务** — Stripe、GitHub、Sentry、Zapier、Make、n8n、IFTTT 以及你自己的后端都支持 Webhook，在这里全部可用。
- **映射任意载荷** — 消息模板中的 GJSON 占位符可从嵌套 JSON 中提取值，推送只显示真正重要的内容。
- **省去中间件** — 将源服务直接指向你的地址；如需重组数据，也可以通过自动化工具中转。
- **权限隔离，安全可靠** — 每个接收地址仅限一个 Webhook 和应用使用，slug 无法猜测，并通过 HTTPS 传输。
- **亚秒级送达** — 收到的 Webhook 在不到一秒内即可送达你的 iPhone 或 Android 设备。

## 发送你的第一个 Webhook

### 1. 创建 Webhook

在 [Webhooks](https://pocketalert.app/zh/webhooks) 页面，或通过 API 创建 Webhook，并设置 `name`、`application_id` 以及使用 GJSON 占位符处理入站载荷的 `message` 模板：

```
curl -X POST 'https://api.pocketalert.app/v1/webhooks' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"GitHub Push","message":"Push to %repository.name%: %head_commit.message%","application_id":"qm47b9pzxzxg"}'
```

### 2. 复制接收地址

Pocket Alert 会返回一个带唯一 slug 的入站地址。任何服务都可以将自己的 JSON 通过 POST 发送到这里：

```
https://p4a.me/wh/1234abcd
```

### 3. 将服务指向该地址

将接收地址粘贴到 Stripe Webhook、GitHub Webhook，或 Make / n8n 的 HTTP 步骤中。触发时，Pocket Alert 会根据载荷渲染你的模板。GJSON 路径可以访问嵌套字段（`%object.field%`）、数组项（`%items.0.name%`）、计数（`%users.#%`）或整个请求体（`*`）。[Webhook 设置文档](https://info.pocketalert.app/api/webhooks/settings.html)涵盖了所有占位符。

### 4. 设置响铃强度

如果发送方在 JSON 中包含 `"level"` 字段——从 `silent` 到 `critical`——推送就会采用对应优先级，因此支付失败可以[突破勿扰模式](https://pocketalert.app/zh/use-cases/critical-alerts)，而日常提醒保持安静。或者，你也可以在 Webhook 上一次性设置 `default_level`，之后无需再管。

## 常见问题

### Webhook 推送到手机是如何工作的？

在 Pocket Alert 中创建 Webhook 并设置消息模板后，你会获得一个接收地址，例如 https://p4a.me/wh/1234abcd。任何能发送 HTTP POST 请求的服务都可以调用它，包括 Stripe、GitHub、Make、n8n 或你自己的后端。请求内容会被渲染成一条推送通知，显示在你的手机上。

### 能否根据自定义载荷定制通知内容？

可以。消息模板支持 GJSON 占位符，例如 %repository.name% 或 %head_commit.message%，用于从嵌套 JSON 中提取值。因此，Stripe 事件或 GitHub 载荷都能只显示你关心的字段。

### 我可以连接哪些服务？

凡是能发送 HTTP 请求的服务都可以，例如 Stripe、GitHub、GitLab、Sentry、Zapier、Make.com、n8n、IFTTT 以及你自己的脚本。

### 是否需要在中间使用 Zapier 或 Make？

直接将源服务指向你的 Pocket Alert Webhook 地址即可。如果需要先转换数据，仍然可以通过 Zapier 或 Make 中转。

### Webhook 地址安全吗？

每个接收地址只对应一个 Webhook 和一个应用，其 slug 无法被猜测。流量通过 HTTPS 传输，你也可以随时在 Webhook 页面删除并重新创建 Webhook。

### Webhook 能否控制通知的响铃强度？

可以。在服务发送的 JSON 中加入 "level" 字段，取值为 silent、low、default、high 或 critical，推送就会采用对应的优先级。critical 级别的 Webhook 会在 Android 上突破勿扰模式，在 iPhone 上穿透专注模式。你还可以在 Webhook 本身设置 default_level，这样它转发的所有通知都会以合适的音量送达，无需修改发送方。
