Platform Messenger

API Profil Pengguna

API Profil Pengguna memungkinkan Anda untuk menggunakan ID Lingkup Instagram (IGSID) untuk mengambil informasi profil pelanggan. Anda dapat menggunakan informasi ini untuk menciptakan pengalaman pribadi bagi orang-orang yang berinteraksi dengan bisnis Anda.

Persetujuan Pengguna

Persetujuan pengguna diperlukan untuk mengakses profil pengguna. Persetujuan pengguna ditetapkan hanya ketika seseorang mengirim pesan ke bisnis, atau mengeklik pencair suasana atau menu persisten. Jika seseorang mengomentari postingan atau komentar tetapi belum mengirim pesan ke bisnis, aplikasi Anda akan menerima kesalahan, Persetujuan pengguna diperlukan untuk mengakses profil pengguna.

Persyaratan

Anda memerlukan:

  • Izin instagram_basic
  • Izin instagram_manage_messages
  • Izin pages_manage_metadata
  • Izin pages_read_engagement
  • Izin pages_show_list
  • Token akses Halaman yang diminta oleh orang yang dapat melakukan tugas MODERATE di Halaman

Batasan

Jika pelanggan telah memblokir bisnis Anda, Anda tidak akan dapat melihat informasi mereka.

Kolom Profil Pengguna

Kolom profil berikut tersedia untuk semua versi Graph API.

Nama Kolom Deskripsi

name

string

Nama pelanggan (dapat "null" jika nama tidak diatur)

profile_pic

url

URL gambar profil pelanggan (dapat "null" jika gambar profil tidak diatur). URL akan kedaluwarsa dalam beberapa hari.

Kolom profil berikut tersedia untuk semua Graph API v12.0 dan setelahnya.

Nama Kolom Deskripsi

is_verified_user

boolean

Status verifikasi pelanggan

follower_count

int

Jumlah pengikut pelanggan

is_user_follow_business

boolean

Menunjukkan apakah pelanggan mengikuti bisnis atau tidak

is_business_follow_user

boolean

Menunjukkan apakah bisnis mengikuti pelanggan atau tidak

Kolom berikut tersedia untuk semua Graph API v14.0 dan setelahnya.

KolomDeskripsi

username

string

Nama pengguna untuk akun Instagram pelanggan

Contoh

Untuk mendapatkan informasi profil pelanggan, kirim permintaan GET ke node ID Lingkup Instagram untuk pelanggan dan sertakan kolom yang ingin dilihat.

Contoh Permintaan

Diformat agar mudah dibaca.
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"

Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON berikut:

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

Dukungan Developer