ブログに戻る

Shopify注文通知:新規注文ごとにiPhone・Androidへプッシュ通知

Shopify注文通知:新規注文ごとにiPhone・Androidへプッシュ通知

新規注文は、ストアのオーナーがいち早く知りたいイベントです。始めたばかりの頃は、1日に何十回も管理画面を開いて確認するかもしれません。その後、梱包担当、問い合わせ対応のパートナー、一部商品を発送してくれる仕入れ先などが関わるようになると、お客様から「注文した商品はまだ?」と問い合わせが来る前に、全員が売上を把握しておく必要が出てきます。

Shopifyには、注文を知るための方法がすでに2つ用意されています。何かを追加する前に、まずこれらを知っておくとよいでしょう。このガイドでは両方を紹介したうえで、Shopify管理画面でWebhookを1つ追加し、注文ごとにPocket Alertのプッシュ通知を届ける設定を説明します。所要時間は約5分で、ストアには何もインストールしません。

Shopifyの標準機能でできること

Shopifyアプリ。 iPhoneとAndroidでは、Shopifyアプリから新規注文のプッシュ通知を送れます。アプリで 設定 → 通知(Androidでは ストアの通知)を開き、注文のプッシュ通知をオンにしてください。iPhoneでは、未処理の注文数をバッジで表示することもできます。使い勝手は良好ですが、一つ注意点があります。この通知を受け取る人は全員、注文へのアクセス権があるスタッフアカウントでShopifyアプリにログインしている必要があります。

スタッフ向け通知メール。 設定 → 通知 → スタッフ通知 では、初期設定でストアオーナー宛に「新規注文」のメールが送られます。スタッフや任意のメールアドレスを受信者として追加することもできます。無料で確実に届きますが、メールなので、ニュースレターや領収書と同じ場所に並び、通知音も鳴りません。

この2つで十分なら、ここで設定を終えても構いません。Pocket Alertのプッシュ通知を追加する価値があるのは、これらにはない次のような場合です。

  • Shopifyのスタッフ権限がないスマホにも届けたい場合。 Pocket Alertアカウントにログインしているすべてのスマホ(iOSまたはAndroid)に通知が届きます。梱包担当やパートナーにストアのスタッフアカウントを与える必要はありません。
  • 通知の重要度を分けたい場合。 通常の注文は静かに届け、大口注文だけ集中モードを突破させることができます。Androidでは重要度ごとに通知チャンネルが分かれるため、片方だけミュートしておくことも可能です。
  • 検索できる履歴が欲しい場合。 すべての通知はアプリに残ります。コンソールには、Shopifyから送られたリクエストのログも保存されるため、注文が届いていないように見えるときの確認に役立ちます。
  • 通知を1つのアプリにまとめたい場合。 注文通知も、Stripeの決済通知、死活監視、サーバーアラートと同じフィードに届きます。
  • ボタンを付けたい場合。 通知に 注文を開く ボタンを付けると、管理画面の注文ページに直接移動できます。

必要なもの

  • Shopifyストアと、設定 → 通知 へのアクセス権。
  • Pocket Alertのアカウントと、スマホにインストールしたアプリ。このガイドは無料プランでも設定できます。無料プランでは1日50件のメッセージ、デバイス1台、Webhook 1つまで利用できます。ボタン、より多くのデバイス、追加のWebhookは有料プランで利用できます。

ステップ1:Pocket AlertのWebhookを作成する

コンソールで Webhook を開き、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をコピーします。URLは https://p4a.me/wh/abc123... のような形式です。

ステップ2:Shopifyに Webhook を追加する

  1. Shopify管理画面で 設定 → 通知 を開きます。
  2. Webhook をクリックしてから、Webhookを作成 をクリックします。
  3. イベント: Order creation。イベントはあとから変更できません。
  4. フォーマット: JSON。Pocket AlertはJSONのみ受け付けます。XMLで送るとプッシュ通知は届きません。
  5. URL: https://p4a.me/wh/... の受信用URL。
  6. Webhook APIバージョン: 一覧から最新の安定版を選びます。ここで使うフィールドは、最近のすべてのバージョンに含まれています。
  7. 保存 をクリックします。

