AccediInizia la prova gratuita
easyCoexistence API ufficiali

ID utente Instagram: IG_ID, IGSID e ID con ambito app

L'API di Instagram usa tre tipi di ID utente. L'IG_ID è l'ID di un account professionale: GET /me lo restituisce come user_id con Instagram Login, i webhook lo trasportano come entry.id e percorsi come /<IG_ID>/media lo usano. Un IGSID, o ID con ambito Instagram, identifica una persona che scrive o commenta su quell'account. L'ID con ambito app è il campo id che restituisce /me.

easyCoexistence assegna a ogni account Instagram connesso un account_id per i suoi strumenti, accanto all'IG_ID, e inoltra gli eventi di Meta con gli IGSID che contengono, così Claude, ChatGPT o il tuo codice possono rispondere a commenti e DM tramite l'API ufficiale di Meta.

user_id

Il campo di /me che contiene l'ID dell'account professionale di Instagram, cioè l'id nelle notifiche webhook di quell'account.

id

Su /me con Instagram Login, l'ID con ambito app dell'utente dell'app.

Per account

Un IGSID è specifico della persona e dell'account Instagram con cui interagisce.

sender.id

Il webhook di un DM ricevuto contiene l'IGSID della persona; recipient.id contiene l'ID dell'account.

Consent

Necessario per la User Profile API; Meta lo imposta quando la persona scrive all'account o tocca un ice breaker o un menu.

Che cos'è un IG_ID?

L'ID di un account professionale Instagram, l'oggetto su cui si fa la maggior parte delle chiamate. Con Instagram Login, GET /me?fields=user_id,username lo restituisce come user_id, e la guida di Meta precisa che coincide con l'id nelle notifiche webhook dell'account, entry.id. Con Facebook Login, una Pagina lo restituisce nel campo instagram_business_account. Percorsi come /<IG_ID>/media, /<IG_ID>/conversations e /<IG_ID>/insights lo usano.

Che cos'è un IGSID?

Un ID con ambito Instagram, creato quando qualcuno commenta un post, un Reel o una Story dell'account, oppure gli invia un messaggio. Meta lo limita alla persona e all'account con cui interagisce, quindi la stessa persona ha un IGSID diverso per ogni account professionale, mentre resta lo stesso tra app diverse: Meta afferma che permette a un'azienda di collegare le interazioni di una persona tra più app. È l'ID a cui rispondere, con cui trovare una conversazione e con cui cercare una persona.

Che cos'è l'ID con ambito app?

Il campo id di GET /me con Instagram Login, che la guida di Meta descrive come l'ID con ambito app dell'utente dell'app; i suoi esempi usano user_id, non id, nei percorsi che seguono. Anche lo scambio di codice al login restituisce un user_id, che la guida al login chiama ID utente con ambito Instagram dell'utente dell'app. Poiché la guida introduttiva lega user_id di /me alle notifiche webhook, è il valore da salvare come IG_ID.

Dove compare ciascun ID?

I riferimenti e gli esempi di webhook di Meta li collocano come segue. Una persona compare come IGSID, che commenti o scriva un DM, e l'account come IG_ID: il destinatario nei DM che riceve, il mittente in quelli che invia:

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

Come risalire a una persona partendo dall'IGSID?

Con la User Profile API: GET /<IGSID> su graph.instagram.com, con instagram_business_basic e instagram_business_manage_messages. Serve il consenso della persona, che Meta imposta solo quando scrive all'account o tocca una voce di ice breaker o di menu persistente. Gli URL di profile_pic scadono dopo alcuni giorni, e non è possibile cercare una persona che ha bloccato l'account.

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>

Un tipo di ID può essere convertito in un altro?

I percorsi documentati da Meta sono ricerche. Partendo da un IGSID, la User Profile API restituisce il nome utente della persona. Partendo da un nome utente, Business Discovery restituisce l'id di un altro account aziendale o di un creator, con Facebook Login o Unified Login. Partendo da un token, GET /me restituisce l'IG_ID. Un IGSID appartiene a un solo account professionale, quindi l'IGSID della stessa persona visto da un altro account è diverso.

Quali ID usa easyCoexistence?

Quelli di Meta, più uno proprio. list_social_accounts restituisce account_id, l'ID di easyCoexistence per la connessione, che usano gli altri strumenti, e external_id, cioè l'IG_ID; get_social_credentials restituisce l'IG_ID come account_id_on_meta. Gli eventi inoltrati arrivano con platform, account_id, external_id e entry di Meta invariati, e send_social_dm riceve l'IGSID della persona come recipient_id.

Errori comuni

  • Salvare user_id dello scambio di codice come ID dell'account. Leggi user_id da GET /me, che Meta collega all'id nelle notifiche webhook.
  • Riutilizzare un IGSID tra account professionali. È limitato a un solo account, quindi la stessa persona ha un altro IGSID altrove.
  • Cercare un utente che non ha mai scritto. Meta imposta il consenso solo quando la persona scrive all'account o tocca una voce di ice breaker o di menu.
  • Salvare gli URL di profile_pic. Meta afferma che scadono dopo alcuni giorni, quindi richiedili di nuovo quando servono.
Farlo con EasyCoexistence

Da US$ 9 a US$ 0.75 per connessione al mese, con calo man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.

Domande frequenti

L'IGSID è lo stesso dell'ID utente Instagram?

No. Un IGSID identifica una persona rispetto a un account professionale, mentre l'IG_ID identifica l'account professionale stesso.

Perché il mio ID del webhook non corrisponde a quello del login?

Lo scambio di codice restituisce un user_id che Meta definisce con ambito Instagram, mentre le notifiche webhook contengono lo user_id restituito da GET /me. Salva quello di /me.

Posso ottenere il nome utente Instagram di qualcuno partendo dall'IGSID?

Sì, tramite la User Profile API, una volta che la persona ha scritto all'account o toccato una voce di ice breaker o di menu persistente.

L'IGSID cambia tra app diverse?

No. Meta afferma che permette alle aziende di collegare le interazioni della stessa persona tra più app, anche se cambia da un account professionale all'altro.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il