客戶觸發機制，逐步解說

客戶記錄變更的十一項觸發條件。其中七項涉及每家門市均可自由使用的資料（標籤、備註、帳戶狀態、行銷同意）。其餘四項涉及個人資料 - - 姓名、電子郵件、電話號碼、地址 - - 除需取得授權外，還需用戶主動同意。

本頁內容：客戶更新, 新增客戶標籤, 移除客戶標籤, 客戶備註變更, 客戶狀態變更, 客戶電子郵件行銷同意狀態變更, 客戶簡訊行銷同意狀態變更, 客戶姓名變更, 客戶電子郵件變更, 客戶電話號碼變更, 客戶地址變更

客戶公告

每當儲存客戶記錄時便會觸發。它會攜帶changes：即已追蹤且發生變更的欄位（標籤、備註、帳戶狀態），並包含變更前與變更後的值。

火災源自	Shopify Webhook 加上變更偵測
權限	客戶資料存取
已開啟	啟用一個使用該功能的「Shopify Flow」工作流程，即可將其開啟。其專屬開關位於該應用程式的「**觸發器」**頁面中

用於

• 一個適用於多種客戶編輯類型的工作流程，並在 changes.fields 處進行分支。
• 將每項客戶變更同步至 CRM。

「客戶更新」會將哪些內容傳送至您的工作流程

Shopify Flow 中的變數	類型	內容為何
customer	客戶（Shopify）	客戶。這是一個完整的「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。請在應用程式的「事件歷史紀錄」中搜尋該 ID，以查看確切的傳送內容。

範例：將追蹤到的客戶變更資料轉發至 CRM

1. 選擇「**客戶更新」**作為觸發條件。
2. 新增條件：changes.fields 既非空，又存在。
3. 使用 {{customer.id}} 並透過 changes.items（field、oldValue、newValue）的迴圈，將**「傳送 HTTP 請求」**功能新增至您的 CRM。
4. 開啟此工作流程。

已新增客戶標籤

當客戶被新增至少一個標籤時觸發。addedTags 僅包含新增的標籤。

火災源自	Shopify Webhook 加上變更偵測
權限	客戶資料存取
已開啟	啟用一個使用該功能的「Shopify Flow」工作流程，即會開啟該功能。其專屬開關位於該應用程式的「**觸發器」**頁面中

用於

• 當員工或其他應用程式為客戶標記 wholesale 或 vip 時，即可開始進行入職流程。
• 對忠誠度、訂閱或評論應用程式所建立的標籤做出反應。

「新增的客戶標籤」會將哪些內容傳送至您的工作流程

Shopify Flow 中的變數	類型	內容為何
customer	客戶（Shopify）	標籤已變更的客戶。此為完整的 Shopify 客戶，因此其所有欄位以及 Shopify Flow 自身的客戶操作皆可使用。
addedTags	文字	以逗號分隔的標籤清單，這些標籤已新增至該客戶
removedTags	文字	在同一筆更新中從該客戶移除的標籤清單（以逗號分隔），該清單可能為空
currentTags	文字	以逗號分隔的清單，列出該客戶目前的所有標籤
previousTags	文字	此更新之前，該客戶所有先前標籤的以逗號分隔清單
eventId	文字	此事件的 ID。請在應用程式的「事件歷史紀錄」中搜尋該 ID，以查看確切的傳送內容。

範例：歡迎新批發客戶

1. 選擇「**新增客戶標籤」**作為觸發條件。
2. 新增條件：addedTags 包含 wholesale。
3. 新增**「透過 {{customer.displayName}} 向帳戶經理發送內部電子郵件**」，或「向您的電子郵件工具發送 HTTP 請求」，以啟動歡迎系列郵件。
4. 開啟此工作流程。

已移除客戶標籤

當客戶身上至少被移除一個標籤時觸發此事件。removedTags 會儲存已被移除的標籤。

火災源自	Shopify Webhook 加上變更偵測
權限	客戶資料存取
已開啟	啟用一個使用該功能的「Shopify Flow」工作流程，即可開啟此功能。其專屬開關位於該應用程式的「**觸發器」**頁面中

用於

• 當會員標籤消失時，撤銷相關權益。
• 當訂閱型應用程式移除其「active-subscriber」標籤時，請通知團隊。

「已移除的客戶標籤」會將哪些內容傳送至您的工作流程

