與顧客分享商品

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

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

目錄訊息

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

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

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

必要條件

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

要求語法

使用 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 object is optional */
      "parameters": {
        "thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID>"
      }
    },

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

屬性

要求範例

curl 'https://graph.facebook.com/v17.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "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. 將購物車傳送給您：加入所有所需商品後，顧客可以將購物車傳送給您。您收到購物車後便可確定後續步驟，例如要求送貨資料或提供付款選項。

如果您的顧客有多部裝置連結了他們的帳戶，各裝置之間的多商品和單一商品訊息將會保持同步。不過，購物車只會儲存於每部特定裝置的本機。詳情請參閱購物車體驗。

目前，下列平台支援接收這些類型的訊息：

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

如果顧客的應用程式版本不支援多商品或單一商品訊息，他們將收到另一則訊息，說明因為他們在使用過舊的 WhatsApp 版本，因此無法接收訊息。我們亦會向您傳送一則 Webhooks 通知，指出由於顧客在使用過舊的 WhatsApp 版本，因此訊息無法送達。

針對訊息的預期行為

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

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

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

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

限制

透過雲端 API 傳送的訊息與透過 WhatsApp Business 應用程式傳送的商品訊息不同，前者目前不會在聊天室對話串標題中顯示購物車圖示。

商品更新

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

購物車體驗

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

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

顧客將商品加到購物車時，針對每一項目錄商品最多可加入 99 件，但針對不同商品則無數量限制。

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

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

使用好處

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

簡單且有效率

功能結合自然語言處理技術、文字搜尋或清單訊息和回覆按鈕等導覽工具，能夠快速找出顧客所需。

提供個人化體驗

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

帶來實質業務成果

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

告別範本

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

使用時機

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

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

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

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

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

新手指南

在傳送商品訊息之前，請參照最切合您需求的新手指南：

• 適合為自己或自家機構開發內容之用戶的新手指南
• 解決方案合作夥伴新手指南

本指南所提及的所有 API 呼叫都必須以存取憑證進行驗證。開發人員可以使用在應用程式管理中心 > WhatsApp > API 設定面板中產生的存取憑證，來驗證其 API 呼叫。解決方案合作夥伴必須以具有 whatsapp_business_messaging 權限的存取憑證進行自我驗證。

步驟 1：整合 Interactive 物件

單一商品訊息

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

請參閱訊息：Interactive 物件以查閱完整資訊。流程結束時，interactive 物件應如以下所示：

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
    "type": "product",
    "body": {
      "text": "BODY_TEXT"
    },
    "footer": {
      "text": "FOOTER_TEXT"
    },
    "action": {
      "catalog_id": "CATALOG_ID",
      "product_retailer_id": "ID_TEST_ITEM_1"
    }
  }
}

多商品訊息

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

請參閱訊息：Interactive 物件以查閱完整資訊。流程結束時，interactive 物件應如以下所示：

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
    "type": "product_list",
    "header":{
      "type": "text",
      "text": "HEADER_CONTENT"
    },
    "body": {
      "text": "BODY_CONTENT"
    },
    "footer": {
      "text": "FOOTER_CONTENT"
    },
    "action": {
      "catalog_id": "CATALOG_ID",
      "sections": [
        {
          "title": "SECTION_TITLE",
          "product_items": [
            { "product_retailer_id": "PRODUCT-SKU" },
            { "product_retailer_id": "PRODUCT-SKU" },
            ...
          ]

        },
        {
          "title": "SECTION_TITLE",
          "product_items": [
            { "product_retailer_id": "PRODUCT-SKU" },
            { "product_retailer_id": "PRODUCT-SKU" },
            ...
          ]
        }
      ]
    }
  }
}

缺少商品

如果上述 API 呼叫中提供的商品無一與您商品目錄中的商品相符，則系統會傳送一則錯誤訊息，並且不會向用戶傳送多商品或單一商品訊息。

如果是多商品訊息，商品清單中至少要有一項商品與您商品目錄中的商品相符。在此情況下：

• 訊息成功送出
• 不相符的商品會被棄置
• 您收到一則錯誤訊息，要求更新目錄

步驟 2：加入通用訊息參數

完成 interactive 物件後，附加其他構成訊息的參數：recipient_type、to、messaging_product 和 type。切記將 type 設定為 interactive。

curl -X  POST https://graph.facebook.com/v19.0/FROM_PHONE_NUMBER/messages \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 - d '{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
  // INTERACTIVE OBJECT GOES HERE    
}'

請參閱參考資料：訊息以了解所有可用參數。

步驟 3：向 Messages 端點傳送要求

使用您在步驟 1 和 2 中整合的 JSON 物件，向 /PHONE_NUMBER_ID/messages 端點傳送 POST 要求。如果您的訊息成功送出，您將收到以下回應：

{
  "messaging_product": "whatsapp",
  "contacts": [{
      "input": "PHONE_NUMBER",
      "wa_id": "WHATSAPP_ID",
    }]
  "messages": [{
      "id": "wamid.ID",
    }]
}

多商品範本訊息

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