מזהי משתמשים ב-Instagram: IG_ID, IGSID ומזהי היקף יישום
ה-API של Instagram משתמש בשלושה סוגים של מזהי משתמש. IG_ID הוא המזהה של חשבון מקצועי: GET /me מחזיר אותו בשדה user_id עם Instagram Login, וובהוקים (Webhook) נושאים אותו בשדה entry.id, ונתיבים כמו /<IG_ID>/media מקבלים אותו. IGSID, או מזהה בהיקף Instagram, מייצג אדם שכותב הודעה או מגיב בחשבון הזה. מזהה בהיקף היישום הוא השדה id שמחזיר /me.
easyCoexistence נותן לכל חשבון Instagram מחובר מזהה אחד, account_id, לכלים שלו, לצד IG_ID, ומעביר את האירועים של Meta עם מזהי IGSID שהם נושאים, כדי ש-Claude, ChatGPT או הקוד שלכם יוכלו להשיב לתגובות ולהודעות ישירות דרך ה-API הרשמי של Meta.
השדה /me שמחזיק את מזהה חשבון Instagram המקצועי, שהוא הערך של השדה id בהודעות הוובהוק של אותו חשבון.
בנקודת הקצה /me עם Instagram Login, מזהה בהיקף היישום של משתמש האפליקציה.
IGSID נקשר לאדם ולחשבון Instagram שאיתו הוא מתקשר.
במקרה שבו וובהוק של הודעה ישירה (DM) שהתקבלה נושא את ה-IGSID של האדם; recipient.id מחזיק את מזהה החשבון.
הסכמה נחוצה ל-User Profile API; Meta מגדירה אותה כשהאדם שולח הודעה לחשבון או לוחץ על ice breaker או על פריט בתפריט.
מה זה IG_ID?
המזהה של חשבון Instagram מקצועי, האובייקט שעליו רוב הקריאות נעשות. עם Instagram Login, GET /me?fields=user_id,username מחזיר אותו בשדה user_id, ולפי המדריך של Meta הוא שווה לשדה id בהודעות הוובהוק של החשבון, entry.id. עם Facebook Login, דף מחזיר אותו בשדה instagram_business_account שלו. נתיבים כמו /<IG_ID>/media, /<IG_ID>/conversations ו-/<IG_ID>/insights מקבלים אותו.
מה זה IGSID?
מזהה בהיקף Instagram, שנוצר כשאדם מגיב לפוסט, לריל או לסטורי של החשבון, או שולח לו הודעה. Meta מגדירה אותו לפי האדם והחשבון שאיתו הוא מתקשר, ולכן לאותו אדם יש IGSID שונה בכל חשבון מקצועי, אך הוא נשאר זהה בין אפליקציות: Meta אומרת שהוא מאפשר לעסק למפות את האינטראקציות של אדם אחד בין כמה אפליקציות. זהו המזהה שאליו משיבים, שלפיו מוצאים שיחה ושלפיו מחפשים אדם.
מה זה מזהה בהיקף היישום?
השדה id של GET /me תחת Instagram Login, שמדריך Meta מתאר כמזהה בהיקף היישום של משתמש האפליקציה. בנתיבים שבאים אחר כך, קריאות הלדוגמה מופיעות עם user_id ולא עם id. קוד ההחלפה בהתחברות מחזיר גם user_id, שהמדריך להתחברות מכנה מזהה המשתמש בהיקף Instagram של משתמש האפליקציה. מאחר שמדריך ההתחלה מקשר את user_id של /me להודעות הוובהוק, יש לשמור את הערך הזה כערך של IG_ID.
איפה כל מזהה מופיע?
ההפניות והדוגמאות לוובהוק של Meta ממקמות אותם כך. אדם מופיע כ-IGSID בין אם הוא מגיב ובין אם הוא שולח הודעה ישירה, והחשבון מופיע כ-IG_ID: הנמען בהודעות ישירות שהוא מקבל, והשולח בהודעות ישירות שהוא שולח:
איך מחפשים אדם לפי IGSID?
עם User Profile API: GET /<IGSID> בכתובת graph.instagram.com, עם instagram_business_basic ו-instagram_business_manage_messages. נדרשת הסכמת האדם, ו-Meta מגדירה אותה רק כשהאדם שולח הודעה לחשבון או לוחץ על ice breaker או על פריט בתפריט קבוע. כתובות profile_pic פוקעות בתוך כמה ימים, ואדם שחסם את החשבון לא ניתן לאיתור.
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>אפשר להפוך סוג מזהה אחד לאחר?
הדרכים ש-Meta מתעדת הן חיפושים. מ-IGSID, User Profile API נותן את שם המשתמש של האדם. משם משתמש, Business Discovery מחזיר את השדה id של חשבון עסקי או יוצר אחר, עם Facebook Login או Unified Login. מאסימון, GET /me נותן את IG_ID.
האם IGSID של אותו אדם זהה בין חשבונות מקצועיים?
IGSID שייך לחשבון מקצועי אחד, ולכן ה-IGSID של אותו אדם כפי שנראה על ידי חשבון אחר שונה ממנו.
טעויות נפוצות
- שמירת השדה user_id מקוד ההחלפה כמזהה החשבון. יש לקרוא את user_id מ-GET /me, ש-Meta קושרת לשדה id בהודעות הוובהוק.
- שימוש חוזר ב-IGSID בין חשבונות מקצועיים. הוא מוגבל לחשבון אחד, ולכן לאותו אדם יש IGSID אחר במקום אחר.
- חיפוש של מגיב שמעולם לא כתב הודעה. Meta מגדירה הסכמה רק כשהאדם שולח הודעה לחשבון או לוחץ על ice breaker או על פריט בתפריט.
- שמירת כתובות profile_pic. Meta אומרת שהן פוקעות בתוך כמה ימים, לכן יש לבקש אותן מחדש כשצריך.
בין US$ 9 ל-US$ 0.75 לחיבור בחודש, שיורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
האם IGSID זהה למזהה המשתמש ב-Instagram?
לא. IGSID מזהה אדם מול חשבון מקצועי אחד, ואילו IG_ID מזהה את החשבון המקצועי עצמו.
למה מזהה הוובהוק שלי לא תואם למזהה מההתחברות?
קוד ההחלפה מחזיר user_id ש-Meta מכנה בהיקף Instagram, ואילו הודעות הוובהוק נושאות את user_id שמחזיר GET /me. יש לשמור את הערך שמחזיר /me.
האם אפשר לקבל את שם המשתמש ב-Instagram של אדם מתוך IGSID?
כן, דרך User Profile API, אחרי שהאדם שלח הודעה לחשבון או לחץ על ice breaker או על פריט בתפריט הקבוע.
האם ה-IGSID משתנה בין אפליקציות?
לא. Meta אומרת שהוא מאפשר לעסקים למפות את האינטראקציות של אותו אדם בין כמה אפליקציות, אף שהוא שונה מחשבון מקצועי אחד למשנהו.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-