Shopify Flow 中的變數	類型	內容為何
customer	客戶（Shopify）	標籤已變更的客戶。此為完整的「Shopify」客戶，因此其所有欄位以及「Shopify Flow」自身的客戶操作皆可使用。
addedTags	文字	在同一筆更新中新增至該客戶的標籤清單（以逗號分隔；可能為空）
removedTags	文字	從客戶處移除的標籤清單（以逗號分隔）
currentTags	文字	以逗號分隔的清單，列出該客戶目前所有的標籤
previousTags	文字	此更新之前，該客戶所有先前標籤以逗號分隔的清單
eventId	文字	此事件的 ID。請在應用程式的「事件歷史紀錄」中搜尋此 ID，以查看確切的傳送內容。

範例：當訂閱者標籤被移除時進行後續追蹤

1. 選擇「**移除客戶標籤」**作為觸發條件。
2. 新增條件：removedTags 包含 active-subscriber。
3. 使用「winback」新增客戶標籤，並向「retention」寄送內部電子郵件。
4. 開啟此工作流程。

客戶備註已變更

當客戶的備註被新增、修改或清除時觸發。

火災源自	Shopify Webhook 加上變更偵測
權限	客戶資料存取
已開啟	啟用一個使用該功能的 Shopify Flow 工作流程，即可開啟此功能。該功能的專用開關位於應用程式的「**觸發器」**頁面上

用於

• 由支援團隊撰寫給帳戶持有人的路線說明。
• 從筆記中解析關鍵字（#callback），並啟動一項任務。

「客戶備註變更」會將哪些內容傳送至您的工作流程

Shopify Flow 中的變數	類型	內容為何
customer	客戶（Shopify）	該客戶的備註內容已變更。此為完整的 Shopify 客戶，因此其所有欄位以及 Shopify Flow 自身提供的客戶操作功能皆可使用。
oldNote	文字	該客戶的先前備註（若先前未設定備註，則為空）
newNote	文字	客戶的新備註（若備註已清除，則為空）
eventId	文字	此事件的 ID。請在應用程式的「事件歷史紀錄」中搜尋該 ID，以查看確切的傳送內容。

範例：從筆記建立回呼任務

1. 選擇「**客戶備註已變更」**作為觸發條件。
2. 新增條件：newNote 包含 #callback。
3. 透過 {{customer.displayName}} 和 {{newNote}}，將**「發送內部電子郵件」**或「發送請求」新增至您的任務管理工具中。
4. 開啟此工作流程。

客戶狀態已變更

當客戶的帳戶狀態在「disabled」、「enabled」、「invited」及「declined」之間發生變更時觸發。

火災源自	Shopify Webhook 加上變更偵測
權限	客戶資料存取
已開啟	啟用一個使用該功能的「Shopify Flow」工作流程，即可開啟此功能。其專屬開關位於該應用程式的「**觸發器」**頁面中

用於

• 當客戶啟用帳戶時，請向他們問好。
• 查看誰拒絕了帳號邀請。

「客戶狀態變更」會將哪些資訊傳送至您的工作流程

Shopify Flow 中的變數	類型	內容為何
customer	客戶（Shopify）	帳戶狀態發生變更的客戶。此為完整的「Shopify」客戶，因此其所有欄位以及「Shopify Flow」自身的客戶操作皆可使用。
oldState	文字	先前帳戶狀態（停用、啟用、已受邀或已拒絕）
newState	文字	新帳戶狀態（停用、啟用、已受邀或已拒絕）
eventId	文字	此事件的 ID。請在應用程式的「事件歷史紀錄」中搜尋此 ID，以查看確切的傳送內容。

範例：標記已啟用帳戶的客戶

1. 選擇「**客戶狀態變更」**作為觸發條件。
2. 新增一個條件：newState 等於 enabled。
3. 使用 account-active 新增客戶標籤。
4. 開啟此工作流程。

客戶電子郵件行銷同意事項已變更

當客戶的電子郵件行銷同意狀態發生變更時觸發。consentState 代表新的狀態：subscribed、not_subscribed、pending、unsubscribed 或 redacted。

火災源自	Shopify webhook
權限	客戶資料存取
已開啟	啟用一個使用該功能的「Shopify Flow」工作流程，即可開啟此功能。其專屬開關位於該應用程式的「**觸發器」**頁面中

用於

• 確保外部電子郵件工具能與 Shopify 雙向同步。
• 為符合合規要求，請記錄取消訂閱的紀錄。

「客戶電子郵件行銷同意書變更」會將哪些內容傳送至您的工作流程

