# 你将在 订单到账的那一刻 。

> 每笔 Shopify、WooCommerce 或 Stripe 订单都会推送通知。将店铺 Webhook 指向 Pocket Alert，新订单和退款第一时间提醒你。

<!-- source: https://pocketalert.app/zh/use-cases/ecommerce-order-alerts -->

最后更新：2026-08-11

来自 Shopify、WooCommerce 或你自有店铺的每笔新订单，都会连同订单号、金额和客户信息发送到你的手机。订单一产生，你就能立即听到提示音。

## 三步开启订单提醒

1. **创建 Webhook** — 创建一个 Pocket Alert Webhook，并使用 GJSON 模板映射 order_number、total_price 和 customer，然后复制其接收 URL。
2. **将店铺指向它** — 在 Shopify 中为 Order creation 事件添加 Webhook，并将接收 URL 粘贴为目标地址。
3. **听到提示音** — 下一笔测试订单。销售信息会连同金额和客户一起发到你的手机上。

## 你的店铺，尽在手机上

只要店铺触发 Webhook，每笔销售、退款和支付失败都会立即发送到你的手机。

- **任何店铺，无需插件** — Shopify、WooCommerce、Stripe、Paddle 或自建店铺可直接将订单 Webhook POST 到你的 Pocket Alert URL。
- **金额与客户** — 映射订单金额、客户和商品，让推送内容读起来像一张真实的收据，而不是原始事件数据。
- **销售、退款、失败** — 新订单、退款或支付失败，各自都会作为独立的推送通知发送，且都来自同一个店铺 Webhook。
- **退款使用独立渠道** — 为 refunds/create 单独配置一个 Webhook，并绑定到独立的应用，退款就会与日常订单区分开，不会淹没在销售通知中。
- **不到一秒** — 订单从店铺发出后，不到一秒即可送达你的手机，无需刷新控制台。
- **每家店铺一个渠道** — 为每家店铺指定独立的应用，让两个品牌通过两个可以区分的渠道发出提醒。

## 连接 Shopify

### 1. 创建 Pocket Alert Webhook

定义名称，并编写一个 GJSON `message` 模板，用于映射 Shopify orders/create 的数据。此操作会返回你的入站接收 URL。

```
curl -X POST 'https://api.pocketalert.app/v1/webhooks' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Shopify Orders","application_id":"qm47b9pzxzxg","message":"Order #%order_number% · %total_price% %currency% · %customer.first_name% %customer.last_name%"}'
```

响应中包含一个 slug，接收 URL 即为 `https://p4a.me/wh/1234abcd`。你也可以在 [Webhooks](https://pocketalert.app/zh/webhooks) 页面创建。

### 2. 将接收 URL 粘贴到 Shopify

在 Shopify 中依次进入 设置、通知、Webhooks，然后点击 创建 Webhook。选择 `Order creation` 事件，格式选择 JSON，并将你的 Pocket Alert 接收 URL 粘贴为目标地址。

### 3. 映射字段

Shopify 会将订单 JSON POST 到你的接收 URL。模板会基于该数据进行渲染：`%order_number%`、`%total_price%`、`%currency%`、`%customer.email%`，以及第一个商品的 `%line_items.0.title%`。[文档](https://info.pocketalert.app/api/webhooks/settings.html)中列出了完整的 GJSON 路径。

## 常见问题

### 如何为新订单设置提醒？

在 Pocket Alert 中创建一个带消息模板的 Webhook，然后将其接收 URL 粘贴到 Shopify 的 设置、通知、Webhooks 中。Shopify 会在每笔订单产生时触发 orders/create Webhook，Pocket Alert 再将其渲染为推送通知。

### 提醒能显示金额和客户吗？

可以。你的 GJSON 模板会直接从 Shopify 数据中提取字段，例如 %order_number%、%total_price%、%currency% 和 %customer.first_name%，因此推送内容会显示为 "Order #1001 · 125.00 USD · Jane"。

### 支持哪些平台？

支持 Shopify、WooCommerce、BigCommerce，以及任何能发送 Webhook POST 请求的自建店铺。在模板中映射各平台自身的数据字段即可，无需额外插件，只需使用各平台自带的原生 Webhook。

### 退款能与销售区分开吗？

可以。为 orders/create 和 refunds/create 分别创建一个 Pocket Alert Webhook，并各自配置独立的应用，这样退款就会通过一个与日常销售区分开的渠道提醒你。

### 我有两家店铺，能分开管理吗？

为每家店铺分配一个独立的 Pocket Alert 应用。两个品牌对应两个渠道，推送内容会告诉你是哪一个店铺有了新动态。

### 能让大额订单比其他订单更醒目吗？

可以。每条消息都可以设置级别，从 silent（-2）到 critical（2）。你可以在后端发送大额订单时设置 level high，它们会以时效性推送的形式送达，并穿透 iPhone 专注模式；而每晚以 silent 级别发送的营收汇总则会进入历史记录，不发出声音。Webhook 本身也可以设置 default_level，因此大额订单的 Webhook 可以与常规订单流区分开，发出独立的提醒。
