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

قصص صفحة Facebook عبر واجهة برمجة التطبيقات (API)

تنشر واجهة Stories API من Meta قصص الصور والفيديو على صفحة Facebook. تحتاج قصة الصورة إلى رفع صورة مع ضبط published على false، ثم استدعاء POST /{page-id}/photo_stories بالمعرف photo_id الخاص بها. أما قصة الفيديو فتمر عبر استدعاءات start وupload وfinish على /{page-id}/video_stories. تصل مدة قصص الفيديو إلى 60 ثانية، ويصل حجم الصور إلى 10 MB.

ينشر easyCoexistence منشورات صفحة Facebook عبر publish_facebook_post من Claude أو ChatGPT أو من كودك الخاص: النصوص والروابط والصور والفيديوهات.

60 seconds

أطول قصة فيديو تسمح بها Meta على صفحة Facebook.

10 MB

أكبر حجم لملف الصورة في قصة صورة، بصيغ JPEG وBMP وPNG وGIF وTIFF.

9 x 16

نسبة أبعاد قصة الفيديو، مع توصية بدقة 1080 x 1920 بكسل، وحد أدنى 540 x 960 بكسل.

PUBLISHED, ARCHIVED

الحالات التي يعرضها GET /{page-id}/stories، وتظهر القصص المؤرشفة فقط عند تفعيل أرشيف القصص للصفحة.

كيف تُنشر قصة الصورة؟

على خطوتين. ارفع الصورة إلى POST /{page-id}/photos مع ضبط published على false، فتعيد الاستجابة معرف الصورة. ثم أرسل POST /{page-id}/photo_stories مع ضبط photo_id على هذا المعرف. ترد Meta بالقيمة success وقيمتها true، مع post_id وهو معرف منشور القصة.

Publishing a photo story
POST /{page-id}/photo_stories
{
  "photo_id": "<PHOTO_ID>"
}

200 OK
{
  "success": true,
  "post_id": "<STORY_POST_ID>"
}

كيف تُنشر قصة الفيديو؟

في ثلاث خطوات، بالشكل نفسه الذي تُنشر به Reels. يُرسل POST /{page-id}/video_stories مع ضبط upload_phase على start، فيعيد video_id وupload_url على rupload.facebook.com. يُرفع الفيديو إلى هذا العنوان كبايتات الملف مع الترويستين offset وfile_size، أو عبر الترويسة file_url لملف مستضاف. ثم يُرسل POST /{page-id}/video_stories مع video_id وupload_phase على finish، فينشر القصة ويعيد post_id.

1StartPOST /{page-id}/video_stories, upload_phase start
2UploadThe bytes or a file_url, sent to the upload_url
3StatusGET /{video-id}?fields=status
4Finishupload_phase finish with video_id: returns post_id

ما الوسائط التي يمكن أن تستخدمها القصة؟

يحدد دليل Stories من Meta مواصفة للصورة وأخرى للفيديو. الصور ملفات .jpeg أو .bmp أو .png أو .gif أو .tiff بحجم يصل إلى 10 MB، ويفضّل أن تبقى ملفات PNG دون 1 MB. أما الفيديو فيتبع مواصفات Reels، مع سقف أقصر:

  • الملف: يُفضّل .mp4، بنسبة أبعاد 9 x 16.
  • الدقة: يوصى بـ 1080 x 1920 بكسل، وبحد أدنى 540 x 960 بكسل.
  • معدل الإطارات: من 24 إلى 60 إطاراً في الثانية، ثابت، مع مسح تدريجي.
  • المدة: 60 ثانية كحد أقصى لقصة الفيديو.
  • الترميز: H.264 أو H.265، مع دعم VP9 وAV1 أيضاً. الصوت بترميز AAC Low Complexity بتردد 48 kHz، ستيريو، وبمعدل 128 kbps أو أعلى.

أي وسائط لا يمكن استخدامها في القصة؟

صورة أو فيديو سبق نشره في منشور آخر، فقاعدة Meta أن الوسائط المرفوعة لقصة لا يجوز أن تكون قد نُشرت من قبل. كما يجب أن يكون الفيديو المستضاف متاحاً للوصول، لأن Meta ترفض الملفات الموجودة على مواقع يمنع ملف robots.txt فيها وكيل المستخدم facebookexternalhit/1.1، وكذلك الملفات الموجودة على شبكة توصيل المحتوى الخاصة بها، مثل روابط fbcdn.

كيف تُعرض قصص الصفحة؟

يعيد GET /{page-id}/stories كائناً واحداً لكل قصة، ويمكن تصفية القائمة بالحالة أو بالتاريخ عبر since وuntil. يحتوي كل كائن على:

  • post_id: معرف منشور القصة.
  • status: PUBLISHED أو ARCHIVED، والقصص المؤرشفة تتطلب تفعيل أرشيف القصص للصفحة.
  • creation_time: الطابع الزمني UNIX لحظة نشر القصة.
  • media_type وmedia_id: photo أو video، ومعرف هذه الوسائط.
  • url: عنوان القصة على Facebook، ضمن facebook.com/stories/.

