更新紀錄

這款應用程式會說您的語言

現在，整個應用程式會根據您在 Shopify 管理後台所使用的語言進行調整。支援的語言包括英語、德語、法語、西班牙語、義大利語、荷蘭語、丹麥語、葡萄牙語（巴西和葡萄牙）、日語，以及中文（簡體和繁體）。只要變更管理後台的語言，應用程式將在下次頁面載入時自動跟進。

• 每個頁面、對話框和訊息均已翻譯，包括 Webhook 編輯器、簽名測試工具及其逐步診斷功能、歷史紀錄以及說明頁面。
• 在 Shopify Flow 中，工作流程範本會以您的語言顯示其標題、說明及設定說明。
• 日期和數字會依照您所用語言的書寫方式顯示。
• 此說明中心也已翻譯成多種語言**。**每篇指南皆提供相同語言版本；請從語言選單中選擇您所需的語言。
• **觸發器和動作名稱仍維持英文。**Shopify Flow 會以英文顯示步驟名稱，因此應用程式也是如此 - - 您在應用程式中看到的名稱，始終與 Shopify Flow 上的名稱一致。載荷欄位名稱（例如 fieldOne）也不會改變。

Shopify Flow 中的七個現成工作流程

開啟 Shopify Flow，選擇**「瀏覽範本**」，並搜尋「webhook」。每個範本都是基於 Webhook 觸發器的完整工作流程；您只需建立該 webhook，並將您的系統指向它即可。

• 收到 Webhook 時的訂單狀態 - 第三方物流（3PL）、企業資源規劃（ERP）或無程式碼工具將訂單標記為「已出貨」、「已開立發票」或「已審核」。
• **在收到 Webhook 時新增訂單備註 - - **將來自支援工具或 ERP 的訊息附加至訂單備註中。
• 在收到 Webhook 時將訂單標記為已付款 - - 當您的銀行、開票系統或付款系統確認付款時。
• 在收到 Webhook 時為產品標記標籤 - - 供應商、PIM 或 ERP 系統會將系列與標章保持同步。
• 在收到 Webhook 時建立客戶 - - 從著陸頁和表單中收集潛在客戶。
• 在收到 Webhook 時更新客戶元資料欄位 - - 忠誠度、CRM 或積分系統會將一個數字儲存至客戶資料中。
• 在收到 Webhook 時回傳訂單狀態 - - 透過同步回應，向聊天機器人、客服系統或客戶入口網站提供訂單的付款與履約狀態。

每個範本的設定說明都會告知您應將哪些欄位進行對應。請參閱 工作流程範本。

Shopify 的新版管理介面設計

Shopify 正在為管理後台推出全新介面。在已啟用此功能的商店中，Workflow Webhooks 現已採用與管理後台其他部分相同的配色、字型和圖示，因此該應用程式的外觀將與管理後台的其他部分保持一致。在尚未啟用此功能的商店中，則一切維持不變。

您的 Webhook 現已支援定時執行、驗證幾乎所有發送者的簽名，並能處理 JSON 以外的格式。

透過任何 API 根據定時器執行工作流程

每個 webhook 都新增了一個「排程」分頁，且有直接的進入方式：選擇「建立 webhook」，並在「什麼會觸發此 webhook？」一欄中選擇「無 - 依照排程執行」。 該應用程式會每 5 分鐘（每日最多一次）擷取一個 URL，並將回應傳送至 webhook，因此任何 API 都能透過 Shopify Flow 工作流程依排程執行。

• 每次擷取資料時觸發，還是僅在回應內容變更時觸發？
• 若 API 需要，請新增請求標頭。這些標頭將以加密形式儲存。
• 「立即執行」現在會執行一次並顯示回應內容。
• 此分頁會顯示行程與您的計畫相較之下總計如何。跑步紀錄會在「歷史紀錄」中以「**已排程」**的狀態顯示。
• 若某個排程連續失敗 20 次，便會自動暫停。

請參閱 排程式 URL 輪詢。

幾乎所有發件人的簽名驗證

