IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

Vitambulisho vya watumiaji wa Instagram: IG_ID, IGSID na vitambulisho vya upeo wa programu

Instagram API inatumia aina tatu za vitambulisho vya watumiaji. IG_ID ni kitambulisho cha akaunti ya kitaalamu: GET /me inakirudisha kama user_id ukitumia Instagram Login, webhook inakibeba kama entry.id, na njia kama /<IG_ID>/media zinakitumia. IGSID, au Instagram-scoped ID, inawakilisha mtu anayetuma ujumbe au kutoa maoni kwenye akaunti hiyo. Kitambulisho cha programu ni thamani ya id inayorudishwa na /me.

easyCoexistence inampa kila akaunti ya Instagram iliyounganishwa account_id moja kwa ajili ya zana zake, pamoja na IG_ID, na inasambaza matukio ya Meta pamoja na IGSID zinazobebwa nayo, ili Claude, ChatGPT au msimbo wako mwenyewe uweze kujibu maoni na DM kupitia API rasmi ya Meta.

user_id

Sehemu ya /me inayoshikilia kitambulisho cha akaunti ya kitaalamu ya Instagram, ambacho ni id katika arifa za webhook za akaunti hiyo.

id

Kwenye /me ukitumia Instagram Login, ni kitambulisho cha programu cha mtumiaji wa programu husika.

Per account

IGSID ni maalum kwa mtu husika na akaunti ya Instagram anayoshirikiana nayo.

sender.id

Pale webhook ya DM iliyopokelewa inapobeba IGSID ya mtu; recipient.id inashikilia kitambulisho cha akaunti.

Consent

Inahitajika kwa User Profile API; Meta huweka idhini pale mtu anapotuma ujumbe kwenye akaunti au kugusa ice breaker au kipengee cha menyu ya kudumu.

IG_ID ni nini?

Kitambulisho cha akaunti ya kitaalamu ya Instagram, ambacho miito mingi ya API hufanywa juu yake. Ukitumia Instagram Login, GET /me?fields=user_id,username kinarudisha kama user_id, na mwongozo wa Meta unasema ni sawa na id katika arifa za webhook za akaunti, yaani entry.id. Ukitumia Facebook Login, Ukurasa hurudisha kwenye sehemu yake ya instagram_business_account. Njia kama /<IG_ID>/media, /<IG_ID>/conversations na /<IG_ID>/insights zinakitumia.

IGSID ni nini?

Kitambulisho cha Instagram chenye upeo (Instagram-scoped ID), kinachoundwa pale mtu anapotoa maoni kwenye chapisho, Reel au Story, au anapotuma ujumbe kwa akaunti. Meta inakiweka upeo kwa mtu na akaunti anayoshirikiana nayo, kwa hiyo mtu huyo huyo ana IGSID tofauti kwa kila akaunti ya kitaalamu, lakini inabaki ile ile katika programu zote: Meta inasema inaziwezesha biashara kuoanisha mwingiliano wa mtu mmoja katika programu nyingi. Ndicho kitambulisho cha kujibu, kutafuta mazungumzo na kumtafuta mtu.

Kitambulisho cha programu ni nini?

Sehemu ya id ya GET /me chini ya Instagram Login, ambayo mwongozo wa Meta unaieleza kama kitambulisho cha programu cha mtumiaji wa programu. Mifano yake ya miito hutumia user_id, si id, katika njia zinazofuata. Ubadilishanaji wa msimbo wakati wa kuingia pia hurudisha user_id, ambayo mwongozo wa kuingia unaiita kitambulisho cha Instagram cha mtumiaji wa programu. Kwa kuwa mwongozo wa kuanza unahusisha user_id ya /me na arifa za webhook, hiyo ndiyo thamani ya kuhifadhi kama IG_ID.

Kila kitambulisho kinaonekana wapi?

Marejeo ya Meta na mifano ya webhook yanavyoviweka ni kama ifuatavyo. Mtu huonekana kama IGSID, iwe anatoa maoni au kuandika DM, na akaunti kama IG_ID yake: ndiyo recipient kwenye DM inazopokea, na mtumaji kwenye DM inazotuma:

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

Unawezaje kumtafuta mtu kwa IGSID?