パソコンから離れている場合は、Shopifyモバイルアプリの 設定 → 通知 → Webhook(ストア設定セクション内)でも同じ画面を開けます。

次に、新しいWebhookの ... メニューをクリックし、テスト送信 を選びます。Shopifyがサンプルの注文を送信し、1秒以内にスマホに次の通知が表示されます。

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

これはShopifyのサンプルデータです。次に実際の注文が入ると、同じ形式で実際の値が届きます。

ステップ3:さらに使いやすくする

重要度を選ぶ

Shopifyのペイロードには level フィールドがないため、すべての通知はWebhookのデフォルトの優先度になります。注文数に応じて選んでください。

  • 1日に数件の注文: High。iPhoneでは時間に敏感な通知として扱われ、集中モードも突破します。
  • 1日に数十件の注文: Low。通知はアプリに静かに溜まり、好きなときに確認できます。ほかの重要な通知は引き続き音で知らせます。

後からコンソールでWebhookを編集すれば、いつでも変更できます。各重要度がiOSとAndroidでどう動作するかは、優先度レベルのドキュメントで確認できます。

「注文を開く」ボタンを追加する

Shopifyの管理画面の注文URLは https://admin.shopify.com/store/<store>/orders/<id> の形式です。<store> は .myshopify.com の前の部分、<id> は注文の数値 id で、Webhookのペイロードに含まれています。ボタンを作るにはこれで十分です。

コンソールにはまだボタンを設定する項目がないため、APIを1回呼び出して設定します。まず APIキー で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% プレースホルダーには、各注文のIDが自動的に入ります。Androidではボタンに「Open order」と表示され、iOSではこの種類のボタンに標準の Open ラベルが表示されます。ボタンは有料機能です。無料プランでも通知は届きますが、ボタンは表示されません。

キャンセルと返金

Shopifyには、これらに対応する別のイベントがあります。それぞれにPocket AlertのWebhookを作成し(無料プランはWebhook 1つ、スタータープランは5つまで)、対応するイベントのShopify Webhookを追加してください。

ShopifyのイベントPocket Alertの名前テンプレート
注文キャンセルShopify cancelled%name% cancelled · %cancel_reason% · %total_price% %currency%
返金の作成Shopify refundRefund %transactions.0.amount% on order %order_id% · %note%

返金のペイロードには注文名が含まれず、数値の order_id だけが含まれます。そのため、%order_id% の代わりに %id% を使った同じ 注文を開く ボタンが、どの注文の返金かを素早く確認する最も簡単な方法です。返金には複数の取引が含まれる場合がありますが、テンプレートには最初の取引だけが表示されます。返金のWebhookは High に設定すると、売上の通知と区別しやすくなります。

Shopify Flowで大口注文と在庫切れを通知する

Pocket Alertのテンプレートは項目を表示できますが、比較はできません。そのため、「500件の注文は20件の注文より重要だ」といった判断はできません。Shopify Flowならそれができます。Flowは無料のShopifyアプリで、HTTPリクエストを送信 アクションは Grow、Advanced、Plus プランで利用できます。Basicプランでは Flow は使えますが、このアクションは使えないため、このセクションの設定はできません。

Flowから Pocket Alert APIを直接呼び出せば、タイトル、重要度、ボタンを自由に設定できます。まず Flow → 設定 で、ハンドルが pocketalert、値が自分のAPIキーのシークレットを追加してください。

