顧客トリガーの手順

顧客レコードの変更を引き起こす11のトリガーがあります。そのうち7つは、どの店舗でも自由に利用できるデータ（タグ、メモ、アカウントの状態、マーケティングに関する同意）を対象としています。残りの4つは、氏名、メールアドレス、電話番号、住所といった個人データを参照するもので、これらの処理には、通常の許可に加えてオプトインが必要です。

このページの内容：顧客情報の更新, 顧客タグの追加, 顧客タグの削除, 顧客メモの変更, 顧客ステータスの変更, 顧客のEメールマーケティング同意内容の変更, 顧客のSMSマーケティング同意内容の変更, 顧客名の変更, 顧客のEメールアドレスの変更, 顧客の電話番号の変更, 顧客の住所の変更

表示場所：「Shopify Flow」で「トリガーを選択」を選び、「Workflow Trigger Extensions」を開き、「Customer」を検索してください。

お客様への最新情報

顧客レコードが保存されるたびに実行されます。changes を引き数として受け取り、変更された追跡対象フィールド（タグ、メモ、アカウントの状態）と、変更前後の値を返します。


火災の原因は	Shopify Webhook と変更検出
許可	顧客データへのアクセス
電源が入った	これを使用するFlowワークフローを有効にすると、それがオンになります。この機能専用のスイッチは、アプリの「トリガー」ページにあります。

次のような用途にご利用ください

changes.fields での分岐により、複数の種類の顧客編集に対応する単一のワークフロー。
顧客情報の変更はすべてCRMに同期します。

「カスタマーアップデート」がワークフローに送信する内容

フロー内の変数	種類	その中身
`customer`	顧客（Shopify）	顧客。完全な「Shopify」の顧客であるため、そのすべてのフィールドと、Flow独自の顧客アクションが利用可能です。
`payload`	テキスト	更新された顧客のGIDを含むJSONオブジェクト（例：{"id":"gid://shopify/Customer/123"}）
`changes`	目的	どの追跡対象フィールド（タグ、メモ、アカウントの状態）が変更されたか、およびそれぞれの旧値と新値
`changes.fields`	テキスト一覧	変更された追跡対象フィールドの名前
`changes.items`	オブジェクトの一覧	変更されたフィールドごとの新旧の値
`changes.items (each).field`	テキスト	変更されたフィールド：タグ、メモ、または状態
`changes.items (each).oldValue`	テキスト	更新前の値。長い値は短縮されます。
`changes.items (each).newValue`	テキスト	更新後の値。長い値は短縮されます。
`eventId`	テキスト	このイベントのIDです。アプリの「イベント履歴」でこれを検索すると、具体的に何が送信されたかを確認できます。

例：顧客情報の変更内容をCRMに転送する

トリガーとして「**顧客情報の更新」**を選択します。
条件を追加：changes.fieldsが空でなく、かつ存在すること。
{{customer.id}} を使用して、CRM に HTTP リクエストを送信する処理を追加し、changes.items（field、oldValue、newValue）をループ処理します。
ワークフローを有効にしてください。

顧客タグが追加されました

顧客にタグが1つ以上追加されたときに発火します。addedTagsには、新しく追加されたタグのみが格納されます。


火災の原因は	Shopify Webhook と変更検出
許可	顧客データへのアクセス
電源が入った	これを使用するFlowワークフローを有効にすると、それがオンになります。この機能専用のスイッチは、アプリの「トリガー」ページにあります。

次のような用途にご利用ください

スタッフや他のアプリが顧客に「wholesale」または「vip」のタグを付けた時点で、オンボーディングを開始します。
ロイヤリティ・サブスクリプション・レビューアプリによって作成されたタグに対応する。

「追加された顧客タグ」がワークフローに送信する内容

