我們即將停用內部部署 API。詳情請參閱內部部署 API 停用文件,並從中了解如何轉用新一代雲端 API。

配置商務設定

您可以為每個商家電話號碼啟用或停用購物車和商品目錄。所有商家電話號碼如已連結至某個 WhatsApp Business 帳戶,系統預設會為其啟用購物車並隱藏店面圖示。

必要條件

獲取商家電話號碼

使用 WhatsApp Business 帳戶 > 電話號碼端點,獲取已連結至 WhatsApp Business 帳戶的所有商家電話號碼之清單。

啟用/停用購物車

使用商家電話號碼 > WhatsApp 商務設定端點,為特定商家電話號碼啟用或停用購物車。

購物車經啟用後,購物車相關按鈕會顯示在對話、目錄和商品詳情版面中:

Three WhatsApp messenger screenshots with callout of various cart UI components displayed

購物車被停用後,顧客可以查看商品及其詳情,但所有購物車相關按鈕都不會顯示在任何版面中。

要求語法

POST /<BUSINESS_PHONE_NUMBER_ID>/whatsapp_commerce_settings
  ?is_cart_enabled=<IS_CART_ENABLED>

參數

預留位置值範例說明

<BUSINESS_PHONE_NUMBER_ID>

106850078877666

商家電話號碼編號。

<IS_CART_ENABLED>

true

布林值。設定為 true 以啟用購物車,或設定為 false 以將其停用。預設值為 true

要求範例

curl -X POST 'https://graph.facebook.com/v21.0/106850078877666/whatsapp_commerce_settings?is_cart_enabled=true' \
-H 'Authorization: Bearer EAAJB...'

回應範例

{
  "success": true
}

啟用/停用目錄

使用商家電話號碼 > WhatsApp 商務設定端點,為特定商家電話號碼啟用或停用商品目錄。

目錄經啟用後,目錄店面圖示和目錄相關按鈕會顯示在對話和商家檔案版面中:

Two WhatsApp messenger screenshots with callout of various catalog UI components displayed

目錄被停用後,店面圖示和目錄相關按鈕不會顯示在任何版面中,而帶縮圖的目錄預覽亦不會顯示在商家檔案版面中。

如果您停用目錄,用戶會在點按導向目錄的 wa.me 連結,以及在您傳送目錄連結的訊息中所顯示的查看目錄按鈕後看到目錄連結無效的警告。

要求語法

POST /<BUSINESS_PHONE_NUMBER_ID>/whatsapp_commerce_settings
  ?is_catalog_visible=<IS_CATALOG_VISIBLE>

參數

預留位置值範例說明

<BUSINESS_PHONE_NUMBER_ID>

106850078877666

商家電話號碼編號。

<IS_CATALOG_VISIBLE>

true

布林值。設定為 true 以顯示目錄店面圖示,或設定為 false 以隱藏該圖示。預設值為 false

要求範例

curl -X POST 'https://graph.facebook.com/v21.0/106850078877666/whatsapp_commerce_settings?is_catalog_visible=true' \
-H 'Authorization: Bearer EAAJB...'

回應範例

{
  "success": true
}

存取商務設定

使用商家電話號碼 > WhatsApp 商務設定端點,以存取個別商家電話號碼的商務設定。

要求語法

GET /<BUSINESS_PHONE_NUMBER_ID>/whatsapp_commerce_settings

參數

預留位置值範例說明

<BUSINESS_PHONE_NUMBER_ID>

106850078877666

商家電話號碼編號。

要求範例

curl -X GET 'https://graph.facebook.com/v21.0/106850078877666/whatsapp_commerce_settings' \
-H 'Authorization: Bearer EAAJB...'

回應範例

{
  "data": [
    {
      "is_cart_enabled": true,
      "is_catalog_visible": true,
      "id": "727705352028726"
    }
  ]
}