قصص صفحة 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 أو من كودك الخاص: النصوص والروابط والصور والفيديوهات.
أطول قصة فيديو تسمح بها Meta على صفحة Facebook.
أكبر حجم لملف الصورة في قصة صورة، بصيغ JPEG وBMP وPNG وGIF وTIFF.
نسبة أبعاد قصة الفيديو، مع توصية بدقة 1080 x 1920 بكسل، وحد أدنى 540 x 960 بكسل.
الحالات التي يعرضها GET /{page-id}/stories، وتظهر القصص المؤرشفة فقط عند تفعيل أرشيف القصص للصفحة.
كيف تُنشر قصة الصورة؟
على خطوتين. ارفع الصورة إلى POST /{page-id}/photos مع ضبط published على false، فتعيد الاستجابة معرف الصورة. ثم أرسل POST /{page-id}/photo_stories مع ضبط photo_id على هذا المعرف. ترد Meta بالقيمة success وقيمتها true، مع post_id وهو معرف منشور القصة.
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.
ما الوسائط التي يمكن أن تستخدمها القصة؟
يحدد دليل 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.
وليست له أداة لـ 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 أيام مجاناً. كل صفحة تمثل اتصالاً واحداً، ويقل السعر لكل اتصال كلما أضفت المزيد.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في