フロー内の変数	種類	その中身
`customer`	顧客（Shopify）	タグが変更された顧客。Shopifyのフル機能版を利用している顧客であるため、そのすべてのフィールドおよびFlow独自の顧客アクションが利用可能です。
`addedTags`	テキスト	その顧客に追加されたタグの、カンマ区切りのリスト
`removedTags`	テキスト	同じ更新処理で顧客から削除されたタグのカンマ区切りのリスト（空の場合もある）
`currentTags`	テキスト	その顧客に現在付与されているすべてのタグを、カンマ区切りで列挙したもの
`previousTags`	テキスト	この更新以前に当該顧客に付与されていたすべてのタグを、カンマ区切りで列挙したもの
`eventId`	テキスト	このイベントのIDです。アプリの「イベント履歴」でこれを検索すると、具体的に何が送信されたかを確認できます。

例：新規の卸売顧客をお迎えする

トリガーとして「**追加された顧客タグ」**を選択します。
条件を追加：addedTags（wholesale を含む）。
「{{customer.displayName}} を使用してアカウントマネージャーに社内メールを送信する」または「メールツールに HTTP リクエストを送信してウェルカムメールシリーズを開始する」を追加します。
ワークフローを有効にしてください。

顧客タグが削除されました

顧客から少なくとも1つのタグが取り外されたときに発火します。removedTagsには、取り外されたタグが格納されます。


火災の原因は	Shopify Webhook と変更検知
許可	顧客データへのアクセス
電源が入った	これを使用するFlowワークフローを有効にすると、それがオンになります。この機能専用のスイッチは、アプリの「トリガー」ページにあります。

次のような用途にご利用ください

メンバーシップタグが消滅した場合は、特典を取り消す。
サブスクリプションアプリがactive-subscriberタグを削除した際は、チームに通知する。

「削除された顧客タグ」がワークフローに送信する内容

フロー内の変数	種類	その中身
`customer`	顧客（Shopify）	タグが変更された顧客。Shopifyのフル機能を利用している顧客であるため、すべてのフィールドおよびFlow独自の顧客アクションが利用可能です。
`addedTags`	テキスト	同じ更新処理で顧客に追加されたタグのカンマ区切りのリスト（空の場合もある）
`removedTags`	テキスト	顧客から削除されたタグのカンマ区切りのリスト
`currentTags`	テキスト	その顧客に現在付与されているすべてのタグを、カンマ区切りで列挙したもの
`previousTags`	テキスト	この更新以前に当該顧客に付与されていたすべてのタグを、カンマ区切りで列挙したもの
`eventId`	テキスト	このイベントのIDです。アプリの「イベント履歴」でこれを検索すると、具体的に何が送信されたかを確認できます。

例：購読者のタグが削除された際のフォローアップ

トリガーとして「**顧客タグが削除された」**を選択します。
条件を追加：removedTags には active-subscriber が含まれます。
「winback」を使用して顧客タグを追加し、リテンション担当者に社内メールを送信します。
ワークフローを有効にしてください。

顧客メモが変更されました

顧客のメモが追加、変更、または削除された際に発火します。


火災の原因は	Shopify Webhook と変更検出
許可	顧客データへのアクセス
電源が入った	これを使用するFlowワークフローを有効にすると、それがオンになります。この機能専用のスイッチは、アプリの「トリガー」ページにあります。

次のような用途にご利用ください

サポート担当者がアカウント所有者に向けて作成したルートノート。
メモからキーワードを解析し（#callback）、タスクを開始します。

「変更された顧客メモ」がワークフローに送信する内容

フロー内の変数	種類	その中身
`customer`	顧客（Shopify）	ノートが変更された顧客。完全な「Shopify」の顧客であるため、そのすべてのフィールドと、Flow独自の顧客アクションが利用可能です。
`oldNote`	テキスト	その顧客に関する前回のメモ（以前にメモが設定されていなかった場合は空欄）
`newNote`	テキスト	顧客に関する新しいメモ（メモが削除された場合は空欄）
`eventId`	テキスト	このイベントのIDです。アプリの「イベント履歴」でこれを検索すると、具体的に何が送信されたかを確認できます。

例：メモからコールバックタスクを作成する

トリガーとして「**顧客メモの変更」**を選択します。
条件を追加：newNote には #callback が含まれます。
{{customer.displayName}} および {{newNote}} を使用して、タスク管理ツールに社内メールやリクエストを送信する機能を追加しましょう。
ワークフローを有効にしてください。

