與顧客分享商品

商家可以透過多種方式與顧客分享商品：

• 目錄訊息 — 包含按鈕的自由格式訊息，當用戶點擊該按鈕時，會在 WhatsApp 中顯示您的商品目錄。
• 目錄範本訊息 — 包含按鈕的範本訊息，當用戶點擊該按鈕時，會在 WhatsApp 中顯示您的商品目錄。
• 目錄連結訊息 — 包含目錄縮圖和完整商品目錄連結的訊息。
• 商品訊息 — 包含單一商品或商品目錄中最多 30 項商品相關資訊的訊息。
• 多項商品範本訊息 — 包含電子商務目錄中最多 30 項商品相關資訊的範本訊息，在單一訊息中最多可分為 10 個部分。

目錄訊息

目錄訊息是自由格式的訊息，可讓您完全在 WhatsApp 中展示商品目錄。

目錄訊息會顯示您選擇的商品縮圖標題圖像、自訂內文文字、固定文字標題、固定文字子標題和查看目錄按鈕。

當顧客點擊查看目錄按鈕時，您的商品目錄會顯示在 WhatsApp 中。

需求

您必須在連結至 WhatsApp Business 帳號的電子商務目錄中，將庫存上傳至 Meta。

限制

在印度無法使用此功能。

要求語法

請使用 WhatsApp Business 電話號碼 > 訊息端點來傳送目錄訊息。

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

張貼內容

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<TO>",
  "type": "interactive",
  "interactive" : {
    "type" : "catalog_message",
    "body" : {
      "text": "<BODY_TEXT>"
    },
    "action": {
      "name": "catalog_message",
      "parameters": {
        "thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID>"
      }
    },

    /* Footer object is optional */
    "footer": {
      "text": "<FOOTER_TEXT>"
  }
}

屬性

要求範例

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "16505551234",
  "type": "interactive",
  "interactive": {
    "type": "catalog_message",
    "body": {
      "text": "Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase."
    },
    "action": {
      "name": "catalog_message",
      "parameters": {
        "thumbnail_product_retailer_id": "2lc20305pt"
      }
    },
    "footer": {
      "text": "Best grocery deals on WhatsApp!"
    }
  }
}'

回應範例

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0ODVEREUwQzEzQkVBRjQ1RUUA"
    }
  ]
}

目錄範本訊息

目錄範本訊息是包含按鈕的範本訊息，當用戶點擊該按鈕時，會在 WhatsApp 中顯示您的商品目錄。

若要傳送目錄範本訊息，您需要有目錄範本。請參閱我們的目錄範本文件，瞭解如何建立這些範本，以及如何在範本訊息中傳送範本。

目錄連結訊息

商家可以傳送完整商品目錄的連結，方法是組合 wa.me 連結，並將其包含在標準簡訊中。傳送簡訊時，商家可以使用設定為 true 的選用 preview_url，讓訊息在訊息 body 字串中呈現一組任何網址的商品目錄縮圖。

請注意，若商家停用目錄，wa.me 連結和目錄連結訊息中的查看目錄按鈕在點按時會顯示無效目錄連結訊息。

若要組合 wa.me 連結，請將商家的營業電話號碼（包含國碼／區碼）附加到以下字串的末端：

https://wa.me/c/

例如：

https://wa.me/c/15555455657

商品訊息

多項商品訊息和單一商品訊息均屬於 interactive 訊息類型。

多項商品訊息範例：	單一商品訊息範例：
用戶點擊「開始購物」時觸發的功能表：	商品詳細資料頁面範例：

總覽

接收到多項商品和單一商品訊息的用戶可以執行 3 個主要動作：

