與顧客分享商品

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

• 目錄訊息：內含按鈕且格式不拘的訊息，用戶點按該按鈕即可在 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": {
        "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 個數量至一部購物車，但系統並未針對可新增至購物車的不同商品數量設限。

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

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

為何應該使用

多項商品訊息和單一商品訊息可為用戶提供最佳體驗，不僅容易使用，而且個人化，可更有效地引導顧客找到與他們最相關的商品，而不必瀏覽商家的所有庫存。

簡單有效率

搭配使用 NLP、文字搜尋或清單訊息和回覆按鈕等導覽工具，能快速找到顧客正在尋找的項目。

個人化

動態填入資訊，為顧客提供個人化體驗或滿足特定情況的需求。例如，您可使用多項商品訊息，顯示顧客最常訂購的項目。

商家成果

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

沒有範本

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

何時該使用這項功能

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

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

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

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

此外，無論您需要建置何種工具，讓真人客服能在對話串中產生多項商品訊息或單一商品訊息，這兩種功能都可整合到真人客服的服務流程。

開始使用

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

建議您設定 Webhooks 接收訊息狀態和訊息傳入通知。如此一來，您就可以追蹤訊息是否成功送出，並留意顧客的回覆。

步驟 1：組建互動式物件

單一商品訊息

若要傳送單一商品訊息，請使用以下元件，組建 product 類型的 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}"
  }]
  }

多項商品範本訊息

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