顧客の状態が変更されました

顧客のアカウント状態が「disabled」、「enabled」、「invited」、「declined」の間で変更された際に発火します。


火災の原因は	Shopify Webhook と変更検出
許可	顧客データへのアクセス
電源が入った	これを使用するFlowワークフローを有効にすると、それがオンになります。この機能専用のスイッチは、アプリの「トリガー」ページにあります。

次のような用途にご利用ください

お客様がアカウントを有効化した際に、挨拶をしてください。
アカウントへの招待を断ったユーザーを確認する。

「顧客ステータスの変更」がワークフローに送信する内容

フロー内の変数	種類	その中身
`customer`	顧客（Shopify）	アカウントの状態が変更された顧客です。Shopifyのフル機能版を利用している顧客であるため、そのすべてのフィールドおよびFlow独自の顧客アクションが利用可能です。
`oldState`	テキスト	以前のアカウントの状態（無効、有効、招待済み、または辞退済み）
`newState`	テキスト	新しいアカウントの状態（無効、有効、招待済み、または拒否済み）
`eventId`	テキスト	このイベントのIDです。アプリの「イベント履歴」でこれを検索すると、具体的に何が送信されたかを確認できます。

例：アカウントを有効化した顧客にタグを付ける

トリガーとして「**顧客の状態が変更された」**を選択します。
条件を追加：newState が enabled と等しい。
account-active を使用して、顧客タグを追加します。
ワークフローを有効にしてください。

顧客向けEメールマーケティングの同意に関する変更

顧客のEメールマーケティングに関する同意状況に変更があった際にトリガーされます。consentState が新しいステータスです：subscribed、not_subscribed、pending、unsubscribed、または redacted。


火災の原因は	Shopify Webhook
許可	顧客データへのアクセス
電源が入った	これを使用するFlowワークフローを有効にすると、それがオンになります。この機能専用のスイッチは、アプリの「トリガー」ページにあります。

次のような用途にご利用ください

外部のメールツールとShopifyとの間で、双方向の連携を保ちましょう。
コンプライアンスのために、購読解除の記録を残す。

「顧客のEメールマーケティングに関する同意内容の変更」がワークフローに送信する内容

フロー内の変数	種類	その中身
`customer`	顧客（Shopify）	Eメールマーケティングへの同意内容が変更された顧客です。Shopifyのフル機能を利用している顧客であるため、そのすべてのフィールドおよびFlow独自の顧客アクションが利用可能です。
`consentState`	テキスト	Eメールマーケティングの同意ステータス：購読中、未購読、保留中、購読解除、または非表示
`optInLevel`	テキスト	オプトインレベル：single_opt_in、confirmed_opt_in、またはunknown（空の場合あり）
`consentUpdatedAt`	テキスト	顧客がこの同意を最後に更新した時点のISO-8601タイムスタンプ（空の場合あり）
`eventId`	テキスト	このイベントのIDです。アプリの「イベント履歴」でこれを検索すると、具体的に何が送信されたかを確認できます。

例：外部リストから購読を解除した顧客を除外する

トリガーとして「**顧客のEメールマーケティングに関する同意の変更」**を選択します。
条件を追加：consentState が unsubscribed と等しい。
{{customer.id}} を使用して、メールツールの配信停止エンドポイントに HTTP リクエストを送信する機能を追加します。
ワークフローを有効にしてください。

顧客向けSMSマーケティングの同意要件が変更されました

顧客のSMSマーケティングに関する同意状況に変更があった際にトリガーされます。


火災の原因は	Shopify Webhook
許可	顧客データへのアクセス
電源が入った	これを使用するFlowワークフローを有効にすると、それがオンになります。この機能専用のスイッチは、アプリの「トリガー」ページにあります。

次のような用途にご利用ください

SMSプロバイダーへのSMS同意をミラーリングする。
オプトアウト直後にSMSの配信を停止してください。

「顧客のSMSマーケティングに関する同意内容の変更」がワークフローに与える影響