1. 查看商品：客戶可以查看商品清單或僅查看一項商品。每當用戶點擊特定項目時，我們都會擷取商品的最新資訊，並以商品詳情頁面（PDP）格式顯示商品。PDP 目前僅支援商品圖像 — 在商品中加入的任何影片和／或 GIF 都不會顯示在 PDP 中。
2. 新增商品至購物車中：用戶可以新增商品至購物車，或直接從清單或商品詳情頁面修改數量。每當用戶將商品加入購物車時，我們都會擷取商品的最新資訊。如果任何商品的狀態發生變更，我們會顯示對話方塊，說明「購物車中的一或多項商品已更新」，詳情請參閱商品更新。購物車會一直保留在商家和顧客之間的聊天對話串中，直到系統將購物車傳給商家，詳情請參閱 購物車體驗。
3. 傳送購物車給商家：顧客在加入所有必要的商品後，就可以將其購物車傳送給與之互傳訊息的商家。之後，商家就可以定義後續步驟，例如要求送貨資訊或提供付款選項。

如果顧客有多個裝置連結到同一個 WhatsApp 帳號，多項商品訊息和單一商品訊息將會在這些裝置之間同步。不過，購物車為各個特定裝置的本機購物車。詳情請參閱購物車體驗。

您目前可以在下列平台接收這幾種訊息類型：

• iOS：2.21.100（多項商品訊息）和 2.21.210（單一商品訊息）。
• Android：2.21.9.15（多項商品訊息）和 2.21.19（單一商品訊息）。
• 網頁：支援這些功能的網頁用戶端已啟用。

如果收件人的應用程式版本不支援多項商品訊息或單一商品訊息，他們將收到說明訊息，告知因使用舊版 WhatsApp 而無法接收訊息。商家也將收到 Webhooks 通知，指示因收件人使用舊版 WhatsApp 而無法傳遞該訊息。

訊息的預期行為

多項商品訊息和單一商品訊息可以：

• 由一位用戶轉寄給另一位用戶。
• 由同一對話中的用戶重新開啟。

目錄訊息、多項商品訊息和單一商品訊息不可以：

• 當成通知傳送。只能作為現有對話的一部分傳送。

商品更新

商家可能需要更新目錄中商品的屬性。根據更新的屬性，以下是我們針對任何提及該商品之訊息的處理方式：

購物車體驗

瀏覽商品後，顧客可將其新增至購物車，並傳送購物車給商家。為滿足 WhatsApp 的商業目的，購物車符合以下特性：

• 是特定裝置中的不重複用戶／商家聊天對話串：顧客和商家間的每個聊天對話串只會產生一個購物車，且購物車不會跨多個裝置持續出現。購物車傳送之後，顧客就能開啟商家的另一個購物車，並再次啟動該流程。
• 沒有過期日：購物車會持續顯示於聊天對話串中，直到傳送給商家為止。傳送之後，就會清除購物車。

針對各單一目錄商品，顧客可以新增最多 99 個數量至一部購物車，但系統並未針對可新增至購物車的不同商品數量設限。

傳送購物車後，就無法再加以編輯。如果顧客需要新商品或想要變更訂單，可以傳送新購物車。商家無法傳送購物車給顧客。

購物車體驗範例及商品狀態變更的預期行為。

為什麼應該使用此功能

多項商品訊息和單一商品訊息可為用戶提供最佳體驗，不僅易於使用而且高度個人化，可更有效引導顧客找到與他們最相關的商品組合，而不是瀏覽商家的所有目錄商品。

簡單而有效率

結合如 NLP、文字搜尋或清單訊息等導覽工具和回覆按鈕，讓顧客快速找到他們想找的商品。

個人化

動態填入資訊，為顧客提供個人化或情景式的體驗。例如：您可以顯示顧客最常訂購之商品的多項商品訊息。

商家成果

促成下單的有利專區，測試期間，在傳送至購物車的多項商品訊息中平均有 7% 達成轉換。

沒有範本

互動式訊息不需要範本或預先核准。訊息皆為即時產生，且一律會反映最新的商品詳細資訊、定價和庫存情況。

何時應該使用此功能