Shopify Flow 中的變數	類型	內容為何
customer	客戶（Shopify）	此客戶的電子郵件行銷同意狀態已變更。該客戶為完整的 Shopify 客戶，因此其所有欄位以及 Shopify Flow 自身的客戶操作資料皆可供使用。
consentState	文字	新的電子郵件行銷同意狀態：已訂閱、未訂閱、待處理、已取消訂閱，或已遮蔽
optInLevel	文字	訂閱方式：single_opt_in、confirmed_opt_in 或未知（可能為空）
consentUpdatedAt	文字	客戶上次更新此同意書時的 ISO-8601 時間戳記（可能為空）
eventId	文字	此事件的 ID。請在應用程式的「事件歷史紀錄」中搜尋此 ID，以查看確切的傳送內容。

範例：從外部名單中移除已取消訂閱的客戶

1. 選擇「**客戶電子郵件行銷同意狀態變更」**作為觸發條件。
2. 新增一個條件：consentState 等於 unsubscribed。
3. 使用 {{customer.id}}，向您的電子郵件工具的取消訂閱端點發送 HTTP 請求。
4. 開啟此工作流程。

客戶簡訊行銷同意事項已變更

當客戶對簡訊行銷的同意狀態發生變更時，系統會觸發此事件。

火災源於	Shopify webhook
權限	客戶資料存取
已開啟	啟用一個使用該功能的 Shopify Flow 工作流程，即可開啟此功能。該功能專屬的開關位於應用程式的「**觸發器」**頁面中

用於

• 將簡訊同意書同步至簡訊服務供應商。
• 在用戶選擇退出後，請立即停止簡訊發送。

「客戶簡訊行銷同意事項變更」會將哪些內容傳送至您的工作流程

Shopify Flow 中的變數	類型	內容為何
customer	客戶（Shopify）	此為已變更簡訊行銷同意狀態的客戶。該客戶為完整的 Shopify 客戶，因此其所有欄位以及 Shopify Flow 自身的客戶操作皆可供使用。
consentState	文字	新的簡訊行銷同意狀態：已訂閱、未訂閱、待處理、已取消訂閱，或內容已遭遮蔽
optInLevel	文字	訂閱方式：single_opt_in、confirmed_opt_in 或未知（可能為空）
consentUpdatedAt	文字	客戶上次更新此同意書時的 ISO-8601 時間戳記（可能為空）
eventId	文字	此事件的 ID。請在應用程式的「事件歷史紀錄」中搜尋此 ID，以查看確切的傳送內容。

範例：為 SMS 訂戶加上標籤

1. 選擇「**客戶簡訊行銷同意狀態變更」**作為觸發條件。
2. 新增一個條件：consentState 等於 subscribed。接著新增「新增客戶標籤」sms-subscriber。
3. 在**「其他」**下方，新增「移除客戶標籤」sms-subscriber。
4. 開啟此工作流程。

客戶名稱已變更

當客戶的姓名或姓氏變更時觸發。該欄位會記錄當前的姓名。

火災源自	Shopify Webhook 加上變更偵測
權限	客戶資料存取
已開啟	啟用一個使用該功能的「Shopify Flow」工作流程，即可開啟此功能。其專屬開關位於該應用程式的「**觸發器」**頁面中

用於

• 請確保 CRM、ERP 或客戶忠誠度工具中的姓名資料保持最新。

「客戶名稱變更」會將哪些資料傳送至您的工作流程

Shopify Flow 中的變數	類型	內容為何
customer	客戶（Shopify）	名稱已變更的客戶。此為完整的「Shopify」客戶，因此其所有欄位以及「Shopify Flow」自身的客戶操作皆可使用。
firstName	文字	客戶目前的名字
lastName	文字	客戶目前的姓氏
eventId	文字	此事件的 ID。請在應用程式的「事件歷史紀錄」中搜尋此 ID，以查看確切的傳送內容。

範例：將變更後的名稱推送至 ERP

1. 在 Shopify Flow 中，選擇「**客戶名稱變更」**作為觸發條件。
2. 新增「傳送 HTTP 請求」功能，並搭配 {{customer.id}}、{{firstName}} 及 {{lastName}} 使用。
3. 開啟此工作流程。

客戶電子郵件地址已變更

當客戶的電子郵件地址變更時觸發。該通知會載明當前的電子郵件地址。

火災源自	Shopify Webhook 加上變更偵測
權限	客戶資料存取
已開啟	啟用一個使用該功能的「Shopify Flow」工作流程，即可開啟此功能。其專屬開關位於該應用程式的「**觸發器」**頁面中

用於

• 請在以電子郵件為依據的工具中更新該地址。
• 針對此變更發送一則安全通知。

「客戶電子郵件變更」會將哪些內容傳送至您的工作流程