フロー内の変数	種類	その中身
`customer`	顧客（Shopify）	SMSマーケティングへの同意内容が変更された顧客です。Shopifyのフル機能版を利用している顧客であるため、すべてのフィールドおよびFlow独自の顧客アクションが利用可能です。
`consentState`	テキスト	SMSマーケティングの同意状況：登録済み、未登録、保留中、登録解除済み、または非表示
`optInLevel`	テキスト	オプトインレベル：single_opt_in、confirmed_opt_in、またはunknown（空の場合あり）
`consentUpdatedAt`	テキスト	顧客がこの同意を最後に更新した時点のISO-8601タイムスタンプ（空の場合あり）
`eventId`	テキスト	このイベントのIDです。アプリの「イベント履歴」でこれを検索すると、具体的に何が送信されたかを確認できます。

例：SMS購読者にタグを付ける

トリガーとして「**顧客のSMSマーケティングへの同意が変更された」**を選択します。
条件を追加：「consentState」が「subscribed」と等しい。その下に**、「**顧客タグ『sms-subscriber』を追加」を追加します。
**「その他」**の下にある「顧客タグの削除」sms-subscriber。
ワークフローを有効にしてください。

顧客名の変更

顧客の氏名または名字に変更があった際に発火します。現在の氏名を保持します。


火災の原因は	Shopify Webhook と変更検出
許可	顧客データへのアクセス
電源が入った	これを使用するFlowワークフローを有効にすると、それがオンになります。この機能専用のスイッチは、アプリの「トリガー」ページにあります。

次のような用途にご利用ください

CRM、ERP、またはロイヤリティ管理ツールに登録されている顧客名を常に最新の状態に保ってください。

「顧客名の変更」がワークフローに送信する内容

フロー内の変数	種類	その中身
`customer`	顧客（Shopify）	名前が変更された顧客。Shopifyのフル機能版を利用している顧客であるため、すべてのフィールドおよびFlow独自の顧客アクションが利用可能です。
`firstName`	テキスト	お客様の現在の名前
`lastName`	テキスト	お客様の現在の姓
`eventId`	テキスト	このイベントのIDです。アプリの「イベント履歴」でこれを検索すると、具体的に何が送信されたかを確認できます。

例：変更された名称をERPに反映する

Flowのトリガーとして「**顧客名の変更」**を選択します。
「{{customer.id}}」、「{{firstName}}」、「{{lastName}}」を使用してHTTPリクエストを送信する機能を追加します。
ワークフローを有効にしてください。

お客様のメールアドレスが変更されました

顧客のメールアドレスが変更された際に送信されます。現在のメールアドレスが記載されています。


火災の原因は	Shopify Webhook と変更検出
許可	顧客データへのアクセス
電源が入った	これを使用するFlowワークフローを有効にすると、それがオンになります。この機能専用のスイッチは、アプリの「トリガー」ページにあります。

次のような用途にご利用ください

メールアドレスをキーとするツール内の住所を更新してください。
この変更に関するセキュリティ通知を送信してください。

「顧客メールの変更」がワークフローに送信する内容

フロー内の変数	種類	その中身
`customer`	顧客（Shopify）	メールアドレスが変更された顧客です。Shopifyのフル機能を利用している顧客であるため、すべてのフィールドおよびFlow独自の顧客アクションが利用可能です。
`email`	テキスト	お客様の現在のデフォルトのメールアドレス
`eventId`	テキスト	このイベントのIDです。アプリの「イベント履歴」でこれを検索すると、具体的に何が送信されたかを確認できます。

例：メールアドレスの変更についてサポートに連絡する

フロー内で「**顧客のメールアドレスが変更された」**を選択します。
「{{customer.displayName}}」と管理者用リンクを記載した内部メールをサポート宛てに送信する機能を追加してください。多くの人が閲覧するチャンネルに「{{email}}」を投稿する前には、よく考えてください。
ワークフローを有効にしてください。

お客様の電話番号が変更されました

顧客の電話番号が変更された際に発火します。現在の番号を保持しています。


