從訂單或客戶的元資料欄位附加檔案

許多應用程式會針對訂單或客戶儲存檔案:例如來自開立發票應用程式的發票或包裝單 PDF、證書,或是已簽署的合約。Shopify 會將這些檔案儲存於元字段中,形式可以是您 Shopify 檔案中的檔案,或是指向該檔案的連結。 此應用程式可將該檔案附加至「Shopify Flow」工作流程發送的電子郵件中,無需您手動上傳或建立連結。

運作原理

  1. 另一款應用程式(或您)會將檔案(或其連結)寫入訂單或客戶的元資料欄位中。在您的 Shopify 管理後台中,路徑為「設定 > 自訂資料 > 訂單(或客戶)」:此處可設定為「檔案」、「網址」類型,或是由應用程式寫入連結的文字欄位。
  2. 在電子郵件版面配置中,您添加附件並選擇**「元字段」**作為其來源,然後選取該定義。選取器會顯示每個選項所包含的內容:檔案、連結,或是兩者的清單。
  3. 在 Shopify Flow 中,「發送交易電子郵件」或**「發送行銷電子郵件」**步驟設有「訂單」欄位和「客戶」欄位。Shopify Flow 會從觸發器中填入這些欄位,因此由「_已建立訂單」_觸發的工作流程,一啟動便已知曉是哪筆訂單。
  4. 當電子郵件寄出時,應用程式會讀取該訂單或客戶的該個元資料欄位,下載檔案(從您的 Shopify 檔案中,或透過連結),並將其附加至郵件中。若為清單型元資料欄位,則會將每個項目附加進去。

該佈局僅指定元欄位名稱。工作流程會標明是哪一筆訂單或哪位客戶,因此一個佈局即可適用於所有訂單。

檔案與連結

該元欄位包含 定義類型 這款應用程式的功能
一個 Shopify 檔案 檔案、檔案清單 根據您「檔案」中該檔案的參照路徑,將其下載
一個連結 網址、網址清單或文字輸入欄位 從該連結下載檔案。僅支援 https:// 格式的連結;若連結無法回應,或指向的檔案類型並非 PDF、圖片、CSV 或文字檔,則會因以下原因導致傳送失敗:

無論如何,檔案大小都是在寄送電子郵件時進行檢查,而非在編輯器中,因此元資料欄位的附件不會計入編輯器的附件總數中。

設定好它

富文本與 HTML 版面配置

在編輯器底部的「附件」卡片中,點選**「從元資料欄位新增」**。選擇「**訂單」**或「客戶」,然後選擇該定義。該列會顯示定義的名稱、其內容以及namespace.key;點選「**變更」**可選擇另一個定義。

視覺佈局

新增一個**「附件」區塊(或開啟現有的區塊),並將其來源切換為「元資料欄位」**。**選擇「元資料欄位」**會開啟相同的選取器。

權限

安裝此應用程式時,不會取得您商店資料的任何存取權限。當您首次選取訂單或客戶的元資料欄位時,選取器會要求讀取該資源的元資料欄位及其所指向的檔案。Shopify 會顯示其自身的同意對話方塊;點選「更新」後,定義清單便會載入。

您可隨時在應用程式的**「權限」**頁面中檢視並撤銷各項權限。撤銷某項權限後,凡是附有來自該元資料欄位的檔案之電子郵件,都將無法寄出,直到該權限再次被授予為止。各項權限的具體內容及其不包含的範圍,請參閱 權限:應用程式可以從您的商店讀取哪些資料。

檔案名稱

預設情況下,附件會保留檔案本身的名稱:即您在「Shopify 檔案」中顯示的名稱,或是連結的最後一部分。若填寫**「檔案名稱」**欄位,該名稱將覆寫預設名稱,且支援 Liquid 語法,例如 invoice-{{ variables.order_name }}.pdf。當清單元資料欄位包含多個項目時,第二項及後續項目會在覆寫名稱後附加 -2、-3。

當元欄位為空時

寫入檔案的應用程式通常會在觸發後幾秒鐘才執行,因此當電子郵件步驟執行時,元資料欄位可能仍為空。此時會發生什麼情況,則取決於附件的「**可選」**核取方塊:

可選 行為
關閉(預設) 電子郵件尚未寄出。應用程式會指示 Shopify Flow 重新嘗試此步驟,而 Shopify Flow 稍後會重新傳送該郵件;只要檔案一上傳,電子郵件就會立即寄出。
於 這封電子郵件是未附上此附件的情況下寄出的。

對於必須包含的發票,請保持關閉狀態;對於僅部分訂單才有的檔案,請開啟此功能。

要求與限制

  • 「Shopify Flow」步驟需要設定其**「Order」或「Customer」**欄位。在此版本發布前新增的步驟尚未具備這些欄位:請在「Shopify Flow」編輯器中刪除該步驟,然後重新新增。
  • 每個檔案大小上限為 10 MB;支援 PDF、圖片、CSV、純文字及行事曆檔案。影片和 3D 模型將被跳過。
  • 連結必須以 https:// 開頭,且無需登入即可存取。若連結會重新導向至非 https 位址,或導向至私有網路,則不予接受。
  • **過去 60 天的訂單。**Shopify 僅允許應用程式讀取最近的訂單。若工作流程涉及較舊的訂單,傳送操作將失敗並顯示明確的錯誤訊息。
  • Microsoft 365 會拒絕總附件大小超過 4 MB 的郵件;請參閱 附件與圖片。

你在「歷史」中看到的是什麼

所有結果皆記錄於「歷史紀錄」頁面中。若出現未下達的訂單、已撤銷的授權、Shopify 無法找到的訂單、無法回應的連結,或超過限額的檔案,系統會將其記錄為**「失敗」**,並附上原因及應修正之處。 若元資料欄位為空且「可選」選項關閉,則不視為失敗:Shopify Flow 會顯示重試紀錄,且當檔案上傳完成後,系統會顯示「已發送」。從「歷史紀錄」中選擇「重新發送」,系統將再次讀取相同的訂單或客戶資料。

試試看

在版面編輯器中發送測試電子郵件時,由於沒有訂單或客戶資料可供讀取,因此會不附帶元資料欄位附件地發送。若要測試附件,請在 Shopify Flow 上針對已包含該檔案的訂單執行工作流程,或使用**「在 Shopify Flow 測試中執行」**功能,並選用此類訂單進行測試。

相關