Plateforme Messenger

API User Profile

L’API User Profile vous permet d’utiliser un ID spécifique à Instagram (IGSID) pour récupérer des informations du profil de votre clientèle. Ces informations servent à créer une expérience personnalisée pour toutes les personnes qui interagissent avec votre entreprise.

Consentement de l’utilisateur·ice

Le consentement de l’utilisateur·ice est nécessaire pour accéder à son profil. Il n’est accordé que lorsqu’une personne envoie un message à une entreprise ou clique sur des boutons de prise de contact ou un menu fixe. Si une personne commente une publication ou répond à un commentaire, mais n’a pas envoyé de message à l’entreprise, votre application recevra l’erreur suivante : Le consentement de l’utilisateur·ice est nécessaire pour accéder à son profil.

Conditions requises

Vous aurez besoin des éléments suivants :

  • Autorisation instagram_basic
  • Autorisation instagram_manage_messages
  • Autorisations pages_manage_metadata
  • Autorisation pages_read_engagement
  • Autorisation pages_show_list
  • Token d’accès de Page demandé par une personne autorisée à effectuer la tâche MODERATE sur la Page

Limites

Si un client ou une cliente a bloqué votre entreprise, vous ne pourrez pas voir ses informations.

Champs du profil utilisateur·ice

Les champs de profil indiqués ci-dessous sont disponibles pour toutes les versions de l’API Graph.

Nom du champ Description

name

chaîne

Nom du client ou de la cliente (peut avoir pour valeur null si aucun nom n’est défini).

profile_pic

url

URL de la photo de profil du client ou de la cliente (peut avoir pour valeur null si aucune photo de profil n’est définie). L’URL expire après quelques jours.

Les champs de profil indiqués ci-dessous sont disponibles dans l’API Graph version 12.0 et ultérieure.

Nom du champ Description

is_verified_user

booléen

Statut de vérification du client ou de la cliente.

follower_count

entier

Nombre de followers du client ou de la cliente.

is_user_follow_business

booléen

Indique si le client ou la cliente suit ou non l’entreprise.

is_business_follow_user

booléen

Indique si l’entreprise suit ou non le client ou la cliente.

Les champs indiqués ci-dessous sont disponibles dans l’API Graph version 14.0 et ultérieure.

ChampDescription

username

chaîne

Nom d’utilisateur du compte Instagram du client ou de la cliente.

Exemples

Pour obtenir les informations de profil d’un client ou d’une cliente, envoyez une requête GET au nœud IGSID de la personne, puis insérez les champs que vous souhaitez consulter.

Exemple de requête

Formaté pour une meilleure lisibilité.
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"

En cas de réussite, votre application reçoit la réponse JSON suivante :

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

Assistance pour les équipes chargées du développement