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.
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.
Sur /me avec Instagram Login, l'ID à portée d'app de l'utilisateur de l'application.
Un IGSID est propre à la personne et au compte Instagram avec lequel elle interagit.
Le webhook d'un DM reçu transporte l'IGSID de la personne ; recipient.id contient l'ID du compte.
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 :
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.
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.
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