Tài liệu tham khảo về nút URL

Nút URL mở ra một trang web trong chế độ xem web của Messenger. Bạn có thể sử dụng nút này với Mẫu nút và Mẫu chung.

Nếu trang web chứa Liên kết ứng dụng, nút này sẽ nhấp vào một ứng dụng gốc. Nếu vừa thực hiện thay đổi, bạn có thể sử dụng Trình gỡ lỗi chia sẻ để yêu cầu lượt quét mới trên trang web đó.

Để biết thêm thông tin về cách sử dụng nút URL, hãy xem Nút URL.

Cú pháp nút URL

SDK Tiện ích Messenger - Yêu cầu đưa miền vào danh sách hợp lệ

Để hiển thị một trang web khi bật SDK Tiện ích Messenger trong chế độ xem web của Messenger, bạn phải đưa miền (kể cả miền con) vào danh sách hợp lệ trong thuộc tính whitelisted_domains của Trang cá nhân Messenger cho bot. Điều này đảm bảo rằng chỉ những miền đáng tin cậy mới quy cập được thông tin người dùng có sẵn qua chức năng của SDK.

Để biết thêm thông tin về cách đưa miền vào danh sách hợp lệ, hãy xem tài liệu tham khảo về whitelisted_domains.

{
  "type":"web_url",
  "url":"

Ví dụ về cách sử dụng URL

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"button",
        "text":"Try the URL button!",
        "buttons":[
          {
            "type":"web_url",
            "url":"https://www.messenger.com/",
            "title":"URL Button",
            "webview_height_ratio": "full"
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Phản hồi URL mẫu

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}  

Thuộc tính URL

Thuộc tính Loại Mô tả

type

String

Loại nút. Phải là web_url.

title

String

Tiêu đề nút. Giới hạn 20 ký tự.

url

String

URL này được mở trong trình duyệt di động khi bạn nhấn vào nút. Phải sử dụng giao thức HTTPS nếu messenger_extensions là true.

webview_height_ratio

String

Không bắt buộc. Chiều cao của Chế độ xem web. Giá trị hợp lệ: compact, tall, full. Giá trị mặc định là full.

messenger_extensions

Boolean

Không bắt buộc. Phải là true nếu sử dụng Tiện ích Messenger.

fallback_url

String

URL để sử dụng trên các máy khách không hỗ trợ Tiện ích Messenger. Nếu URL này không được xác định, url sẽ được dùng làm URL dự phòng. Bạn chỉ có thể chỉ định URL này nếu messenger_extensions là true.

webview_share_button

String

Không bắt buộc. Đặt thành hide để vô hiệu hóa nút chia sẻ trong Chế độ xem web (đối với thông tin nhạy cảm). Điều này không ảnh hưởng đến bất kỳ lượt chia sẻ nào do nhà phát triển khởi tạo bằng Tiện ích.