لماذا يتوقف اتصال صفحة Facebook API (واجهة برمجة التطبيقات) عن العمل، وكيف تُبقيه نشطاً
يتوقف اتصال صفحة Facebook عن العمل حين ترفض Meta رمز الوصول الخاص به أو تتوقف عن إرسال أحداثه: إما لأن الرمز جاء من تسجيل دخول قصير الأمد، أو لأن الشخص غيّر كلمة المرور (الخطأ 190، الرمز الفرعي 460)، أو فقد دوره على الصفحة (492)، أو أزال التطبيق من تكاملات الأعمال (458)، أو لم يُستخدم أحد الأذونات لمدة 90 يوماً، أو بقي التطبيق بلا نشاط، أو قيّدت Meta الصفحة.
تأخذ easyCoexistence رمز كل صفحة من تسجيل دخول طويل الأمد، وتفحص الصفحة كل 6 ساعات، وترسل إليك بريداً إلكترونياً عندما ترفض Meta الرمز.
مدة صلاحية رموز المستخدم والصفحة الافتراضية في Meta، والرمز المأخوذ للصفحة من رمز مستخدم طويل الأمد لا يملك تاريخ انتهاء.
إذا لم يحدث أي تسجيل دخول أو استدعاء API أو webhook لمدة 90 يوماً، تعدّ Meta التطبيق غير نشط وتُبطل جميع رموزه.
أذونات الصفحة، مثل pages_manage_posts و read_insights، لا تنتهي مع فترة الوصول إلى البيانات البالغة 90 يوماً.
قيد Page Integrity الذي يمنع الصفحة من إرسال الرسائل عبر Messenger Platform API.
عدد مرات فحص easyCoexistence لكل صفحة متصلة باستدعاء Graph خفيف، وإرسال بريد إلكتروني للمالك إذا رفضت Meta الرمز.
ما الذي يمكن أن يجعل اتصال الصفحة يتوقف عن العمل؟
أسباب على أربعة مستويات: تسجيل دخول الشخص، وأذونات التطبيق ووضعه، والصفحة نفسها، واشتراك webhook. يظهر كل منها بطريقته، ومعظمها يعود بالخطأ 190 مع رمز فرعي يسمّي السبب:
لماذا قد ينتهي رمز الصفحة خلال ساعات؟
لأنه قُرئ من /me/accounts برمز مستخدم قصير الأمد، وبذلك يصبح هو أيضاً قصير الأمد. تنتهي رموز المستخدم والصفحة الافتراضية في Meta خلال ساعات، وتدوم عادةً ساعة إلى ساعتين للرمز القصير الأمد. وعند تبادله على الخادم باستخدام fb_exchange_token، يدوم رمز المستخدم نحو 60 يوماً، ولا يملك رمز الصفحة المقروء به تاريخ انتهاء. ولا تمدّد Meta رمزاً انتهت صلاحيته: يظهر الخطأ Session has expired مع الرمز الفرعي 463، ويجب أن يسجّل الشخص الدخول من جديد.
ماذا يحدث بعد تغيير كلمة المرور أو فحص أمني؟
تُبطل Meta رموز الشخص. وعند تسجيل الخروج أو تغيير كلمة المرور يعيد الخطأ 190 مع الرمز الفرعي 460، The session is invalid because the user logged out، وتحذّر Meta من أن الأحداث الأمنية قد تُبطل الرموز قبل موعد انتهائها المتوقع. أما الرمزان الفرعيان 459 و464 فيعنيان أن الحساب نفسه يحتاج إلى انتباه: على الشخص أن يسجّل الدخول إلى facebook.com ليصحح المشكلة، ثم يسجّل الدخول إلى التطبيق من جديد. وإلا فالحل تسجيل دخول جديد، يقوم به الشخص نفسه أو شخص آخر له دور على الصفحة.
ماذا يحدث عندما يفقد الشخص دوره على الصفحة؟
يتوقف رمز صفحته عن العمل بالخطأ 190 والرمز الفرعي 492، الذي تصفه Meta بأن المستخدم المرتبط برمز وصول الصفحة لم يعد يملك دوراً مناسباً عليها. تُصدر الرموز لكل صفحة وشخص وتطبيق، لذلك تستمر رموز الأشخاص الآخرين الذين لهم دور في النشاط التجاري. والحل إعادة ربط الصفحة من حساب ما زال يملك سيطرة كاملة أو وصولاً إلى المهام، ويفضّل أن يكون حساباً لا يوشك صاحبه على مغادرة النشاط التجاري.
ماذا يحدث عندما يُزيل أحدهم التطبيق من تكاملات الأعمال؟
تُبطل Meta رموز وصول المستخدم التي حصل عليها التطبيق لذلك الشخص، وتتوقف أيضاً رموز الصفحات المقروءة بها، بالخطأ 190 والرمز الفرعي 458: لم يصرّح المستخدم بالتطبيق. يزيل الشخص التطبيق من إعدادات Facebook، ضمن تكاملات الأعمال، فتستدعي Meta رد الاتصال deauthorize الخاص بالتطبيق. ويُنهى رمز المستخدم النظامي بالطريقة نفسها من Business Manager، من خلال Business Settings ثم Integrations ثم Connected apps، ويمكن للتطبيق أن ينهي وصوله بنفسه عبر DELETE /{user-id}/permissions.
هل تنتهي أذونات الصفحة بعد 90 يوماً؟
هناك قاعدتان مختلفتان لمدة 90 يوماً، ولا تطال أذونات الصفحة إلا إحداهما. انتهاء الوصول إلى البيانات، الذي يقطع التطبيق بعد 90 يوماً من آخر نشاط للشخص، لا ينطبق على pages_show_list و pages_messaging و read_insights وسائر أذونات الصفحة التي تذكرها Meta بأنها لا تنتهي. أما انتهاء الإذن فينطبق: فالإذن الذي لم يستخدمه التطبيق لمدة 90 يوماً قد ينتهي، حتى لو وافقت عليه مراجعة التطبيق (App Review)، ويجب أن يمنحه الشخص من جديد. وتفشل الاستدعاءات التي تحتاجه بالرمز 10 أو برمز في نطاق 200 إلى أن يمنحه تسجيل دخول جديد.
هل يمكن أن يفقد التطبيق كله وصوله؟
نعم، بثلاث طرق موثقة، تحذّر منها Meta بإشعار عاجل في صندوق التنبيهات بلوحة App Dashboard. يُعدّ التطبيق غير نشط إذا مرّت 90 يوماً دون أي تسجيل دخول أو استدعاء Graph API أو Marketing API أو إشعار webhook، فتُبطل Meta جميع رموزه. وإعادة تفعيله من App Dashboard ترقيه إلى أحدث إصدار، لكن الرموز القديمة تبقى باطلة، والأذونات التي سقطت لعدم الاستخدام تعود عبر مراجعة التطبيق. كما يجب إكمال Data Use Checkup السنوي، وقد يؤدي خرق شروط Meta أو سياساتها إلى تقييد وصول API أو سحب الأذونات.
ماذا يحدث عندما تقيّد Meta الصفحة؟
تفشل الإجراءات المقيّدة: الخطأ 368، أي محظور مؤقتاً بسبب انتهاكات السياسات، أو بالنسبة للرسائل الرمز 10 مع الرمز الفرعي 1893063. وتوضح Page Integrity API ذلك: إذ يعيد GET /{page-id}/page_status، مع pages_manage_metadata، حالة هي ok أو warning أو restricted أو suspended، مع كل قيد نشط، مثل page_publish أو page_read_only أو page_messaging أو page_messaging_api، مع expiration_time الخاص به، والإجراءات الموصى بها مثل FILE_APPEAL. ويُبلغ حقل webhook باسم business_integrity بالتغييرات لحظة وقوعها.
لماذا تتوقف الأحداث بينما تعمل استدعاءات API؟
لأن webhooks تفشل وفق شروطها الخاصة. فبعد ساعة من عمليات التسليم الفاشلة، ترسل Meta تنبيه Webhooks Disabled وتلغي اشتراك التطبيق بالصفحة حتى يشترك من جديد، ولا ترسل شيئاً أبداً لصفحة أوقفت App platform في إعداداتها (App Settings). وقد يبقى الرمز صالحاً خلال الحالتين، لذلك بعد انقطاع تحقّق من GET /{page-id}/subscribed_apps، وحين تعود نقطة النهاية (endpoint) إلى الرد أرسل إليها POST برمز الصفحة.
كيف تكتشف الاتصال المعطّل قبل أن يفشل منشور؟
بالفحص وفق جدول زمني، لأن Meta لا تُخطر التطبيق عندما يصبح الرمز غير صالح. يفشل استدعاء خفيف مثل GET /{page-id}?fields=id,name برمز الصفحة بالطريقة نفسها التي سيفشل بها المنشور. ويعيد debug_token، عند استدعائه بمعرّف التطبيق وسره بوصفه رمز الوصول، القيم is_valid و expires_at والنطاقات الممنوحة، إضافة إلى رمز الخطأ والرمز الفرعي لرمز لم يعد يعمل. ويُبلغ page_status بالقيود، ويعلن رد الاتصال deauthorize عن إزالة التطبيق.
curl -G "https://graph.facebook.com/v26.0/debug_token" \
--data-urlencode "input_token=$PAGE_TOKEN" \
--data-urlencode "access_token=$APP_ID|$APP_SECRET"
# data.is_valid, data.expires_at, data.scopes, data.granular_scopes,
# and data.error.code with data.error.subcode once the token stops workingكيف تعيد ربط الصفحة؟
بالتدفق نفسه الذي ربطها أول مرة، ويقوم به شخص ما زال له دور على الصفحة، بعد معالجة السبب إن وُجد: يسجّل الحساب الذي عليه نقطة تحقق الدخول إلى facebook.com، ويُنفَّذ الإجراء الموصى به لأي قيد، وتعود نقطة النهاية المتعطلة إلى الرد بـ 200. ينتج تسجيل الدخول الجديد سلاسل رموز جديدة، لذا استبدل المخزنة بها بدلاً من الاحتفاظ بالاثنتين:
ماذا تفعل easyCoexistence عندما ينقطع اتصال الصفحة؟
تراقب الانقطاعات التي تراها وتُخبرك بها. كل 6 ساعات تفحص كل صفحة متصلة بـ GET /{page-id}?fields=id,name، وعندما ترفض Meta الرمز بالخطأ 190 أو 102، في هذا الفحص أو في أي استدعاء للأداة، تُوسم الصفحة بـ Reconnect needed، ويتلقى مالكها بريداً إلكترونياً واحداً، وتتلقى منصة شريكة الحدث channel.disconnected. أما الرفض الآخر، مثل إذن مفقود أو حظر سياسة، فيعود في نتيجة الأداة برمز Meta ورسالته.
عندما يُزيل أحدهم التطبيق من تكاملات الأعمال، يصل رد الاتصال deauthorize من Meta إلى easyCoexistence، فيزيل الصفحات التي ربطها ذلك الشخص، ويحذف رموزه ووجهات أحداثه، ويلغي احتسابها من الفاتورة، ويرسل channel.removed. ويعيد تسجيل الدخول من لوحة التحكم الصفحة بوصفها اتصالاً واحداً، مع قواعد تعليقاتها وقواعد الأتمتة، ويشترك من جديد في feed و messages و mention. وبعد حالة Reconnect needed تبقى وجهة الحدث كما هي؛ أما بعد الإزالة فيعيدها set_social_webhook_destination بسر جديد.
الأخطاء الشائعة
- إعادة محاولة الخطأ 190. يفشل الرمز المرفوض بالطريقة نفسها في كل استدعاء، ولا ينتج رمزاً صالحاً إلا تسجيل دخول جديد من شخص له دور على الصفحة.
- إعادة الربط لرفع قيد. الرمز الجديد لا يغيّر حالة الصفحة؛ ما يغيّرها هو الإجراءات الموصى بها في page_status، مثل طلب الاستئناف.
- طلب إذن نادراً ما يستخدمه المنتج. إذا بقي دون استخدام لمدة 90 يوماً قد ينتهي، وتفشل الاستدعاءات التي تحتاجه؛ اطلبه عند إطلاق الميزة.
- الاحتفاظ بالرمز القديم بعد إعادة الربط. يعيد تسجيل الدخول الجديد سلسلة رمز مختلفة، والمهمة التي ما زالت تحمل القديم ستستمر في الفشل بالخطأ 190.
ويعيد تسجيل دخول واحد على Facebook الصفحة كما كانت، بوصفها الاتصال نفسه، مع قواعد تعليقاتها وأتمتتها. من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ينخفض مع إضافة الاتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل يتوقف رمز الصفحة عن العمل عندما ينتهي رمز المستخدم الذي يدوم 60 يوماً؟
لا، إن كان قد قُرئ من /me/accounts بذلك الرمز طويل الأمد، فلا يملك رمز الصفحة هذا تاريخ انتهاء، غير أن الأسباب الواردة في هذه الصفحة قد تنهيه مع ذلك.
هل تخبرني Meta عندما يتوقف رمز الصفحة عن العمل؟
لا، بالنسبة إلى رمز أصبح غير صالح؛ فالاستدعاء التالي يعيد الخطأ. أما عند إزالة التطبيق فتستدعي Meta رد الاتصال deauthorize، وتحذّر من المخاطر على مستوى التطبيق في صندوق التنبيهات بلوحة App Dashboard.
هل يمكن لرمز شخص آخر أن يُبقي الصفحة متصلة؟
نعم. تُصدر رموز الصفحة لكل صفحة وشخص وتطبيق، لذلك يستمر عمل رمز شخص آخر ما زال له دور على الصفحة عند انتهاء وصول شخص واحد.
كم تكلف easyCoexistence لصفحة Facebook؟
من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، يحدده عدد اتصالاتك، وتُحسب كل صفحة اتصالاً واحداً، مع فترة تجريبية مجانية مدتها 3 أيام.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في