Nền tảng Messenger

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

Với API Trang cá nhân người dùng, bạn có thể sử dụng ID trong Instagram (IGSID) để truy xuất thông tin trên trang cá nhân của khách hàng. Bạn có thể dùng thông tin này để tạo trải nghiệm cá nhân hóa cho những người tương tác với doanh nghiệp của mình.

Sự chấp thuận của người dùng

Cần có sự chấp thuận của người dùng để truy cập vào trang cá nhân người dùng. Sự chấp thuận của người dùng chỉ được đặt khi một người gửi tin nhắn cho doanh nghiệp hoặc nhấp vào tin nhắn làm quen/menu cố định. Nếu một người bình luận về một bài viết/bình luận nhưng chưa gửi tin nhắn cho doanh nghiệp, ứng dụng của bạn sẽ nhận được lỗi với nội dung là Cần có sự chấp thuận của người dùng để truy cập vào trang cá nhân người dùng.

Yêu cầu

Bạn sẽ cần:

  • Quyền instagram_basic
  • Quyền instagram_manage_messages
  • Quyền pages_manage_metadata
  • Quyền pages_read_engagement
  • Quyền pages_show_list
  • Mã truy cập Trang do một người có thể thực hiện tác vụ MODERATE trên Trang đó yêu cầu

Các giới hạn

Nếu khách hàng chặn doanh nghiệp của bạn, bạn sẽ không thể xem thông tin của khách hàng đó.

Trường trên trang cá nhân người dùng

Dưới đây là các trường trên trang cá nhân có sẵn cho mọi phiên bản API Đồ thị.

Tên trường Mô tả

name

chuỗi

Tên của khách hàng (có thể bị trống nếu không đặt tên)

profile_pic

url

URL ảnh đại diện của khách hàng (có thể bị trống nếu không đặt ảnh đại diện). URL này sẽ hết hạn sau vài ngày.

Dưới đây là các trường trên trang cá nhân có sẵn cho API Đồ thị v12.0 trở lên.

Tên trường Mô tả

is_verified_user

boolean

Trạng thái xác minh của khách hàng

follower_count

số nguyên

Số người theo dõi của khách hàng

is_user_follow_business

boolean

Cho biết liệu khách hàng có theo dõi doanh nghiệp hay không

is_business_follow_user

boolean

Cho biết liệu doanh nghiệp có theo dõi khách hàng hay không

Dưới đây là các trường có sẵn cho API Đồ thị v14.0 trở lên.

TrườngMô tả

username

chuỗi

Tên người dùng cho tài khoản Instagram của khách hàng

Ví dụ

Để lấy thông tin trên trang cá nhân của một khách hàng, hãy gửi yêu cầu GET đến nút ID trong Instagram của khách hàng đó và thêm các trường bạn muốn xem.

Yêu cầu mẫu

Được định dạng để dễ đọc.
curl -X GET "https://graph.facebook.com/v19.0/instagram-scoped-user-id
  ?fields=name,username,profile_pic,follower_count,is_user_follow_business,is_business_follow_user
  &access_token=page-access-token"

Khi thành công, ứng dụng của bạn sẽ nhận được phản hồi JSON sau đây:

{
  "name": "Peter Chang",
  "username": "peter_chang_live",
  "profile_pic": "https://fbcdn-profile-...",
  "follower_count": 1234
  "is_user_follow_business": false,
  "is_business_follow_user": true,
}

Hỗ trợ nhà phát triển