在 Shopify Flow 中查看您所選的版面配置
- **在 Shopify Flow 步驟中預覽所選的版面配置。**現在,Send Transactional Email和Send Marketing Email的設定頁面會在「版面配置」欄位下方顯示您所選的版面配置及其主旨。 預覽內容會根據佈局中的測試變數,以該佈局的主要語言呈現;若為行銷佈局,則會顯示其取消訂閱的頁尾。當您擁有多個佈局,或多個名稱相似的佈局時,可在儲存前確認該步驟將發送哪一個佈局。預覽中的連結無法開啟。
最新更新與改進。
新
已改進
您可以在不移除寄件者或變更現有 Shopify Flow 步驟的情況下,重新連線您的 Google 或 Microsoft 365 帳戶。現在,當登入權限過期時,即使所有必要權限已獲授予,您仍可進行重新連線。 選擇其他帳戶或取消授權時,現有設定將保持不變。儀表板、寄件者、歷史紀錄及開發者頁面亦能更有效率地載入資料。支援聊天按鈕將使用其正常的底部間距,而非額外的 Shopify 安全區域偏移量。
在視覺化排版中,若您使用「文字區塊」工具列將段落設定為居中或右對齊,該段落雖在編輯器與預覽畫面中顯示正常,但實際寄出的電子郵件卻採用了區塊本身的對齊方式(左對齊,除非您變更了該區塊)。這是因為段落的對齊設定是以電子郵件客戶端會忽略的方式寫入的。
問題已於今日修復。現在電子郵件的顯示效果將完全與編輯器中的預覽一致:段落的對齊方式將優先於其所屬區塊的對齊方式。您無需進行任何變更,也無需再次儲存版面配置;您工作流程中發送的下一封電子郵件已自動修正。
如果您之前曾設定過段落對齊方式,但電子郵件一直未依此顯示,從現在起將會照此顯示。請開啟版面配置一次,查看收件者所看到的內容;畫布上一直以來都已顯示該效果。
開發者 API 和 MCP 伺服器現已涵蓋應用程式在 1.16 和 1.17 版本中新增的所有功能。鍵值與權限等級維持不變:READ 鍵用於讀取,WRITE 鍵則可進行修改。
GET /api/v1/unsubscribes 列出包含遮罩地址的行銷郵件取消訂閱清單,POST /api/v1/unsubscribes/check 可查詢特定地址是否在清單中(請將地址填入郵件正文,切勿放入網址中),而 POST / DELETE /api/v1/unsubscribes 則可用於取消或重新訂閱某個地址(寫入操作)。MCP:list_unsubscribes、check_unsubscribed、add_unsubscribe、remove_unsubscribe。GET /api/v1/settings 會回傳商店的電子郵件預設值(抄送、密送、回覆至、寄件者名稱)、各語言的行銷頁尾文字、品牌顏色以及自訂字型。MCP:get_settings。GET /api/v1/permissions 列出了可選權限以及已授予的權限。MCP:get_permissions。GET /api/v1/presets 會回傳各語言的頁首與頁尾預設值及其對應文字。MCP:list_presets。GET /api/v1/sending-health 會回傳儀表板卡片上顯示的內容:失效的連結與圖片、寄件者問題、失敗率以及取消訂閱數。MCP:get_sending_health。emailTemplateId、senderId);清單會顯示總數,並可依版面配置、寄件者、姓名及回溯期間進行篩選。統計資料會單獨統計被跳過的行銷電子郵件(skippedInvocations)。localeConfirmed 說明該佈局是否已選定主要語言;若將未包含公司詳細資訊的行銷佈局儲存,會返回 warning;而佈局架構 (GET /api/v1/layout-schema) 則說明了來自元字段的附件、專屬折扣碼、預設值、{{ view_in_browser_url }} 以及公司詳細資訊。此外,已修正以下問題:Sidekick 不再從錯誤訊息中引用收件者地址;此外,在交易型佈局畫布上的電子郵件下方,以及「設定」>「行銷電子郵件」中的頁尾預覽下方,原先出現的一行技術性文字已移除。該文字從未出現在任何已發送的電子郵件中。
透過已連結的 Google 帳戶寄出的電子郵件,未能送達其密件副本 (BCC) 收件者。該地址雖被系統接受,並顯示於「歷史紀錄」及 Gmail 的「已寄出」資料夾中,但卻從交由 Gmail 處理的郵件中被移除,因此該步驟中 BCC 欄位所填的 CRM 記錄地址始終未收到該郵件的副本。 「收件者」和「副本」收件者並未受到影響,透過 Microsoft 365 或 SMTP 伺服器發送的電子郵件亦未受影響。
此問題已於今日修復。您的工作流程無需進行任何變更:從現在起,您所設定的密件副本 (BCC) 地址將照常使用。在今日之前發送的電子郵件並未送達至該密件副本 (BCC) 地址。
Workflow Transactional Email 現在也可以發送行銷電子郵件了,而且您原本發送的每封電子郵件都會完全維持原樣。
Workflow Transactional Email 以下是您的 Shopify 管理後台所使用的語言。目前提供英語、德語、西班牙語、法語、義大利語、荷蘭語、丹麥語、葡萄牙語(巴西與葡萄牙)、日語以及中文(簡體與繁體)版本。
語言設定將依照您在 Shopify 帳戶中選擇的語言。若要變更語言,請開啟您的 Shopify 帳戶個人資料,並選擇「偏好語言」。您團隊中的每位成員都會以各自的語言查看該應用程式。
有兩件事依然如故:
**此外已修正:**當您建立新的頁首或頁尾預設值時,有時「**儲存」**列不會出現,導致無法儲存該預設值。現在只要您進行任何變更,該列便會立即顯示在頁面頂端。
包含訂單明細表的版面配置,其**「Shopify Flow**」片段中包含一個針對產品的簡短 Shopify Flow 迴圈。將該片段貼入「發送交易電子郵件」動作的**「變數 (JSON)」**欄位後,系統顯示「JSON 格式無效」的錯誤訊息,儘管該片段本身並無錯誤。
原因在於:Shopify Flow 編輯器中的檢查功能,是在 Shopify Flow 還未填入任何內容之前就讀取了該文字。此時,該迴圈內容還不是 JSON;只有在工作流程執行時,它才會變成一組產品清單。
line_items 這行前後加上引號。"name": {{ order.customer.displayName | json }}。若某個步驟出現此錯誤,請開啟該步驟並重新貼上程式碼片段。目前正在執行的流程不會受到影響。訂單明細表 從 Shopify Flow 傳遞資料
迄今為止,對於完全沒有回應的 SMTP 伺服器,系統僅會進行重試:每封電子郵件都會因連線超時而失敗,且不會發送任何警示,因為單次超時並不能證明該伺服器已無法使用。
現在,應用程式會進行計數。當連續發生三次連線失敗後,商店會收到一則來自發件方的警示,其中會明確指出問題所在 - - 您的郵件伺服器未回應我們的連線嘗試 - - 並附上應檢查的項目:主機、埠號、伺服器是否正在運行,以及是否可從網際網路(包括從我們的發送 IP 位址)連線至該伺服器。成功發送後,計數器將重置。
在 SMTP 伺服器上執行「測試連線」,以及失敗電子郵件的「歷史紀錄」詳細資訊中,皆顯示相同的建議。通知與警示
向每位客戶發送其語言版本的電子郵件,透過描述來建立版面配置,並永遠不再遺漏任何變更。
{{order.customerLocale}},每位客戶便會收到對應的版本。以客戶的語言發送電子郵件{{ language }} 變數會儲存電子郵件所使用的語言,因此單一版面配置既能向德語客戶顯示一段文字,又能向其他所有客戶顯示另一段文字,無需進行完整翻譯。在版面配置的語言之間切換時,編輯器會保持原樣不變;僅內容會隨之變更。以客戶的語言發送電子郵件在現有的工作流程中使用新欄位:Shopify Flow 會保留步驟建立時所設定的欄位。若要在現有工作流程中取得「語言」、**「回覆至」及「寄件者名稱」**等欄位,請刪除「傳送交易電子郵件」步驟,然後重新新增該步驟。未進行變更的工作流程將完全依照原先的方式繼續運作。
這篇貼文要談的是那些你無法察覺的失誤:一個悄然停止發送的信箱、一個預覽時一切正常卻最終失敗的版面配置,以及在傳送到收件匣的過程中未能完整呈現的設計細節。
當電子郵件寄件者無法正常運作時,我們會通知您
直到現在,若某個寄件者發生故障,所有經由該寄件者發送的電子郵件都會失敗,而「歷史紀錄」中僅會顯示一行紅色字樣。
此提醒預設為開啟狀態。您可以在「通知」設定中將其關閉。
現在在編輯器中輸入的 Liquid 代碼,在寄送電子郵件時已可正常運作
像 {% if variables.total > 5 %} 這樣的比較運算子、{{ variables.name | default: "there" }} 這樣的引號過濾器,或是您已部分格式化的標籤,在預覽中可能看起來沒問題,但在實際發送時卻會因出現 expected "|" before filter 而失敗。這是因為編輯器以 Liquid 無法讀取的方式儲存了這些字元。
Shopify Flow 包含制表符或引號的資料,不再會導致您的電子郵件內容被清空
若產品標題或備註中包含分隔符號或引號(例如 12" vinyl),可能會導致「變數(JSON)」無法讀取,進而導致寄出的電子郵件中相關欄位呈現空白。
您的電子郵件設計會完全按照您所製作的樣式呈現
我們對外寄出的電子郵件所進行的安全檢查,移除了設計電子郵件所需的一些內容。
透過您自己的 SMTP 伺服器發送郵件更穩定
隱私權
瑣事
現在您可以刪除已上傳且不再需要的標誌、圖片和附件。此前,檔案只能透過編輯其所屬的版面配置來間接刪除,若您只是想清除舊標誌,這種方式並無助益。
在應用程式中
無論您在哪裡插入圖片或附件 - - 例如「品牌設定」中的標誌欄位,或是佈局中的「插入圖片」功能 - - 皆可開啟媒體選擇器。現在每個檔案的角落都設有「刪除」按鈕。確認後,該檔案將永久從儲存空間中移除。
系統會拒絕刪除仍在使用的檔案,並會告知您是哪個程式正在使用該檔案
此設計是刻意為之。此選取器讓您能將單一上傳檔案重複用於任意多個版面配置,因此若刪除仍被引用的檔案,將會悄無聲息地導致另一封仍在發送給客戶的電子郵件出現錯誤。若某個版面配置或共享的頁首/頁尾預設設定仍在使用該檔案,系統將拒絕刪除操作,並在訊息中列出相關檔案名稱。 請先將該檔案從這些項目中移除,再進行刪除。
任何「anything」或「nothing」的引用都會立即被刪除。
關於 API 和 MCP
GET /api/v1/files 列出您的檔案。加入 ?usage=true,每個檔案都會回報是否仍有其他項目引用它,因此您可以透過單一呼叫,找出所有可以安全刪除的項目。DELETE /api/v1/files 移除一個,並執行相同的運行中檢查。list_files 和 delete_file 這兩項服務。您可以要求它找出並移除您未使用的圖片,而它不會刪除仍被活躍電子郵件所需要的圖片。請參閱 REST API 參考手冊。
此外也已修復
儲存佈局時,系統原本會清理不再需要的檔案,但僅檢查其他佈局 - - 不包括共用頁首/頁尾預設值。若某個標誌僅由單一預設值使用,則可能被移除。現在這兩種情況都會執行相同的檢查。
您可以透過自己的程式碼,或透過像 Claude 或 Cursor 這樣的 AI 助理來管理您的操作。
開發者 API
這兩項服務皆透過專屬網址 shopify.workflow-transactional-email.app 提供,因此您的整合功能無需依賴該應用程式的管理員網址。
**您的憑證將保持私密。**無論在何種存取層級,API 或 MCP 皆無法讀取機密值、SMTP 密碼及 OAuth 憑證。助理可以查看到名為 stripeApiKey 的機密存在,並以 {{ secrets.stripeApiKey }} 的形式引用它,但絕不會看到其具體值。執行記錄中的個人資料在離開伺服器前會被遮罩,不過自由文字欄位仍可能包含客戶詳細資訊。
完整文件:開發者 API 與 MCP、驗證與 API 金鑰、REST API 參考手冊 及 連接 AI 助理(MCP)。
在富文本編輯器中,建立連結要簡單得多
這兩項資訊均出自一份商人報告。
hello@yourstore.com 會自動轉為 mailto 連結;輸入 (703) 638-2601 會自動撥號;輸入 yourstore.com 則會以一般網頁網址的形式開啟。在您插入內容之前,對話方塊會事先告知您系統將執行的動作。究竟問題出在哪裡,既然它同時引發了這兩項問題:未在網址中輸入 https:// 的網址,會被視為相對於 Shopify 管理頁面,而非真實的網頁網址。這導致連結失效,因此要讓連結正常運作的唯一方法就是輸入完整的網址 - - 而且電子郵件地址根本無法轉為 mailto 連結。問題已從根源處解決。
您現有的版面配置和已儲存的連結均不受影響。
升級後的正確頁面
過去進行升級時,系統會直接將您帶回主畫面,且不會顯示任何確認訊息。現在則會出現一個確認頁面,顯示您的新方案包含哪些內容、目前已使用多少,並指引您進行下一個實用的設定。
視覺化建構器中有兩處格式修正,均由一位商家回報。
現在,頁首和頁尾的文字中已可使用換行
<br>」作為字面文字列印出來,同時又獨立處理了您的 Enter 鍵,因此螢幕上出現了一個換行符_,以及_一個多餘的「<br>」。這兩項都已修正。按下 Enter 鍵即可換行 - - 若您習慣如此,輸入 <br> 同樣有效。此變更將立即套用至您現有的版面配置,無需進行任何調整。
區塊之間的間距
每個區塊的四邊_以及_區塊之間的間隙都帶有填充,這使得元素之間的間距累積起來約為 44px,導致電子郵件看起來布局鬆散。
間距設定現已拆分為兩部分,在**「品牌形象」→「版面配置」**下,除了更名為「**區塊間距(左右)」**的滑桿外,還新增了「區塊間距(上下)」滑桿。每個間距控制項現在都會說明其實際功能。
本次發布的核心重點只有一件事:在_客戶指出電子郵件有問題_之前,先確保您的電子郵件內容無誤。
預覽文字
{{ variables.xxx }}」,因此可包含交貨日期或訂單編號。請參閱 主旨和預覽文字。
當變數顯示為空白時,系統現在會向您發出警告
範本的渲染方式刻意設計得較為寬鬆,因此即使變數錯誤或缺失,也不會阻礙客戶的電子郵件發送。代價是這會產生一種「無聲的空白」:發送成功、狀態列顯示為綠色,而只有收件者會注意到內容缺失。
「變數 (JSON)」現已為您生成
手動撰寫該 JSON 內容,是導致支援工單最多的單一原因。
{{ order.lineItems.variant.title }} 會返回空值,需要使用迴圈處理。這是導致變數為空的最常見原因。請參閱 從 Shopify Flow 傳遞資料。
你可以再次刪除這些內容
只要 Shopify Flow 步驟仍引用了佈局、發件人、SMTP 伺服器、HTTP 請求、密鑰及預設值,這些項目過去便無法刪除。
問題在於:該參考資料會一直保留,直到應用程式被卸載為止,因此它往往是您已經刪除或重建的工作流程所留下的殘餘 - - 而系統無法區分兩者。商家因此被迫保留這些無法刪除的記錄。
在負載下更穩定
瑣事
cdn.example.com/logo.png 即可正常運作 - - 系統會自動為您加上 https://。尋求協助不再意味著得四處尋找電子郵件地址。
應用程式內聊天功能,每頁皆有
新的文件網站:docs.workflow-transactional-email.app
全新協助中心 - - 您可以透過專用表單直接向我們回報錯誤、提出功能建議或聯絡我們,並可附上螢幕截圖。應用程式中的「協助」頁面現已直接連結至所有相關功能。
docs.flow-action-extensions.app 上的舊版文件已完整遷移過來,因此您先前加入書籤的內容並未遺失 - - 只是現在改用新名稱了。
**Shopify Flow 「Transactional Email」現已更名為「Workflow Transactional Email」。**應用程式、安裝方式、寄件者及範本皆維持不變 - - 僅更名,以與我們其餘的 Workflow 系列產品保持一致。
您這邊無需進行任何操作。您的 Shopify Flow 工作流程將照常運作,無需任何變更。
有一點值得注意:Microsoft 和 Google 的同意畫面可能仍會顯示舊名稱「Shopify Flow Action Extensions」。這是預期中的情況,批准也完全安全。
向 Shopify Sidekick 詢問您的電子郵件
Sidekick 現在可以直接回答有關此應用程式的問題。您可以詢問諸如「已設定哪些電子郵件寄件者」、「本週是否有任何電子郵件發送失敗」、「我是否有針對 Airtable 的 HTTP 請求」,或是「為什麼我上次發送失敗」等問題。
唯讀模式 - Sidekick 可以檢視您的範本、寄件者、請求及歷史紀錄,但無法進行任何變更。它絕不會回傳機密值、SMTP 密碼、OAuth 憑證或訊息內容。
例行安全性維護:更新依賴項並強化整個應用程式的安全性。無需採取任何行動。
此通行證包含以下功能:由商家設定的外發請求,在建立連線前會先比對內部及私有網路位址;而渲染完成的電子郵件 HTML 內容,在發送前會經過淨化處理。
媒體庫
那些無法在不引起任何問題的情況下進行的刪除操作
過去,若刪除Shopify Flow步驟仍指向的範本、寄件者、SMTP 伺服器或密鑰,會導致該工作流程在不知不覺中失效 - - 它會持續執行,但會不斷失敗。
此外
自推出以來最大的改變:您完全不需要再提供 SMTP 憑證了。
已連結的帳戶
為何這很重要:應用程式密碼和儲存的 SMTP 憑證存在安全隱患 - - 它們會過期、會被輪替,而且存放在資料庫中。OAuth 能一舉解決這三項問題,而且透過您自己的服務供應商發送的郵件,將繼承您自身網域的信譽。
一套新的固定系統
針對每個畫面進行調整,以符合 Shopify 的「專為 Shopify 打造」標準,確保此應用程式能與您管理系統的其他部分保持一致的運作方式。
此應用程式現已遷移至全新的歐洲雲端平台。對您的使用方式而言並無任何改變,但在後端方面:
手動撰寫 HTML 並非設計電子郵件的好方法。因此,現在您不必這麼做了。
視覺化電子郵件編輯器
匯出與匯入
首個版本。Shopify Flow 能在 Shopify 內部自動化許多操作,但無法進行外部互動 - - 此版本新增了兩項可實現此功能的動作。
{{ secrets.keyName }} 進行引用。這些資訊絕不會在模板、設定或日誌中暴露。{{ variables.xxx }},根據 Shopify Flow 的資料建構動態的主題、正文、URL 及載荷。