與顧客分享商品

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

• 目錄訊息 - 包含按鈕的自由格式訊息，當用戶點擊該按鈕時，會在 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 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 而無法接收訊息。我們也會傳送 Webhook 通知給您，指示因顧客使用舊版 WhatsApp 而無法傳遞該訊息。

訊息的預期行為

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

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

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

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

限制

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

商品更新

您無法傳送購物車給顧客。根據更新的屬性，以下是我們針對任何提及該商品之訊息的處理方式：

購物車體驗

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

• 對於特定裝置中的顧客／商家聊天對話串來說是不重複的：您和顧客之間的每個聊天對話串只會產生一個購物車，且購物車不會在多個裝置之間保留。購物車傳送之後，顧客就能開啟您的另一個購物車，並再次啟動該流程。
• 沒有到期日：購物車會保留在聊天對話串中，直到將其傳送給您。傳送購物車之後，系統就會將其清除。

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

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

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

為什麼應該使用此功能

多項商品訊息和單一商品訊息都會引導顧客瀏覽最貼近需求的商品種類，而不是瀏覽您的所有庫存商品，這能提供簡單、個人化且更優質的用戶體驗。

簡單有效率

搭配使用 NLP（自然語言處理）、文字搜尋或清單訊息和回覆按鈕等導覽工具，能夠快速找出顧客正在尋找的內容。

個人化服務

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

商家成果

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

沒有範本

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

何時該使用這項功能

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

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

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

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

這兩種功能也可以用作真人客服流程的一部分，但是您需要建置工具以允許真人客服人員在對話串中產生多項商品訊息或單一商品訊息。

開始使用

傳送商品訊息之前，請按照最符合您需求的新手指南操作：

• 適用於為自己或組織開發之人員的新手指南
• 解決方案合作夥伴新手指南

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

步驟 1：組合互動式物件

單一商品訊息

若要傳送單一商品訊息，請組合 product 類型的 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 物件，並包含下列元件：

如需完整資訊，請參閱訊息：互動式物件。該程序結束時，互動式物件應如下所示：

{
  "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：新增公用訊息參數

完成互動式物件後，請附加其他可撰寫訊息的參數：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：傳送要求至訊息端點

使用您在步驟 1 和步驟 2 組合的 JSON 物件，傳送 POST 要求至 /PHONE_NUMBER_ID/messages 端點。若訊息傳送成功，您會收到以下回覆：

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

多項商品範本訊息

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