返回博客

Shopify 订单通知:每笔新订单都推送到手机

Shopify 订单通知:每笔新订单都推送到手机

新订单是每位店主最想第一时间知道的事件。店铺刚起步时,你可能一天要刷二十次后台。之后如果有了打包员、负责售后的合作伙伴,或是替你发货部分商品的供应商,他们都希望在顾客开始询问物流之前就知道有新订单。

Shopify 本身就提供了两种接收订单通知的方式,在添加其他方案之前值得先了解。本指南会介绍这两种方式,然后通过 Shopify 后台的一个 Webhook,为每笔订单设置一条 Pocket Alert 推送。整个过程大约五分钟,而且无需在店铺里安装任何东西。

Shopify 自带的通知

Shopify 应用。 在 iPhone 和 Android 上,Shopify 应用可以为新订单发送推送:打开应用中的 设置 → 通知(Android 上为 Store notifications),开启订单推送。在 iPhone 上,它还能用角标显示未处理的订单数量。对你来说这很好用,但问题是,每个需要接收推送的人都必须以有订单权限的员工身份登录 Shopify 应用。

员工通知邮件。 在 设置 → 通知 → Staff notifications 中,Shopify 默认会向店主发送"New order"邮件,你也可以添加收件人,可以是员工,也可以是任意邮箱地址。它免费且稳定,但毕竟是邮件,容易和电子报、收据混在一起,而且收到邮件时不会有提示音。

如果这两种方式已经够用,就不必往下看了。当你需要以下功能时,Pocket Alert 推送会更有价值:

  • 没有 Shopify 席位的手机。 推送会发送到每一部登录你 Pocket Alert 账户的手机,支持 iOS 和 Android。打包员或合作伙伴无需在你的店铺里拥有员工账户。
  • 通知级别。 常规订单可以静默送达,大额订单则可以突破专注模式。每个级别在 Android 上都有独立的通知渠道,因此你可以关闭其中一个,同时保留另一个。
  • 可搜索的历史记录。 每条推送都会保留在应用中,控制台还会记录 Shopify 发来的每一次请求,订单似乎缺失时非常有用。
  • 所有通知集中在一个应用里。 订单与你的 Stripe 支付、可用性监控和服务器告警会出现在同一个列表中。
  • 操作按钮。 推送可以带一个 Open order 按钮,点击后直接跳转到后台中的该订单。

你需要准备

  • 一个 Shopify 店铺,并且有权限访问 设置 → 通知。
  • 一个 Pocket Alert 账户,以及手机上的 应用。免费套餐即可完成本指南:每天 50 条消息、1 台设备、1 个 Webhook。操作按钮、更多设备和更多 Webhook 需要付费套餐。

第一步:创建 Pocket Alert Webhook

在控制台中打开 Webhooks,然后创建一个 Webhook:

  • 名称: Shopify orders。Pocket Alert 会将其用于推送标题,标题会显示为"Webhook Shopify orders"。
  • 默认优先级: 暂时选择 Default。
  • 消息: 使用下面的模板。
%name% · %total_price% %currency% · %customer.first_name%
%line_items.0.title% · %line_items.#% products

每个 %...% 都是指向 Shopify 所发送 JSON 的路径。以下是 orders/create 载荷中的真实字段:

  • name 是顾客看到的订单名称,例如 #1042。(order_number 是同一个数字,但不带 #。)
  • total_price 和 currency 分别是订单总额和店铺货币。
  • customer.first_name 是顾客的名字。没有关联顾客的订单(例如部分 POS 销售)该字段为空。
  • line_items.0.title 是第一件商品,line_items.# 统计订单的行数,也就是不同商品的种类数,而不是总件数。

保存 Webhook,并复制其接收 URL。它看起来像 https://p4a.me/wh/abc123...。

第二步:在 Shopify 中添加 Webhook

  1. 在 Shopify 后台进入 设置 → 通知。
  2. 点击 Webhooks,然后点击 Create webhook。
  3. 事件: 选择 Order creation。事件创建后无法更改。
  4. 格式: 选择 JSON。Pocket Alert 只接受 JSON,使用 XML 将收不到推送。
  5. URL: 填入你的 https://p4a.me/wh/... 接收 URL。
  6. Webhook API 版本: 选择列表中最新的稳定版本。本指南用到的字段在近期所有版本中都有。
  7. 点击 Save。

