WhatsApp Business Management API

Mã QR và liên kết ngắn

Hướng dẫn này giải thích cách tạo và quản lý mã QR bằng API Quản lý WhatsApp Business.

Khách hàng có thể quét mã QR bằng điện thoại để nhanh chóng bắt đầu cuộc trò chuyện với doanh nghiệp của bạn. Thông qua API Quản lý WhatsApp Business, bạn có thể tạo và truy cập vào những mã QR này cũng như các liên kết ngắn liên quan.

Nếu bạn có thể dùng Trình quản lý kinh doanh để quản lý mã QR thay cho API này, hãy xem bài viết Quản lý mã QR trên WhatsApp.

Trước khi bạn bắt đầu

Bạn sẽ cần có:

Tạo mã QR

Để tạo mã QR, hãy gửi yêu cầu POST đến điểm cuối Số điện thoại WhatsApp Business > Qrdls tin nhắn.

Trong nội dung của yêu cầu POST này, hãy bổ sung một đối tượng có thuộc tính prefilled_message được đặt là tin nhắn văn bản của bạn và thuộc tính generate_qr_image được đặt là định dạng hình ảnh bạn muốn dùng (SVG hoặc PNG).

Yêu cầu mẫu

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

Phản hồi mẫu

{
  "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/..."
}

Lấy danh sách mã QR

Để lấy danh sách gồm tất cả mã QR trên một số điện thoại của doanh nghiệp, hãy gửi yêu cầu GET đến điểm cuối Số điện thoại WhatsApp Business > Qrdls tin nhắn.

Yêu cầu mẫu

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

Phản hồi mẫu

{
  "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"
    }
  ]
}

Lấy mã QR

Để lấy thông tin về một mã QR cụ thể, hãy gửi yêu cầu GET đến điểm cuối Số điện thoại WhatsApp Business > Qrdls tin nhắn rồi thêm ID của mã QR làm thông số đường dẫn.

Yêu cầu mẫu

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

Phản hồi mẫu

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

Cập nhật mã QR

Để cập nhật mã QR, hãy gửi yêu cầu POST đến điểm cuối Số điện thoại WhatsApp Business > Qrdls tin nhắn.

Trong nội dung của yêu cầu POST này, hãy bổ sung thuộc tính code được đặt là ID của mã QR bạn muốn cập nhật và thuộc tính prefilled_message được đặt là văn bản mới cho mã QR.

Yêu cầu mẫu

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

Phản hồi mẫu

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

Xóa mã QR

Mã QR không tự động hết hạn. Để xóa mã QR, hãy gửi yêu cầu DELETE đến điểm cuối Số điện thoại WhatsApp Business > Qrdls tin nhắn rồi thêm ID của mã QR mà bạn muốn gỡ bỏ làm thông số đường dẫn.

Yêu cầu mẫu

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

Phản hồi mẫu

{
  "success": true
}

Tài liệu tham khảo

Tìm hiểu thêm