Kwa User Profile API: GET /<IGSID> kwenye graph.instagram.com, ukiwa na instagram_business_basic na instagram_business_manage_messages. Inahitaji idhini ya mtu, ambayo Meta inaiweka tu pale mtu anapotuma ujumbe kwenye akaunti au kugusa kipengee cha ice breaker au menyu ya kudumu. URL za profile_pic huisha muda baada ya siku chache, na mtu aliyezuia akaunti hawezi kutafutwa.

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>

Aina moja ya kitambulisho inaweza kugeuzwa kuwa nyingine?

Njia ambazo Meta inaeleza ni utafutaji. Kutoka IGSID, User Profile API inatoa jina la mtumiaji la mtu. Kutoka jina la mtumiaji, Business Discovery hurudisha id ya akaunti nyingine ya biashara au muumbaji, ukitumia Facebook Login au Unified Login. Kutoka token, GET /me inatoa IG_ID. IGSID ni ya akaunti moja ya kitaalamu, kwa hiyo IGSID ya mtu huyo huyo inayoonekana kwa akaunti nyingine ni tofauti nayo.

easyCoexistence inatumia vitambulisho gani?

Vya Meta, pamoja na kimoja chake. list_social_accounts hurudisha account_id, kitambulisho cha easyCoexistence cha muunganisho, ambacho zana nyingine huchukua, na external_id, ambacho ni IG_ID. get_social_credentials hurudisha IG_ID kama account_id_on_meta. Matukio yanayosambazwa hufika na platform, account_id, external_id na entry ya Meta bila mabadiliko, na send_social_dm inapokea IGSID ya mtu kama recipient_id.

Makosa ya kawaida

  • Kuhifadhi user_id kutoka kwenye ubadilishanaji wa msimbo kama kitambulisho cha akaunti. Soma user_id kutoka GET /me, ambayo Meta inaiunganisha na id katika arifa za webhook.
  • Kutumia tena IGSID katika akaunti za kitaalamu. Ina upeo wa akaunti moja, kwa hiyo mtu huyo huyo ana IGSID nyingine kwenye akaunti nyingine.
  • Kumtafuta mtu anayetoa maoni tu bila kuandika kamwe. Meta inaweka idhini pale tu mtu anapotuma ujumbe kwenye akaunti au kugusa ice breaker au kipengee cha menyu.
  • Kuhifadhi URL za profile_pic. Meta inasema huisha muda baada ya siku chache, kwa hiyo ziombe tena inapohitajika.
Kufanya hili ukitumia EasyCoexistence

Kuanzia US$ 9 hadi US$ 0.75 kwa muunganisho kwa mwezi, inashuka kadri unavyoongeza muunganisho, na kipindi cha majaribio bila malipo cha siku 3 za kwanza.

Maswali yanayoulizwa mara kwa mara

IGSID ni sawa na kitambulisho cha mtumiaji wa Instagram?

Hapana. IGSID inamtambulisha mtu kwa akaunti moja ya kitaalamu, wakati IG_ID inaitambulisha akaunti ya kitaalamu yenyewe.

Kwa nini kitambulisho cha webhook yangu hakilingani na kile cha kuingia?

Ubadilishanaji wa msimbo hurudisha user_id ambayo Meta inaiita ya upeo wa Instagram, wakati arifa za webhook zinabeba user_id ambayo GET /me hurudisha. Hifadhi ile kutoka /me.

Naweza kupata jina la mtumiaji la Instagram la mtu kutoka IGSID?

Ndiyo, kupitia User Profile API, mara tu mtu anapokuwa ametuma ujumbe kwenye akaunti au kugusa ice breaker au kipengee cha menyu ya kudumu.

Je, IGSID hubadilika kati ya programu?

Hapana. Meta inasema huruhusu biashara kuoanisha mwingiliano wa mtu mmoja katika programu nyingi, ingawa hutofautiana kutoka akaunti moja ya kitaalamu hadi nyingine.

Endelea kusoma

Unganisha chaneli yako ya kwanza ndani ya dakika mbili.

Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.

  • Siku 3 bila malipo
  • Ghairi wakati wowote
  • API rasmi pekee
  • Hufuatiliwa saa 24/7

Imethibitishwa kwenye