22 個內建預設值（從 6 個增加至 22 個），每個預設值均已根據發送方自身的文件進行核對：Stripe、GitHub、Shopify、Slack、Typeform、Calendly、標準 Webhook（OpenAI、Supabase）， Svix（Clerk、Resend）、Paddle、Linear、WooCommerce、Square、Sentry、Vercel、Zendesk、Lemon Squeezy、Razorpay、Paystack、Customer.io、Sendcloud、Mollie 以及 Sanity。

• 若發件人未預設任何設定，則會套用「自訂簽名」：請選擇標頭、演算法、編碼方式、具備重播防護功能的時間戳記，以及待簽署的確切文字內容。
• 編輯器中的簽名測試工具會顯示哪個驗證步驟失敗，並能產生一個有效的範例請求。
• 現在要建立 Webhook，首先要釐清會有哪些內容傳送至該 Webhook。

請參閱 驗證已簽名的 Webhook，該頁面針對每位寄件者提供了逐步操作指南。

更多驗證方式

• 對於無法設定自訂標頭的發送者，靜態憑證現在可以以 Bearer 憑證、基本驗證（使用者名稱和密碼）或 URL 參數的形式傳送。URL 中的憑證會在瀏覽紀錄中被遮蔽，且絕不會傳遞給 Shopify Flow。
• **在不造成服務中斷的情況下輪替密鑰。**對於靜態憑證及所有簽名方案，系統會同時接受第一組密鑰與第二組密鑰。
• **IP 允許清單。**除了任何驗證機制之外，還可將能存取該 URL 的對象限制為您列出的 IP 位址或位址範圍。請參閱 IP 白名單。

請參閱 驗證。

表單與 XML 內容，以及陣列的分割

• 表單提交、檔案上傳表單和 XML 現已能像 JSON 一樣被讀取並映射至可映射欄位。若表單內容為有效的 JSON，仍會被視為 JSON 進行讀取，因此現有發送者的行為不會有所改變。
• **將陣列拆分為多個執行區段。**將新設定指向載入資料中的清單，每個項目便會啟動自己的 Shopify Flow 執行區段，每個請求最多可達 100 個。每個項目均計為一次呼叫。

請參閱 正文格式與陣列分割。

一款基於 Shopify 的 Web Components 重新打造、運行更流暢的應用程式

現在整個應用程式直接運行於 Shopify 管理介面的 Web Components 上，而非透過獨立的介面函式庫。由於需要載入的內容較少，頁面載入速度更快，且每個欄位、選單和對話方塊的外觀與行為都與您管理介面的其他部分一致。

• **Webhook 編輯器是一個建構工具。**左側為設定選項；右側則是包含 Webhook URL 和 Webhook ID 的「端點」卡片，上方則有「即時預覽」、「測試」和「使用情況」 - - 因此您可以一邊調整設定，一邊在並排的視窗中觀察請求的傳入。
• Webhook 清單會顯示每個 Webhook 的呼叫次數、呼叫者的驗證方式以及最後一次變更的時間，且每行皆設有選單，可供使用者進行編輯、啟用、停用或刪除。
• **連接已簽名的發送者。**針對 Stripe、GitHub 或其他供應商的 Webhook 會顯示連接步驟，並提供連結至設定指南的按鈕，而非一個永遠無法驗證的範例請求。

本版本中還包含以下內容

• **儀表板上的封阻請求。**過去，因方案限額而被拒絕的請求通常不會留下任何紀錄。現在，儀表板會顯示過去 30 天內被封阻的請求數量，而方案卡則會顯示使用量計量表。
• Webhook 清單的分頁功能已正常運作，且**「清除**歷史紀錄」功能也會一併清除「已重播」篩選條件。
• 每個頁面都連結至「說明中心」中的相關指南，而「說明」頁面則列出了我們其他適用於 Shopify Flow 的應用程式。
• 例行安全維護。無需採取任何行動。

迄今為止，Webhook 只能對請求進行確認 - - 您的 Shopify Flow 工作流程會在確認後執行，而呼叫方永遠無法得知結果。同步回應則改變了這種情況：應用程式會保持請求處於開啟狀態，直到您的工作流程傳回資料，並將其傳回給呼叫方。

當呼叫者需要的是答案而非回執時，此功能便十分實用 - - 例如顯示結果的表單、等待計算結果的系統，或是資料查詢。

