客戶觸發機制，逐步解說

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

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

客戶公告

每當儲存客戶記錄時都會觸發。它會傳回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。請在應用程式的「事件記錄」中搜尋此 ID，以查看確切的傳送內容。

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

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

已新增客戶標籤

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

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

用於

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

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

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

範例：歡迎新批發客戶

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

已移除客戶標籤

當客戶身上至少有一個標籤被移除時觸發。removedTags 會記錄已被移除的標籤。

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

用於

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

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

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

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

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

客戶備註已變更

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

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

用於

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

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

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

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

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

客戶狀態已變更

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

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

用於

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

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

流量中的變量	類型	內容為何
customer	客戶（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
權限	客戶資料存取
已開啟	啟用一個使用該功能的 Flow 工作流程，即可開啟該功能。其專屬開關位於應用程式的「**觸發器」**頁面中

用於

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

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

流量中的變數	類型	內容為何
customer	客戶（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
權限	客戶資料存取
已開啟	啟用一個使用該功能的 Flow 工作流程，即可開啟該功能。其專屬開關位於應用程式的「**觸發器」**頁面上

用於

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

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

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

範例：為簡訊訂戶加上標籤

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

客戶名稱已變更

當客戶的姓名或姓氏變更時觸發。其中包含當前的姓名。

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

用於

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

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

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

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

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

客戶電子郵件地址已變更

當客戶的電子郵件地址變更時，系統會觸發此事件。該事件會攜帶當前的電子郵件地址。

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

用於

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

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

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

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

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

客戶電話號碼已變更

當客戶的電話號碼變更時觸發。該事件會攜帶當前的號碼。

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

用於

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

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

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

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

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

客戶地址變更

當客戶的預設地址變更時觸發。address 為單行格式化內容，addressDetails 則是將同一地址分列於不同欄位中。

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

用於

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

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

流量中的變量	類型	內容為何
customer	客戶（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	文字	此事件的識別碼。請在應用程式的「事件歷史紀錄」中搜尋該識別碼，以查看確切的傳送內容。

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

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

下一步

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