在收到 webhook 時回傳訂單狀態

針對 HTTP 請求,回傳訂單的付款與履約狀態。聊天機器人、客服系統或客戶入口網站會傳送訂單編號,並在同一則回應中取得狀態資訊。

只需一個來自 Workflow Webhooks 的觸發器,加上其「傳回 Webhook 回應」動作,無需其他應用程式。

Shopify Flow 中的工作流程:接收到 webhook 時回傳訂單狀態
這是在 Shopify Flow 中顯示的完整工作流程。

需要什麼

Workflow Webhooks 中的 Webhook,已啟用同步回應功能,請參閱 同步響應,以及此載荷映射。請參閱 有效載荷映射與 Shopify Flow 變數。

領域 該將什麼映射到它身上
fieldOne 例如,訂單編號 #1001

對 webhook 的呼叫則如下所示:

bash
curl -X POST https://<your webhook URL> \
  -H "Content-Type: application/json" \
  -d '{"orderNumber": "#1001"}'

# Response:
# {"orders": [{"name": "#1001", "financialStatus": "PAID", "fulfillmentStatus": "UNFULFILLED"}]}

取得工作流程

  1. 請下載本頁底部附帶的「.flow」檔案。
  2. 在您的 Shopify 管理後台中,開啟 Shopify Flow,點擊「匯入」,然後選擇檔案。
  3. 請檢查各步驟,然後按一下**「啟用工作流程**」。

此檔案是由 Shopify Flow 直接匯出的。請勿手動編輯該檔案;請在匯入後,於 Shopify Flow 中變更工作流程。

運作原理

  1. **「同步 Webhook 觸發器」**會在呼叫方等待回應的同時啟動工作流程,並將invocationId及已映射的欄位傳遞給該工作流程。
  2. **「取得訂單資料」**會透過查詢 name:{{fieldOne}} 來查詢訂單,並最多保留一個結果。
  3. 「Return Webhook」回應會將 {"orders": [...]} 傳回給呼叫方,其中包含訂單名稱、財務狀態及履約狀態。若無符合條件的訂單,該清單將為空。

讓它成為你的專屬

  • 在回應內容中新增更多訂單欄位,例如 {{order.totalPriceSet.shopMoney.amount}}。

下一步