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

كيف تتيح لعملائك ربط Instagram بتطبيقك

يستدعي الخادم الخلفي لتطبيقك POST /connect-sessions في easyCoexistence مع channel بقيمة instagram، ويوجّه العميل إلى عنوان URL المُعاد، حيث يسجل الدخول عبر Instagram Login بحساب Business أو Creator. يعود العميل إلى redirect_url لديك مع channel_id، ويعيد GET /channels/{id}?credentials=1 رمز الوصول (token) لـ graph.instagram.com، فيتمكن تطبيقك من النشر وقراءة التعليقات والرد على الرسائل المباشرة.

100 posts

الحد الأقصى لعدد المنشورات التي يمكن لحساب Instagram نشرها عبر واجهة برمجة التطبيقات (API) خلال أي 24 ساعة متحركة، ويُحتسب carousel واحد منشورًا واحدًا.

JPEG

صيغة الصور الوحيدة التي تدعمها Meta للنشر على Instagram عبر API.

24 hours

المدة القياسية للرد على الرسالة المباشرة (DM) على Instagram لمعظم إجراءات المستخدم، ويجب أن يكون الشخص قد كتب أولًا.

1 private reply

عدد الرسائل التي يمكن للحساب إرسالها إلى من علّق عبر الرد الخاص، خلال 7 أيام من التعليق.

1 hour

المدة التي يبقى فيها رابط الربط في easyCoexistence صالحًا قبل انتهاء الجلسة.

ماذا يفعل العميل ليتم الربط؟

يضغط زرًا واحدًا. ينشئ تطبيقك الجلسة بقيمة channel هي instagram، مع redirect_url ومعرّف عميلك كقيمة external_ref، ثم يرسل العميل إلى عنوان URL الخاص بها. تعرض الصفحة المستضافة اسمك وزر «المتابعة عبر Instagram»، الذي يفتح تسجيل الدخول الخاص بـ Instagram في النافذة نفسها، فيعمل على الهواتف أيضًا. يوافق العميل على الوصول فيعود إلى redirect_url مع status=connected وchannel_id، ويؤكد خادمك ذلك عبر GET /connect-sessions/{id}.

1Your appPOST /connect-sessions with channel instagram
2Hosted pageYour name and Continue with Instagram
3Instagram LoginThe professional account approves access
4Back to youredirect_url with status and channel_id

أي حسابات Instagram يمكنها الربط؟

الحسابات الاحترافية، أي Business أو Creator، وهي ما تخدمه واجهة Instagram API من Meta. يُرفض الحساب المربوط بالفعل عبر خدمة أخرى تستخدم easyCoexistence، ويوضح last_error في الجلسة ذلك، فيزيله العميل من هناك أولًا، أو يسجل الدخول بحساب آخر. وفي حالة الرسائل المباشرة، يجب أيضًا تفعيل «السماح بالوصول إلى الرسائل» في تطبيق Instagram، ويشرح دليل ربط Instagram المسار.

ما الرمز الذي يحصل عليه تطبيقك؟

رمز الوصول (token) لمستخدم Instagram لـ graph.instagram.com/v25.0، مع account_id_on_meta، وهو معرّف حساب Instagram، من GET /channels/{id}?credentials=1. يجدد easyCoexistence الرمز قبل انتهاء مدة 60 يومًا بوقت كافٍ، والتجديد يصدر رمزًا جديدًا؛ لذا اطلب بيانات الاعتماد عند بداية كل مهمة بدلًا من الاحتفاظ بنسخة واحدة.

كيف ينشر تطبيقك على الحساب؟

عبر POST /channels/{id}/posts. يختار ig_type بين IMAGE وCAROUSEL وREELS وSTORIES، ويُستنتج من الوسائط إذا حذفته: فعدة ملفات تكوّن carousel، وفيديو واحد يكوّن Reel. يتراوح carousel هنا بين 2 و10 عناصر، ويجب أن تكون الصور بصيغة JPEG، ويصل النص إلى 2,200 حرف، ولا يملك منشور Instagram حقل رابط. بدون publish_at يُنشر الآن، ومع الحقل ينشر في الوقت المحدد، حتى 90 يومًا قادمة.

A carousel on the customer's Instagram account
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ig_post_2291" \
  -d '{
    "text": "Three looks for the weekend.",
    "ig_type": "CAROUSEL",
    "media": [
      { "url": "https://cdn.example.com/look-1.jpg", "type": "image" },
      { "url": "https://cdn.example.com/look-2.jpg", "type": "image" },
      { "url": "https://cdn.example.com/look-3.jpg", "type": "image" }
    ]
  }'

كيف تصل التعليقات والرسائل المباشرة إلى تطبيقك؟

بعد تحديد وجهة. يعيد PUT /channels/{id}/webhook مع عنوان URL الخاص بك المفتاح السري للتوقيع الخاص بالحساب، ومن ذلك الحين تُرسل تعليقاته وإشاراته ورسائله المباشرة فور وصولها، موقّعة بالترويسة X-EC-Signature. يحتوي الجسم على platform وaccount_id وexternal_id، وإدخال webhook الخاص بـ Meta كما هو دون تغيير، مع changes للتعليقات والإشارات، وmessaging للرسائل المباشرة.

كيف يرد تطبيقك على التعليقات والرسائل المباشرة؟

