從 Shopify 發送 WhatsApp 訂單訊息

Shopify Flow 如何發送 WhatsApp 訊息？

使用 Send HTTP request 動作。它可向任何 URL 發送請求，標頭與內容主體亦可使用觸發條件提供的 Liquid 變數。

請以訂單建立作為觸發條件建立工作流程，再加入 Send HTTP request。URL 是已連接號碼的 phone number id 所對應的 Cloud API 訊息端點。加入 Authorization 標頭，值為 Bearer 加上該號碼的存取權杖；權杖應儲存為 Flow 密鑰，並以密鑰變數引用。密鑰的值不會顯示在 Flow 介面，執行記錄中也會被遮蔽，權杖正應放在這裏。內容主體是一則範本訊息，to 欄位填寫客戶的電話號碼，訂單詳情則作為範本的參數。

Flow 會把 2XX 或 3XX 回應視為成功。Meta 對有效請求會回覆訊息 id，所以執行成功即代表 Meta 已接受該訊息。

{
  "messaging_product": "whatsapp",
  "to": "<customer phone, digits only>",
  "type": "template",
  "template": {
    "name": "order_confirmation",
    "language": { "code": "en" },
    "components": [{
      "type": "body",
      "parameters": [{ "type": "text", "text": "{{order.name}}" }]
    }]
  }
}

為甚麼訂單訊息必須使用範本？

因為是店舖先發訊息。Meta 的 24 小時客戶服務時段，只會在客戶向該號碼發訊息時才開啟。訂單確認、出貨通知或棄單提醒都在此之前發出，所以自由格式訊息會被拒絕，只有預先批准的範本才能發送。

請先建立一次範本，類別選「utility」，用於訂單及出貨通知，並待批准後才啟用工作流程。請求內容中的名稱和語言必須與已批准的範本完全一致，參數數量也必須與範本的佔位符相符。

此外還有用戶同意的問題。Meta 規定企業必須先取得選擇加入許可，才可在 WhatsApp 向對方發送訊息：即對方提供了號碼，並同意接收該企業的訊息。最常見的做法是在結帳頁加入勾選框，工作流程在發送前應先檢查這一項。

如果店舖的方案不含 Send HTTP request，怎麼辦？

改用 Shopify 管理後台的 Webhook。在「設定」、「通知」、「Webhook」下，商家可為訂單建立等事件建立 Webhook，格式為 JSON，並指向某個 URL。把它指向接收端即可：可以是 n8n 的 Webhook 節點，或以 PHP、Python 或 Node 寫成的路由。接收端讀取訂單、檢查用戶同意，再向 Cloud API 發出相同的範本呼叫。

無論用哪種方式發送，回覆的流程都一樣。客戶回覆訂單訊息後，回覆會進入店舖手機上的 WhatsApp Business 應用程式，因為該號碼已啟用 Coexistence，而 24 小時時段亦已開啟，可以發送自由格式訊息。若已設定該號碼的 Webhook 目的地，回覆也會送到您的系統。訂單訊息本身同樣會顯示在應用程式內，回覆的同事可以看到客戶在回應甚麼。

常見錯誤

• 在訂單建立時發送自由格式訊息。客戶尚未發訊息，Meta 會拒絕，必須使用已批准的範本。
• 對 4XX 回應仍把錯誤處理設為 Retry。Flow 最多可能用 24 小時，重複發送 Meta 永遠不會接受的請求。
• 把權杖以純文字放在標頭中。請儲存為 Flow 密鑰，使它不會出現在介面和記錄裏。

常見問題

繼續閱讀