大口注文を強く通知する

  1. 新しいワークフローを作成し、トリガーに 注文が作成されたとき を選びます。
  2. 条件:order.totalPriceSet.shopMoney.amount が 500 以上。
  3. アクション HTTPリクエストを送信:
    • メソッド: POST
    • URL: https://api.pocketalert.app/v1/messages
    • ヘッダー: Token = {{secrets.pocketalert}}、Content-Type = application/json
    • 本文:
{
  "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 として送信されます。

在庫切れ

トリガーに 商品バリアントの在庫数が変更されたとき を選び、次の2つの条件を設定します。これにより、在庫が基準を下回るたびに通知するのではなく、基準を下回った瞬間に1回だけ通知されます。

  • productVariant.inventoryQuantity が 5 未満
  • inventoryQuantityPrior が 5 以上

そのうえで、同じHTTPリクエストアクションを使い、本文は次のようにします。

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

どちらの本文にも共通する注意点があります。Flowは値をそのまま挿入します。商品名に二重引用符が含まれていると、JSONが不正になり、APIはリクエストを拒否します。商品名は記号を含まない形にするか、その項目を省いてください。

制限事項

  • Pocket AlertはShopifyの署名を検証しません。 Shopifyは各Webhookに HMAC ヘッダーで署名します。Pocket Alertは受信用URLに送られたすべてのJSONを受け付けるため、URLそのものが秘密情報になります。公開の場には貼り付けないでください。署名の検証が必要な場合は、間に小さな関数を置いて署名を確認してから、Pocket Alert APIを呼び出してください。
  • 無料プランは1日50件までです。 上限を超えると、上限がリセットされるまでPocket AlertはShopifyにエラーを返します。Shopifyは失敗した配信を再試行し、Webhookが失敗を繰り返すと削除します。1日に約40件以上の注文がある場合は、有料プランを利用するか、Webhookが消えてしまう可能性があることを念頭に置いてください。
  • Webhookのタイトルは固定です。 Webhookの通知は常に「Webhook」とWebhookの名前がタイトルになります。独自のタイトルを設定するには、上で説明したとおりFlowとAPIを使ってください。
  • iOSのボタンラベルは汎用的です。 Androidではラベルが表示されますが、iOSでは Open と表示されます。

通知が届かないとき

  • コンソールで Webhookの履歴 を開きます。Shopifyから送られたすべてのリクエストが、ヘッダー、本文、生成されたメッセージ、ステータスとともに記録されています。一覧が空の場合、ShopifyがURLを呼び出していません。URLが全体を正しくコピーされているか確認してください。
  • 「Invalid JSON」を確認します。 ShopifyのWebhookのフォーマットがXMLに設定されている可能性があります。Shopifyでそのその Webhookを編集し、フォーマットをJSONに切り替えてください。
  • 通知の項目が空になる。 パスが間違っているか、その注文にフィールドがありません。テンプレートを履歴の本文と比較してください。たとえば、POS注文では customer が空になることがあります。
  • ShopifyからWebhookが消えた。 連続して失敗しすぎたことが原因で、多くはURLの誤りか1日の上限です。原因を解消してから、Webhookを追加し直してください。
  • Flowのリクエストが失敗した。 ワークフローの実行ログを開いてください。401はシークレットのキーが間違っていることを、400は通常、本文が有効なJSONではないことを示します。

よくある質問

Shopify Basicプランでも使えますか?

はい、使えます。基本の設定では 設定 → 通知 のWebhookページだけを使用します。Flowのセクションのみ、Grow、Advanced、またはPlusプランが必要です。

スタッフはShopifyアカウントがなくても注文の通知を受け取れますか?

はい、受け取れます。通知はPocket Alertアカウントにログインしているスマホに届き、Shopifyが関わるのはWebhookを送信するところまでです。無料プランでは1台のデバイスのみ利用できます。有料プランではより多くのデバイスを利用できます。

2つのストアの注文を送れますか?

はい、ストアごとにWebhookを作成し、それぞれに「Shopify EU」「Shopify US」のような名前を付けてください。名前はプッシュ通知のタイトルに表示されるため、区別できます。また、それぞれを別のPocket Alertアプリケーションに送ることもできます。

StripeやWooCommerceの場合はどうすればよいですか?

Stripeについては専用のガイドがあります:Stripeの決済通知。ほかのプラットフォームについては、ECサイトの注文アラートページで同じ仕組みを紹介しています。JSONのWebhookを送信できるサービスであれば、Webhookツールを使って利用できます。

無料アカウントを作成して、Shopifyに URL を1つ貼り付ければ、次の注文をスマホで受け取れます。

この記事をシェア