Nền tảng Messenger

API Trang cá nhân của người dùng

Với API Trang cá nhân của người dùng, bạn có thể sử dụng ID người dùng trong trang (PSID) để truy xuất thông tin trên trang cá nhân của người dùng. Thông tin này có thể được dùng để cá nhân hóa trải nghiệm của những người dùng tương tác với Messenger của bạn.

Khả năng sử dụng

Để truy xuất thông tin trên trang cá nhân của người dùng, bạn cần có Quyền truy cập nâng cao cho tính năng Quyền truy cập vào trang cá nhân của người dùng trong tài sản doanh nghiệp. Một số trường cần có quyền truy cập bổ sung.

Mặc dù PSID có thể hợp lệ nhưng trong một số trường hợp, bạn không thể dùng PSID để truy xuất thông tin trên trang cá nhân của người dùng. Ví dụ: bạn không thể truy cập các PSID được liên kết với Trang Trò chơi tức thì qua API Trang cá nhân của người dùng.

Khả năng chọn tham gia của người dùng

Dưới đây là những sự kiện sẽ cho phép bot Messenger của bạn truy cập thông tin trên trang cá nhân của một người dùng:

Một số điểm truy cập cho phép ứng dụng bắt đầu cuộc trò chuyện mà không cần cấp cho ứng dụng quyền truy cập trang cá nhân công khai của người dùng. Trong những trường hợp như vậy, ứng dụng sẽ được cấp quyền truy cập trang cá nhân sau khi người dùng trả lời tin nhắn đầu tiên. Dưới đây là những trường hợp đáng chú ý mà người dùng có thể bắt đầu cuộc trò chuyện với ứng dụng, nhưng không cho phép truy cập trang cá nhân:

Trang cá nhân không khả dụng

Hiện tại, API Trang cá nhân của người dùng không hỗ trợ truy xuất thông tin trên trang cá nhân đối với các tài khoản Messenger được tạo bằng số điện thoại.

Trong trường hợp này, API sẽ trả về mã lỗi 2018218 cùng với thông báo "Người dùng này không có trang cá nhân nào".

Trường có thể truy cập trên trang cá nhân

Những ứng dụng đã được phê duyệt các tính năng và quyền cần thiết qua quy trình Xét duyệt ứng dụng có thể truy xuất các trường sau đối với những người dùng đã đặt thông tin này ở chế độ công khai và đã chọn tham gia Trang của bạn.

Tên trườngMô tảQuyền

id

PSID của người dùng

Không có

name

Tên và họ của người dùng

Không có

first_name

Tên

Không có

last_name

Họ

Không có

profile_pic

Ảnh đại diện

Không có

locale

Ngôn ngữ của người dùng trên Facebook

pages_user_locale

timezone

Múi giờ, số liên quan tới GMT

pages_user_timezone

gender

Giới tính

pages_user_gender

Yêu cầu quyền truy cập tính năng vào các trường của người dùng cho Trang

  1. Chuyển đến phần Cài đặt Trang > Nhắn tin nâng cao
  2. Trong phần "Thông tin người dùng", chọn trường và nhấp vào nút "Yêu cầu".

Truy xuất trang cá nhân của một người dùng

Để sử dụng API Trang cá nhân của người dùng, hãy gửi yêu cầu GET với các trường trên trang cá nhân mà bạn muốn nhận cho người dùng này:

curl -X GET "https://graph.facebook.com/<PSID>?fields=first_name,last_name,profile_pic&access_token=<PAGE_ACCESS_TOKEN>"

Nếu ứng dụng có thể truy cập trang cá nhân của người dùng, API Trang cá nhân của người dùng sẽ trả về chuỗi JSON với các trường được yêu cầu từ trang cá nhân của người dùng đó.

{
  "first_name": "Peter",
  "last_name": "Chang",
  "profile_pic": "https://fbcdn-profile-a.akamaihd.net/hprofile-ak-xpf1/v/t1.0-1/p200x200/13055603_10105219398495383_8237637584159975445_n.jpg?oh=1d241d4b6d4dac50eaf9bb73288ea192&oe=57AF5C03&__gda__=1470213755_ab17c8c8e3a0a447fed3f272fa2179ce",
  "locale": "en_US",
  "timezone": -7,
  "gender": "male",
  "last_ad_referral": {
    "source": "ADS",
    "type": "OPEN_THREAD",
    "ad_id": "6045246247433"
  }
}

Nếu ứng dụng không thể truy cập trang cá nhân của người dùng ở trên, hệ thống sẽ trả về một đối tượng trống.

Xem thêm