Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Instagram-käyttäjätunnukset: IG_ID, IGSID ja sovelluskohtaiset tunnukset

Instagramin API käyttää kolmenlaisia käyttäjätunnuksia. IG_ID on ammattitilin tunnus: GET /me palauttaa sen kentässä user_id Instagram Loginilla, webhookit kuljettavat sen kentässä entry.id ja polut, kuten /<IG_ID>/media, käyttävät sitä. IGSID eli Instagram-kohtainen tunnus tarkoittaa henkilöä, joka lähettää viestin tai kommentoi tiliä. Sovelluskohtainen tunnus on kenttä id, jonka /me palauttaa.

easyCoexistence antaa jokaiselle yhdistetylle Instagram-tilille yhden account_id:n työkaluilleen IG_ID:n rinnalla ja välittää Metan tapahtumat niiden mukana kulkevilla IGSID:illä.

user_id

Kenttä /me:ssä, joka sisältää Instagram-ammattitilin tunnuksen, eli sen tilin webhook-ilmoitusten id.

id

Instagram Loginilla /me-kutsussa sovelluksen käyttäjän sovelluskohtainen tunnus.

Per account

IGSID on sidottu henkilöön ja siihen Instagram-tiliin, jonka kanssa hän on vuorovaikutuksessa.

sender.id

Vastaanotetun DM:n webhookissa on henkilön IGSID; recipient.id sisältää tilin tunnuksen.

Consent

Tarvitaan User Profile API:ssa; Meta asettaa sen, kun henkilö lähettää viestin tilille tai napauttaa ice breakeria tai valikon kohtaa.

Mikä on IG_ID?

Instagram-ammattitilin tunnus, jolla useimmat kutsut tehdään. Instagram Loginilla GET /me?fields=user_id,username palauttaa sen kentässä user_id, ja Metan oppaan mukaan se vastaa tilin webhook-ilmoitusten id-kenttää, entry.id:tä. Facebook Loginilla Sivu palauttaa sen kentässään instagram_business_account. Polut, kuten /<IG_ID>/media, /<IG_ID>/conversations ja /<IG_ID>/insights, käyttävät sitä.

Mikä on IGSID?

Instagram-kohtainen tunnus, joka syntyy, kun joku kommentoi tilin julkaisua, Reeliä tai Storya tai lähettää tilille viestin. Meta rajaa sen henkilöön ja tiliin, jonka kanssa hän on vuorovaikutuksessa, joten sama henkilö saa eri IGSID:n jokaisella ammattitilillä. Sovellusten välillä se pysyy samana: Metan mukaan sen avulla yritys voi yhdistää yhden henkilön vuorovaikutukset useiden sovellusten välillä. Sillä vastataan, löydetään keskustelu ja haetaan henkilön tiedot.

Mikä on sovelluskohtainen tunnus?

GET /me:n kenttä id Instagram Loginilla. Metan oppaan mukaan se on sovelluksen käyttäjän sovelluskohtainen tunnus. Sen esimerkkikutsut käyttävät kuitenkin poluissa user_id:tä, ei id:tä. Kirjautumisen koodinvaihto palauttaa myös user_id:n, jonka kirjautumisopas kutsuu sovelluksen käyttäjän Instagram-kohtaiseksi käyttäjätunnukseksi. Koska aloitusoppaan mukaan /me:n user_id liittyy webhook-ilmoituksiin, se on arvo, joka kannattaa tallentaa IG_ID:ksi.

Mistä kukin tunnus löytyy?

Metan viitteet ja webhook-esimerkit sijoittavat ne alla olevalla tavalla. Henkilö näkyy IGSID:nä riippumatta siitä, kommentoiko hän vai kirjoittaako DM:n, ja tili näkyy omalla IG_ID:llään: vastaanotetuissa DM:ssä vastaanottajana, lähetetyissä DM:ssä lähettäjänä:

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

Miten henkilön tiedot haetaan IGSID:n perusteella?

