変更履歴

このアプリは、あなたの言語で話しかけてくれます

アプリ全体が、Shopifyの管理画面で設定された言語に合わせて表示されるようになりました。対応言語は、**英語、ドイツ語、フランス語、スペイン語、イタリア語、オランダ語、デンマーク語、ポルトガル語（ブラジルおよびポルトガル）、日本語、中国語（簡体字および繁体字）**です。管理画面の言語を変更すると、次のページ読み込み時にアプリもそれに合わせて変更されます。

• すべてのページ、ダイアログ、メッセージが翻訳されています。これには、Webhookエディタ、署名テスターとその段階的な診断機能、履歴、およびヘルプページも含まれます。
• Shopify Flow では、ワークフローテンプレートのタイトル、説明、および設定に関する注意事項が、お客様の言語で表示されます。
• **日付や数字は、**お使いの言語の表記方法に従って表示されます。
• **このヘルプセンターも翻訳されています。**すべてのガイドは同じ言語でご利用いただけます。言語メニューからご希望の言語をお選びください。
• トリガー名とアクション名は英語のままです。「Shopify Flow」ではステップ名が英語で表示されるため、アプリでも同様に表示されます。アプリに表示される名前は、常に「Shopify Flow」にあるものと同じです。「fieldOne」などのペイロードフィールド名も変更されません。

Shopify Flow に用意されている7つの既成ワークフロー

「Open Flow」を開き、「テンプレートの参照」を選択して、「Webhook」と検索してください。各テンプレートは、Webhookトリガー上の完全なワークフローとなっています。ユーザーはWebhookを作成し、システムをそのWebhookに紐づけるだけで済みます。

• Webhookを受信した際の注文の処理順序 - 3PL、ERP、またはノーコードツールが、注文を「出荷済み」「請求済み」、または「確認済み」としてマークします。
• Webhookを受信した際に注文メモを追加する - サポートツールやERPからのメッセージを注文メモに追記します。
• Webhookを受信した時点で、注文を「支払済み」としてください。これは、ご利用の銀行、請求システム、または決済システムから支払いが確認されたことを意味します。
• Webhookを受信した際に商品にタグを付与します。これにより、サプライヤー、PIM、またはERPがコレクションやバッジを常に同期させた状態を維持します。
• Webhookを受信した際にお客様を作成する - ランディングページやフォームから見込み客情報を収集します。
• Webhookを受信した際にお客様のメタフィールドを更新する - ロイヤリティ、CRM、またはポイントシステムでは、お客様情報に数値が保存されます。
• Webhookを受信した際の注文ステータスの返却 - 同期レスポンスを使用して、チャットボット、ヘルプデスク、または顧客ポータルに対し、注文の支払い状況やフルフィルメント状況に関する情報を提供します。

各テンプレートの設定説明には、どのフィールドをマッピングすべきかが記載されています。ワークフローテンプレート をご覧ください。

Shopifyの新しい管理画面のデザイン

Shopify 管理画面の新しいデザインを導入しています。すでに導入済みのストアでは、「Workflow Webhooks」でも同じ色、書体、アイコンが使用されるようになり、アプリの外観が管理画面の他の部分と統一されます。まだ導入されていないストアでは、変更はありません。

Webhookは、タイマーに基づいて実行できるようになり、ほぼすべての送信者の署名を検証できるようになり、JSON以外の形式も受け付けられるようになりました。

任意のAPIから、タイマーに基づいてワークフローを実行する

各Webhookに新しい**「スケジュール」**タブが追加されました。直接設定するには、「Webhookを作成」を選択し、「このWebhookを何で呼び出しますか？」という質問に対して「なし - スケジュールに従って実行」と回答してください。 このアプリは、5分ごとに（最大1日1回まで）URLを取得し、そのレスポンスをWebhookに送信します。これにより、Shopify Flowのワークフローを、どのAPIからでもスケジュールに従って実行できるようになります。

• すべてのフェッチで「fire」を実行するか、レスポンスが変更された場合のみ実行するか。
• APIで必要とされる場合は、リクエストヘッダーを追加してください。これらは暗号化されて保存されます。
• 「Run now」をクリックすると、一度取得を行い、そのレスポンスが表示されます。
• このタブでは、スケジュールがご自身のプランに対してどのように進捗しているかが確認できます。実行されたランニングは、履歴に「**予定通り」**として表示されます。
• 20回連続で失敗したスケジュールは、自動的に一時停止します。

定期的なURLポーリング をご覧ください。

ほぼすべての送信者に対する署名検証

22個の組み込みプリセット（従来は6個）があり、それぞれ送信元自身のドキュメントに基づいて確認済みです：Stripe、GitHub、Shopify、Slack、Typeform、Calendly、標準Webhook（OpenAI、Supabase）、 Svix（Clerk、Resend）、Paddle、Linear、WooCommerce、Square、Sentry、Vercel、Zendesk、Lemon Squeezy、Razorpay、Paystack、Customer.io、Sendcloud、Mollie、Sanity。

• 事前設定のない送信者については、「カスタム署名」が適用されます。ヘッダー、アルゴリズム、エンコーディング、リプレイ保護機能付きのタイムスタンプ、および署名対象となる正確なテキストを選択してください。
• エディタ内のシグネチャテスターは、どの検証ステップで失敗したかを示し、有効なリクエスト例を生成することができます。
• Webhookを作成する際は、まず何がそのWebhookに送信されるのかを指定することから始まります。

署名付きWebhookの検証 をご覧ください。各送信者ごとの手順が詳しく解説されています。

その他の認証方法

• カスタムヘッダーを設定できない送信者については、静的トークンが「**Bearer」**トークン、Basic認証（ユーザー名とパスワード）、またはURLパラメータとして送信されるようになりました。URL内のトークンは履歴上でマスクされ、Shopify Flowには一切渡されません。
• **ダウンタイムなしでシークレットをローテーションできます。**静的トークンおよびすべての署名方式において、最初のシークレットと並行して2つ目のシークレットが受け入れられます。
• **IP許可リスト。**認証に加えて、URLへのアクセスが許可される対象を、指定したアドレスまたはアドレス範囲に限定します。詳細は IP許可リスト をご覧ください。

認証 をご覧ください。

フォームおよびXMLの本文、ならびに配列の分割

• フォームの投稿、ファイルアップロードフォーム、およびXMLは、JSONと同様にマッピング可能なフィールドとして読み込まれるようになりました。有効なJSON形式のボディは引き続きJSONとして読み込まれるため、既存の送信元における動作に変更はありません。
• **配列を実行単位に分割します。**新しい設定をペイロード内のリストに向けることで、各項目が独自にShopify Flowの実行を開始します。1回のリクエストにつき最大100件まで可能です。各項目は1回の呼び出しとしてカウントされます。

ボディ形式と配列の分割 をご覧ください。

ShopifyのWebコンポーネントを用いて再構築された、より高速なアプリ

アプリ全体が、これまでは独立したインターフェースライブラリ上で動作していましたが、現在はShopifyの管理画面自体のWebコンポーネント上で動作するようになりました。読み込む量が減ったため、ページの表示が速くなり、すべてのフィールド、メニュー、ダイアログが、管理画面の他の部分と同じ見た目と動作をするようになりました。

• **Webhookエディタはビルダーです。左側には設定項目、右側にはWebhookのURLとIDが表示された「エンドポイント」**カードがあり、その上には「ライブプレビュー」、「テスト」、「使用状況」が表示されます。これにより、設定を変更すると、リクエストが到着する様子を並べて確認することができます。
• Webhookの一覧には、各Webhookの呼び出し回数、呼び出し元による認証方法、最終更新日時が表示されており、各行には編集、有効化、無効化、削除を行うためのメニューが用意されています。
• **署名付き送信者の接続について。**Stripe、GitHub、またはその他のプロバイダー向けのWebhookでは、検証できないサンプルリクエストの代わりに、接続手順と設定ガイドへのリンクボタンが表示されます。

このリリースには、他にも以下の内容が含まれています

• **ダッシュボードにブロックされたリクエストが表示されます。**これまで、プランの制限により拒否されたリクエストには、記録が残りませんでした。現在、ダッシュボードには過去30日間でブロックされた件数が表示されるようになり、プランカードには利用状況メーターが搭載されています。
• Webhookリストのページネーションは正常に動作しており、「履歴を**すべてクリア」**を実行すると、「再生済み」フィルターもクリアされます。
• 各ページには、ヘルプセンター内の該当ガイドへのリンクが掲載されており、ヘルプページには、Shopify Flow向けの当社のその他のアプリが一覧表示されています。
• 定期的なセキュリティメンテナンスです。特にアクションいただく必要はありません。

これまでは、Webhookはリクエストの受信確認しか行えませんでした。つまり、Shopify Flowのワークフローがその後実行されても、呼び出し元にはその結果が通知されませんでした。同期レスポンスではこれが変わります。アプリは、ワークフローからデータが返されるまでリクエストを保持し、そのデータを呼び出し元に返します。

呼び出し元が「受信確認」ではなく「回答」を必要とする場合、つまり、結果が表示されるフォームや、計算結果を待機しているシステム、検索機能などにおいて役立ちます。

仕組み

Webhookの「詳細設定」で**「同期応答」をオンにしてください。その後、新しい「同期Webhookトリガー」に基づいてワークフローを構築し、新しい「Webhook応答を返す**」アクションでワークフローを完了させてください。

トリガーの変数を使用して、アクション内に直接レスポンス本文を記述してください：

{"ok": true, "orderId": "{{fieldOne}}", "email": "{{fieldTwo}}"}

あるいは、「コードを実行」アクションでより複雑な処理を作成し、その結果をバインドすることもできます。

通常の往復処理時間は2～4秒です。ワークフローが15秒以内に応答しない場合、発信者には通常の応答が返されます。エラーや応答停止が発生することは決してありません。

完全ガイド：同期応答：

電源を入れない限り、何も変わりません

すべてのWebhookで、デフォルトではオフになっています。既存のWebhookは、これまでとまったく同じように、引き続き即座に応答し、標準のWebhookトリガーを使い続けます。

REST API と MCP サーバーには、ついに専用の恒久的な設置場所が設けられました：

https://shopify.workflow-webhooks.app

APIのURLは https://shopify.workflow-webhooks.app/api/v1、MCPサーバーのURLは https://shopify.workflow-webhooks.app/api/mcp です。どちらも「**開発者」**ページに「コピー」ボタンが表示されています。

これまでは、これらはアプリの埋め込みURL上に存在していました。これらを分離することで、スクリプトやCIジョブ、AIアシスタントに貼り付けるアドレスが安定し、管理画面でのアプリの埋め込み方法とは無関係になります。新しいホスト名はAPIのみを提供するものであり、アプリ自体は以前の場所にそのまま残り、すでに設定済みの内容に変更を加える必要はありません。

さらに多くの資料

、docs.workflow-webhooks.app、 に、9つの新しいページが公開されました：

• 初めてのWebhookを作成しましょう ― Shopify Flow側の設定を含めた、一連の流れをすべて解説します
• 認証 - 静的トークン、HMAC、およびStripe、GitHub、Shopify、Slack、Typeform、Calendly用のプリセット
• ペイロードのマッピングとShopify Flow変数 ― ドットパス、ネストされた値、そして4つのフィールドでは足りない場合の対処法
• 重複配送防止
• 履歴とトラブルシューティング ― すべての拒否コードとその対処法
• Shopify FlowからWebhookを呼び出す
• プランと利用状況 ― データ通信量の上限にカウントされるものと、カウントされないもの
• サイドキックとAIアシスタント
• よくあるご質問

開発者向けAPIおよびMCPガイドも公開されました。

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

重複配信防止機能により、この問題は解決されます。送信システムでイベントごとに一意のIDが割り当てられている場合は、どのヘッダーにそのIDが含まれているかをお知らせいただければ、重複した配信を無視いたします。

**「詳細設定」→「Webhook 受信時に配信を複製」**で設定してください。送信者が使用しているヘッダー名を入力してください。一般的な例としては、Event-Id、Idempotency-Key、または X-Request-Id などがあります。

• 指定されたIDを持つ最初のリクエストは、通常通り実行されます。
• 24時間以内に再送信があった場合は、通常の「200 OK」という応答が返されるため、送信者は送信を中止します 再試行中ですが、Shopify Flowには再度送信されません。
• 削除された重複データは、プランの制限枠にはカウントされません。
• それらは今でも確認できます。「Live Request Inspector」にはリクエストが表示され、次のようにラベル付けされています。 重複を排除したため、呼び出しが消えたように見えることはありません。

このフィールドを空のままにしておくと、何も変わりません。すべてのリクエストは、これまでとまったく同じように処理されます。これは、既存のすべてのWebhookにおいて、デフォルトで無効になっています。

ご自身のコードから、あるいはClaudeやCursorといったAIアシスタントから、Webhookを管理できます。

• 新しい開発者向けページ：Claude Code、Claude Desktop、Cursor、VS Code、Gemini CLI、OpenAI Codex向けのスコープ付きAPIキーを作成し、コピーしてすぐに使える接続コマンドを取得できます。
• /api/v1 の REST API - Webhook の一覧表示と管理、呼び出し履歴や統計情報の確認、テンプレートの一覧表示が可能です。
• /api/mcp にある MCP サーバーですので、AI アシスタントも会話の中で同様の操作を行うことができます。
• **3つのアクセスレベルがあります。**読み取りキーでは閲覧のみが可能です。書き込みキーでは、Webhookの作成、更新、削除も可能です。実行キーでは、さらにテスト呼び出しを実行したり、過去の呼び出しを再生したりすることができ、これによりShopify Flowのワークフローを実際に実行することができます。
• **お客様のデータは確実に保護されます。**Webhookの認証トークンはAPIを通じて読み取られることは一切ありません。また、リクエストのペイロードに含まれる個人情報（メールアドレス、電話番号、氏名、カード番号）は、サーバーから送信される前にマスク処理されます。

**Flow Webhooks 現在は「Workflow Webhooks」となりました。**アプリも、インストール方法も、Webhookも従来通りですが、当社の他の「ワークフロー」シリーズに合わせて名称が変更されました。

• 、docs.workflow-webhooks.app、 に新しいドキュメントサイトが開設されました。ここには、動画ガイドを含む、n8n、Make、Zapier の完全な手順解説が掲載されています。
• 新しいヘルプセンター ― バグの報告、機能のリクエスト、またはスクリーンショットを添付して、弊社に直接届く専用のフォームからお問い合わせください。
• アプリ内チャット ― チャットバブルがアプリのすべてのページに表示されるようになりました。また、ダイアログが開いているときは、さりげなく非表示になります。
• ダッシュボード上のセットアップガイドでは、最初のWebhookの設定から、正常に動作するShopify Flowワークフローの構築までを順を追ってご案内します。また、このガイドは、折りたたんだかどうかを記憶しています。

定期的なセキュリティメンテナンス：アプリ全体の依存関係の更新およびセキュリティ強化を行います。特にアクションを行う必要はありません。

• メール通知 - プランの制限に近づいたとき、制限に達したとき、およびWebhookの失敗が通常より多くなったときに通知を受け取ることができます。ストアオーナー以外にも受信者を追加でき、各受信者には個別の配信停止リンクが用意されています。
• HMAC署名のプリセット - フォーマットを手作業で作成することなく、一般的な送信元の署名方式に合わせることができます。
• リクエストデータの取得を有効にする - 各Webhookごとに、リクエストヘッダー、クエリ文字列パラメータ、および生のリクエスト本文をShopify Flowに渡すかどうかを選択してください。
• ペイロードの内容で呼び出し履歴を検索します。

Sidekickでは、このアプリに関する質問に直接お答えできるようになりました。「お問い合わせフォーム用のWebhookはありますか」「n8nのWebhookは有効になっていますか」「今週は何回トリガーされましたか」「前回の呼び出しが失敗したのはなぜですか」といった質問をお寄せください。

読み取り専用 - Sidekick は、お客様の Webhook、その設定、および呼び出し履歴を確認することはできますが、いかなる変更も行うことはできません。

Workflow Webhooks 現在は、新しい欧州のクラウドプラットフォーム上で稼働しています。ご利用方法に変化はありませんが、その裏側では：

• Webhookの処理は、デッドレター処理機能を備えたマネージドキューに移行されたため、呼び出しが黙って破棄されることは一切ありません。
• EU域内では、データベースとキャッシュは地域内に保存され、保存時の暗号化が行われています。
• マーチャント秘密情報（静的トークンおよびHMACキー）は、ディスクレベルで暗号化して保存されるだけでなく、専用の鍵管理サービスによって暗号化されるようになりました。
• アベイラビリティゾーンにまたがる冗長化されたインスタンス。

その結果、Webhookの受信時の遅延が短縮され、高負荷時の動作も大幅に改善されました。

• カスタム静的トークンヘッダー - トークンヘッダーは、もはや X-Api-Key である必要はありません。「詳細設定」で、各 Webhook ごとに、送信元システムがすでに送信している内容に合わせて独自の名前を設定してください。安全上の理由から、予約済みおよびプロキシによって制御されるヘッダー名は拒否されます。
• セッションの自動更新 - アクセストークンがバックグラウンドで更新されるようになったため、長時間実行されるストアでは、トークンの有効期限が切れた後に配信が失敗することがなくなりました。
• より賢い再試行 - 配信に失敗した場合はバックオフを適用して再試行を行い、恒久的な失敗の場合は試行回数を無駄に消費することなく、直ちに再試行を中止します。

• アクセスが集中するストアにおける履歴および統計情報のクエリ処理を高速化するためのデータベースインデックスを追加しました。
• 管理画面でページの表示が遅い箇所を検出できるよう、実際のユーザーによるパフォーマンス監視機能を追加しました。
• アプリ全体のセキュリティ対策：依存関係の更新と、安全でないHTMLレンダリングの削除。