火災の原因は	Shopify Webhook と変更検出
許可	顧客データへのアクセス
電源が入った	これを利用するFlowワークフローを有効にすると、それがオンになります。この機能専用のスイッチは、アプリの「トリガー」ページにあります。

次のような用途にご利用ください

SMSや電話ツールを常に最新の状態に保つ。

「顧客の電話番号変更」がワークフローに送信する内容

フロー内の変数	種類	その中身
`customer`	顧客（Shopify）	電話番号が変更された顧客。Shopifyのフル機能を利用している顧客であるため、すべてのフィールドとFlow独自の顧客アクションが利用可能です。
`phone`	テキスト	お客様の現在のデフォルトの電話番号
`eventId`	テキスト	このイベントのIDです。アプリの「イベント履歴」でこれを検索すると、具体的に何が送信されたかを確認できます。

例：新しい電話番号をSMSプロバイダーと同期する

フロー内で顧客の電話番号が変更されました。
{{customer.id}} および {{phone}} を使用して、プロバイダーに HTTP リクエストを送信する機能を追加します。
ワークフローを有効にしてください。

お客様の住所が変更されました

顧客のデフォルト住所が変更された際にトリガーされます。address は1行でフォーマットされた形式、addressDetails は同じ住所が個別のフィールドに分かれて記載された形式です。


火災の原因は	Shopify Webhook と変更検出
許可	顧客データへのアクセス
電源が入った	これを使用するFlowワークフローを有効にすると、それがオンになります。この機能専用のスイッチは、アプリの「トリガー」ページにあります。

次のような用途にご利用ください

顧客が国を移動した場合は、税務区分や配送ゾーンの割り当てを再確認してください。
ERPの債務者レコードを更新する。

「顧客住所の変更」がワークフローに送信する内容

フロー内の変数	種類	その中身
`customer`	顧客（Shopify）	デフォルトの住所が変更された顧客です。Shopifyのフル機能版を利用している顧客であるため、すべてのフィールドおよびFlow独自の顧客アクションを利用できます。
`address`	テキスト	顧客の現在のデフォルト住所を、1行にまとめて表示（空の場合もある）
`addressDetails`	目的	構造化フィールドとして表された、顧客の現在のデフォルトの住所（空の場合もある）
`addressDetails.firstName`	テキスト	住所に記載されている名前（ファーストネーム）
`addressDetails.lastName`	テキスト	住所に記載されている姓
`addressDetails.name`	テキスト	フルネーム（firstName と lastName から算出）
`addressDetails.company`	テキスト	会社名または団体名
`addressDetails.address1`	テキスト	1行目 - 住所または私書箱番号
`addressDetails.address2`	テキスト	2行目 - アパート、スイート、またはユニット
`addressDetails.city`	テキスト	市、区、村、または町
`addressDetails.province`	テキスト	地域 - 県、州、または地区
`addressDetails.provinceCode`	テキスト	リージョンコード（例：ON）
`addressDetails.zip`	テキスト	郵便番号
`addressDetails.country`	テキスト	国名
`addressDetails.countryCode`	テキスト	2文字の国コード（例：US）
`addressDetails.phone`	テキスト	住所に記載されている電話番号
`eventId`	テキスト	このイベントのIDです。アプリの「イベント履歴」でこれを検索すると、具体的に何が送信されたかを確認できます。

例：他国へ移住した顧客を特定する

フロー内で顧客の住所が変更されたものを選択してください。
条件を追加：addressDetails.countryCode ≠ DE（自国市場）。
international を使用して、顧客タグを追加します。
ワークフローを有効にしてください。

今後の手順

トリガーの完全なリファレンス - すべてのトリガーを1つのページにまとめる。
適切なトリガーの選択 - どちらがあなたのケースに当てはまりますか。
カスタムトリガー - 組み込みのトリガーがどれも当てはまらない場合は、独自のトリガーを作成してください。
イベント履歴とトラブルシューティング - 何が発射され、何を搭載していたかを確認する。
レコードの管理ページでのトリガーイベント - 1つのレコードに関する最新のイベントが、Shopifyの管理画面内のそのレコード専用のページに表示されます。