عبر واجهة Instagram API من Meta على graph.instagram.com، باستخدام token الخاص بالعميل، فيصدر كل رد من حساب العميل:

  • الرد على تعليق: POST /<IG_COMMENT_ID>/replies مع message.
  • الرد على رسالة مباشرة: POST /<IG_ID>/messages مع recipient بقيمة معرّف الشخص ونص الرسالة، خلال 24 ساعة من آخر رسالة منه.
  • الرد الخاص على تعليق: المسار messages نفسه مع recipient بقيمة comment_id، مرة واحدة لكل تعليق، خلال 7 أيام منه.
  • إخفاء التعليق أو حذفه: POST أو DELETE على /<IG_COMMENT_ID>.

ماذا يحدث عند انتهاء وصول العميل؟

يستقبل عنوان URL الخاص بالأحداث لديك الحدث channel.disconnected عندما يرفض Instagram الرمز، أو عندما يسحب المالك الوصول من إعدادات Instagram. وتعيد جلسة ربط جديدة لذلك العميل الحساب. ولإنهائه من جهتك، يلغي DELETE /channels/{id} الوصول على مستوى الشبكة ويلغي المنشورات المنتظرة في الطابور، وتتوقف الفوترة في نهاية الدورة.

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

  • إرسال صور PNG أو WebP إلى Instagram. تنشر Meta صيغة JPEG فقط، فيُرفض المنشور قبل إدراجه في الطابور؛ حوّل الصور أولًا.
  • إضافة حقل رابط إلى منشور Instagram. لا تحمل منشورات Instagram روابط، فيُرفض الطلب؛ ضع الرابط داخل النص.
  • عرض زر رد على رسائل مباشرة أقدم من 24 ساعة. تسمح Meta بالرد ضمن النافذة التي فتحتها آخر رسالة من الشخص.
  • إرسال رد خاص ثانٍ على التعليق نفسه. تسمح Meta برد واحد، وينتظر أي رد لاحق حتى يرد الشخص.
إنجاز ذلك باستخدام EasyCoexistence

يتيح easyCoexistence لعملائك ربط Instagram بتطبيقك عبر تسجيل دخول مستضاف واحد، ثم يمنح خادمك token مجددًا، ونقطة النهاية (endpoint) للمنشورات، وتعليقاتهم ورسائلهم المباشرة عبر webhook، مع مراقبة كل اتصال على مدار الساعة. وتغطي الاستدعاءات نفسها WhatsApp وFacebook وTikTok وYouTube وLinkedIn وقنوات أخرى. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض كلما أضفت اتصالات، مع أول 3 أيام مجانًا.

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

هل أحتاج إلى تطبيق Meta الخاص بي لربط حسابات Instagram لعملائي؟

لا. يسجل العملاء الدخول عبر تطبيق easyCoexistence، ويستلم خادمك الخلفي token لواجهة Instagram API من Meta عبر استدعاء بيانات الاعتماد.

هل يمكن للعميل ربط عدة حسابات Instagram؟

نعم، حساب واحد لكل تسجيل دخول. أنشئ جلسة ربط لكل حساب بالقيمة external_ref نفسها، وتعرض GET /channels?external_ref= كل حسابات ذلك العميل.

هل يمكن لتطبيقي جدولة قصص Instagram؟

نعم. اضبط ig_type على STORIES مع صورة أو فيديو واحد ووقت publish_at، وسينشره الطابور في ذلك الوقت.

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

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

تابع القراءة

واجهة برمجة وسائل التواصل بعلامتك: أضف النشر والتعليقات والرسائل المباشرة إلى تطبيق SaaS تحت علامتك التجاريةأضف النشر والتعليقات والرسائل المباشرة إلى تطبيقك: ما يراه عملاؤك، وأين يظهر اسم easyCoexistence، والاستدعاءات خلفه.كيف تضيف النشر على TikTok إلى منتج SaaS الخاص بكأضف النشر على TikTok إلى SaaS: اربط حساب كل عميل، وانشر فيديوهات أو صورًا الآن أو لاحقًا بطلب واحد، وتابع كل منشور حتى يُنشر.كيفية إضافة WhatsApp إلى SaaS باستخدام Embedded Signup و Coexistenceأضف WhatsApp إلى SaaS: اربط أرقام العملاء بـ Embedded Signup وCoexistence، واستقبل الرسائل، وردّ داخل نافذة 24 ساعة، وأرسل القوالب.كيفية ربط حساب Instagram بواجهة API أو وكيل ذكاء اصطناعيكيفية ربط حساب Instagram بواجهة API أو وكيل ذكاء اصطناعي: تسجيل الدخول عبر Instagram، وصلاحيات كل ميزة، والسماح بالوصول إلى الرسائل وروابط الربط.رسائل Instagram المباشرة عبر API ونافذة الـ24 ساعةطريقة عمل رسائل Instagram المباشرة عبر API: من يمكن للحساب مراسلته، ونافذة الرسائل 24 ساعة، والردود الخاصة، وإعداد السماح بالوصول.كيف تستقبل عبر خطاف الويب (webhook) رسائل عملائك على WhatsApp وتعليقات مواقع التواصلwebhook لكل اتصال: رسائل WhatsApp مباشرة من Meta موثّقة بسر في عنوان URL، وتعليقات ورسائل مباشرة من منصات التواصل موقّعة بترويسة X-EC-Signature لكل حساب.

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

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

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

تم التحقق في