تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

معرّفات مستخدمي 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 أو الكود الخاص بك من الرد على التعليقات والرسائل المباشرة عبر واجهة Meta البرمجية الرسمية.

user_id

حقل /me الذي يحمل معرّف الحساب المهني في Instagram، وهو id في إشعارات webhook الخاصة بذلك الحساب.

id

عند استخدام Instagram Login، يُعاد عبر /me معرّف مستخدم التطبيق المحدد بنطاق التطبيق.

Per account

IGSID خاص بالشخص وبحساب Instagram الذي يتفاعل معه.

sender.id

حيث تحمل webhook الرسالة المباشرة الواردة IGSID الخاص بالشخص، ويحمل الحقل recipient.id معرّف الحساب.

Consent

مطلوب لواجهة User Profile API، وتضبطه Meta حين يراسل الشخص الحساب أو ينقر على Ice breaker أو على عنصر في القائمة.

ما هو IG_ID بالتحديد؟

معرّف الحساب المهني في Instagram، وهو الكائن الذي تُجرى عليه معظم الاستدعاءات. مع Instagram Login، يعيده GET /me?fields=user_id,username بوصفه user_id، ويذكر دليل Meta أنه يساوي id في إشعارات webhook الخاصة بالحساب، أي entry.id. ومع Facebook Login، تعيده صفحة Facebook في الحقل instagram_business_account الخاص بها. وتقبل المسارات مثل /<IG_ID>/media و/<IG_ID>/conversations و/<IG_ID>/insights هذا المعرّف.

ما هو IGSID بالتحديد؟

معرّف Instagram المحدد النطاق، ويُنشأ عندما يعلّق شخص على منشور الحساب أو على Reel أو Story، أو يرسل إليه رسالة. تحدّده Meta بالشخص والحساب الذي يتفاعل معه، فيكون للشخص نفسه IGSID مختلف مع كل حساب مهني، لكنه يبقى ثابتاً عبر التطبيقات، إذ تقول Meta إنه يتيح للنشاط التجاري ربط تفاعلات الشخص الواحد عبر عدة تطبيقات. وهو المعرّف الذي يُرد عليه، ويُعثر به على المحادثة، ويُبحث به عن الشخص.

ما هو معرّف التطبيق المحدد النطاق؟

حقل id في GET /me عند استخدام Instagram Login، ويصفه دليل Meta بأنه معرّف مستخدم التطبيق المحدد بنطاق التطبيق. أما أمثلته فتستخدم user_id بدلاً من id في المسارات التي تلي ذلك. ويعيد استدعاء تبادل الرمز عند تسجيل الدخول أيضاً user_id، ويسميه دليل تسجيل الدخول معرّف مستخدم التطبيق المحدد بنطاق Instagram. ولأن دليل البدء يربط user_id في /me بإشعارات webhook، فهو القيمة التي تُخزَّن بوصفها IG_ID الخاص بالحساب.

أين يظهر كل معرّف؟

تضع مراجع Meta وأمثلة webhook كل معرّف في الموضع التالي. يظهر الشخص بوصفه IGSID سواء علّق أو أرسل الرسائل المباشرة (DM)، ويظهر الحساب بوصفه IG_ID: المستلم في الرسائل المباشرة التي يتلقاها، والمرسل في الرسائل التي يرسلها:

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

كيف تبحث عن شخص انطلاقاً من IGSID الخاص به؟

عبر User Profile API: استدعاء GET /<IGSID> على graph.instagram.com مع الصلاحيتين instagram_business_basic وinstagram_business_manage_messages. ويحتاج ذلك إلى موافقة الشخص، وهي موافقة لا تضبطها Meta إلا عندما يراسل الشخص الحساب أو ينقر على Ice breaker أو على عنصر في القائمة الثابتة (persistent menu). وتنتهي صلاحية روابط profile_pic خلال أيام قليلة، ولا يمكن البحث عن شخص حظر الحساب.

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>

هل يمكن تحويل نوع معرّف إلى آخر؟

المسارات التي توثّقها Meta كلها عمليات بحث. فمن IGSID تعطي User Profile API اسم المستخدم الخاص بالشخص. ومن اسم المستخدم، تعيد Business Discovery معرّف حساب نشاط تجاري أو منشئ محتوى آخر، مع Facebook Login أو Unified Login. ومن رمز الوصول (token)، يعطي GET /me معرّف IG_ID. ويتبع IGSID حساباً مهنياً واحداً، لذلك يختلف IGSID الذي يراه حساب آخر لنفس الشخص عن هذا المعرّف.

