我們即將停用內部部署 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"
    }
  ]
}