如果你不在电脑旁,Shopify 手机应用中也有同样的页面,路径是 Store settings 部分的 设置 → 通知 → Webhooks。

现在点击新 Webhook 的 ... 菜单,选择 Send test。Shopify 会发送一个示例订单,一秒钟内你的手机上就会显示:

Webhook Shopify orders
#9999 · 404.95 USD · John
Aviator sunglasses · 5 products

这是 Shopify 的示例数据。之后的真实订单会以相同的方式送达,只是内容为真实数值。

第三步:进一步优化

选择通知级别

Shopify 的载荷中没有 level 字段,因此每条推送都会采用 Webhook 的默认优先级。你可以根据订单量来选择:

  • 每天几笔订单: 选 High。在 iPhone 上它是时效性通知,能突破专注模式。
  • 每天几十笔订单: 选 Low。它们会静默积累在应用中,你想看的时候再看,同时其他提醒依然保持响亮。

随时可以在控制台中编辑 Webhook 来修改。优先级级别文档说明了每个级别在 iOS 和 Android 上的具体效果。

添加 Open order 按钮

Shopify 后台的订单链接形如 https://admin.shopify.com/store/<store>/orders/<id>,其中 <store> 是 .myshopify.com 之前的部分,<id> 是订单的数字 id,Webhook 载荷中已包含该字段。有了这些,就可以创建按钮了。

控制台目前还没有设置按钮的字段,所以需要通过一次 API 调用来设置。你需要一个来自 API Keys 的 API 密钥。先找到 Webhook 的 tid:

curl -s https://api.pocketalert.app/v1/webhooks -H 'Token: YOUR_API_KEY' \
  | jq -r '.[] | "\(.tid)  \(.name)"'

然后添加按钮,并将 your-store 替换为你的店铺标识:

curl -X PUT https://api.pocketalert.app/v1/webhooks/WEBHOOK_TID \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"actions": "[{\"type\":\"view\",\"label\":\"Open order\",\"value\":\"https://admin.shopify.com/store/your-store/orders/%id%\"}]"}'

actions 是一个 JSON 字符串,因此内层引号需要转义。%id% 占位符会由每笔订单自动填充。在 Android 上,按钮显示为"Open order";iOS 则对这类按钮显示标准的 Open 标签。操作按钮是付费功能。免费套餐下推送依然会送达,只是没有按钮。

取消订单和退款

Shopify 为这两类情况提供了独立的事件。为每种事件分别创建一个 Pocket Alert Webhook(免费套餐只有 1 个 Webhook,Starter 套餐有 5 个),然后添加对应事件的 Shopify Webhook:

Shopify 事件Pocket Alert 名称模板
Order cancellationShopify cancelled%name% cancelled · %cancel_reason% · %total_price% %currency%
Refund createShopify refundRefund %transactions.0.amount% on order %order_id% · %note%

退款载荷不包含订单名称,只有数字形式的 order_id,因此最快的方法是使用相同的 Open order 按钮,并将 %order_id% 替换为 %id%,这样就能看出是哪笔订单。一次退款可能包含多笔交易,模板只显示第一笔。建议将退款 Webhook 设为 High,让它与普通销售通知有所区分。

大额订单和库存不足:使用 Shopify Flow

Pocket Alert 模板可以展示字段,但无法对字段进行比较,因此它无法判断 500 件的订单比 20 件的订单更值得提醒。Shopify Flow 可以做到这一点。它是一款免费的 Shopify 应用,其 Send HTTP request 动作适用于 Grow、Advanced 和 Plus 套餐。Basic 套餐可以使用 Flow,但没有这个动作,因此本节内容在该套餐下无法实现。

Flow 可以直接调用 Pocket Alert API,让你自定义标题、级别和按钮。首先,在 Flow → Settings 中添加一个密钥,名称为 pocketalert,值为你的 API 密钥。

大额订单的高优先级推送

  1. 新建工作流,触发器选择 Order created。
  2. 条件:order.totalPriceSet.shopMoney.amount 大于或等于 500。
  3. 动作选择 Send HTTP request:
    • Method: POST
    • URL: https://api.pocketalert.app/v1/messages
    • Headers: Token = {{secrets.pocketalert}},Content-Type = application/json
    • Body:
{
  "title": "Big order {{order.name}}",
  "message": "{{order.totalPriceSet.shopMoney.amount}} {{order.totalPriceSet.shopMoney.currencyCode}} · {{order.customer.firstName}}",
  "level": "high",
  "actions": [
    {"type": "view", "label": "Open order",
     "value": "https://admin.shopify.com/store/your-store/orders/{{order.legacyResourceId}}"}
  ]
}

