WhatsApp Business Management API

WhatsApp Business 平台 > Business Management API > 指南

QR 碼與短連結

本指南說明如何使用 WhatsApp Business Management API 建立和管理 QR 碼。

顧客可以使用手機掃描 QR 碼，快速地與您的商家展開對話。WhatsApp Business Management API 允許您建立和存取這些 QR 碼及相關聯的短連結。

如果您可以使用企業管理平台而不是 API 來管理您的 QR 碼，請參閱管理 WhatsApp QR 碼。

準備工作

必備資料：

建立 QR 碼

若要建立 QR 碼，請傳送 POST 要求至 WhatsApp Business 電話號碼 > 訊息 Qrdls 端點。

在 POST 內容中，加入一個物件，並將 prefilled_message 屬性設為您的訊息文字，將 generate_qr_image 屬性設為您慣用的圖像格式（SVG 或 PNG）。

要求範例

curl 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "prefilled_message": "Cyber Monday",
  "generate_qr_image": "SVG"
}'

回應範例

{
  "code": "4O4YGZEG3RIVE1",
  "prefilled_message": "Cyber Monday 1",
  "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1",
  "qr_image_url": "https://scontent-iad3-2.xx.fbcdn.net/..."
}

取得 QR 碼清單

若要取得商家電話號碼的所有 QR 碼清單，請傳送 GET 要求至 WhatsApp Business 電話號碼 > 訊息 Qrdls 端點。

要求範例

curl 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls' \
-H 'Authorization: Bearer EAAJB...'

回應範例

{
  "data": [
    {
      "code": "4O4YGZEG3RIVE1",
      "prefilled_message": "Cyber Monday",
      "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1"
    },
    {
      "code": "WOMVT6TJ2BP7A1",
      "prefilled_message": "Tell me more about your production workshop",
      "deep_link_url": "https://wa.me/message/WOMVT6TJ2BP7A1"
    }
  ]
}

取得 QR 碼

若要取得有關特定 QR 碼的資訊，請傳送 GET 要求至 WhatsApp Business 電話號碼 > 訊息 Qrdls 端點，並將 QR 碼編號附加為路徑參數。

要求範例

curl 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls/4O4YGZEG3RIVE1' \
-H 'Authorization: Bearer EAAJB...'

回應範例

{
  "data": [
    {
      "code": "4O4YGZEG3RIVE1",
      "prefilled_message": "Cyber Monday",
      "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1"
    }
  ]
}

更新 QR 碼

若要更新 QR 碼，請傳送 POST 要求至 WhatsApp Business 電話號碼 > 訊息 Qrdls 端點。

在 POST 內容中，加入一個 code 屬性，並將其設為要更新的 QR 碼編號，以及一個 prefilled_message 屬性，並將其設為新 QR 碼文字。

要求範例

curl 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
    "code": "4O4YGZEG3RIVE1",
    "prefilled_message": "Cyber Tuesday"
}'

回應範例

{
  "code": "4O4YGZEG3RIVE1",
  "prefilled_message": "Cyber Tuesday",
  "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1"
}

刪除 QR 碼

QR 碼不會自動過期。若要刪除 QR 碼，請傳送 DELETE 要求至 WhatsApp Business 電話號碼 > 訊息 Qrdls 端點，並將您希望停用的 QR 碼編號附加為路徑參數。

要求範例

curl -X DELETE 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls/4O4YGZEG3RIVE1' \
-H 'Authorization: Bearer EAAJB...'

回應範例

{
  "success": true
}

參考資料

瞭解詳情