ما الأذونات المطلوبة؟

رمز وصول (token) للصفحة من شخص يمكنه تنفيذ المهمة CREATE_CONTENT على الصفحة، عبر Facebook Login أو Facebook Login for Business، مع منح pages_manage_posts وpages_read_engagement وpages_show_list. تحتاج الطلبات التي يقدمها مستخدم نظام تجاري أيضاً إلى business_management. وهي الأذونات الثلاثة نفسها التي يطلبها النشر على خلاصة الصفحة.

متى تُنشر القصة؟

عند استدعاء photo_stories، أو عند استدعاء finish على video_stories. لا تتضمن واجهة Stories API وقتاً للنشر المجدول: يأخذ photo_stories المعرف photo_id، ويأخذ استدعاء finish الحقول video_id وupload_phase والحقل الاختياري is_ai_generated. أي قصة لوقت لاحق تحتاج إلى استدعاء يُجرى في ذلك الوقت، من جدولة خاصة بك.

كيف تنشر قصة عبر easyCoexistence؟

لا يمكنك ذلك بعد. ينشر publish_facebook_post المنشورات لا القصص، وليست لدى easyCoexistence أداة لـ photo_stories أو video_stories؛ ولا تُسلَّم رموز الصفحات، فلا يمكن تشغيل هذه الاستدعاءات من كودك الخاص على اتصالها أيضًا. انشر القصص من Facebook أو Meta Business Suite.

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

  • إعادة استخدام صورة من منشور سابق. لا يمكن أن تأتي وسائط القصة من منشور سبق نشره، لذلك ارفعها من جديد مع ضبط published على false.
  • تحويل Reel مدته 90 ثانية إلى قصة. تصل مدة Reels إلى 90 ثانية، لكن قصة الفيديو تتوقف عند 60 ثانية.
  • توقع ظهور القصص المؤرشفة في القائمة. تظهر في GET /{page-id}/stories فقط عند تفعيل أرشيف القصص للصفحة.
  • إرسال الفيديو إلى graph.facebook.com. يكون الرفع على upload_url في rupload.facebook.com، أما استدعاءات start وfinish والحالة فتبقى على graph.facebook.com.
إنجاز ذلك باستخدام EasyCoexistence

وليست له أداة لـ Stories API، لذلك تُنشر القصص من Facebook أو Meta Business Suite. من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية لأول 3 أيام.

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

هل يمكن مشاركة Reel كقصة على صفحة Facebook؟

نعم، إذا كانت مدته 60 ثانية أو أقل، لأن مواصفات Meta تنص على ألا تتجاوز مدة Reel المنشور كقصة على صفحة هذا الحد.

هل يمكن وسم قصة الفيديو بأنها مُنشأة بالذكاء الاصطناعي؟

نعم. اضبط is_ai_generated على true في استدعاء finish على video_stories، والقيمة الافتراضية هي false.

ماذا لو انقطع رفع فيديو القصة؟

أعد الرفع مع ضبط offset على 0 لإعادة البدء، أو مع ضبطه على قيمة bytes_transfered من فحص الحالة للاستئناف.

كم تكلف easyCoexistence لصفحة Facebook؟

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

تابع القراءة

واجهة برمجة التطبيقات (API) لـ Facebook Reels: نشر Reels إلى صفحةكيفية نشر Reels إلى صفحة عبر Facebook Reels API: استدعاءات البدء والرفع والإنهاء على video_reels، ومواصفات الفيديو، والحد 30 يومياً، وفحص الحالة.نشر الصور على صفحة Facebook: صورة واحدة ومنشورات بعدة صوركيفية نشر الصور على صفحة Facebook عبر Graph API: صورة واحدة برابط أو رفع، وعدة صور في منشور واحد، وقواعد Meta للملفات.نشر الفيديوهات على صفحة فيسبوك عبر واجهة برمجة التطبيقات (API)طريقة نشر فيديو على صفحة فيسبوك عبر Graph API: بإرسال file_url أو رفع ملف إلى /videos، مع العنوان والوصف وحالة المعالجة.واجهة برمجة نشر منشورات صفحات Facebook: نص وروابط وصور وفيديوهاتطريقة نشر منشورات صفحة Facebook عبر Graph API: نص وروابط على /feed، وصور من رابط على /photos، وفيديوهات على /videos، وقواعد Meta.أذونات واجهة برمجة التطبيقات (API) لصفحات Facebook ومتطلبات مراجعة التطبيقالأذونات التسعة لصفحات Facebook، وما يتيحه كل منها، وما تطلبه مراجعة التطبيق من Meta: Advanced Access، والتحقق من النشاط التجاري، وتسجيل الشاشة.

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

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

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

تم التحقق في