كيف تتيح لعملائك ربط 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، فيتمكن تطبيقك من النشر وقراءة التعليقات والرد على الرسائل المباشرة.
الحد الأقصى لعدد المنشورات التي يمكن لحساب Instagram نشرها عبر واجهة برمجة التطبيقات (API) خلال أي 24 ساعة متحركة، ويُحتسب carousel واحد منشورًا واحدًا.
صيغة الصور الوحيدة التي تدعمها Meta للنشر على Instagram عبر API.
المدة القياسية للرد على الرسالة المباشرة (DM) على Instagram لمعظم إجراءات المستخدم، ويجب أن يكون الشخص قد كتب أولًا.
عدد الرسائل التي يمكن للحساب إرسالها إلى من علّق عبر الرد الخاص، خلال 7 أيام من التعليق.
المدة التي يبقى فيها رابط الربط في easyCoexistence صالحًا قبل انتهاء الجلسة.
ماذا يفعل العميل ليتم الربط؟
يضغط زرًا واحدًا. ينشئ تطبيقك الجلسة بقيمة channel هي instagram، مع redirect_url ومعرّف عميلك كقيمة external_ref، ثم يرسل العميل إلى عنوان URL الخاص بها. تعرض الصفحة المستضافة اسمك وزر «المتابعة عبر Instagram»، الذي يفتح تسجيل الدخول الخاص بـ Instagram في النافذة نفسها، فيعمل على الهواتف أيضًا. يوافق العميل على الوصول فيعود إلى redirect_url مع status=connected وchannel_id، ويؤكد خادمك ذلك عبر GET /connect-sessions/{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 يومًا قادمة.
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 لعملائك ربط 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 أيام مجانًا.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في