أي المعرّفات التي تستخدمها easyCoexistence في المنصة؟

معرّفات Meta، إضافةً إلى معرّف خاص بالمنصة. يعيد list_social_accounts الحقل account_id، وهو معرّف easyCoexistence للاتصال الذي تأخذه الأدوات الأخرى، والحقل external_id، وهو IG_ID. ويعيد get_social_credentials معرّف IG_ID بوصفه account_id_on_meta. وتصل الأحداث المُعاد توجيهها بالحقول platform وaccount_id وexternal_id وentry كما أرسلتها Meta دون تغيير، ويأخذ الحقل recipient_id في send_social_dm معرّف IGSID الخاص بالشخص.

الأخطاء الشائعة

  • تخزين user_id الناتج عن تبادل الرمز بوصفه معرّف الحساب. اقرأ user_id من GET /me، لأن Meta تربطه بالحقل id في إشعارات webhook.
  • إعادة استخدام IGSID عبر حسابات مهنية مختلفة. فهو محدد بحساب واحد، لذلك يكون للشخص نفسه IGSID آخر لدى حساب آخر.
  • البحث عن شخص علّق ولم يراسل الحساب قط. لا تضبط Meta الموافقة إلا حين يراسل الشخص الحساب أو ينقر على Ice breaker أو عنصراً من القائمة.
  • حفظ روابط profile_pic. تقول Meta إنها تنتهي خلال أيام قليلة، فاطلبها من جديد عند الحاجة.
إنجاز ذلك باستخدام EasyCoexistence

من US$ 9 إلى US$ 0.75 للاتصال الواحد شهرياً، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.

الأسئلة الشائعة

هل يُعدّ IGSID هو معرّف مستخدم Instagram نفسه؟

لا. يحدّد IGSID شخصاً بالنسبة إلى حساب مهني واحد، بينما يحدد IG_ID الحساب المهني نفسه.

لماذا لا يطابق معرّف webhook الخاص بي المعرّف القادم من تسجيل الدخول؟

يعيد تبادل الرمز user_id تسميه Meta محدداً بنطاق Instagram، بينما تحمل إشعارات webhook الـ user_id الذي يعيده GET /me. فاحفظ المعرّف القادم من /me.

هل يمكنني معرفة اسم المستخدم على Instagram انطلاقاً من IGSID الخاص بالشخص؟

نعم، عبر User Profile API، بعد أن يراسل الشخص الحساب أو ينقر على Ice breaker أو عنصراً في القائمة الثابتة.

هل يتغير IGSID بين التطبيقات؟

لا. تقول Meta إنه يتيح للأنشطة التجارية ربط تفاعلات الشخص نفسه عبر عدة تطبيقات، لكنه يختلف من حساب مهني إلى آخر.

تابع القراءة

قراءة سجل الرسائل المباشرة في Instagram: واجهة Conversations APIكيف تقرأ Conversations API سجل الرسائل المباشرة في Instagram: قائمة المحادثات، ومحادثة شخص واحد، وحد الرسائل العشرين، والأذونات.خطاف الويب (webhook) للرسائل على Instagram: حمولة الرسالة المباشرة (DM) والأصداء والحقولما يرسله webhook الرسائل على Instagram لكل رسالة مباشرة: معرّف المرسل المحدود والنص والمرفقات والردود على القصص والأصداء، حقلاً حقلاً، مع نافذة 24 ساعة.عدد متابعي Instagram وحقول الملف الشخصي عبر APIكيف تعيد API الخاصة بـ Instagram عدد المتابعين وحقول الملف الشخصي، وأي حقول يعرضها كل تسجيل دخول.Instagram Business Discovery: قراءة منشورات حساب آخر وعدد متابعيهكيف يقرأ Business Discovery في Instagram عدد متابعي حساب تجاري أو منشئ آخر وملفه ومنشوراته باسم المستخدم، وتسجيل الدخول الذي يحتاجه.خطأ تسجيل الدخول إلى Instagram "Invalid platform app": ما الذي يجب التحقق منهسبب ظهور Invalid platform app في تسجيل دخول Instagram وطريقة إصلاحه: معرّف تطبيق Instagram في client_id، وعنوان redirect URI مطابق، وإعداد التطبيق.ما هي Instagram Graph API؟ واجهة Instagram API في 2026Instagram Graph API في 2026: واجهة Meta لـ Instagram بالتسجيل عبر Instagram أو Facebook أو Unified Login، وما تغطيه والحسابات التي تخدمها.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في