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

دليل واجهة برمجة التطبيقات (API) لـ Instagram لعام 2026: من تطبيقك إلى أول منشور

في 2026 تأخذ واجهة برمجة التطبيقات (API) الخاصة بـ Instagram التطبيق إلى أول منشور في ست خطوات: حساب احترافي، وإعداد لتسجيل الدخول، وتطبيق Meta، وأذونات بمستوى الوصول المناسب، ثم رمز الوصول (token)، ثم حاوية وسائط تُنشأ عبر POST /<IG_ID>/media وتُنشر عبر media_publish. تأتي بعد ذلك التعليقات والرسائل المباشرة وخطاف الويب (webhook) والتحليلات وحدود Meta. وبالنسبة للتطبيقات الجديدة توصي Meta بـ Unified Login.

يحوّل easyCoexistence الخطوات من 2 إلى 5 إلى تسجيل دخول واحد عبر Instagram: يدير تطبيق Meta الخاص به تسجيل الدخول، ويجدد الرمز قبل انتهائه، ويتحقق من الحساب كل 6 ساعات، بينما ينشر Claude أو ChatGPT أو منصتك الخاصة، ويجدول، ويرد على التعليقات والرسائل المباشرة، ويقرأ التحليلات عبر واجهة Meta الرسمية.

3 setups

Unified Login، وهو الموصى به للتكاملات الجديدة، إلى جانب Instagram Login وFacebook Login، المحفوظَين للتكاملات القائمة.

New apps

لا يمكن للتطبيقات الجديدة المُنشأة في Meta إعداد Instagram API باستخدام Instagram Login، وفق دليل الترحيل الخاص بـ Meta.

60 days

المدة التي يبقى فيها رمز Instagram User طويل الأمد صالحاً، ويمكن تجديده بعد أن يبلغ 24 ساعة من إصداره.

100 posts

عدد المنشورات التي يمكن لحساب واحد نشرها عبر API خلال فترة متحركة مدتها 24 ساعة، ويُحتسب المنشور متعدد الصور منشوراً واحداً.

2 to 3 days

المدة التي تستغرقها عادةً مراجعة App Review بحسب حساب Meta، إذ تُعالج الطلبات عادةً في أقل من أسبوع.

ما الخطوات من تطبيق جديد إلى أول منشور؟

تقود ست خطوات إلى أول منشور، وأربع خطوات أخرى تحدد ما يفعله التطبيق بعده. يجب أن يكون الحساب احترافياً، ويختار التطبيق واحداً من إعدادات تسجيل الدخول الثلاثة لدى Meta، ويمنح مالك الحساب الأذونات، ويحتفظ خادم التطبيق برمز الوصول (token). ثم يتطلب النشر استدعاءين فقط. تأتي بعد ذلك التعليقات والرسائل المباشرة وwebhooks والتحليلات والحدود، وتُحيل الأقسام الأخيرة إلى الصفحة التي تغطي كل خطوة بالتفصيل.

1Professional accountBusiness or Creator, switched in the Instagram app
2Login setupUnified Login for new apps, Instagram Login for existing ones
3Meta app and permissionsStandard Access to test, Advanced Access through App Review
4Access tokenFrom the owner's sign-in, kept on the server
5First postPOST /<IG_ID>/media, then media_publish

الخطوة 1: أي حساب على Instagram يعمل مع API؟

حساب احترافي، سواء حساب نشاط تجاري أو حساب منشئ محتوى. تخدم Instagram Platform الحسابات الاحترافية فقط، ويعمل النوعان بالطريقة نفسها في النشر والتعليقات والرسائل المباشرة والتحليلات. يتحول الحساب الشخصي إلى احترافي من تطبيق Instagram ضمن خيار نوع الحساب والأدوات، ويصبح الحساب الخاص عاماً عند التحويل. ولا يحتاج Instagram Login وUnified Login إلى صفحة مرتبطة، بينما تشترط Facebook Login وجود صفحة مرتبطة.

الخطوة 2: أي إعداد لتسجيل الدخول ينبغي للتطبيق استخدامه؟