Shopify Flow 中的變數	類型	內容為何
customer	客戶（Shopify）	電子郵件地址已變更的客戶。此為完整的 Shopify 客戶，因此其所有欄位以及 Shopify Flow 自身的客戶操作皆可使用。
email	文字	客戶目前的預設電子郵件地址
eventId	文字	此事件的 ID。請在應用程式的「事件歷史紀錄」中搜尋此 ID，以查看確切的傳送內容。

範例：向支援團隊通報電子郵件地址變更

1. 在Shopify Flow中，客戶電子郵件已變更。
2. 請新增「透過 {{customer.displayName}} 及管理員連結向支援團隊發送內部電子郵件」這項選項。在將 {{email}} 放進許多人閱讀的頻道之前，請三思而後行。
3. 開啟此工作流程。

客戶電話號碼已變更

當客戶的電話號碼變更時會觸發此事件。該事件會傳遞當前的號碼。

火災源自	Shopify Webhook 加上變更偵測
權限	客戶資料存取
已開啟	啟用一個使用該功能的「Shopify Flow」工作流程，即可開啟此功能。其專屬開關位於應用程式的「**觸發器」**頁面中

用於

• 請保持簡訊或語音通話工具的版本為最新。

「客戶電話變更」會將哪些資料傳送至您的工作流程

Shopify Flow 中的變數	類型	內容為何
customer	客戶（Shopify）	該客戶的電話號碼已變更。此為完整的「Shopify」客戶，因此其所有欄位以及「Shopify Flow」自身的客戶操作皆可使用。
phone	文字	客戶目前的預設電話號碼
eventId	文字	此事件的 ID。請在應用程式的「事件歷史紀錄」中搜尋此 ID，以查看確切的傳送內容。

範例：將新電話號碼同步至簡訊服務供應商

1. 在Shopify Flow中，客戶電話號碼已變更。
2. 請將「向服務提供者發送 HTTP 請求」新增至 {{customer.id}} 及 {{phone}}。
3. 開啟此工作流程。

客戶地址變更

當客戶的預設地址變更時觸發。address 是一行格式化的內容，addressDetails 則是將相同地址分開填入各欄位。

火災源自	Shopify Webhook 加上變更偵測
權限	客戶資料存取
已開啟	啟用一個使用該功能的「Shopify Flow」工作流程，即可將其開啟。其專屬開關位於該應用程式的「**觸發器」**頁面中

用於

• 當客戶遷居至其他國家時，請重新檢查稅務或運送區域的分配設定。
• 更新 ERP 債務人記錄。

「客戶地址變更」會將哪些資料傳送至您的工作流程

Shopify Flow 中的變數	類型	內容為何
customer	客戶（Shopify）	此客戶的預設地址已變更。該客戶為完整的 Shopify 客戶，因此其所有欄位以及 Shopify Flow 自身提供的客戶操作功能皆可使用。
address	文字	客戶目前的預設地址，以單行格式呈現（可能為空）
addressDetails	對象	客戶目前的預設地址，以結構化欄位形式呈現（可能為空）
addressDetails.firstName	文字	地址上的名字
addressDetails.lastName	文字	地址上的姓氏
addressDetails.name	文字	全名，由 firstName 和 lastName 推導而出
addressDetails.company	文字	公司或組織名稱
addressDetails.address1	文字	第一行 - - 街道地址或郵政信箱號碼
addressDetails.address2	文字	第二行 - - 公寓、套房或單位
addressDetails.city	文字	市、區、村或鎮
addressDetails.province	文字	地區 - - 省、州或區
addressDetails.provinceCode	文字	地區代碼（例如 ON）
addressDetails.zip	文字	郵遞區號或郵政編碼
addressDetails.country	文字	國家名稱
addressDetails.countryCode	文字	兩字母國家代碼（例如 US）
addressDetails.phone	文字	地址上的電話號碼
eventId	文字	此事件的 ID。請在應用程式的「事件歷史紀錄」中搜尋此 ID，以查看確切的傳送內容。

範例：標記已移居他國的客戶

1. 在Shopify Flow中，選擇「客戶地址已變更」。
2. 新增條件：addressDetails.countryCode 不等於 DE（您的本土市場）。
3. 使用 international 新增客戶標籤。
4. 開啟此工作流程。

下一步

• 完整的觸發器參考指南 - 將所有觸發器集中於一頁。
• 選擇合適的扳機 - 哪一種適合您的情況。
• 自訂觸發器 - 若沒有合適的內建觸發器，請自行撰寫。
• 事件歷史紀錄與疑難排解 - 查看發射了什麼，以及它攜帶了什麼。
• 在記錄的管理頁面上觸發事件 - 某筆紀錄的最新動態，會顯示在「Shopify」管理介面中該紀錄的專屬頁面。