從訂單或客戶的元資料欄位附加檔案
許多應用程式會針對訂單或客戶儲存檔案:例如來自開立發票應用程式的發票或包裝單 PDF、證書,或是已簽署的合約。Shopify 會將這些檔案儲存於元字段中,形式可以是您 Shopify 檔案中的檔案,或是指向該檔案的連結。 此應用程式可將該檔案附加至「Shopify Flow」工作流程發送的電子郵件中,無需您手動上傳或建立連結。
運作原理
- 另一款應用程式(或您)會將檔案(或其連結)寫入訂單或客戶的元資料欄位中。在您的 Shopify 管理後台中,路徑為「設定 > 自訂資料 > 訂單(或客戶)」:此處可設定為「檔案」、「網址」類型,或是由應用程式寫入連結的文字欄位。
- 在電子郵件版面配置中,您添加附件並選擇**「元字段」**作為其來源,然後選取該定義。選取器會顯示每個選項所包含的內容:檔案、連結,或是兩者的清單。
- 在 Shopify Flow 中,「發送交易電子郵件」或**「發送行銷電子郵件」**步驟設有「訂單」欄位和「客戶」欄位。Shopify Flow 會從觸發器中填入這些欄位,因此由「_已建立訂單」_觸發的工作流程,一啟動便已知曉是哪筆訂單。
- 當電子郵件寄出時,應用程式會讀取該訂單或客戶的該個元資料欄位,下載檔案(從您的 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 測試中執行」**功能,並選用此類訂單進行測試。
相關
- 權限:應用程式可以從您的商店讀取哪些資料 - 可選權限的具體內容,以及如何撤銷這些權限。
- 附件與圖片 - 上傳的附件、附件模式與連結模式的區別,以及檔案大小。
- 從 Shopify Flow 傳遞資料 - 步驟欄位與變數。
- 歷史與疑難排解 - 讀取一次發送失敗的訊息。

