API Profil Pengguna

API Profil Pengguna memungkinkan Anda menggunakan ID Lingkup Instagram (PSID) untuk mengambil informasi profil pengguna yang dapat digunakan untuk mempersonalisasi pengalaman orang-orang yang berinteraksi dengan Messenger Anda.

Ketersediaan

Untuk mengambil informasi profil pengguna, Anda harus memiliki Advanced Access untuk fitur Akses Profil Pengguna Aset Bisnis. Beberapa kolom memerlukan izin tambahan untuk akses.

Meskipun PSID mungkin valid, dalam beberapa kasus PSID mungkin tidak bisa digunakan untuk mengambil informasi profil seseorang. Contoh: PSID yang terkait dengan Halaman Game Instan tidak dapat diakses melalui API Profil Pengguna.

Persetujuan Pengguna

Peristiwa berikut akan mengotorisasi bot Messenger Anda untuk mengakses informasi profil seseorang:

Orang tersebut memulai percakapan melalui layar sambutan dan mengetuk tombol "Mulai".
Orang tersebut memulai percakapan dengan mengeklik tombol "Kirim ke Messenger".
Orang itu memulai percakapan dengan mengirim pesan.
Orang tersebut memulai percakapan dengan menerima permintaan pesan dari Halaman.
Bot Messenger Anda menggunakan fungsi askPermission() dari SDK Ekstensi Messenger di tampilan web untuk meminta izin user_profile.
Untuk aplikasi Bisnis, fitur tambahan Akses Profil Pengguna Aset Bisnis diperlukan, dan dapat diterapkan melalui Tinjauan Aplikasi.

Beberapa titik masuk memungkinkan aplikasi untuk memulai percakapan tanpa memberikan otorisasi aplikasi untuk mengakses profil publik orang tersebut. Dalam kasus tersebut, aplikasi akan diberi izin untuk mengakses profil seseorang setelah orang tersebut membalas pesan awal. Situasi penting saat seseorang dapat memulai percakapan dengan aplikasi, tetapi tidak mengizinkan izin profil mencakup hal berikut:

Percakapan dimulai melalui Plugin Kotak Centang tempat orang tersebut tidak menanggapi Messenger.
Interaksi dengan Iklan yang mengarahkan ke Messenger sebelum orang tersebut membalas di Messenger

Profil Tidak Tersedia

Saat ini, API Profil Pengguna tidak mendukung pengambilan informasi profil untuk akun Messenger yang dibuat menggunakan nomor telepon.

Dalam hal ini, API akan mengembalikan kode kesalahan 2018218 bersama dengan pesan "Tidak ada profil yang tersedia untuk pengguna ini."

Kolom Profil yang Tersedia

Aplikasi yang telah menerima Persetujuan Tinjauan Aplikasi untuk fitur dan izin yang diperlukan dapat mengambil kolom berikut bagi pengguna yang telah menjadikan informasi ini publik dan telah memilih Halaman Anda.

Nama Kolom	Keterangan	Izin
`id`	PSID pengguna	N/A
`name`	Nama depan dan nama belakang pengguna	N/A
`first_name`	Nama depan	N/A
`last_name`	Nama belakang	N/A
`profile_pic`	Foto profil	N/A
`locale`	Lokale pengguna di Facebook	`pages_user_locale`
`timezone`	Zona waktu, angkanya berkaitan dengan GMT	`pages_user_timezone`
`gender`	Jenis kelamin	`pages_user_gender`

Meminta akses fitur ke kolom pengguna untuk Halaman

Buka Pengaturan Halaman > Berkirim Pesan Lanjutan
Di bawah 'Info Tentang Orang', pilih kolom dan klik tombol 'Minta'.

Mengambil Profil Seseorang

Untuk menggunakan API Profil Pengguna, kirim permintaan GET dengan kolom profil yang Anda inginkan untuk orang tersebut:

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

Jika aplikasi dapat mengakses profil orang tersebut, API Profil Pengguna akan memberikan string JSON dengan kolom yang diminta dari profil orang tersebut.

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

Jika aplikasi tidak dapat mengakses profil orang tersebut, objek kosong akan ditampilkan.

Lihat Juga

Kode Kesalahan Platform Messenger