我們即將停用內部部署 API。詳情請參閱內部部署 API 停用文件,並從中了解如何轉用新一代雲端 API。
目錄訊息是一種自由形式訊息,支援您在 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>" } }
預留位置 | 說明 | 值範例 |
---|---|---|
字串 | 此為必要項目。 出現在訊息內文的文字。 最多 1024 個字元。 |
|
字串 | 此為選用項目。 出現在訊息頁尾的文字。 最多 60 個字元。 |
|
字串 | 此為必要項目。 商品 SKU 編號。在商務管理工具中標記為內容編號。 此商品的縮圖會被用作訊息的標題圖片。 如省略 |
|
字串 | 顧客手機號碼。 |
|
{ "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 內展示您的商品目錄。
如要傳送目錄範本訊息,您需要使用目錄訊息範本。請參閱我們的目錄範本文件,了解如何建立此類範本,以及如何在範本訊息中傳送有關範本。
多商品訊息和單一商品訊息都屬於 interactive
訊息類型。
多商品訊息範例: | 單一商品訊息範例: |
用戶點擊「開始購物」時觸發的選單: | 商品詳情頁面範例: |
用戶在收到多商品和單一商品訊息時可執行 3 項主要動作:
如果顧客有多部裝置連結了同一個 WhatsApp 帳戶,各裝置之間的多商品和單一商品訊息將會保持同步。不過,購物車只會儲存於每部特定裝置的本機。詳情請參閱購物車體驗。
目前,下列平台支援接收這些類型的訊息:
2.21.100
(多商品訊息)和 2.21.210
(單一商品訊息)。2.21.9.15
(多商品訊息)和 2.21.19
(單一商品訊息)。如果傳送對象的應用程式版本不支援多商品或單一商品訊息,他們將收到另一則訊息,說明因為他們在使用過舊的 WhatsApp 版本,因此無法接收訊息。商家亦會收到一則 Webhook 通知,指出由於傳送對象在使用過舊的 WhatsApp 版本,因此訊息無法送達。
多商品訊息和單一商品訊息支援以下行為:
目錄訊息、多產品訊息和單一商品訊息不支援以下行為:
商家可能需要更新其目錄商品的屬性。我們會根據更新後的屬性來處理提及該商品的任何訊息:
所更新屬性 | 更新程序 |
---|---|
商品的價格、名稱、說明和圖像。 |
|
存貨狀況變更 |
|
瀏覽商品後,顧客可以將商品加到自己的購物車,並將該購物車傳送給商家。就 WhatsApp 商務而言,購物車有以下特性:
顧客將商品加到購物車時,針對每一項目錄商品最多可加入 99 件,但針對不同商品則無數量限制。
購物車一經傳送便無法再被編輯。如果顧客需要新商品或是想更改訂單,可以傳送新的購物車。商家無法向顧客傳送購物車。
多商品和單一商品訊息都可以帶來簡單且個人化的用戶體驗,引導顧客瀏覽與自身最相關的商品子集,而非商家的所有庫存,從而讓他們獲得更出色的體驗。
這兩類訊息配合自然語言處理技術、文字搜尋或清單訊息和回覆按鈕等導覽工具,能夠快速找出顧客想要的東西。
訊息內容是因應情況填入的,因此可根據顧客或具體情形度身制定。舉例來說,您可以顯示包含顧客最常訂購商品的多商品訊息。
此功能是有助提升訂單量的強效渠道。在測試期間,各商家所傳送的多商品訊息中平均有 7% 完成轉換,亦即商家成功收到購物車。
您不需要準備範本或接受預先審查,也能使用互動式訊息。此類訊息為即時產生的訊息,一律反映庫存中最新的商品詳情、價格和存貨量。
多商品訊息非常適合用於引導顧客瀏覽商家庫存中的特定商品子集,在以下情境例子尤為有用:
單一商品訊息非常適合引導顧客從商家庫存中找到一項特定商品,以便從一小組選項中提供快速回應,例如:
這兩項功能亦可以納入真人客戶服務人員流程,但是您需要建立相關工具,以允許真人客戶服務人員在對話串中產生多商品或單一商品訊息。
在傳送每則訊息之前,您需要向 /contacts
節點執行呼叫,以獲取傳送對象的 WhatsApp 編號。
我們建議設定 Webhooks,以接收訊息狀態和訊息傳入通知。您可以透過這種方式追蹤訊息是否已送出以及顧客的回答。
如要傳送單一商品訊息,請整合 product
類型的 interactive
物件與以下組件:
物件 | 說明 |
---|---|
| 此為選用項目。 body 物件。查看 |
| 此為選用項目。 footer 物件。查看 |
| 此為必要項目。 action 欄位必須包含以下項目:
|
最後,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
物件與以下組件:
物件 | 說明 |
---|---|
| 此為必要項目。 標題的 |
| 此為必要項目。
|
| 此為選用項目。
|
| 此為必要項目。 action 欄位必須包含以下項目:
在每個區塊中,您可以加入以下項目:
每個商品物件都包含一個 |
最後,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 目錄中的商品相符。在此情況下:
完成 interactive 物件後,附加其他構成訊息的參數:recipient_type
、to
和 type
。請緊記將 type
設定為 interactive
。
{ "recipient_type": "individual", "to" : "whatsapp-id", // WhatsApp ID of the recipient "type": "interactive", "interactive":{ // The interactive object } }
請在此處瀏覽所有訊息類型通用的參數。
/messages
執行 POST
呼叫使用您在步驟 1 和 2 中整合的 JSON
物件,向 /messages
端點執行 POST
呼叫。如果您的訊息成功送出,您將收到以下回應:
{ "messages": [{ "id": "{message-id}" }] }
如要傳送多商品範本訊息,您需要使用多商品息範本。參閱我們的多商品訊息範本文件,了解如何建立此類範本,以及如何在範本訊息中傳送有關範本。