與顧客分享商品

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

• 目錄訊息：此為自由形式訊息，當中包含一個按鈕，點按後會在 WhatsApp 內展示您的商品目錄。
• 目錄範本訊息：此為範本訊息，當中包含一個按鈕，點按後會在 WhatsApp 內展示您的商品目錄。
• 目錄連結訊息：此類訊息包含目錄縮圖和導向其整個商品目錄的連結。
• 商品訊息：此類訊息包含商品目錄中單一商品或最多 30 項商品的相關資訊。
• 多商品範本訊息：此為範本訊息，當中在單一訊息中包含電子商務目錄內最多 30 項商品的相關資訊，最多可分為 10 個部分。

目錄訊息

目錄訊息是一種自由形式訊息，支援您在 WhatsApp 內展示整個商品目錄。

目錄訊息展示您所選的產品縮圖標題圖像、自訂正文文字、固定文字標頭、固定文字副標題，以及查看目錄按鈕。

顧客點按「查看目錄」按鈕後，您的商品目錄就會在 WhatsApp 內顯示。

必要條件

您必須已將庫存上載至 Meta，並展示在已連結至您 WhatsApp Business 帳戶的電子商務目錄中。

要求語法

使用 WhatsApp Business 手機號碼 > 訊息端點傳送目錄訊息。

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

Post 內文

{
  "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 版本，因此無法接收訊息。商家亦會收到一則 Webhook 通知，指出由於傳送對象在使用過舊的 WhatsApp 版本，因此訊息無法送達。

針對訊息的預期行為

多商品訊息和單一商品訊息支援以下行為：

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

目錄訊息、多商品訊息和單一商品訊息不支援以下行為：

• 作為通知送出；它們只可作為現有聊天室對話串的一部分傳送出去。

商品更新

商家可能需要更新其目錄商品的屬性。我們會根據更新後的屬性來處理提及該商品的任何訊息：

購物車體驗

瀏覽商品後，顧客可以將商品加到自己的購物車，並將該購物車傳送給商家。就 WhatsApp 商務而言，購物車有以下特性：

• 購物車專屬於某部特定裝置上的一個用戶／商家聊天室對話串：顧客和商家之間的每個聊天室對話串中只可建立一個購物車，並且購物車不會在多部裝置上維持一樣。傳送一個購物車後，顧客可以與商家開啟另一個購物車，並重新開始流程。
• 購物車不設到期日：購物車會一直保留在聊天室對話串中，直至被傳送給商家為止。購物車一經傳送便會被清除。

顧客最多可以將每項目錄商品新增 99 件到購物車，但可以加入的商品款式數量則無限制。

購物車一經傳送便無法編輯。如果顧客需要新商品或是想更改訂單，可以傳送新的購物車。商家無法向顧客傳送購物車。

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

使用好處

多商品和單一商品訊息都可以帶來簡單且個人化的用戶體驗，引導顧客瀏覽與自身最相關的商品子集，而非商家的所有庫存，從而讓他們獲得更出色的體驗。

簡單且有效率

這兩類訊息配合自然語言處理技術、文字搜尋或清單訊息和回覆按鈕等導覽工具，能夠快速找出顧客想要的東西。

提供個人化體驗

訊息內容是因應情況填入的，因此可根據顧客或具體情形度身制定。舉例來說，您可以顯示包含顧客最常訂購商品的多商品訊息。

帶來實質業務成果

此功能是有助提升訂單量的強效渠道。在測試期間，各商家所傳送的多商品訊息中平均有 7% 完成轉換，亦即商家成功收到購物車。

告別範本

您不需要準備範本或接受預先審查，也能使用互動式訊息。此類訊息為即時產生的訊息，一律反映庫存中最新的商品詳情、價格和存貨量。

使用時機

多商品訊息非常適合用於引導顧客瀏覽商家庫存中的特定商品子集，在以下情境例子尤為有用：

• 以對話方式購物；舉例來說，顧客可使用搜尋功能輸入購物清單，然後系統傳回多商品訊息來回應。
• 導覽至特定類別，例如健身服飾。
• 提供個人化優惠或推薦。
• 再次訂購之前購買過的商品；舉例來說，用戶可以再次訂購不超過 30 項的常點外帶商品。

單一商品訊息非常適合引導顧客從商家庫存中找到一項特定商品，以便從一小組選項中提供快速回應，例如：

• 回應顧客的特定要求。
• 提供推薦。
• 再次訂購之前購買過的商品。

這兩項功能亦可以納入真人客戶服務人員流程，但是您需要建立相關工具，以允許真人客戶服務人員在對話串中產生多商品或單一商品訊息。

新手指南

在傳送每則訊息之前，您需要向 /contacts 節點執行呼叫，以獲取傳送對象的 WhatsApp 編號。

我們建議設定 Webhooks，以接收訊息狀態和訊息傳入通知。您可以透過這種方式追蹤訊息是否已送出以及顧客的回答。

步驟 1：整合 Interactive 物件

單一商品訊息

如要傳送單一商品訊息，請整合 product 類型的 interactive 物件與以下組件：

最後，interactive 物件應如下所示：

"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"
    }
}

多商品訊息

如要傳送多商品訊息，請整合 product_list 類型的 interactive 物件與以下組件：

最後，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}"
  }]
  }

多商品範本訊息

如要傳送多商品範本訊息，您需要使用多商品息範本。參閱我們的多商品訊息範本文件，了解如何建立此類範本，以及如何在範本訊息中傳送有關範本。