Instagram-gebruiker-ID's: IG_ID, IGSID en app-gebonden ID's
De Instagram-API gebruikt drie soorten gebruiker-ID's. De IG_ID is de ID van een professioneel account: GET /me geeft die terug als user_id bij Instagram Login, webhooks sturen die mee als entry.id, en paden zoals /<IG_ID>/media nemen die over. Een IGSID, of Instagram-gebonden ID, staat voor een persoon die een bericht stuurt of reageert op dat account. De app-gebonden ID is het id-veld dat /me teruggeeft.
easyCoexistence geeft elk verbonden Instagram-account één account_id voor de tools, naast de IG_ID, en stuurt de events van Meta door met de IGSID's die ze bevatten.
Het /me-veld met de ID van het professionele Instagram-account, die de id is in de webhookmeldingen van dat account.
Op /me met Instagram Login: de app-gebonden ID van de app-gebruiker.
Een IGSID is specifiek voor de persoon en het Instagram-account waarmee die persoon contact heeft.
Waar de webhook van een ontvangen DM de IGSID van de persoon bevat; recipient.id bevat de ID van het account.
Nodig voor de User Profile API; Meta stelt die in wanneer de persoon het account een bericht stuurt of een ice breaker of menu-item aantikt.
Wat is een IG_ID?
De ID van een professioneel Instagram-account, het object waarop de meeste aanroepen worden gedaan. Met Instagram Login geeft GET /me?fields=user_id,username die terug als user_id, en de gids van Meta zegt dat die gelijk is aan de id in de webhookmeldingen van het account, entry.id. Met Facebook Login geeft een pagina die terug in het veld instagram_business_account. Paden zoals /<IG_ID>/media, /<IG_ID>/conversations en /<IG_ID>/insights gebruiken hem.
Wat is een IGSID?
Een Instagram-gebonden ID, aangemaakt wanneer iemand reageert op een post, Reel of Story van het account, of het account een bericht stuurt. Meta koppelt die aan de persoon en het account waarmee die contact heeft, dus dezelfde persoon heeft een andere IGSID bij elk professioneel account, terwijl die over apps heen hetzelfde blijft: Meta zegt dat het een bedrijf in staat stelt de interacties van één persoon over meerdere apps heen te koppelen. Het is de ID waarnaar je antwoordt, waarmee je een gesprek vindt en waarmee je een persoon opzoekt.
Wat is de app-gebonden ID?
Het id-veld van GET /me onder Instagram Login, dat de gids van Meta beschrijft als de app-gebonden ID van de app-gebruiker. De voorbeeldaanroepen gebruiken in de volgende paden user_id, niet id. De codewisseling bij het inloggen geeft ook een user_id terug, die de inloggids de Instagram-gebonden gebruikers-ID van de app-gebruiker noemt. Omdat de startgids de user_id van /me koppelt aan webhookmeldingen, is dat de waarde om op te slaan als IG_ID.
Waar verschijnt elke ID?
De referenties en webhookvoorbeelden van Meta plaatsen ze zoals hieronder. Een persoon verschijnt als IGSID, of die nu reageert of een DM schrijft, en het account als zijn IG_ID: de ontvanger bij DM's die het ontvangt, de afzender bij DM's die het verstuurt:
Hoe zoek je een persoon op aan de hand van een IGSID?
Met de User Profile API: GET /<IGSID> op graph.instagram.com, met instagram_business_basic en instagram_business_manage_messages. Daarvoor is toestemming van de persoon nodig, die Meta alleen instelt wanneer die het account een bericht stuurt of een ice breaker of persistent menu-item aantikt. profile_pic-URL's verlopen binnen enkele dagen, en een persoon die het account heeft geblokkeerd kan niet worden opgezocht.
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>Kan de ene soort ID in de andere worden omgezet?
De routes die Meta documenteert zijn opzoekingen. Vanuit een IGSID geeft de User Profile API de gebruikersnaam van de persoon. Vanuit een gebruikersnaam geeft Business Discovery de id van een ander bedrijfs- of creator-account terug, met Facebook Login of Unified Login. Vanuit een token geeft GET /me de IG_ID. Een IGSID hoort bij één professioneel account, dus de IGSID van dezelfde persoon, gezien door een ander account, verschilt ervan.
Welke ID's gebruikt easyCoexistence?
Die van Meta, plus één eigen. list_social_accounts geeft account_id terug, de ID van easyCoexistence voor de verbinding die de andere tools gebruiken, en external_id, de IG_ID. get_social_credentials geeft de IG_ID terug als account_id_on_meta. Doorgestuurde events komen binnen als platform, account_id, external_id en de entry van Meta, ongewijzigd, en send_social_dm neemt de IGSID van de persoon als recipient_id.
Veelgemaakte fouten
- De user_id van de codewisseling opslaan als de ID van het account. Lees user_id uit GET /me, dat Meta koppelt aan het id in webhookmeldingen.
- Een IGSID hergebruiken over professionele accounts heen. Die is gebonden aan één account, dus dezelfde persoon heeft elders een andere IGSID.
- Een reageerder opzoeken die nooit heeft geschreven. Meta stelt toestemming alleen in wanneer de persoon het account een bericht stuurt of een ice breaker of menu-item aantikt.
- profile_pic-URL's opslaan. Meta zegt dat ze binnen enkele dagen verlopen, dus vraag ze opnieuw op wanneer nodig.
Zo kunnen Claude, ChatGPT of je eigen code via de officiële API van Meta reageren op reacties en DM's. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Is de IGSID hetzelfde als de Instagram-gebruikers-ID?
Nee. Een IGSID identificeert een persoon bij één professioneel account, terwijl de IG_ID het professionele account zelf identificeert.
Waarom komt mijn webhook-ID niet overeen met de ID van het inloggen?
De codewisseling geeft een user_id terug die Meta Instagram-gebonden noemt, terwijl webhookmeldingen de user_id bevatten die GET /me teruggeeft. Sla die van /me op.
Kan ik de Instagram-gebruikersnaam van iemand krijgen via een IGSID?
Ja, via de User Profile API, zodra de persoon het account een bericht heeft gestuurd of een ice breaker of persistent menu-item heeft aangetikt.
Verandert de IGSID tussen apps?
Nee. Meta zegt dat het bedrijven in staat stelt de interacties van dezelfde persoon over meerdere apps heen te koppelen, al verschilt de IGSID van het ene professionele account tot het andere.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op