توثق Meta ثلاثة إعدادات، ويحدد الاختيار المضيف والرمز وأسماء الأذونات. توصي نظرة Meta العامة بـ Unified Login للتكاملات الجديدة، وتنص صفحة Unified Login الخاصة بها على أن ميزات Instagram API الجديدة تُطلق عبره وحده، ويذكر دليل الترحيل أن التطبيقات المُنشأة حديثاً لا يمكنها إعداد Instagram Login. ويستمر عمل تكاملات Instagram Login القائمة، دون تاريخ انتهاء معلن.

  • Unified Login: يسجل العميل الدخول عبر Instagram أو عبر Facebook Login، ويختار Business Portfolio، ويتلقى التطبيق رمز Business Integration System User.
  • Instagram Login: يسجل المالك الدخول عبر Instagram، وتذهب الاستدعاءات إلى graph.instagram.com برمز Instagram User وأذونات instagram_business_*.
  • Facebook Login: يجب ربط الحساب بصفحة يستطيع الشخص إدارتها، مع أذونات instagram_* وأذونات الصفحة.

الخطوة 3: كيف يُنشأ تطبيق Meta؟

من لوحة تحكم التطبيق في Meta، وفق مسار يعتمد على الإعداد. يبدأ دليل Unified Login لدى Meta من تطبيق يضم حالة الاستخدام Manage messaging & content on Instagram، ويملكه Business Portfolio. وضمن إعداد API مع Unified login ينشئ التطبيق تكويناً يحدد config_id الأذونات والأصول المطلوبة، ويحفظ عنوان إعادة توجيه HTTPS وينسخ رابط تسجيل الدخول. ويحتفظ تطبيق Instagram Login القائم بإعداد API مع Instagram login، حيث توجد معرّف تطبيق Instagram ومفتاحه السري.

الخطوة 4: ما الأذونات ومستوى الوصول الذي يحتاجه التطبيق؟

إذن واحد لكل ميزة، يمنحه مالك الحساب عند تسجيل الدخول. يستخدم Unified Login عائلة instagram_* مثل instagram_content_publish وinstagram_manage_comments، ويستخدم Instagram Login أسماء instagram_business_*. يغطي Standard Access، وهو الافتراضي، الحسابات التي تملكها أو تديرها والأشخاص الذين لهم دور في التطبيق. أما خدمة حسابات نشاط تجاري أخرى فتتطلب Advanced Access، يُمنح كل إذن على حدة عبر App Review، مع Business Verification.

الخطوة 5: كيف يحصل التطبيق على رمز الوصول (token)؟

من تسجيل دخول المالك، ويُستبدل على الخادم ولا يُتداول أبداً في المتصفح أو في تطبيق الجوال. مع Instagram Login، تحمل إعادة التوجيه رمزاً صالحاً لساعة واحدة ويُستخدم مرة واحدة؛ ويصبح بعدها رمزاً قصير الأمد، ثم رمزاً طويل الأمد مدته 60 يوماً ويمكن تجديده بعد مرور يوم على إصداره. ومع Unified Login، يتحول الرمز إلى رمز Business Integration System User، ويعتمد انتهاء صلاحيته على التكوين.

الخطوة 6: كيف تنشر أول منشور؟

عبر استدعاءين. يُنشئ POST /<IG_ID>/media، مع image_url عام تجلبه Meta بنفسها، حاوية؛ ويُنشر POST /<IG_ID>/media_publish بمعرّف تلك الحاوية بوصفه creation_id، ويعيد معرّف الوسائط (media ID). ويجب أن تكون الصور بصيغة JPEG. أما للريل أو أي فيديو آخر، فتحقق من status_code للحاوية حتى تصبح قيمته FINISHED، لأن النشر قبل ذلك يفشل.

A first photo post with Instagram Login
POST https://graph.instagram.com/v26.0/<IG_ID>/media
  ?image_url=https://www.example.com/images/first-post.jpg
  &caption=Hello%20from%20the%20API
  &access_token=<ACCESS_TOKEN>

{ "id": "<IG_CONTAINER_ID>" }

POST https://graph.instagram.com/v26.0/<IG_ID>/media_publish
  ?creation_id=<IG_CONTAINER_ID>
  &access_token=<ACCESS_TOKEN>

{ "id": "<IG_MEDIA_ID>" }

الخطوة 7: كيف تعمل التعليقات والرسائل المباشرة؟