多項商品訊息最適合用來引導顧客找到商家商品的特定組合，例如：

• 以對話的方式進行購物。例如：顧客可以使用搜尋功能輸入購物清單，再以多項商品訊息回傳回覆。
• 導覽至特定類別。例如：運動服飾。
• 個人化商品優惠或建議。
• 再次訂購之前訂購的商品。例如，用戶可以再次訂購經常性的外帶訂購項目（不超過 30 個項目）。

單一商品訊息最適合引導顧客找到商家商品中的特定項目、從有限的選項中快速提供回覆，例如：

• 回覆顧客的特定要求。
• 提供建議。
• 再次訂購之前的商品。

此外，無論您需要建置何種工具讓真人代理專員在對話串中產生多項商品訊息或單一商品訊息，這兩種功能都能當作真人代理流程的一部分來使用。

開始使用

傳送各訊息前，您必須呼叫 /contacts 節點，取得訊息接收者的 WhatsApp 編號。

建議您設定 Webhooks 來接收訊息狀態和外來的訊息通知。這樣一來，訊息傳送出去及獲得顧客的答覆後，您就可以加以追蹤。

步驟 1：組合互動式物件

單一商品訊息

若要傳送單一商品訊息，請組合具有下列元件的 interactive 物件類型 product：

結束前，互動式物件應該看起來如以下情況：

"interactive": {
    "type": "product",
    "body": {
      "text": "text-body-content"
    },
    "footer": {
      "text": "text-footer-content"
    },
    "action": {
      "catalog_id": "catalog-id",
      "product_retailer_id": "product-SKU-in-catalog"
    }
}

多項商品訊息

若要傳送多項商品訊息，請組合具有下列元件的 interactive 物件類型 product_list：

結束前，interactive 物件應該看起來如以下情況：

"interactive": 
    {
    "type": "product_list",
    "header":{
       "type": "text",
        "text": "text-header-content"
     },
     "body":{
        "text": "text-body-content"
      },
     "footer":{
        "text":"text-footer-content"
     },
     "action":{
        "catalog_id":"catalog-id",
        "sections": [
             {
             "title": "the-section-title",             
             "product_items": [
                  { "product_retailer_id": "product-SKU-in-catalog" },
                  { "product_retailer_id": "product-SKU-in-catalog" },
                            ...
              ]},
              {
              "title": "the-section-title",
              "product_items": [
                 { "product_retailer_id": "product-SKU-in-catalog" }
                           ...
              ]},
               ...
       ]
     },  
    }

遺失的項目

若上述 API 呼叫中提供的項目沒有任何一個符合商家 Facebook 目錄的商品，系統會傳送一則錯誤訊息，將不會把多項商品訊息或單一商品訊息傳送給用戶。

針對多項商品訊息，商品清單中至少要有一個項目必須符合商家 Facebook 目錄中的一項商品。在此案例中：

• 訊息已成功傳送；
• 沒有相符項目已捨棄；
• 商家收到請求目錄更新的錯誤訊息。

步驟 2：新增公用訊息參數

完成互動式物件後，請附加其他可撰寫訊息的參數：recipient_type、to 及 type。請記得將 type 設定為 interactive。

{
  "recipient_type": "individual",
  "to" : "whatsapp-id", // WhatsApp ID of the recipient
  "type": "interactive",
  "interactive":{
    // The interactive object  
   }
  }

請在此處查看所有訊息類型的公用參數。

步驟 3：對 /messages 進行 POST 呼叫

利用您在步驟 1 與步驟 2 組合的 JSON 物件對 /messages 端點進行 POST 呼叫。若訊息傳送成功，您會收到以下回覆：

{
  "messages": [{
    "id": "{message-id}"
  }]
  }

多項商品範本訊息

若要傳送多項商品範本訊息，您需要多項商品訊息範本。請參閱我們的多項商品訊息範本文件，瞭解如何建立這些範本以及如何在範本訊息中傳送。