運作原理

在 webhook 的「進階設定」中啟用「同步回應」。接著，以新的「同步 webhook 觸發器」為基礎建立工作流程，並以新的「傳回 webhook 回應」動作作為結尾。

直接在動作中使用觸發器的變數來寫入回應內容：

{"ok": true, "orderId": "{{fieldOne}}", "email": "{{fieldTwo}}"}

或者在「執行程式碼」動作中建立更複雜的程式，並將結果綁定上去。

典型的往返時間為兩至四秒。若您的工作流程在 15 秒內未回應，來電者只會收到標準回應 - - 絕不會出現錯誤訊息，也不會發生掛線情況。

完整指南：同步回應：

除非你打開它，否則一切都不會改變

所有 Webhook 預設皆為關閉狀態。現有的 Webhook 仍會立即回應，並繼續使用標準的 Webhook 觸發器，與先前完全相同。

REST API 和 MCP 伺服器現在有了專屬的永久位置：

https://shopify.workflow-webhooks.app

因此，API 的網址為 https://shopify.workflow-webhooks.app/api/v1，而 MCP 伺服器的網址則為 https://shopify.workflow-webhooks.app/api/mcp。這兩者都在「**開發者」**頁面上顯示，並附有「複製」按鈕。

先前這些內容是存放在應用程式內嵌的 URL 中。將它們分離出來後，您貼到腳本、CI 工作或 AI 助理中的網址便會保持穩定，且與該應用程式在您的管理後台中的內嵌方式無關。新的主機名稱僅用於提供 API 服務 - - 應用程式本身仍保留在原處，您先前設定的內容也無需進行任何變更。

更多文件

docs.workflow-webhooks.app 已上線九個新頁面：

• 建立您的第一個 Webhook - 從頭到尾，包括配置 Shopify Flow 端
• 驗證 - 靜態憑證、HMAC，以及適用於 Stripe、GitHub、Shopify、Slack、Typeform 和 Calendly 的預設設定
• 有效載荷映射與 Shopify Flow 變數 - - 點路徑、嵌套值，以及當四個欄位不足時該如何處理
• 重複送達防護
• 歷史與疑難排解 - - 所有拒收代碼及其處理方法
• 從 Shopify Flow 呼叫 webhook
• 資費方案與使用方式 - - 哪些會計入您的流量上限，哪些不會
• 隨身助手與 AI 助理
• 常見問題

《開發者 API 與 MCP 指南》也已發布。

大多數系統在未立即收到回覆時，會重新嘗試觸發 webhook。如果第一次嘗試確實送達，您的 Shopify Flow 工作流程將會針對同一事件執行兩次 - - 導致收到第二封電子郵件、第二個標籤，以及重複的訂單備註。

**「重複傳送防護」**功能可解決此問題。若您的發送系統為每個事件都包含一個唯一識別碼，請告知我們該識別碼位於哪個標頭中，我們便會忽略重複的訊息。

請在**「進階設定」→「任何 Webhook 的重複傳送」**中進行設定。請輸入您的寄件者所使用的標頭名稱 - - 通常為 Event-Id、Idempotency-Key 或 X-Request-Id。

• 第一個具有特定 ID 的請求會正常執行。
• 若在 24 小時內有任何重複傳送，系統會傳回標準的 200 OK 回應，因此發件人便會停止傳送 正在重試 - - 但並不會再次將訊息傳送至 Shopify Flow。
• 被隱藏的重複內容不會計入您的方案上限。
• 您仍然可以看到它們：「即時請求檢視器」會顯示該請求，並將其標記為 已移除重複項目，因此看起來呼叫並未消失。

若將此欄位留空，則不會產生任何變化 - - 每個請求都會像以往一樣被處理。此功能在所有現有的 Webhook 中預設為關閉狀態。

您可以透過自己的程式碼，或透過 Claude 或 Cursor 等 AI 助理來管理您的 webhooks。