يبدأ كلاهما بشخص آخر. يعيد GET /<IG_MEDIA_ID>/comments حتى 50 تعليقاً من المستوى الأعلى في كل طلب، ويرد POST /<IG_COMMENT_ID>/replies على تعليق واحد علناً، ويرسل الرد الخاص رسالة مباشرة واحدة إلى صاحب التعليق خلال 7 أيام من التعليق. تذهب الرسائل المباشرة إلى من كتبوا أولاً، ضمن نافذة قياسية مدتها 24 ساعة لمعظم الإجراءات، بعد أن يفعّل المالك الخيار Allow access to messages في تطبيق Instagram.

الخطوة 8: كيف تخبر الخطافات التطبيق بما حدث؟

ترسل Meta بيانات JSON عبر POST إلى نقطة نهاية (endpoint) تعمل بروتوكول HTTPS، وتثبت نقطة النهاية هويتها مرة واحدة بإعادة hub.challenge، وتوقّع كل حدث في الترويسة X-Hub-Signature-256 بتجزئة HMAC-SHA256 للحمولة، مع مفتاح هو سر التطبيق. يختار التطبيق حقولاً مثل comments وmessages في لوحة تحكم التطبيق في Meta، ثم يشترك في كل حساب عبر الحافة subscribed_apps. ولا تصل الإشعارات إلا إلى تطبيقات Live، وتحتاج إشعارات التعليقات إلى Advanced Access.

الخطوة 9: كيف يقرأ التطبيق التحليلات؟

من حافتين: GET /<IG_ID>/insights للحساب وGET /<IG_MEDIA_ID>/insights لمنشور أو ريل أو قصة. تأخذ مقاييس الحساب مثل reach وviews وaccounts_engaged الصيغة period=day مع metric_type=total_value. حلّ views محل impressions في 2025، وتحتاج بعض المقاييس إلى 100 متابع على الأقل، وتشير Meta إلى أن البيانات قد تتأخر حتى 48 ساعة.

الخطوة 10: ما الحدود التي تشكل التطبيق؟

تحدد Meta حدودها الرئيسية لكل حساب، فيحصل الحساب الجديد على حصته الخاصة بدلاً من مشاركة حصة واحدة:

  • الاستدعاءات: 4,800 مرة من عدد مرات ظهور الحساب في آخر 24 ساعة متحركة، لكل تطبيق وحساب، باستثناء المراسلة.
  • النشر: 100 منشور عبر API و400 حاوية وسائط لكل حساب خلال 24 ساعة.
  • المراسلة: 100 استدعاء Send API في الثانية للنص، و750 رداً خاصاً في الساعة على المنشورات والريلات.
  • الحاويات: الحاوية التي تبقى دون نشر 24 ساعة تنتهي ويجب إنشاؤها من جديد.

أي صفحة تغطي كل خطوة بالتفصيل؟

لكل خطوة صفحة مرجعية خاصة بها في هذه الوثائق، تتضمن الحقول والأخطاء والحالات الحدية التي يتجاوزها هذا الدليل. تقع المسارات أدناه تحت عنوان الموقع، وتعرض صفحة الكود استدعاءات النشر والتعليقات والتحليلات والخطافات بلغتي Python وNode.js جنباً إلى جنب:

Account type/docs/instagram/business-or-creator-account
Login setups/docs/instagram/unified-login
Meta app and access/docs/instagram/api-access, /docs/instagram/app-review
Permissions/docs/instagram/api-permissions
Tokens/docs/instagram/access-tokens
Code/docs/instagram/api-python-node
Publishing/docs/instagram/publishing-limits
Webhooks/docs/instagram/webhook-events
Insights/docs/instagram/insights-metrics
Limits/docs/instagram/api-rate-limits
When it stops working/docs/instagram/connection-lost

ما هو المسار عبر easyCoexistence؟

