Registration Formの送信時にShopify Flowをトリガーする

有効にすると、Registration Formで顧客が作成または更新されるたびに、アプリがShopify Flow（Shopifyの無料のノーコード自動化ツール）にイベントを送信します。Flowでワークフローを作成して、このイベントに応じた処理を自由に設定できます。たとえば、Slackで営業チームに通知する、顧客にタグを付ける、顧客をセグメントに追加する、タスクを作成する、顧客を別のシステムに同期するなどが可能です。

ノート

この機能を使用する前に、フォームがShopifyの顧客データに接続されていることを確認してください。詳しくは、Registration FormをShopifyの顧客データと連携するをご覧ください。

手順

1. フォームの連携設定を開く

   アプリでRegistration Formをクリックし、対象のフォームを開きます。次にIntegrationタブをクリックし、Shopifyを選択します。

   

2. Flowトリガーを有効にする

   Enable Shopify Flow triggerをオンにします。

   

3. 保存する

   Saveをクリックします。

注意

このオプションは、一部の料金プランでのみ利用できます。Integration > ShopifyにEnable Shopify Flow triggerが表示されない場合は、Settings > Pricing planを確認するか、サポートにお問い合わせください。

Shopify Flowでワークフローを作成する

1. Shopify Flowをインストールする

   Shopify管理画面 > アプリ > Flowに移動します。Flowは無料で、すべてのShopifyプランで利用できます。まだインストールしていない場合は、インストールしてください。

2. ワークフローを作成する

   Create workflowをクリックします。

3. トリガーを選択する

   トリガーのステップでSami Wholesale（*“All-in-1 Wholesale B2B: Volume discount, b2b registration, tax”として表示されます）を検索して開きます。その中から、Sami B2B Wholesale Pricingという名前のトリガーを選択します。説明には、“Triggers when a customer is created or updated via a Wholesale registration form.”*と表示されています。

   

4. アクションを追加する

   必要なアクションを追加します。Flowには、通知の送信、タグの追加、Webhookの呼び出し、条件による分岐など、数百の組み込みアクションが用意されています。

5. ワークフローをオンにする

   Turn onをクリックします。

ヒント

結果: 以降は、このオプションを有効にしたフォームで顧客が登録または更新されるたびに、ワークフローが自動的に実行されます。通常は、送信から約2分以内に実行されます。

ワークフローで利用できるデータ

ワークフローを作成するときは、次の変数を任意のステップに挿入できます。

変数	説明
Customer	作成または更新されたShopifyの顧客です。顧客に関するあらゆるアクション（タグの追加、セグメントへの追加、メールの送信など）で直接使用できます。
Form > Name	送信されたRegistration Formの名前です。複数のフォームがあり、使用されたフォームに応じてワークフローの動作を変えたい場合に便利です。
Registration customer > Data	顧客がフォームに入力したすべての内容（フィールドのラベルと値）が、1つのJSON文字列にまとめられています。個別のフィールドに分割する方法は、以下をご覧ください。

「Registration customer > Data」から個別のフィールドを読み取る

送信されたフォームのデータは、すべてのフィールドが1つの変数にまとめられた1つのJSON文字列として送信されます（例: {"Email": "[email protected]", "First Name": "John", "Company name": "ABC Co."}）。ワークフローの後半で使える個別のフィールドに分割するには、トリガーの直後にRun codeステップを追加します。

ステップ1 — 「Run code」アクションを追加する

ワークフローでAdd actionをクリックし、Run codeを見つけて選択します。

ステップ2 — Input（GraphQLクエリ）を入力する

Inputボックスに、次の内容を貼り付けます。

{
  registrationCustomer {
    data
  }
}

ステップ3 — Function（JavaScript）を入力する

Functionボックスに、次の内容を貼り付けます。

export default function main({ registrationCustomer }) {
  const formData = JSON.parse(registrationCustomer.data);

  return {
    email: formData['Email'] || '',
    firstName: formData['First Name'] || '',
    companyName: formData['Company name'] || '',
  };
}

ノート

'Email'、'First Name'、'Company name'などを、フォームに表示されているフィールドのラベルと正確に一致するものに置き換えてください（内部の要素IDではありません）。

ステップ4 — Output（戻り値の型）を入力する

Outputボックスに、ステップ3で返した内容に対応する型宣言を貼り付けます。

type Output {
  email: String!
  firstName: String!
  companyName: String!
}

ステップ5 — 結果を後のステップで使用する

保存すると、このRun codeステップは、後続のアクションで使用できる新しい変数のソースになります。email、firstName、companyName（または付けた名前）を、メールの本文、Slackのメッセージ、条件などに挿入できます。

注意

Shopify FlowのRun codeは、制限付きのサンドボックスでJavaScriptを実行します（外部APIの呼び出し不可、外部ライブラリ不可、実行時間は5秒まで）。データの整形にのみ使用し、Webhookを直接呼び出すことには使用しないでください。Webhookを呼び出すには、別のステップでFlowの組み込みアクションHTTP requestを使用します。

制限事項: Run codeステップのOutputでは、個別のフィールド（String、Int、Float、Boolean、IDなど）の宣言のみがサポートされており、汎用の「JSON」型の戻り値はありません。registrationCustomer.dataオブジェクト全体をそのまま渡すことはできないため、必要なフィールドごとに、フォームのラベルと正確に一致する名前で宣言する必要があります（ステップ3〜4）。後からフォームに新しいフィールドを追加して、ワークフローで使用する場合は、Run codeステップにも追加してください。

注意事項

• ストアにShopify Flowアプリが必要です（無料で、すべてのShopifyプランで利用できます）。
• 顧客がフォームを送信してから、ワークフローが実行されるまでに数分かかる場合があります。これは想定された動作であり、エラーではありません。
• この機能は、アプリの料金プランによって利用できるかどうかが異なります。Enable Shopify Flow triggerが表示されない場合は、現在のプランを確認するか、サポートにお問い合わせください。

サポートが必要な場合

これらの手順で問題が発生した場合は、お気軽にメール（[email protected]）までお問い合わせください。