Identyfikatory użytkowników Instagrama: IG_ID, IGSID i ID w zakresie aplikacji
API Instagrama używa trzech rodzajów identyfikatorów użytkownika. IG_ID to identyfikator konta zawodowego: GET /me zwraca go jako user_id przy Instagram Login, webhooki przekazują go jako entry.id, a ścieżki takie jak /<IG_ID>/media go przyjmują. IGSID, czyli identyfikator w zakresie Instagrama, oznacza osobę, która pisze wiadomość lub komentuje na tym koncie. ID w zakresie aplikacji to pole id zwracane przez /me.
easyCoexistence przydziela każdemu połączonemu kontu Instagram jeden account_id dla swoich narzędzi, obok IG_ID, i przekazuje zdarzenia Meta z IGSID, które zawierają, dzięki czemu Claude, ChatGPT lub Twój własny kod mogą odpowiadać na komentarze i DM przez oficjalne API Meta.
Pole /me z ID konta zawodowego Instagrama, czyli id w powiadomieniach webhooka tego konta.
Na /me przy Instagram Login: identyfikator w zakresie aplikacji dla użytkownika aplikacji.
IGSID jest przypisany do konkretnej osoby i konta Instagram, z którym ta osoba wchodzi w interakcję.
Webhook otrzymanej wiadomości DM zawiera IGSID osoby; recipient.id zawiera ID konta.
Potrzebny do User Profile API; Meta ustawia go, gdy osoba napisze do konta lub kliknie ice breaker albo pozycję menu.
Czym jest IG_ID?
ID konta zawodowego Instagrama, na którym wykonuje się większość wywołań. Przy Instagram Login GET /me?fields=user_id,username zwraca je jako user_id, a przewodnik Meta podaje, że jest ono równe id z powiadomień webhooka tego konta, czyli entry.id. Przy Facebook Login Strona Facebooka zwraca je w polu instagram_business_account. Ścieżki takie jak /<IG_ID>/media, /<IG_ID>/conversations i /<IG_ID>/insights go przyjmują.
Czym jest IGSID?
Identyfikator w zakresie Instagrama, tworzony, gdy ktoś skomentuje post, Reel lub Story konta albo wyśle mu wiadomość. Meta przypisuje go do osoby i konta, z którym ta osoba wchodzi w interakcję, więc ta sama osoba ma inny IGSID przy każdym koncie zawodowym, ale pozostaje taki sam w różnych aplikacjach: według Meta pozwala to firmie powiązać interakcje jednej osoby między aplikacjami. To ID, na które się odpowiada, którym znajduje się rozmowę i po którym wyszukuje się osobę.
Czym jest ID w zakresie aplikacji?
Pole id zwracane przez GET /me przy Instagram Login, które przewodnik Meta opisuje jako identyfikator w zakresie aplikacji użytkownika aplikacji. Jego przykładowe wywołania używają jednak user_id, a nie id, w ścieżkach, które następują. Wymiana kodu przy logowaniu również zwraca user_id, który przewodnik logowania nazywa identyfikatorem użytkownika aplikacji w zakresie Instagrama. Skoro przewodnik Get started łączy user_id z /me z powiadomieniami webhooka, to właśnie tę wartość należy zapisać jako IG_ID.
Gdzie pojawia się każdy ID?
Dokumentacja i przykłady webhooków Meta umieszczają je tak, jak poniżej. Osoba pojawia się jako IGSID, niezależnie od tego, czy komentuje, czy pisze DM, a konto jako IG_ID: jako odbiorca w wiadomościach DM, które konto otrzymuje, i jako nadawca w tych, które wysyła:
Jak wyszukać osobę na podstawie IGSID?
Za pomocą User Profile API: GET /<IGSID> na graph.instagram.com, z uprawnieniami instagram_business_basic i instagram_business_manage_messages. Wymagana jest zgoda, którą Meta przyznaje dopiero wtedy, gdy osoba napisze do konta lub kliknie ice breaker albo pozycję trwałego menu. Adresy URL profile_pic wygasają po kilku dniach, a osoby, które zablokowały konto, nie da się wyszukać.
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>Czy jeden rodzaj ID da się zamienić w inny?
Trasy udokumentowane przez Meta to wyszukiwania. Z IGSID User Profile API zwraca nazwę użytkownika osoby. Z nazwy użytkownika Business Discovery zwraca id innego konta firmowego lub twórcy, przy Facebook Login lub Unified Login. Z tokenu GET /me daje IG_ID. IGSID należy do jednego konta zawodowego, więc IGSID tej samej osoby widziany przez inne konto jest inny.
Których ID używa easyCoexistence?
Identyfikatorów Meta oraz jednego własnego. list_social_accounts zwraca account_id, czyli identyfikator easyCoexistence dla połączenia, którego używają pozostałe narzędzia, oraz external_id, czyli IG_ID; get_social_credentials zwraca IG_ID jako account_id_on_meta. Przekazane zdarzenia docierają jako platform, account_id, external_id i entry Meta bez zmian, a send_social_dm przyjmuje IGSID osoby jako recipient_id.
Typowe błędy
- Zapisywanie user_id z wymiany kodu jako ID konta. Odczytuj user_id z GET /me, które Meta wiąże z id w powiadomieniach webhooka.
- Ponowne użycie IGSID przy różnych kontach zawodowych. Jest przypisany do jednego konta, więc ta sama osoba ma inny IGSID gdzie indziej.
- Wyszukiwanie komentującego, który nigdy nie napisał. Meta ustawia zgodę dopiero wtedy, gdy osoba napisze do konta albo kliknie ice breaker lub pozycję menu.
- Zapisywanie adresów URL profile_pic. Meta podaje, że wygasają po kilku dniach, więc w razie potrzeby pobieraj je ponownie.
Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z bezpłatnym okresem próbnym przez pierwsze 3 dni.
Najczęściej zadawane pytania
Czy IGSID to to samo co identyfikator użytkownika Instagrama?
Nie. IGSID identyfikuje osobę wobec jednego konta zawodowego, a IG_ID identyfikuje samo konto zawodowe.
Dlaczego ID z mojego webhooka nie zgadza się z ID z logowania?
Wymiana kodu zwraca user_id, które Meta nazywa identyfikatorem w zakresie Instagrama, a powiadomienia webhooka zawierają user_id, które zwraca GET /me. Zapisz ten z /me.
Czy mogę uzyskać nazwę użytkownika Instagrama osoby na podstawie IGSID?
Tak, przez User Profile API, gdy osoba napisze do konta albo kliknie ice breaker lub pozycję trwałego menu.
Czy IGSID zmienia się między aplikacjami?
Nie. Meta podaje, że pozwala firmom powiązać interakcje tej samej osoby między aplikacjami, choć IGSID różni się między kontami zawodowymi.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w