تسجيل دخول واحد يحل محل الخطوات من 2 إلى 5 وإعداد الخطافات. في لوحة التحكم، اختر اتصالاً جديداً ثم Instagram، وسجّل الدخول بحساب نشاط تجاري أو منشئ محتوى، ووافق على أذونات instagram_business_* الخمسة؛ يدير تطبيق Meta الخاص بـ easyCoexistence تسجيل الدخول، ويجدد الرمز، ويتحقق من الحساب كل 6 ساعات. ثم يعمل Claude أو ChatGPT أو وكيلك الخاص عبر https://easycoexistence.com/api/mcp، ويمكن لكودك أخذ معرّف الحساب وقاعدة API من get_social_credentials، ويمكن جدولة المنشورات حتى 90 يوماً مقدماً من طابور easyCoexistence.

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

  • بدء تطبيق جديد على Instagram Login. يذكر دليل الترحيل من Meta أن التطبيقات المُنشأة حديثاً لا يمكنها إعداده، وتوصي نظرة Meta العامة بـ Unified Login للتكاملات الجديدة.
  • استدعاء تكامل Unified Login برمز Instagram User. يذكر دليل الخطافات لدى Meta أن هذه الرموز وgraph.instagram.com لا تعمل مع Unified Login.
  • نشر حاوية فيديو فوراً. يفشل media_publish بالرمز الفرعي 2207027 حتى تصبح قيمة status_code للحاوية FINISHED.
  • استطلاع التعليقات والرسائل المباشرة بالسحب المتكرر. توصي Meta بالخطافات، لأنها تقلل عدد الاستدعاءات التي يرسلها التطبيق وخطر تعرضه لتقييد المعدل.
إنجاز ذلك باستخدام EasyCoexistence

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

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

كم يستغرق الحصول على وصول Instagram API؟

بالنسبة للحسابات التي تملكها أو تديرها، لا انتظار: يعمل Standard Access منذ البداية. أما خدمة حسابات نشاط تجاري أخرى فتتطلب App Review، وتقول Meta إن مراجعته عادةً تستغرق أقل من أسبوع، مع Business Verification.

هل يمكن لتطبيق Meta جديد أن يستخدم Instagram Login؟

لا، وفق دليل الترحيل لدى Meta الذي ينص على أن التطبيقات المُنشأة حديثاً لا يمكنها إعداده. تستمر تكاملات Instagram Login القائمة في العمل، ولم تعلن Meta أي تاريخ انتهاء.

هل يمكن لـ API نشر ملف من حاسوبي؟

لا مع Instagram Login، حيث تجلب Meta كل صورة أو فيديو من عنوان URL عام. وتوثق Meta الرفع القابل للاستئناف، الذي يقبل ملف فيديو محلياً، للإعدادات المبنية على Facebook Login for Business، بما فيها Unified Login.

كم تكلف easyCoexistence لحساب Instagram؟

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

تابع القراءة

Unified Login من Meta لـ Instagram: ما هو وماذا يتغير للتطبيقات في 2026ما هي واجهة Instagram API مع Unified Login، وكيف تختلف عن Instagram Login، وما الذي تنفرد به، وما على التطبيقات القائمة فعله في 2026.Instagram API في Python وNode.js: أمثلة عمليةأمثلة Python وNode.js تعمل للـ Instagram API: نشر صورة وReel، والرد على التعليقات، وقراءة الإحصاءات، والتحقق من خطاف الويب (webhook) ومعالجة الأخطاء.لماذا يتوقف اتصال واجهة برمجة التطبيقات (API) بـ Instagram، وكيف تُبقيه فعّالًاأسباب توقف اتصال Instagram API: انتهاء صلاحية الرمز، تغيير كلمة المرور، إزالة إذن أو تطبيق، تحويل الحساب إلى شخصي، أو تقييد الحساب، وحل كل حالة.كيف تحصل على وصول Instagram API في 2026طريقتان للحصول على وصول Instagram API في 2026: تطبيق Meta خاص بك مع Instagram Login ومراجعة التطبيق، أو تطبيق مزود معتمد يتولى ذلك عنك.رموز وصول Instagram: رموز طويلة الأجل لمدة 60 يومًا وتجديدهاكيف تعمل رموز وصول Instagram Login: رمز قصير الأجل صالح ساعة بعد تسجيل الدخول، ورمز طويل الأجل صالح 60 يومًا، وتجديده بعد 24 ساعة.حدود النشر في Instagram API: الصيغ والأحجام والمنشورات في اليومما يحتويه منشور Instagram API وكم منشورًا يمكن نشره يوميًا: صور JPEG حتى 8 MB وReels وStories وتسميات حتى 2,200 حرف و100 منشور كل 24 ساعة.

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

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

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

تم التحقق في