• 全新開發者頁面：建立範圍限定的 API 金鑰，並取得可直接複製的連接指令，適用於 Claude Code、Claude Desktop、Cursor、VS Code、Gemini CLI 及 OpenAI Codex。
• /api/v1 上的 REST API - - 列出及管理 Webhook、讀取呼叫歷史紀錄與統計資料、列出範本。
• MCP 伺服器位於 /api/mcp，因此 AI 助理也能在對話中執行相同操作。
• **共有三種存取層級。**讀取金鑰僅能瀏覽資料；寫入金鑰除了能瀏覽外，還能建立、更新及刪除 Webhook；執行金鑰則可額外觸發測試呼叫或重播過去的呼叫 - - 這確實能執行您的 Shopify Flow 工作流程。
• **您的資料將受到保護。**Webhook 的授權憑證絕不會透過 API 被讀取，而請求載荷中的個人資料（電子郵件地址、電話號碼、姓名、卡號）在離開伺服器之前都會被遮蔽。

**Flow Webhooks 現已更名為 Workflow Webhooks。**應用程式、安裝方式及 Webhooks 皆維持不變，僅更名為與我們其他 Workflow 系列產品相符的新名稱。

• 新的文件網站位於 docs.workflow-webhooks.app，提供完整的 n8n、Make 和 Zapier 操作指南，包括影片教學。
• 全新協助中心 - - 您可以透過專用表單直接向我們回報錯誤、提出功能建議或與我們聯繫，並請附上螢幕截圖。
• 應用程式內聊天功能 - - 聊天氣泡現在出現在應用程式的每個頁面，當對話視窗開啟時，它會禮貌地讓出空間。
• 儀表板上的設定指南，將引導您從建立第一個 Webhook 開始，一路到建立一個可運作的 Shopify Flow 工作流程。它會記住您是否曾將其收起。

例行安全性維護：更新依賴項並強化整個應用程式的安全性。無需採取任何行動。

• 電子郵件通知 - - 當您接近方案限額、達到限額，或是您的 Webhook 失敗次數比平時更多時，系統會發送提醒。除了商店店主之外，您還可新增其他收件者，每位收件者皆有專屬的取消訂閱連結。
• HMAC 簽名預設值 - - 無需手動設定格式，即可與常見發送者的簽名方案相符。
• 選擇傳送更多請求資料 - 針對每個 Webhook，可選擇是否將請求標頭、查詢字串參數及原始請求內容傳送至 Shopify Flow。
• 根據有效載荷內容搜尋呼叫歷史紀錄。

Sidekick 現在可以直接回答關於此應用程式的問題。您可以詢問諸如「我的聯絡表單有 webhook 嗎」、「我的 n8n webhook 是否已啟用」、「本週觸發了多少次」或「為什麼我上次的呼叫失敗了」等問題。

唯讀 - Sidekick 可以檢視您的 Webhook、其設定以及呼叫紀錄，但無法進行任何變更。

Workflow Webhooks 現在已遷移至全新的歐洲雲端平台。使用方式並無任何改變，但在後端方面：

• Webhook 處理已移至具備死信處理功能的託管佇列，因此呼叫絕不會被默默丟棄。
• 資料庫與快取均位於歐盟境內，並採用靜態加密。
• 商家機密 - - 您的靜態代幣和 HMAC 金鑰 - - 現已透過專用的金鑰管理服務進行加密，而不再僅是於磁碟層級以加密形式儲存。
• 跨可用區域的冗餘實例。

其結果是，在接收 webhook 時延遲更低，且在負載下表現大幅提升。

• 自訂靜態代碼標頭 - 標頭名稱不再必須是 X-Api-Key。您可在「進階設定」中針對每個 webhook 設定專屬名稱，使其與發送系統現有的傳送名稱相符。基於安全考量，系統會拒絕預留及由代理伺服器控制的標頭名稱。
• 自動會話刷新 - 存取憑證現已改為在後台進行刷新，因此長期運行的商店不再會因憑證過期而導致配送失敗。
• 更聰明的重試機制 - - 傳送失敗時會採用退避策略進行重試，而永久性失敗則會立即停止重試，而非無謂地耗盡重試次數。

• 新增了資料庫索引，可加快繁忙門市中的歷史紀錄與統計資料查詢速度。
• 新增了真實使用者效能監控功能，以便我們能在管理後台偵測到載入緩慢的頁面。
• 應用程式整體的安全性更新：依賴項更新及移除不安全的 HTML 渲染功能。

