Workflow WebhooksWorkflow Webhooks

Webhookを受信した際の注文ステータスを返す

注文の支払いおよびフルフィルメント状況について、HTTPリクエストに応答します。チャットボット、ヘルプデスク、または顧客ポータルが注文番号を送信すると、同じレスポンスで状況が返されます。

Workflow Webhooksのトリガー1つと、「Webhook応答を返す」アクションだけで、他のアプリは必要ありません。

Shopify Flow のワークフロー：Webhook を受信した際の注文ステータスの返送
Shopify Flow でのワークフローの全体像です。

必要なもの

Workflow Webhooks の Webhook で、同期レスポンスが有効になっている場合については、同期応答 およびこのペイロードマッピングをご参照ください。ペイロードのマッピングとShopify Flow変数 もご参照ください。

フィールド そこに何を割り当てるか
fieldOne 注文番号は、例えば #1001 といったものです。

Webhookへの呼び出しは、次のような形になります：

bash
curl -X POST https://<your webhook URL> \
  -H "Content-Type: application/json" \
  -d '{"orderNumber": "#1001"}'

# Response:
# {"orders": [{"name": "#1001", "financialStatus": "PAID", "fulfillmentStatus": "UNFULFILLED"}]}

ワークフローを入手する

  1. このページの下部に添付されている「.flow」ファイルをダウンロードしてください。
  2. Shopifyの管理画面で「**Shopify Flow」**を開き、「**インポート」**をクリックしてファイルを選択してください。
  3. 手順を確認してから、「**ワークフローを有効にする」**をクリックしてください。

このファイルは、Shopify Flow自体からエクスポートされたものです。手動で編集せず、インポート後にShopify Flowでワークフローを変更してください。

仕組みについて

  1. 「Sync Webhook Trigger」は、呼び出し元が応答を待っている間にワークフローを開始し、invocationIdおよびマッピングされたフィールドをワークフローに渡します。
  2. **「注文データの取得」は、**クエリ name:{{fieldOne}} を使用して注文を検索し、最大1件の結果を保持します。
  3. Return Webhookのレスポンスでは、注文名、財務状況、およびフルフィルメント状況を含む{"orders": [...]}が呼び出し元に返されます。一致する注文がない場合、このリストは空になります。

自分だけのものにしましょう

  • レスポンス本文に注文フィールドをさらに追加してください。例えば、{{order.totalPriceSet.shopMoney.amount}} のようにします。

今後の手順