Workflow WebhooksWorkflow Webhooks

『Workflow Webhooks』の概要

Shopify Flow これは強力な機能ですが、Shopify 内のイベントにのみ反応します。Workflow Webhooks を使用すると、その制限が解消されます。これにより、外部システムから POST リクエストを送信できる安全な URL エンドポイントが提供されます。外部システムからリクエストが送信されると、Shopify Flow のワークフローが即座に実行され、送信されたペイロードデータが利用可能な変数として渡されます。

Workflow Webhooks

仕組みについて

  • 外部ツールは、JSON形式のペイロードを添付して、WebhookのURLに対してHTTP POSTリクエストを送信します。 （例：名前、メールアドレス、質問など）。n8n、Make、Zapier、あるいはHTTPに対応したあらゆるツールと連携可能です。
  • Workflow Webhooks それを受け取り、リクエストの認証を行い、完全なヘッダー情報とともにログに記録します およびペイロードを受け取ると、リンクされたShopify Flowトリガーを発動させます。
  • Shopify Flow 自動化を実行します - お客様にタグを付けたり、メールを送信したり、 メタフィールド - ペイロードデータを名前付き変数として使用する方法（{{fieldOne}}、{{fieldTwo}}、 {{fieldThree}}、{{fieldFour}}）。また、チェックを入れると、追加のデータを送信することもできます。 [セキュリティ] → [Webhookでのカスタムリクエストボディを許可]。
  • 1つのWebhookエンドポイントで、あらゆるShopify Flowの自動化を実現できます。

完成したワークフロー：Webhookトリガー、Webhook IDに基づく条件、そして「True」分岐で内部メールを送信します。
Webhook URL へのリクエストにより、Shopify Flowのワークフローが開始されます。条件設定により、Webhookは1つに限定されます。アクションについては、Shopify Flowで実行可能なあらゆる操作が可能です。

特長

特集 説明
Shopify FlowのWebhookトリガー Shopify Flowの自動化をオンデマンドで開始する、セキュアなHTTPエンドポイント
変数のマッピング ペイロードのフィールドをShopify Flow変数にマッピングし、{{fieldOne}}、{{fieldTwo}}などの形式で参照します。
認証 静的トークン（簡易型）またはHMAC SHA256（改ざん防止型）
召喚履歴 すべてのリクエストの完全なログ - タイムスタンプ、ペイロード、ヘッダー、およびステータス
CORSのサポート ブラウザベースまたはフロントエンドとの連携を有効にする
カスタムリクエスト本文 サードパーティのプラットフォームからの柔軟なペイロード構造を受け入れる
Webhookダッシュボード すべてのエンドポイントを一か所で管理、監視、テストします
重複防止機能 すでに確認済みのイベントIDを含む重複した配信は無視してください

認証

方法 仕組みについて こんな方に最適です
なし 認証なし テスト用のみであり、本番環境ではありません
静的トークン ✓ X-Api-Keyヘッダー内のトークンを修正しました 主な連携サービス（n8n、Make、Zapier）
HMAC SHA256 ペイロードと秘密鍵による署名 高度なセキュリティまたはコンプライアンス

変数のマッピング

Workflow Webhooks これにより、受信したJSONペイロードのフィールドを、Shopify Flowで使用可能な名前付き変数にマッピングすることができます。「詳細設定」タブで、最大4つのフィールド名を定義できます。また、**「セキュリティ」→「カスタムリクエストボディを許可」**にチェックを入れると、追加のデータを送信することも可能です。

アプリ内のフィールド お客様のペイロードキー Shopify Flow内での参照
フィールド1 name {{fieldOne}}
フィールド 2 email {{fieldTwo}}
フィールド3 question {{fieldThree}}
フィールド4 other {{fieldFour}}
Shopify Flowの「Webhookトリガー」用「変数を追加」パネルには、webhookIdおよびfieldOneからfieldFourまでが、最近のリクエストからのサンプル値とともに一覧表示されます
トリガーがワークフローに送信する内容：Webhook IDと、マッピングされた4つのフィールドです。これらは、最近のリクエストの値とともに表示されています。

重複配送防止

ほとんどのシステムでは、すぐに応答が得られない場合、Webhookを再試行します。もし最初の試行が実際に届いていた場合、同じイベントに対してShopify Flowワークフローが2回実行されてしまいます。その結果、2通目のメールが送信されたり、2つ目のタグが付けられたり、ノートが重複して作成されたりします。

送信システムでイベントごとに一意のIDが割り当てられている場合は、Webhookの**「詳細設定」→「重複配信の検出」**でそのヘッダーに名前を指定すると、重複した配信は無視されます。

行動
指定されたIDを持つ最初のリクエスト 通常通り処理すると、Shopify Flowが実行されます
24時間以内に再度行ってください 200 OK duplicate: true を使用 - Shopify Flow には送信されません
異なるID 通常通り処理されました
リクエストにそのようなヘッダーはありません 通常通り処理されました

一般的なヘッダー名：Event-Id、Idempotency-Key、X-Request-Id。大文字小文字は区別されません。

bash
# Second call with the same Event-Id is accepted but not re-sent to Flow
curl -X POST https://.../webhook/<short> \
  -H "Content-Type: application/json" \
  -H "Event-Id: evt_12345" \
  -d '{"orderId":"1001"}'

一般的な利用例

  • 外部からフォームが送信された際に、Shopifyのお客様にタグを付与するか、情報を更新する
  • n8n または Make のワークフローから、注文やフルフィルメントのアクションをトリガーする
  • レコードに変更があった際に、CRMやヘルプデスクの連絡先データをShopifyに同期します
  • Zapierの自動化が完了したら、Shopify Flowを起動する
  • フロントエンドのフォームからの自動実行（CORSを有効にした場合）
  • 複数の単一機能の連携を、1つの統合されたWebhookマネージャーに置き換える

統合の手順ガイド

  1. n8nとWorkflow Webhooksを連携させる方法
  2. MakeとWorkflow Webhooksを連携させる方法
  3. ZapierとWorkflow Webhooksを連携させる方法

マーチャントの声

「このアプリのおかげで、Shopify Flowの使い勝手が5倍も良くなりました。開発者の方にはとても連絡が取りやすいです」 「そして、非常に役に立ちました。」 - SuperFast Startup（ポルトガル）

「Shopify Flowに欠けていたピース――たった1つのShopify Flowで、すべてに対応できます」 「Webhook」 ― オーストリア、ゼンケルス

「まさに私が、数多くのサードパーティ製アプリを使って解決しようとしていた問題そのものです。非常に 「おすすめします。」 - アロハ・タイニーボード、アメリカ合衆国

インストール

ShopifyのApp Storeから「Workflow Webhooks」をインストールしてください。

サポート

お困りですか？ サポート をご覧いただくか、Shopifyの管理画面内のアプリのどのページにあるチャットアイコンをご利用ください。