• 以指標卡片、日期範圍選擇器及呼叫次數圖表為核心，重新建構了儀表板。
• **未儲存的變更現在受到保護。**編輯 webhook 時會顯示Shopify的儲存列，若在有待儲存的編輯內容時切換分頁或點擊「返回」按鈕，系統會先提示您確認，而非默默地捨棄這些變更。

已重新建立 Webhook 歷史紀錄的索引。呼叫量較大的商店將會發現，歷史紀錄頁面和儀表板的載入速度顯著加快。

• 重播 - 點一下即可開啟任何過去的呼叫，並再次發送。這是建立「Shopify Flow」工作流程最快速的方式：先在「Shopify Flow」中記錄事件，接著重播實際的呼叫，而非重新觸發來源系統。
• Webhook 範本 - 針對 n8n、Make、Zapier、聯絡表單及自訂整合所預先設定的起始點。

• 修正了一個可能導致有效請求被拒絕的驗證邊緣案例。
• 已修正代理路徑解析問題，確保應用程式代理 URL 能正確路由。
• 修正了 webhook 清單中的顯示錯誤。

• Shopify Flow 動作 - 反向操作。Shopify Flow 工作流程現在可以將 webhook 作為動作步驟來呼叫，因此 Shopify Flow 既能推送資料，也能由資料觸發。
• 儀表板統計資料 - - 呼叫總數、成功率，以及您所選日期範圍內的圖表。
• 呼叫來源追蹤 - 歷史紀錄現已會記錄呼叫是來自 Shopify Flow、測試、curl 還是外部系統，您可據此進行篩選。

Shopify Flow 由於變數是扁平字串，因此過去嵌套的物件和陣列往往無法使用。

現在，系統會自動偵測為物件或陣列的值，並將其作為 JSON 字串傳遞給 Shopify Flow，因此資料在傳入過程中不會悄無聲息地遺失。

我們推出了設有每月呼叫配額的訂閱方案，並在儀表板上新增了使用量追蹤功能，讓您能清楚掌握當前使用量與配額上限的對比狀況。

每個方案均包含所有驗證方式、欄位對應、CORS、瀏覽紀錄與重播功能 - - 各方案的差異僅在於每月流量上限。

• 應用程式代理端點 - 現在每個 webhook 也可透過 Shopify 應用程式代理網址存取，這能避免瀏覽器端呼叫者遭遇的跨來源問題。
• 「歷史紀錄」頁面設有日期範圍篩選功能，讓您能直接鎖定出問題發生的當天，無需反覆捲動頁面。

四個已映射的欄位未必總是足夠。在 webhook 的「安全性」設定中啟用**「允許自訂請求正文**」後，除了這四個命名欄位之外，所有傳入的載荷都會被完整傳遞至 Shopify Flow。

當您無法控制發送系統的有效載荷結構時，此功能便派上用場。

• Webhook 的設定現已存入快取，因此接收呼叫時所需處理的工作量較少，回應速度也更快。
• 已停用的 Webhook 會在清單中明確標示，因此一眼就能看出為何某個 Webhook 未能觸發。
• 重新設計了 webhook 詳細資訊頁面，並進行了一系列較小的修正。

首個版本。Shopify Flow 僅會對 Shopify 內的事件做出反應 - - 此更新移除了該限制。

• Webhook 端點 - 每個 Webhook 都會獲得一個專屬的安全網址，任何外部系統皆可向該網址發送 POST 請求。
• **三種驗證模式 - - 「**無」用於測試、「X-Api-Key」標頭中的靜態憑證，或用於防篡改簽名的 HMAC SHA256。
• 有效載荷映射 - 從傳入的 JSON 中映射最多四個欄位，並在 Shopify Flow 中將其用作 {{fieldOne}} 至 {{fieldFour}} 的參數。
• 呼叫記錄 - 每次呼叫都會連同其標頭、有效載荷、狀態及時間一併記錄下來。
• CORS 支援 - 啟用此功能即可直接接受來自瀏覽器或商店前端表單的呼叫。
• Webhook 儀表板 - - 在同一處建立、啟用、停用及批次管理所有端點，並具備一鍵式代幣產生器。