API Trang cá nhân Messenger

Trang cá nhân Messenger cho Trang của bạn là nơi bạn đặt các thuộc tính để xác định nhiều khía cạnh khác nhau trong các tính năng Nền tảng Messenger sau đây. Để biết thêm thông tin, hãy xem bảng Thuộc tính trang cá nhân Messenger ở bên dưới.

• Nút Bắt đầu
• Trang chào mừng
• Tin nhắn làm quen
• Menu cố định
• Danh sách miền hợp lệ
• Liên kết tài khoản
• Lệnh
• Tab Khám phá (Không còn dùng nữa)

Với API Trang cá nhân Messenger, bạn có thể đặt, cập nhật, truy xuất và xóa các thuộc tính khỏi Trang cá nhân Messenger của Trang.

Quyền

Bạn cần có mã truy cập trang có quyền pages_messaging thì mới tương tác được với điểm cuối này.

Khi ứng dụng ở Chế độ phát triển, cài đặt Trang cá nhân Messenger sẽ chỉ hiển thị với người dùng có vai trò trên ứng dụng.

Nội dung

• URI yêu cầu
• Thuộc tính trang cá nhân Messenger
• Truy xuất thuộc tính
• Đặt/cập nhật thuộc tính
• Xóa thuộc tính
• Giới hạn tốc độ

URI yêu cầu

https://graph.facebook.com/v19.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>

Thuộc tính trang cá nhân Messenger

Các thuộc tính sau có thể được đưa vào trang cá nhân Messenger cho Trang của bạn. Hãy xem mô tả trong bảng bên dưới để biết loại và mục đích của từng thuộc tính.

Truy xuất thuộc tính

Truy xuất giá trị hiện tại của một hoặc nhiều thuộc tính Trang cá nhân Messenger theo tên.

Thông số yêu cầu

Các thông số sau được đưa vào chuỗi truy vấn của yêu cầu:

Yêu cầu mẫu

curl -X GET "https://graph.facebook.com/v19.0/me/messenger_profile?fields=whitelisted_domains,greeting&access_token=<PAGE_ACCESS_TOKEN>"

Phản hồi mẫu

Giá trị hiện tại của các thuộc tính đã yêu cầu sẽ được trả về trong mảng data:

{
   "data": [
        {
          "whitelisted_domains": [
            "https://facebook.com/"
          ],
          "greeting": [
            {
               "locale": "default",
               "text": "Hello!"
            },
            {
               "locale": "en_US",
               "text": "Timeless apparel for the masses."
            }
         ]
      }
   ]
}

Đặt/cập nhật thuộc tính

Đặt các giá trị của một hoặc nhiều thuộc tính Trang cá nhân Messenger. Chỉ các thuộc tính được đặt trong phần nội dung yêu cầu mới bị ghi đè.

Yêu cầu mẫu

curl -X POST -H "Content-Type: application/json" -d '{
  "<PROPERTY_NAME>": "<NEW_PROPERTY_VALUE>",
  "<PROPERTY_NAME>": "<NEW_PROPERTY_VALUE>",
  ...
}' "https://graph.facebook.com/v18.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>"

Phản hồi mẫu

{
    "result": "success"
}

Xóa thuộc tính

Xóa một hoặc nhiều thuộc tính Trang cá nhân Messenger. Chỉ các thuộc tính được chỉ định trong mảng fields mới bị xóa.

Yêu cầu mẫu

curl -X DELETE -H "Content-Type: application/json" -d '{
  "fields": [
    "<PROPERTY_NAME>",
    "<PROPERTY_NAME>",
    "<PROPERTY_NAME>",
    ...
  ]
}' "https://graph.facebook.com/v19.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>"

Phản hồi mẫu

{
    "result": "success"
}