User Profile API:lla: GET /<IGSID> osoitteessa graph.instagram.com, oikeuksilla instagram_business_basic ja instagram_business_manage_messages. Tarvitaan henkilön suostumus, jonka Meta asettaa vain silloin, kun henkilö lähettää viestin tilille tai napauttaa ice breaker -kohtaa tai pysyvän valikon kohtaa. profile_pic-URL-osoitteet vanhenevat muutamassa päivässä, eikä henkilöä, joka on estänyt tilin, voi hakea.

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>

Voiko yhtä tunnusta muuttaa toiseksi?

Metan dokumentoidut reitit ovat hakuja. IGSID:stä User Profile API antaa henkilön käyttäjätunnuksen. Käyttäjätunnuksesta Business Discovery palauttaa toisen yrityksen tai tekijän tilin id:n Facebook Loginilla tai Unified Loginilla. Tunnuksesta GET /me antaa IG_ID:n. IGSID kuuluu yhdelle ammattitilille, joten saman henkilön IGSID, jonka näkee toinen tili, on eri kuin tämä.

Mitä tunnuksia easyCoexistence käyttää?

Metan tunnuksia sekä yhtä omaa. list_social_accounts palauttaa account_id:n, easyCoexistencen tunnuksen yhteydelle, jota muut työkalut käyttävät, ja external_id:n, eli IG_ID:n. get_social_credentials palauttaa IG_ID:n kentässä account_id_on_meta. Välitetyt tapahtumat saapuvat muuttumattomina, ja niissä on kentät platform, account_id, external_id sekä Metan entry. send_social_dm ottaa henkilön IGSID:n kentässä recipient_id.

Yleiset virheet

  • Kirjautumisen koodinvaihdon user_id:n tallentaminen tilin tunnukseksi. Lue user_id GET /me:stä, jonka Meta liittää webhook-ilmoitusten id-kenttään.
  • IGSID:n käyttäminen useilla ammattitileillä. Se on sidottu yhteen tiliin, joten sama henkilö saa toisaalla eri IGSID:n.
  • Kommentoijan tietojen hakeminen, joka ei ole koskaan kirjoittanut. Meta asettaa suostumuksen vain, kun henkilö lähettää viestin tilille tai napauttaa ice breaker -kohtaa tai valikon kohtaa.
  • profile_pic-URL-osoitteiden tallentaminen. Meta sanoo niiden vanhenevan muutamassa päivässä, joten pyydä ne uudelleen tarvittaessa.
Näin teet tämän EasyCoexistencen avulla

Näin Claude, ChatGPT tai oma koodisi voi vastata kommentteihin ja DM:iin Metan virallisen API:n kautta. US$ 9:stä US$ 0,75:een per yhteys kuukaudessa, hinta laskee lisättäessä yhteyksiä, ja ensimmäiset 3 päivää ovat ilmainen kokeilu.

Usein kysytyt kysymykset

Onko IGSID sama kuin Instagram-käyttäjätunnus?

Ei. IGSID tunnistaa henkilön yhdelle ammattitilille, kun taas IG_ID tunnistaa itse ammattitilin.

Miksi webhook-tunnukseni ei vastaa kirjautumisen tunnusta?

Koodinvaihto palauttaa user_id:n, jonka Meta kutsuu Instagram-kohtaiseksi, kun taas webhook-ilmoitukset kuljettavat GET /me:n palauttaman user_id:n. Tallenna /me:stä saatu.

Voiko IGSID:stä saada henkilön Instagram-käyttäjätunnuksen?

Kyllä, User Profile API:n kautta, kun henkilö on lähettänyt viestin tilille tai napauttanut ice breaker -kohtaa tai pysyvän valikon kohtaa.

Muuttuuko IGSID sovellusten välillä?

Ei. Metan mukaan sen avulla yritykset voivat yhdistää saman henkilön vuorovaikutukset useiden sovellusten välillä, vaikka se eroaa ammattitilien välillä.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu