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

نشر قصص Instagram عبر واجهة برمجة التطبيقات (API)

تنشر API القصة من صورة واحدة أو فيديو واحد على عنوان URL عام: تُنشئ حاوية الوسائط (container) مع media_type بالقيمة STORIES، ثم تنشرها. الصور بصيغة JPEG حتى 8 ميغابايت، والفيديوهات من 3 إلى 60 ثانية وحتى 100 ميغابايت، وتوصي Meta بإطار بنسبة 9:16، وتختفي القصة بعد 24 ساعة كما في التطبيق.

تنشر easyCoexistence قصص الصور والفيديو عبر publish_instagram_post من Claude أو ChatGPT أو من كودك الخاص، ويمكنه جدولتها من قائمة انتظاره الخاصة.

60 s

أطول فيديو قصة تنشره API، وأقصره 3 ثوانٍ، ويمكن أن يصل حجم الملف إلى 100 ميغابايت.

8 MB

أكبر صورة للقصة، ويجب أن تكون بصيغة JPEG.

24 hours

المدة التي تبقى فيها القصة المنشورة قبل أن تنتهي.

Under 5

قيم المقاييس المنخفضة لقصة تعود كخطأ 10، أي عدم كفاية عدد المشاهدين، بدلًا من رقم.

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

بالاستدعاءين نفسهما المستخدمين في أي منشور: POST /<IG_ID>/media مع media_type بالقيمة STORIES وأحد الحقلين image_url أو video_url، ثم POST /<IG_ID>/media_publish مع معرّف الحاوية. تُعالَج قصة الفيديو أولًا، لذلك يجب أن تظهر قيمة status_code للحاوية FINISHED قبل نشرها.

تصف مرجعية Meta التعليق للصور والفيديوهات ومنشورات الألبومات المتعددة الصور، لا للقصص، لذلك تُوضع الكلمات الموجهة للمشاهد داخل الصورة أو الفيديو نفسه.

ما متطلبات وسائط القصة؟

توصي Meta بإطار بنسبة 9:16 لصور القصص وفيديوهاتها على حد سواء، لتجنب القص أو المساحات الفارغة.

  • الصورة: JPEG، حتى 8 ميغابايت، بمساحة الألوان sRGB، وتُحوَّل المساحات الأخرى.
  • الفيديو: بصيغة MOV أو MP4 مع ترميز الفيديو H.264 أو HEVC وترميز الصوت AAC، بمعدل 23 إلى 60 إطارًا في الثانية، وبعرض يصل إلى 1920 بكسل ومعدل بت 25 Mbps.
  • مدة الفيديو: من 3 إلى 60 ثانية، وبحجم ملف يصل إلى 100 ميغابايت.
  • نسبة أبعاد الفيديو: مقبول أي نسبة من 0.1:1 إلى 10:1.

ما الذي يمكن أن تحمله القصة؟

الصورة أو الفيديو نفسه، وإشارات إلى حسابات أخرى: منذ يوليو 2025 يُتيح المعامل user_tags وسم الحسابات العامة في قصص الصور والفيديو، مع إمكانية تحديد الإحداثيات x وy (اختيارية). لا تدعم Meta نشر الملصقات عبر API، لذلك تبقى الروابط والاستطلاعات والمواقع الجغرافية في التطبيق.

ماذا يحدث بعد نشر القصة؟

تبقى ظاهرة 24 ساعة ثم تنتهي، كما في التطبيق. تعرض Meta القصص الحية على stories edge منفصلة، ولا تتضمنها قائمة وسائط الحساب GET /<IG_ID>/media. وعند قراءتها، تكون قيمة media_type للقصة IMAGE أو VIDEO كأي وسائط أخرى، لذلك تميّز القصص بالمكان الذي وجدتها فيه لا بنوعها.

كيف تعود الردود والإشارات؟

كرسائل مباشرة. يصل الرد على القصة إلى الحساب كرسالة مباشرة عبر خطاف الويب (webhook) الخاص بالرسائل، ومعه معرّف القصة وعنوان URL الخاص بها، ويفتح نافذة الرد المعتادة لمدة 24 ساعة. وعندما يذكر شخص الحساب في قصته، تصل الإشارة كرسالة أيضًا، مع مرفق من نوع story_mention. ولا تغطي واجهة Mentions API من Meta القصص.