• メトリックカード、日付範囲ピッカー、および呼び出し回数のグラフを中心に、ダッシュボードを再構築しました。
• **保存されていない変更は、保護されるようになりました。**Webhook を編集すると、Shopify の保存バーが表示され、編集内容が未保存の状態でタブを切り替えたり、「戻る」ボタンを押したりしても、変更内容が黙って破棄されることなく、まず確認のメッセージが表示されます。

Webhookの履歴を再インデックスしました。呼び出し件数の多いストアでは、履歴ページやダッシュボードの読み込み速度が大幅に改善されていることがお分かりいただけるでしょう。

• リプレイ - 過去の呼び出しを開き、ワンクリックで再度送信できます。これは、Shopify Flowワークフローを構築する最も迅速な方法です。Flowでイベントを記録し、ソースシステムを再トリガーする代わりに、実際の呼び出しをリプレイします。
• Webhookテンプレート - n8n、Make、Zapier、お問い合わせフォーム、およびカスタム連携のための、あらかじめ設定済みのスタートポイント。

• 有効なリクエストが拒否されてしまう可能性があった、認証に関するエッジケースを修正しました。
• アプリのプロキシURLが正しくルーティングされるよう、プロキシパスの解決を修正しました。
• Webhook一覧の表示エラーを修正しました。

• Flowのアクション ― 逆方向。Shopify Flowのワークフローでは、アクションステップとしてWebhookを呼び出せるようになりました。これにより、Flowはデータを受け取るだけでなく、データを送信することも可能になりました。
• ダッシュボードの統計情報 ― 呼び出し総数、成功率、および選択した期間のグラフです。
• 呼び出し元追跡機能 ― 履歴には、呼び出しがShopify Flow、テスト、curl、または外部システムからのものかどうかの情報が記録されるようになり、この情報に基づいてフィルタリングが可能になりました。

Shopify Flow 変数は単純な文字列であるため、以前はネストされたオブジェクトや配列は利用できませんでした。

オブジェクトや配列である値は、自動的に検出され、JSON文字列としてShopify Flowに渡されるようになりました。そのため、取り込みの過程でデータが気づかれないまま失われることはありません。

月ごとの呼び出し回数の制限が設けられたサブスクリプションプランを導入し、ダッシュボード上で利用状況を確認できるようになりました。これにより、制限に対する現在の利用状況をご確認いただけます。

すべてのプランには、すべての認証方法、フィールドマッピング、CORS、履歴およびリプレイ機能が含まれています。プランの違いは、月間利用量のみです。

• アプリプロキシのエンドポイント - 各Webhookは、ShopifyのアプリプロキシURLを介してアクセスできるようになりました。これにより、ブラウザから呼び出す際のクロスオリジン問題を回避できます。
• 履歴ページには日付範囲フィルターが用意されており、スクロールせずに問題が発生した日に絞り込むことができます。

4つのマッピングされたフィールドだけでは不十分な場合があります。Webhookの「セキュリティ」設定で**「カスタムリクエストボディを許可」**を有効にすると、4つの名前付きフィールドに加えて、受信ペイロード全体がShopify Flowに渡されます。

送信側のシステムのペイロードの形状を制御できない場合に役立ちます。

• Webhookの設定はキャッシュされるようになったため、呼び出しを受けた際の処理負荷が軽減され、応答が速くなりました。
• 無効化されたWebhookはリスト内で明確にマークされているため、なぜそのWebhookがトリガーされないのかが一目でわかります。
• Webhookの詳細ページを刷新し、さらにいくつかの細かい修正を行いました。

最初のリリースです。Shopify Flowは、Shopify内のイベントにのみ反応していましたが、今回のリリースにより、その制限が解除されました。

• Webhookのエンドポイント - すべてのWebhookには、外部システムからPOSTリクエストを送信できる独自のセキュアなURLが割り当てられます。
• 3つの認証モードがあります。テスト用の「なし」、X-Api-Keyヘッダー内の静的トークン、および改ざん防止のためのHMAC SHA256です。
• ペイロードのマッピング - 受信したJSONの中から最大4つのフィールドをマッピングし、Shopify Flow内で{{fieldOne}}から{{fieldFour}}として使用します。
• 呼び出し履歴 - すべての呼び出しについて、ヘッダー、ペイロード、ステータス、および実行時刻が記録されます。
• CORSのサポート ― これを有効にすると、ブラウザやストアフロントのフォームから直接発信された通話を受け付けることができます。
• Webhookダッシュボード - すべてのエンドポイントを一か所で作成、有効化、無効化、一括管理でき、ワンクリックでトークンを生成できます。