دليل Facebook Pages API لعام 2026: من تطبيقك إلى أول منشور
مسار Facebook Pages API في 2026 يبدأ من تطبيق Meta بحالة الاستخدام Manage everything on your Page، ويمر عبر Facebook Login for Business، وصولاً إلى رمز الوصول (token) الخاص بالصفحة، والذي يُقرأ من /me/accounts، ثم إلى أول طلب POST إلى /{page-id}/feed على Graph API v26.0. بعد ذلك تعمل التعليقات وردود Messenger وخطاف الويب (webhook) والتحليلات على token الصفحة نفسه، ولكل منها إذنها الخاص.
يحمل تطبيق Meta الخاص بـ easyCoexistence أذونات الصفحات، فيربط تسجيل دخول واحد عبر Facebook صفحةً، ويتيح لـ Claude أو ChatGPT أو منصتك الخاصة النشر والجدولة والرد على التعليقات والرسائل الخاصة (DMs)، واستقبال أحداث الصفحة، وقراءة تحليلاتها عبر واجهة Meta الرسمية، مع فحص كل اتصال كل 6 ساعات، وإرسال بريد إلكتروني عندما يحتاج إلى إعادة الربط.
أحدث إصدار من Graph API صدر في 29 يوليو 2026، ويبقى الإصدار v25.0 متاحاً حتى 29 يوليو 2028.
المهمة الخاصة بالصفحة التي يطلبها دليل Get Started من Meta لنشر أول منشور، على صفحة منشورة أو غير منشورة.
أكبر أيقونة للتطبيق تقبلها Meta عند نشره: من 512 x 512 إلى 1024 x 1024 بكسل، بصيغة JPEG أو GIF أو PNG.
مدة احتفاظ Meta ببيانات Page Insights لصفحة غير منشورة، أما بيانات الصفحة العامة فتُحفظ لمدة 2 سنة.
ما الخطوات من تطبيق Meta إلى أول منشور؟
خمس خطوات بترتيب ثابت، لأن كل خطوة تحتاج إلى التي قبلها: التطبيق يحمل الأذونات، وتسجيل الدخول يمنحها، والمنح ينتج رمز الصفحة، والرمز يوقّع الطلبات. تأتي التعليقات وMessenger وwebhook والتحليلات بعد أول منشور، وتعيد استخدام الرمز نفسه. تتناول الأقسام أدناه الخطوات بالترتيب، ثم الأعمال التي تلي ذلك.
كيف تُنشئ تطبيق Meta؟
من لوحة تحكم التطبيقات في Meta: أنشئ تطبيقاً، واختر حالة الاستخدام Manage everything on your Page، ثم خصّصه لإضافة الأذونات الاختيارية التي تحتاجها. يضع خيار Ready to test علامة الاختبار على كل حالة استخدام، وهو شرط مراجعة التطبيق (App Review)، ويشغّل Graph API Explorer استعلامات الاختبار مع الرموز ونماذج الأكواد. التطبيق الذي سيعمل على صفحات تعود لأنشطة تجارية أخرى يُعدّ كـ Tech Provider ضمن Become a Tech Provider، وهذا يضيف أسئلة البيانات ومراجعة التطبيق وBusiness Portfolio موثّقة. الإعداد الكامل موجود في صفحة الوصول إلى Graph API.
أين يقع Facebook Login for Business؟
هو الطريقة التي يمنح بها من يدير الصفحة التطبيقَ الوصولَ، وتسمّيه Meta تسجيل الدخول المفضّل لمزودي التقنية الذين يبنون على أدوات الأعمال الخاصة بها. تأخذ إعداداته عنوان Redirect URI وعنوان Deauthorize Callback URL وعنوان Data Deletion Request URL؛ ثم يحدد الإعداد نوع الرمز والأصول والأذونات، ويُوضع config_id في نافذة تسجيل الدخول في المكان الذي يقع فيه scope لولاه. بعد أن يوافق الشخص، تعيد Facebook رمز التفويض (code) الذي يستبدله خادمك برمز مستخدم.
ما الأذونات ومستوى الوصول الذي يحتاجه تطبيق الصفحات؟
إذن pages_ واحد لكل نوع من العمل، يُمنح عند تسجيل الدخول: pages_manage_posts للنشر، وpages_read_engagement وpages_read_user_content للقراءة، وpages_manage_engagement للرد على التعليقات، وpages_messaging لـ Messenger، وpages_manage_metadata لخطافات الويب، وread_insights للمقاييس، مع pages_show_list أسفلها. يغطي Standard Access الأشخاص الذين لهم دور في التطبيق، أما الصفحات التي يديرها غيرهم فتحتاج Advanced Access عبر مراجعة التطبيق والتحقق من النشاط التجاري. لم يعد التحقق من الوصول (Access Verification) من الخطوات، إذ أوقفته Meta لتطبيقات Tech Provider في أكتوبر 2026. تجد تبعيات كل إذن في صفحة الأذونات.
كيف يحصل التطبيق على رمز الصفحة؟
من GET /me/accounts، ويُستدعى برمز مستخدم طويل الأمد. يتبع رمز الصفحة رمز المستخدم الذي جاء منه: إذا قُرئ برمز قصير الأمد من تسجيل دخول حديث، فإنه ينتهي خلال ساعات، أما إذا قُرئ برمز مستخدم طويل الأمد يُحصل عليه على الخادم عبر fb_exchange_token، فليس له تاريخ انتهاء. يتضمن كل عنصر في الاستجابة معرّف الصفحة واسمها، والمهام التي يملكها الشخص عليها، ورمز تلك الصفحة الخاص بها، وهو فريد للصفحة والشخص والتطبيق معاً. تغطي صفحة الرموز ما يمكن أن ينهي الرمز.
كيف تنشر أول منشور؟
بطلب POST إلى /{page-id}/feed، مع الرسالة ورمز الصفحة الخاص بشخص يملك مهمة CREATE_CONTENT. تجيب Meta بمعرّف المنشور الجديد، بصيغة {page-id}_{post-id}، ويظهر المنشور بصوت الصفحة. إذا أضفت حقل link صار المنشور رابطاً، وإذا جعلت published بالقيمة false مع scheduled_publish_time أُجّل نشره لوقت لاحق. يرسل مثال Get Started الرسمي من Meta الحقول بصيغة JSON:
curl -X POST "https://graph.facebook.com/v26.0/{page-id}/feed" \
-H "Content-Type: application/json" \
-d '{
"message": "Our first post through the API",
"access_token": "{page-access-token}"
}'
# {"id": "{page-id}_{post-id}"}كيف ترد الصفحة على التعليقات؟
تقرؤها بطلب GET /{page-post-id}/comments، وترد باسم الصفحة بطلب POST /{comment-id}/comments مع message. يجب أن يصدر الرمز عن شخص يملك مهمة MODERATE، وإلا تحجب Meta معرّفات التعليقات، ويحتاج الرد أيضاً إلى pages_manage_engagement. يعيد filter=stream التعليقات بكل مستوياتها حسب ترتيب الزمن. ويمكن أن يتلقى التعليق رداً خاصاً واحداً في Messenger خلال 7 أيام من وروده، ويخفيه is_hidden على التعليق أو يعيد إظهاره.
كيف يندرج Messenger هنا؟
عبر رمز الصفحة نفسه و POST /{page-id}/messages، بعد أن يكتب الشخص رسالة أولاً: تفتح رسالته نافذة مدتها 24 ساعة للرد بالقيمة messaging_type RESPONSE، موجهاً إلى المعرّف المقصور على الصفحة الذي جاء مع خطاف الويب. يجب أن يصدر الرمز عن شخص يملك مهمة MESSAGING ويحمل pages_messaging. بعد انتهاء النافذة، لا يصل إلى الشخص إلا وسم رسالة مثل HUMAN_AGENT، ومنذ 27 أبريل 2026 تعيد ثلاثة وسوم أقدم الخطأ 100، كما توضح صفحة وسوم الرسائل.
كيف تصل الأحداث إلى خادمك؟
عبر ثلاثة عناصر: نقطة نهاية (endpoint) تعمل بـ HTTPS وتجيب على فحص hub.challenge من Meta، ومنتج Webhooks في لوحة تحكم التطبيقات مضبوط على كائن Page مع حقول مثل feed وmessages، وطلب POST /{page-id}/subscribed_apps برمز كل صفحة، وهذا يركّب التطبيق على تلك الصفحة. لا ترسل Meta شيئاً للصفحة التي لم تركّب التطبيق أو أوقفت منصة التطبيق في إعدادات التطبيق. يصل كل حدث موقّعاً بالترويسة X-Hub-Signature-256، ويتحقق منه خادمك بالسر الخاص بالتطبيق.
كيف تقرأ تحليلات الصفحة؟
بطلب GET /{page-id}/insights، مع قائمة مفصولة بفواصل من المقاييس وفترة day أو week أو days_28، ويُستخدم رمز صادر عن شخص يملك مهمة ANALYZE، مع منح read_insights وpages_read_engagement. من المقاييس التي تعمل في أواخر 2026: page_media_view وpage_total_media_view_unique وpage_post_engagements وpage_follows، ويغطي الطلب الواحد 90 يوماً كحد أقصى عبر since وuntil. تعود بيانات الصفحة العامة 2 سنة إلى الوراء.
ما الحدود التي تشكّل التصميم؟
عدد قليل، تحددها Meta وتوثّقها مع كل واجهة، وهي التي تحدد كيف يرتّب التكامل مهامه في الطابور:
- استدعاءات Pages API برمز الصفحة: 4,800 لكل مستخدم متفاعل مع الصفحة خلال 24 ساعة متحركة.
- Messenger Send API: 300 استدعاء في الثانية لكل صفحة للنص والروابط والتفاعلات والملصقات، و10 للصوت أو الفيديو.
- Conversations API: استدعاءان في الثانية لكل صفحة.
- المنشورات المجدولة عبر
scheduled_publish_timeالخاص بـ Meta: بين 10 دقائق و30 يومًا بعد الطلب؛ أما قائمة انتظار easyCoexistence فتقبل من دقيقة واحدة إلى 90 يومًا بدلًا من ذلك. - Reels: 30 مقطعاً منشوراً عبر الواجهة في فترة متحركة مدتها 24 ساعة، وتُفرض على /{page-id}/
video_reels. - الردود الخاصة: رد واحد لكل تعليق، خلال 7 أيام منه.
ما المسار الأقصر عبر easyCoexistence؟
الواجهة نفسها مع الإعداد المنجز مسبقاً. يحمل تطبيق Meta الخاص بـ easyCoexistence الأذونات، فيسجّل من يدير الصفحة الدخول مرة واحدة عبر Facebook، وتبدأ Claude أو ChatGPT أو منصتك الخاصة من أول منشور. تقابل كل خطوة أعلاه شيئاً يعمل بالفعل:
الأخطاء الشائعة
- تثبيت إصدار Graph API قرب نهايته. أُزيل v20.0 في 24 سبتمبر 2026، وسيُوقف v21.0 في 21 يناير 2027، وبعدها تعمل استدعاءاته على الإصدار الأعلى التالي، فانتقل إلى v26.0 عن قصد.
- الاختبار بحسابات لها دور في التطبيق فقط. في وضع التطوير يمكنها منح أي إذن، فقد يعمل تدفق يناسب الفريق ويفشل مع العميل إلى أن تُعتمد Advanced Access.
- طلب أذونات لن يستخدمها التطبيق. يحتاج كل إذن إلى استدعاء ناجح خلال 30 يوماً قبل مراجعة التطبيق، وإذن لم يُستخدم 90 يوماً قد تنتهي صلاحيته ويجب منحه من جديد.
- تمرير معرّف منشور مجرد. تعود منشورات الصفحة بصيغة {page-id}_{post-id}، وتأخذ التعليقات والتعديلات والتحليلات على المنشور هذه القيمة كاملة.
من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ويقل السعر كلما أضفت اتصالات، مع أول 3 أيام مجانية.
الأسئلة الشائعة
هل يمكنني البناء والاختبار على صفحة غير منشورة؟
نعم. يعمل دليل Get Started من Meta على صفحة منشورة أو غير منشورة تستطيع فيها تنفيذ CREATE_CONTENT، لذا تكفي صفحة اختبار مخفية. وتحتفظ Meta ببيانات Page Insights لصفحة غير منشورة لمدة 5 أيام فقط.
أي إصدار من Graph API ينبغي أن يستخدمه تكامل صفحة جديد؟
v26.0، وهو الأحدث منذ 29 يوليو 2026. تُبقي Meta كل إصدار يعمل لمدة لا تقل عن سنتين، لذا ثبّت الإصدار في كل عنوان URL وانتقل إلى إصدار أعلى عن قصد لا تلقائياً.
هل يمكن لتطبيق Meta واحد أن يخدم صفحات أنشطة تجارية أخرى؟
نعم، بوصفه تطبيق Tech Provider. تحتاج أذونته إلى Advanced Access عبر مراجعة التطبيق، ويجب أن يُكمل النشاط التجاري الذي يقف خلف التطبيق التحقق من النشاط التجاري قبل الوصول إلى بيانات تملكها أنشطة تجارية أخرى.
كم تكلف easyCoexistence لصفحة Facebook؟
كل صفحة تُحسب اتصالاً واحداً، بسعر من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً مع نمو إجماليك، وأول 3 أيام مجانية، ودون تطبيق Meta خاص بك تحتاج إلى صيانته.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في