أي المقاييس تعرضها القصة؟

الوصول والمشاهدات والمشاركات والردود والمتابعات وزيارات الملف الشخصي ونشاط الملف الشخصي والتنقل ونقرات الروابط وإعادات النشر وإجمالي التفاعلات، وتُقرأ عبر نقطة النهاية (endpoint) الخاصة بالمقاييس media insights. وهي متاحة 24 ساعة فقط، وأي قيمة أقل من 5 تعود بالخطأ 10، أي عدم كفاية المشاهدين، بدلًا من رقم. تُستبعد الردود من أشخاص في أوروبا واليابان من العدد، ويُظهر أي قصة ينشئها حساب هناك صفر ردود.

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

  • التخطيط لملصق رابط. لا تنشر API الملصقات، لذا يجب أن يصل الرابط إلى الناس بطريقة أخرى، مثل الرد عبر الرسالة المباشرة.
  • قراءة مقاييس القصة في اليوم التالي. هي متاحة 24 ساعة فقط، لذا اجمعها والقصة ما زالت ظاهرة.
  • البحث عن قصة منشورة في قائمة وسائط الحساب. تُدرج القصص الحية على stories edge منفصلة.
  • نشر فيديو أفقي كقصة. توصي Meta بنسبة 9:16، وقد تظهر الأشكال الأخرى مساحات فارغة أو تُقص.
إنجاز ذلك باستخدام EasyCoexistence

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

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

هل يمكنني إضافة ملصق رابط إلى قصة عبر API؟

لا. لا تدعم Meta نشر الملصقات عبر API، بما فيها الروابط والاستطلاعات والمواقع الجغرافية. أما ذكر حساب آخر دون ملصق فمدعوم.

أين تظهر القصة المنشورة في API؟

في stories edge الخاصة بالحساب طوال مدة ظهورها. لا تتضمن GET /<IG_ID>/media القصص، وتُقرأ القصة كـ IMAGE أو VIDEO.

هل يمكن أن تحمل القصة تعليقًا عبر API؟

لا. لا تصف مرجعية Meta تعليقًا للقصص، ويرسل publish_instagram_post القصة دونه، لذلك تُوضع الكلمات الموجهة للمشاهد داخل الصورة أو الفيديو نفسه.

كم مدة توفر مقاييس القصة؟

24 ساعة. لا تتيح Meta مقاييس القصص إلا لهذه المدة، لذا اقرأها والقصة ما زالت ظاهرة.

تابع القراءة

حدود النشر في Instagram API: الصيغ والأحجام والمنشورات في اليومما يحتويه منشور Instagram API وكم منشورًا يمكن نشره يوميًا: صور JPEG حتى 8 MB وReels وStories وتسميات حتى 2,200 حرف و100 منشور كل 24 ساعة.نشر Reels على Instagram عبر واجهة برمجة التطبيقات (API)كيف ينشر API من Instagram مقاطع Reels: متطلبات Meta للفيديو، والحاويات ومدة المعالجة، والمشاركة في Feed، والأغلفة، والمقاييس.تحليلات Instagram عبر واجهة برمجة التطبيقات (API): مقاييس الحساب والمنشوراتالمقاييس التي تعيدها واجهة Instagram للحساب ولكل منشور وReels وقصة، مع حدود Meta وفترات التأخير والمقاييس المعاد تسميتها.رسائل Instagram المباشرة عبر API ونافذة الـ24 ساعةطريقة عمل رسائل Instagram المباشرة عبر API: من يمكن للحساب مراسلته، ونافذة الرسائل 24 ساعة، والردود الخاصة، وإعداد السماح بالوصول.أخطاء واجهة برمجة التطبيقات (API) في Instagram: معنى الرموز الشائعةأخطاء Instagram API الشائعة ومعانيها: رموز الوصول المنتهية، وحدود المعدل، والوسائط التي لا يستطيع Meta جلبها، وحد النشر، ونوافذ الرسائل المغلقة.

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

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

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

تم التحقق في