API User Profile

L'API User Profile ti consente di utilizzare un ID della singola Pagina (PSID) per recuperare le informazioni del profilo dell'utente che possono essere utilizzate per personalizzare l'esperienza delle persone che interagiscono con il tuo account Messenger.

Disponibilità

Sebbene un PSID possa essere valido, in alcuni casi potrebbe non essere possibile utilizzarlo per recuperare le informazioni del profilo di una persona. Ad esempio, i PSID associati alle pagine di giochi istantanei non sono accessibili tramite l'API User Profile.

Consenso dell'utente

I seguenti eventi autorizzeranno il tuo bot di Messenger ad accedere alle informazioni del profilo di una persona:

• La persona avvia la conversazione tramite una schermata di benvenuto e dopo aver toccato il pulsante "Inizia".
• La persona avvia la conversazione cliccando sul pulsante "Invia a Messenger".
• La persona avvia la conversazione inviando un messaggio.
• La persona avvia la conversazione accettando la richiesta di messaggio di una Pagina.
• Il tuo bot di Messenger utilizza la funzione askPermission() dell'SDK per le estensioni di Messenger nella visualizzazione web per chiedere l'autorizzazione user_profile.
• Per le app business, la funzione Accesso al profilo utente della risorsa business è richiesta in aggiunta e può essere applicata tramite l'analisi dell'app.

Alcuni punti di accesso consentono alle app di avviare una conversazione senza concedere all'app l'autorizzazione per l'accesso al profilo pubblico della persona. In tali casi, all'app verrà concessa l'autorizzazione per l'accesso al profilo della persona dopo la risposta della persona al messaggio iniziale. Situazioni rilevanti in cui una persona può avviare una conversazione con l'app, ma non concedere l'autorizzazione del profilo, includono quanto segue:

• Conversazioni avviate tramite il plug-in della casella di spunta in cui la persona non ha risposto su Messenger
• Interazioni con le inserzioni che rimandano a Messenger prima della risposta della persona su Messenger

Profilo non disponibile

Al momento, l'API User Profile non supporta il recupero delle informazioni del profilo per gli account Messenger creati utilizzando un numero di telefono.

In tal caso, l'API restituirà il codice di errore 2018218 insieme al messaggio "Nessun profilo disponibile per questo utente".

Campi del profilo disponibili

Le app che hanno ricevuto l'approvazione dell'analisi dell'app per la funzione e l'autorizzazione richieste possono recuperare i seguenti campi per gli utenti che hanno reso pubbliche queste informazioni e hanno espresso il proprio consenso per la tua Pagina.

Richiesta dell'accesso alle funzioni ai campi dell'utente per la Pagina

1. Accedi a Impostazioni della Pagina > Messaggi avanzati
2. In "Informazioni sulle persone" seleziona il campo e clicca sul pulsante "Richiesta".

Recupero del profilo di una persona

Per utilizzare l'API User Profile, invia una richiesta GET con i campi del profilo che desideri per la persona:

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

Se l'app può accedere al profilo della persona, l'API User Profile ti restituirà una stringa JSON con i campi richiesti dal profilo della persona.

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

Se l'app non può accedere al profilo della persona, viene restituito un oggetto vuoto.

Altri contenuti da consultare

• Codici di errore della piattaforma Messenger