Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

ID utilisateur Instagram : IG_ID, IGSID et ID à portée d'app

L'API d'Instagram utilise trois types d'ID utilisateur. L'IG_ID est l'ID d'un compte professionnel : GET /me le renvoie sous user_id avec Instagram Login, les webhooks l'envoient dans entry.id, et des chemins comme /<IG_ID>/media le prennent en paramètre. Un IGSID, ou ID à portée Instagram, désigne une personne qui écrit ou commente sur ce compte. L'ID à portée d'app est le champ id renvoyé par /me.

easyCoexistence attribue à chaque compte Instagram connecté un account_id pour ses outils, en plus de l'IG_ID, et transmet les événements de Meta avec les IGSID qu'ils contiennent.

user_id

Le champ de /me qui contient l'ID du compte professionnel Instagram, c'est-à-dire l'id présent dans les notifications webhook de ce compte.

id

Sur /me avec Instagram Login, l'ID à portée d'app de l'utilisateur de l'application.

Per account

Un IGSID est propre à la personne et au compte Instagram avec lequel elle interagit.

sender.id

Le webhook d'un DM reçu transporte l'IGSID de la personne ; recipient.id contient l'ID du compte.

Consent

Nécessaire pour l'API User Profile ; Meta le définit lorsque la personne écrit au compte ou touche un ice breaker ou un élément du menu.

Qu'est-ce qu'un IG_ID ?

L'ID d'un compte professionnel Instagram, l'objet sur lequel la plupart des appels sont faits. Avec Instagram Login, GET /me?fields=user_id,username le renvoie sous user_id, et le guide de Meta indique qu'il est égal à l'id des notifications webhook du compte, entry.id. Avec Facebook Login, une Page le renvoie dans son champ instagram_business_account. Des chemins comme /<IG_ID>/media, /<IG_ID>/conversations et /<IG_ID>/insights le prennent en paramètre.

Qu'est-ce qu'un IGSID ?

Un ID à portée Instagram, créé lorsqu'une personne commente la publication, le Reel ou la Story du compte, ou lui envoie un message. Meta le rattache à la personne et au compte avec lequel elle interagit : une même personne a donc un IGSID différent pour chaque compte professionnel, mais il reste identique d'une application à l'autre, Meta indiquant qu'il permet à une entreprise de relier les interactions d'une personne entre plusieurs applications. C'est l'ID auquel répondre, à partir duquel retrouver une conversation et grâce auquel rechercher une personne.

Qu'est-ce que l'ID à portée d'app ?

Le champ id de GET /me avec Instagram Login, que le guide de Meta décrit comme l'ID à portée d'app de l'utilisateur de l'application. Ses exemples d'appels utilisent user_id, et non id, dans les chemins qui suivent. L'échange de code lors de la connexion renvoie aussi un user_id, que le guide de connexion appelle l'ID utilisateur à portée Instagram de l'utilisateur de l'application. Comme le guide de démarrage relie le user_id de /me aux notifications webhook, c'est cette valeur qu'il faut stocker comme IG_ID.

Où apparaît chaque ID ?

Les références et exemples de webhooks de Meta les placent comme suit. Une personne apparaît sous son IGSID, qu'elle commente ou écrive un DM, et le compte sous son IG_ID : le destinataire dans les DM qu'il reçoit, l'expéditeur dans ceux qu'il envoie :

GET /me user_idIG_ID, the professional account
GET /me idApp-scoped ID of the app user
Webhook entry.idIG_ID of the account the event belongs to
comments value.from.idIGSID of the person who commented
messages sender.idIGSID on a received DM; the IG_ID on one the account sent
Conversations user_idIGSID that finds that person's conversation
Message from and toAn id with a username for each side
Page instagram_business_accountIG_ID, with Facebook Login

Comment retrouver une personne à partir d'un IGSID ?

Avec l'API User Profile : GET /<IGSID> sur graph.instagram.com, avec instagram_business_basic et instagram_business_manage_messages. Elle nécessite le consentement de la personne, que Meta ne définit que lorsqu'elle écrit au compte ou touche un ice breaker ou un élément du menu persistant. Les URL profile_pic expirent en quelques jours, et une personne qui a bloqué le compte ne peut pas être retrouvée.

A person's profile from their IGSID
GET https://graph.instagram.com/<IGSID>
  ?fields=name,username,profile_pic,follower_count,is_user_follow_business,is_business_follow_user
  &access_token=<ACCESS_TOKEN>

Peut-on convertir un type d'ID en un autre ?

Les parcours documentés par Meta sont des recherches. À partir d'un IGSID, l'API User Profile donne le nom d'utilisateur de la personne. À partir d'un nom d'utilisateur, Business Discovery renvoie l'id d'un autre compte d'entreprise ou de créateur, avec Facebook Login ou Unified Login. À partir d'un token, GET /me donne l'IG_ID. Un IGSID appartient à un seul compte professionnel : l'IGSID d'une même personne vu par un autre compte est donc différent.

Quels ID utilise easyCoexistence ?

Ceux de Meta, plus un ID propre. list_social_accounts renvoie account_id, l'ID d'easyCoexistence pour la connexion que consomment les autres outils, et external_id, l'IG_ID ; get_social_credentials renvoie l'IG_ID sous account_id_on_meta. Les événements transmis arrivent avec platform, account_id, external_id et l'entry de Meta inchangés, et send_social_dm prend l'IGSID de la personne comme recipient_id.

Erreurs courantes

  • Stocker le user_id de l'échange de code comme ID du compte. Lisez le user_id dans GET /me, que Meta relie à l'id des notifications webhook.
  • Réutiliser un IGSID entre comptes professionnels. Il est propre à un seul compte, donc la même personne a un autre IGSID ailleurs.
  • Chercher un commentateur qui n'a jamais écrit. Meta n'accorde le consentement que lorsque la personne écrit au compte ou touche un ice breaker ou un élément du menu.
  • Sauvegarder les URL profile_pic. Meta indique qu'elles expirent en quelques jours : demandez-les à nouveau au besoin.
Faire cela avec EasyCoexistence

Ainsi, Claude, ChatGPT ou votre propre code peuvent répondre aux commentaires et aux DM via l'API officielle de Meta. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.

Questions fréquemment posées

L'IGSID est-il le même que l'ID utilisateur Instagram ?

Non. Un IGSID identifie une personne auprès d'un compte professionnel, alors que l'IG_ID identifie le compte professionnel lui-même.

Pourquoi mon ID de webhook ne correspond-il pas à l'ID de la connexion ?

L'échange de code renvoie un user_id que Meta qualifie de à portée Instagram, alors que les notifications webhook transportent le user_id renvoyé par GET /me. Stockez celui de /me.

Peut-on obtenir le nom d'utilisateur Instagram d'une personne à partir d'un IGSID ?

Oui, via l'API User Profile, une fois que la personne a écrit au compte ou touché un ice breaker ou un élément du menu persistant.

L'IGSID change-t-il d'une application à l'autre ?

Non. Meta indique qu'il permet aux entreprises de relier les interactions d'une même personne entre plusieurs applications, bien qu'il diffère d'un compte professionnel à l'autre.

Poursuivre la lecture

Connectez votre premier canal en deux minutes.

Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.

  • 3 jours gratuits
  • Résiliable à tout moment
  • API officielles uniquement
  • Supervisé 24/7

Vérifié le