لماذا يتوقف اتصال واجهة برمجة التطبيقات (API) بـ Instagram، وكيف تُبقيه فعّالًا
يتوقف اتصال API بـ Instagram عن العمل حين ترفض Meta رمز الوصول (token) أو حين يفقد الحساب أهليته: رمز طويل الأمد لم يُجدَّد خلال 60 يومًا، أو تغيير كلمة المرور، أو إزالة المالك للإذن أو للتطبيق كاملًا، أو تحويل الحساب إلى حساب شخصي، أو تقييد الحساب. يعيد كل سبب خطأً خاصًا به، ويُصلح معظمها أن يُعيد المالك تسجيل الدخول.
يراقب easyCoexistence كل اتصال Instagram على مدار الساعة: يجدّد الرمز قبل انقضاء الـ 60 يومًا بوقت كافٍ، ويفحص الحساب كل 6 ساعات، ويرسل إليك بريدًا واحدًا حين ترفض Meta الوصول، ويرسل حدث channel.disconnected إلى المنصات، فيعود الاتصال المنقطع بتسجيل دخول واحد.
رموز Instagram التي لا تُجدَّد خلال 60 يومًا تنتهي صلاحيتها ولا يمكن تجديدها بعد ذلك.
الرمز الفرعي (subcode) ضمن الرمز 190 في Graph API يشير إلى جلسة أنهاها تغيير كلمة المرور، فيُعيد الشخص تسجيل الدخول.
من عمليات تسليم خطاف الويب (webhook) الفاشلة للرسائل قبل أن تعطّلها Meta وتُلغي اشتراك التطبيق من الحساب.
قد تُنهي Meta وصول التطبيق إلى الأذونات أو الميزات التي لم يستخدمها خلال فترة 28 يومًا.
وتيرة فحص easyCoexistence لكل حساب Instagram متصل، مع تجديد رمزه قبل انقضاء الـ 60 يومًا بوقت كافٍ.
لماذا يتوقف اتصال API بـ Instagram؟
لأن Meta تتوقف عن قبول الرمز، أو لأن الحساب يتوقف عن استيفاء شروط الواجهة. توثيق Meta يسمّي الأسباب، ولكل سبب ما تُعيده الواجهة والخطوة التي تستعيد الوصول. أغلبها يظهر أولًا كاستدعاء فاشل، ولهذا تبحث الفحوص أدناه عنها وفق جدول زمني:
| What the API returns | What restores it | |
|---|---|---|
| Token not refreshed for 60 days | Code 190; a refresh is no longer possible | The owner signs in again |
| Password changed | Code 190 with subcode 460 | The owner signs in again |
| Permission missing or removed | Code 10, or a code from 200 to 299 | A new sign-in that grants it |
| App removed in Instagram's settings | A call to the app's deauthorize callback | A 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 off | Code 200 with subcode 2534041, on DMs | The owner turns the setting back on |
| Account restricted, inactive or checkpointed | Code 25 with subcode 2207050 | The owner acts in the Instagram app |
| Webhook endpoint failing for an hour | A Webhooks Disabled alert, the account unsubscribed | A 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.
من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض كلما أضفت اتصالات، مع أول 3 أيام مجانًا.
الأسئلة الشائعة
هل استخدام رمز Instagram يمنعه من الانتهاء؟
لا. لا يمدّد الرمز طويل الأمد إلا التجديد، والرمز الذي يمرّ عليه 60 يومًا دون تجديد ينتهي مهما كثر استخدامه.
هل يزيل Instagram تطبيقًا تجاريًا بعد 90 يومًا من عدم الاستخدام؟
لا. يقول مركز مساعدة Instagram إن التطبيقات التي تملك أذونات إدارة الحسابات التجارية والمنشئين لا تنتهي صلاحيتها بعد 90 يومًا من عدم النشاط.
هل يُحتسب الحساب المنقطع في فاتورة easyCoexistence؟
نعم، إلى أن تعيد ربطه أو تزيله. والحساب الذي أزال مالكه التطبيق من إعدادات Instagram يخرج من العدد فور أن تُبلغ Meta عن الإزالة.
كم تكلّف مراقبة حساب Instagram مع easyCoexistence؟
المراقبة مشمولة مع كل اتصال: من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض كلما أضفت اتصالات، مع أول 3 أيام مجانًا.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في