Flow 变量使用 GraphQL Admin API 的命名方式,因此这里是驼峰式,而 Webhook 模板中是下划线式。legacyResourceId 与 Webhook 中称为 id 的数字 ID 相同。

一个不错的组合是:常规 Webhook 保持 Low,大额订单由 Flow 以 High 发送。如果某笔订单需要有人立即处理,可以使用 critical。在付费套餐上,它能突破勿扰模式;在免费套餐上,它会按 high 发送。

库存不足

使用触发器 Product variant inventory quantity changed,并设置两个条件,这样库存跨过阈值时只推送一次,而不是每卖掉一件就推送一次:

  • productVariant.inventoryQuantity 小于 5
  • inventoryQuantityPrior 大于或等于 5

然后使用相同的 HTTP 请求动作,Body 如下:

{
  "title": "Low stock: {{product.title}}",
  "message": "{{productVariant.title}}: {{productVariant.inventoryQuantity}} left",
  "level": "default"
}

两个 Body 都需要注意一点:Flow 会原样插入变量值。如果商品标题中包含双引号,就会生成无效的 JSON,API 会拒绝该请求。请保持标题为纯文本,或直接去掉该字段。

诚实说明的局限

  • Pocket Alert 不校验 Shopify 签名。 Shopify 会为每个 Webhook 附加 HMAC 签名头。Pocket Alert 会接受发送到你接收 URL 的任何 JSON,因此 URL 本身就是秘密。不要把它公开发布。如果你需要校验签名,可以在中间加一个小型函数来验证签名,然后再调用 Pocket Alert API。
  • 免费套餐每天上限为 50 条消息。 超过后,Pocket Alert 会向 Shopify 返回错误,直到限额重置。Shopify 会重试失败的投递,如果某个 Webhook 持续失败,Shopify 会将其删除。如果你每天的订单超过约 40 笔,请使用付费套餐,否则 Webhook 可能会消失。
  • Webhook 标题是固定的。 Webhook 推送的标题始终是"Webhook"加上 Webhook 的名称。如果要自定义标题,请按上文所示使用 Flow 和 API。
  • iOS 按钮标签是通用的。 Android 显示你设置的标签,iOS 显示 Open。

如果没有收到推送

  • 打开 Webhook 历史记录。 在控制台中,可以看到 Shopify 发来的每一次请求,包括请求头、Body、渲染后的消息和状态。如果列表为空,说明 Shopify 没有调用该 URL,请检查 URL 是否完整粘贴。
  • 查看是否出现"Invalid JSON"。 说明 Shopify 的 Webhook 格式被设为 XML。请在 Shopify 中编辑该 Webhook,将格式改为 JSON。
  • 推送中的字段为空。 路径写错,或该订单缺少此字段。将模板与历史记录中的 Body 对比;例如,POS 订单的 customer 可能为空。
  • Shopify 中的 Webhook 消失了。 它连续失败次数过多,通常是 URL 错误或达到了每日上限。请排除原因后重新添加。
  • Flow 请求失败。 打开工作流的运行日志。401 表示密钥中的 API 密钥有误;400 通常表示 Body 不是有效的 JSON。

常见问题

这个方案能用于 Shopify Basic 套餐吗?

可以。主要设置只需使用 设置 → 通知 中的 Webhooks 页面。只有 Flow 部分需要 Grow、Advanced 或 Plus 套餐。

员工不用 Shopify 账户也能收到订单推送吗?

可以。推送会发送到登录你 Pocket Alert 账户的手机,Shopify 只负责发送 Webhook。免费套餐允许 1 台设备,付费套餐允许更多。

两个店铺的订单可以都发送吗?

可以。为每个店铺分别创建一个 Webhook,并各自命名,例如"Shopify EU"和"Shopify US"。名称会显示在推送标题中,方便区分。你还可以把每个 Webhook 发送到不同的 Pocket Alert 应用中。

Stripe 或 WooCommerce 怎么办?

Stripe 有单独的指南:Stripe 支付通知。对于其他平台,电商订单提醒页面展示了相同的思路,任何能发送 JSON Webhook 的服务都可以配合 Webhook 工具使用。

免费注册账户,把一个 URL 粘贴到 Shopify 中,下一笔订单就会直接提醒到你的手机上。

分享这篇文章