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

لماذا يتوقف اتصال واجهة برمجة التطبيقات (API) بـ Instagram، وكيف تُبقيه فعّالًا

يتوقف اتصال API بـ Instagram عن العمل حين ترفض Meta رمز الوصول (token) أو حين يفقد الحساب أهليته: رمز طويل الأمد لم يُجدَّد خلال 60 يومًا، أو تغيير كلمة المرور، أو إزالة المالك للإذن أو للتطبيق كاملًا، أو تحويل الحساب إلى حساب شخصي، أو تقييد الحساب. يعيد كل سبب خطأً خاصًا به، ويُصلح معظمها أن يُعيد المالك تسجيل الدخول.

يراقب easyCoexistence كل اتصال Instagram على مدار الساعة: يجدّد الرمز قبل انقضاء الـ 60 يومًا بوقت كافٍ، ويفحص الحساب كل 6 ساعات، ويرسل إليك بريدًا واحدًا حين ترفض Meta الوصول، ويرسل حدث channel.disconnected إلى المنصات، فيعود الاتصال المنقطع بتسجيل دخول واحد.

60 days

رموز Instagram التي لا تُجدَّد خلال 60 يومًا تنتهي صلاحيتها ولا يمكن تجديدها بعد ذلك.

460

الرمز الفرعي (subcode) ضمن الرمز 190 في Graph API يشير إلى جلسة أنهاها تغيير كلمة المرور، فيُعيد الشخص تسجيل الدخول.

1 hour

من عمليات تسليم خطاف الويب (webhook) الفاشلة للرسائل قبل أن تعطّلها Meta وتُلغي اشتراك التطبيق من الحساب.

28 days

قد تُنهي Meta وصول التطبيق إلى الأذونات أو الميزات التي لم يستخدمها خلال فترة 28 يومًا.

6 hours

وتيرة فحص easyCoexistence لكل حساب Instagram متصل، مع تجديد رمزه قبل انقضاء الـ 60 يومًا بوقت كافٍ.

لماذا يتوقف اتصال API بـ Instagram؟

لأن Meta تتوقف عن قبول الرمز، أو لأن الحساب يتوقف عن استيفاء شروط الواجهة. توثيق Meta يسمّي الأسباب، ولكل سبب ما تُعيده الواجهة والخطوة التي تستعيد الوصول. أغلبها يظهر أولًا كاستدعاء فاشل، ولهذا تبحث الفحوص أدناه عنها وفق جدول زمني:

What the API returnsWhat restores it
Token not refreshed for 60 daysCode 190; a refresh is no longer possibleThe owner signs in again
Password changedCode 190 with subcode 460The owner signs in again
Permission missing or removedCode 10, or a code from 200 to 299A new sign-in that grants it
App removed in Instagram's settingsA call to the app's deauthorize callbackA new sign-in, if the owner wants it back
Switched to a personal account(#10) Access is denied because the instagram account type is not business or creator.Back to Business or Creator, then a new sign-in
Allow access to messages offCode 200 with subcode 2534041, on DMsThe owner turns the setting back on
Account restricted, inactive or checkpointedCode 25 with subcode 2207050The owner acts in the Instagram app
Webhook endpoint failing for an hourA Webhooks Disabled alert, the account unsubscribedA working endpoint, then a new subscription

متى تنتهي صلاحية الرمز، ومتى يمكن تجديده؟

مع Instagram Login يبقى الرمز طويل الأمد صالحًا 60 يومًا من آخر تجديد. يمنحه التجديد عبر grant_type=ig_refresh_token 60 يومًا أخرى، بشرط أن يكون عمره 24 ساعة على الأقل، وألّا يكون قد انتهى، وأن يكون المالك قد منح instagram_business_basic. وبعد مرور الستين يومًا تفشل الاستدعاءات بالرمز 190، ولا يُجدي إلا تسجيل دخول جديد. أما مع Unified Login فالإعداد هو ما يحدد إن كان الرمز ينتهي أصلًا.

ماذا يحدث عند تغيير كلمة المرور أو إزالة إذن؟

قد يُنهي تغيير كلمة المرور الجلسة التي ينتمي إليها الرمز: يُبلغ دليل أخطاء Graph API عن ذلك بالرمز 190 مع الرمز الفرعي 460، ويقول إن على الشخص تسجيل الدخول إلى التطبيق من جديد. أما الإذن الذي لم يُمنح قط أو الذي أُزيل فيُعيد الرمز 10، أو رمزًا من 200 إلى 299. وفي الرسائل المباشرة، يعني الرمز 200 مع الرمز الفرعي 2534041 أن المالك أوقف الوصول إلى الرسائل. وتسمح شروط منصة Meta أيضًا بإنهاء وصول التطبيق إلى إذن أو ميزة لم تُستخدم 28 يومًا.

ماذا يحدث عندما يُزيل المالك التطبيق؟

ينتهي وصوله إلى البيانات غير العامة. يُزيل المالك التطبيق من Instagram عبر Website permissions، ثم Apps and websites، ثم Active، وتستدعي Meta عنوان URL لرد النداء deauthorize المحفوظ في إعدادات تسجيل الدخول التجاري للتطبيق. ويقول مركز مساعدة Instagram إن التطبيق المُزال لا يستطيع بعد ذلك الوصول إلا إلى المعلومات العامة للحساب، فيكون الاتصال قد انتهى حتى يُعيد المالك تسجيل الدخول.

ماذا يحدث عندما يتغير نوع الحساب أو يُقيَّد؟

يُخرج أيٌّ منهما الحساب من نطاق ما تخدمه الواجهة. فواجهة Meta تعمل مع الحسابات الاحترافية فقط، وجدول استكشاف الأخطاء في Unified Login يعرض الرسالة (#10) Access is denied because the instagram account type is not business or creator لحساب تحوّل إلى شخصي؛ فيعيده المالك إلى تجاري أو منشئ، ثم يعيد الربط. أما الحساب المقيَّد أو غير النشط أو الخاضع للتحقق فيُعيد الرمز 25 مع الرمز الفرعي 2207050، ويحلّه المالك في تطبيق Instagram.

كيف تتوقف webhooks عن الوصول؟

عبر نقطة نهاية (endpoint) تفشل. تُعيد Meta محاولة إشعار Instagram حتى 36 ساعة، لكن تسليم الرسائل أشد صرامة: بعد 15 دقيقة من الفشل يُرسل تنبيه إلى حساب المطوّر، وبعد ساعة ترسل Meta تنبيه Webhooks Disabled وتُلغي اشتراك التطبيق من الحساب. وحين تعمل نقطة النهاية من جديد، يُعيد استدعاء POST /<IG_ID>/subscribed_apps بالحقول نفسها تفعيل الإشعارات.

كيف تلاحظ الانقطاع قبل أن يلاحظه المستخدمون؟

بفحص الاتصال وفق جدول زمني، بدلًا من انتظار فشل منشور:

  • خزّن قيمة expires_in من كل تبادل للرمز ومن كل تجديد له، وجدّده قبل اليوم الستين بوقت كافٍ، بعد أن يبلغ عمر الرمز يومًا على الأقل.
  • نفّذ استدعاءً موثّقًا رخيصًا وفق جدول زمني، مثل GET /me?fields=user_id,username، واعتبر الرمز 190 أو 102 علامة على الحاجة إلى إعادة الربط.
  • فعّل رد النداء deauthorize، ليصلك فورًا أي إزالة يجريها المالك من إعدادات Instagram.
  • اقرأ Developer Alerts والبريد التجاري المرتبط بالتطبيق، حيث ترسل Meta إشعارات webhook والمراجعة.
  • سجّل الرمز والرمز الفرعي وfbtrace_id لكل خطأ على حدة لكل حساب، فيتميز التقييد عن طلب معيب.

كيف تعيد ربط كل حالة؟

تنتهي معظم الأسباب بالخطوة نفسها: تسجيل دخول جديد يُجريه مالك الحساب، فيُصدر رمزًا جديدًا. والاستثناءات هي الإعدادات التي يغيّرها المالك في تطبيق Instagram:

  • رمز منتهٍ، أو تغيير كلمة المرور، أو إزالة التطبيق أو الإذن: يُرسل المالك إلى تسجيل الدخول مجددًا ويوافق على الأذونات.
  • حساب شخصي: حوّله إلى تجاري أو منشئ من تطبيق Instagram، ثم سجّل الدخول مجددًا.
  • الرسائل معطّلة: فعّل Allow access to messages ضمن Connected tools؛ لا حاجة إلى تسجيل دخول جديد.
  • حساب مقيَّد: أكمل ما يطلبه تطبيق Instagram؛ فتسجيل الدخول الجديد لا يغيّر شيئًا.
  • webhooks معطّلة: أصلح نقطة النهاية، ثم أعد اشتراك الحساب.

ماذا يفعل easyCoexistence للحفاظ على الاتصال؟

يراقب easyCoexistence كل حساب Instagram متصل على مدار الساعة. يجدّد الرمز حين يبقى أقل من 20 يومًا من أصل 60، ويفحص الحساب كل 6 ساعات عبر GET /me، ويضع الاتصال في حالة تستدعي إعادة الربط لحظة رفض Meta للرمز، سواء في ذلك الفحص أو في استدعاء أداة. ويرد على تسليمات webhook من Meta فورًا ويُمرّرها بعد ذلك، وحين يُزيل المالك التطبيق من إعدادات Instagram ينهي رد النداء deauthorize الصادر من Meta الاتصال ويُخرجه من الفاتورة.

كيف يُخبرك easyCoexistence، وكيف تعيد الربط؟

مرة واحدة، عبر البريد الإلكتروني، مع ذكر اسم الحساب وزر يوصلك إلى صفحة القناة، ويُرسل إلى المنصات حدث channel.disconnected موقّعًا. وحتى يتصرف المالك، تعرض list_social_accounts الحالة وآخر خطأ من Meta، وترد الأدوات بأن الحساب يحتاج إلى إعادة الربط. وإعادة الربط تكون بتسجيل دخول واحد بالحساب نفسه في Instagram، فيُحيي الاتصال نفسه مع إعداداته.

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

  • تجديد الرمز فقط بعد فشل استدعاء. فبمجرد انتهاء صلاحيته ترفض Meta التجديد، لذا جدوِل التجديدات وهو لا يزال صالحًا.
  • إعادة حساب مقيَّد إلى تسجيل الدخول. الرمز 25 مع الرمز الفرعي 2207050 يصف حالة الحساب، ويحلّها المالك في تطبيق Instagram.
  • ترك رد النداء deauthorize غير مُعدّ. فإزالة التطبيق من إعدادات Instagram لا تظهر حينها إلا عند فشل الاستدعاء التالي.
  • إصلاح endpoint الفاشل ثم الانتظار. بعد تنبيه Webhooks Disabled تبقى الإشعارات متوقفة حتى يُعاد اشتراك الحساب عبر POST /<IG_ID>/subscribed_apps.
إنجاز ذلك باستخدام EasyCoexistence

من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض كلما أضفت اتصالات، مع أول 3 أيام مجانًا.

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

هل استخدام رمز Instagram يمنعه من الانتهاء؟

لا. لا يمدّد الرمز طويل الأمد إلا التجديد، والرمز الذي يمرّ عليه 60 يومًا دون تجديد ينتهي مهما كثر استخدامه.

هل يزيل Instagram تطبيقًا تجاريًا بعد 90 يومًا من عدم الاستخدام؟

لا. يقول مركز مساعدة Instagram إن التطبيقات التي تملك أذونات إدارة الحسابات التجارية والمنشئين لا تنتهي صلاحيتها بعد 90 يومًا من عدم النشاط.

هل يُحتسب الحساب المنقطع في فاتورة easyCoexistence؟

نعم، إلى أن تعيد ربطه أو تزيله. والحساب الذي أزال مالكه التطبيق من إعدادات Instagram يخرج من العدد فور أن تُبلغ Meta عن الإزالة.

كم تكلّف مراقبة حساب Instagram مع easyCoexistence؟

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

تابع القراءة

رموز وصول Instagram: رموز طويلة الأجل لمدة 60 يومًا وتجديدهاكيف تعمل رموز وصول Instagram Login: رمز قصير الأجل صالح ساعة بعد تسجيل الدخول، ورمز طويل الأجل صالح 60 يومًا، وتجديده بعد 24 ساعة.Instagram API في Python وNode.js: أمثلة عمليةأمثلة Python وNode.js تعمل للـ Instagram API: نشر صورة وReel، والرد على التعليقات، وقراءة الإحصاءات، والتحقق من خطاف الويب (webhook) ومعالجة الأخطاء.أتمتة Instagram: ما الذي يقيّد الحسابات، وواجهة برمجة التطبيقات (API) الرسمية مقابل الروبوتاتما تنص عليه شروط Instagram وMeta بشأن الأتمتة، ولماذا ترصد الروبوتات القائمة على كلمة المرور، وكيف ترد تلقائيا على الرسائل والتعليقات ضمن قواعد Meta.كيفية ربط حساب Instagram بواجهة API أو وكيل ذكاء اصطناعيكيفية ربط حساب Instagram بواجهة API أو وكيل ذكاء اصطناعي: تسجيل الدخول عبر Instagram، وصلاحيات كل ميزة، والسماح بالوصول إلى الرسائل وروابط الربط.أذونات واجهة برمجة التطبيقات (API) في Instagram: النطاقات وراء كل ميزةالأذونات التي تستخدمها Instagram API مع تسجيل الدخول عبر Instagram، من instagram_business_basic إلى manage_insights، وأي ميزة تحتاج أيّاً منها.دليل واجهة برمجة التطبيقات (API) لـ Instagram لعام 2026: من تطبيقك إلى أول منشورمسار Instagram API في 2026 خطوة بخطوة: نوع الحساب وتسجيل الدخول وتطبيق Meta والأذونات والرموز وأول منشور والتعليقات والرسائل والخطافات والحدود.

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

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

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

تم التحقق في