Piattaforma Messenger

API User Profile

L'API User Profile ti consente di utilizzare un ID per Instagram (IGSID) per recuperare le informazioni sul profilo del cliente. Puoi utilizzare queste informazioni per creare un'esperienza personalizzata per le persone che interagiscono con la tua azienda.

Consenso dell'utente

Per accedere al profilo di un utente è necessario il suo consenso. Il consenso dell'utente è impostato solo quando una persona invia un messaggio a un'azienda oppure clicca su rompighiaccio o menu always-on. Se una persona commenta un post o un commento ma non ha inviato alcun messaggio all'azienda, la tua app riceverà un errore. Per accedere al profilo di un utente è necessario il suo consenso.

Requisiti

Ecco cosa ti servirà:

  • Autorizzazione instagram_basic
  • Autorizzazione instagram_manage_messages
  • Autorizzazioni pages_manage_metadata
  • Autorizzazione pages_read_engagement
  • Autorizzazione pages_show_list
  • Token d'accesso della Pagina richiesto da una persona che può eseguire l'attività MODERATE sulla Pagina

Limitazioni

Se un cliente ha bloccato la tua azienda, non sarai in grado di visualizzare le sue informazioni.

Campi del profilo utente

I seguenti campi del profilo sono disponibili per tutte le versioni dell'API Graph.

Nome del campo Descrizione

name

stringa

Il nome del cliente (può essere null se il nome non è impostato).

profile_pic

url

L'URL dell'immagine del profilo del cliente (può essere null se l'immagine del profilo non è impostata). L'URL scadrà entro pochi giorni.

I seguenti campi del profilo sono disponibili per l'API Graph v12.0 e versioni successive.

Nome del campo Descrizione

is_verified_user

booleano

Stato di verifica per il cliente.

follower_count

int

Numero di follower per il cliente.

is_user_follow_business

booleano

Indica se il cliente segue o meno l'azienda.

is_business_follow_user

booleano

Indica se l'azienda segue o meno il cliente.

I seguenti campi sono disponibili per l'API Graph v14.0 e versioni successive.

CampoDescrizione

username

stringa

Il nome utente per l'account Instagram del cliente.

Esempi

Per ottenere le informazioni sul profilo di un cliente, invia una richiesta GET al nodo ID per Instagram per il cliente e includi i campi che desideri visualizzare.

Esempio di richiesta

Formattato per una maggiore leggibilità.
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"

Se l'azione viene eseguita correttamente, l'app riceve la seguente risposta JSON:

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

Assistenza per gli sviluppatori