إشارات @mentions على Instagram عبر API: استقبالها والرد عليها
تبلغ واجهة برمجة التطبيقات (API) الخاصة بـ Instagram عن إشارات @ لحساب احترافي في التعليقات والتسميات التوضيحية على المنشورات العامة، وتتيح للحساب الرد في المكان نفسه. مع Instagram Login تصل الإشارات عبر خطاف الويب (webhook) للتعليقات، ويتم الرد عبر POST /<IG_ID>/mentions مع معرّف الوسائط media ID، ومعرّف التعليق comment ID عند الرد على تعليق، فينشر الرد تعليقًا في المكان نفسه.
يمرر easyCoexistence تعليقات حساب Instagram وإشاراته ورسائله المباشرة إلى نقطة النهاية (endpoint) الخاصة بك فور وصولها، موقعة بسر خاص بذلك الحساب، بعد ضبطه باستخدام set_social_webhook_destination.
إشعار webhook يتضمن الإشارات للتطبيقات التي تستخدم Instagram Login.
نقطة النهاية (endpoint) التي ترد على تعليق أو تسمية توضيحية أشار فيها مستخدم Instagram آخر إلى الحساب بـ @.
لا يُطلق أي webhook لتعليق أو إشارة @ على وسائط يملكها حساب خاص.
الأذونات المطلوبة للإشارات مع Instagram Login هي instagram_business_basic و instagram_business_manage_comments.
كيف تصل الإشارات؟
عبر webhook فور حدوثها. مع Instagram Login، تُدرج Meta الإشارات ضمن إشعار التعليقات بدلًا من إرسال حقل mentions منفصل، فيقرأ المعالج الإشارات من الأحداث نفسها التي تصل فيها التعليقات الجديدة. لا تحتفظ Meta بسجل للإشعارات السابقة، لذا احفظ ما تحتاجه من كل إشعار فور وصوله.
ما الإشارات التي تغطيها الواجهة؟
تحدد واجهة الإشارات لدى Meta التسميات التوضيحية والتعليقات والوسائط التي أُشير فيها إلى حساب نشاط تجاري أو منشئ محتوى بـ @ أو وُسم فيها:
- إشارات @ في التعليقات.
- إشارات @ في التسمية التوضيحية لمنشور.
- الوسائط التي وُسم فيها الحساب، والتي تُعرض عبر GET /<
IG_ID>/tags، ولا يُدعم التعليق على الصور التي وُسم فيها الحساب فقط. - ليست القصص: لا تدعم واجهة الإشارات القصص، وتصل إشارة القصة إلى الحساب كرسالة مباشرة نوع مرفقها
story_mention. - ليست الحسابات الخاصة: لا ترسل الوسائط التي يملكها حساب خاص أي webhook للإشارات.
كيف ترد على إشارة؟
عبر POST /<IG_ID>/mentions. للإشارة في تعليق، أرسل media_id و comment_id مع الرسالة، فيظهر الرد في سلسلة ذلك التعليق. وللإشارة في تسمية توضيحية، أرسل media_id والرسالة، فيُنشر الرد تعليقًا على الوسائط. يأتي المعرّفان من إشعار webhook.
POST https://graph.instagram.com/<IG_ID>/mentions
?media_id=<MEDIA_ID>
&comment_id=<COMMENT_ID>
&message=<REPLY_TEXT>ماذا تحتاج الإشارات؟
مع Instagram Login، يلزم الإذنان instagram_business_basic و instagram_business_manage_comments، وهما الإذنان نفسهما اللذان تستخدمهما إدارة التعليقات، مع توجيه الاستدعاءات إلى graph.instagram.com. ولخدمة الحسابات الاحترافية التي لا يملكها المطور أو لا يديرها، يحتاج التطبيق أيضًا إلى الوصول المتقدم (Advanced Access).
الأخطاء الشائعة
- انتظار حدث إشارات منفصل مع Instagram Login. تسلّم Meta الإشارات داخل إشعار التعليقات.
- الرد على إشارة في منشور لحساب آخر كما لو كان تعليقًا على منشورك. مسار Meta لذلك هو POST /<IG_ID>/mentions، مع معرّف الوسائط، ومعرّف التعليق عند الرد على تعليق.
- توقع إشارات القصص من واجهة الإشارات. لا تدعمها Meta هناك، إذ تصل إلى الحساب كرسائل مباشرة.
- الاعتماد على webhook لإعادة إشارات قديمة. لا تحتفظ Meta بسجل للإشعارات، لذا احفظ كل إشارة فور وصولها.
وتردّ أدواته على التعليقات على منشوراتك الخاصة عبر reply_to_comment؛ أما الرد على إشارة في منشور شخص آخر، وهو ما يستخدم نقطة نهاية الإشارات لدى Meta، فليس من بينها. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل يمكنني التعليق على صورة وُسم فيها حسابي؟
لا. تعرض GET /<IG_ID>/tags الوسائط التي وُسم فيها الحساب، لكن Meta لا تدعم التعليق على الصور التي وُسم فيها الحساب فقط.
هل يمكنني الرد على إشارة في منشور لشخص آخر؟
نعم. يُنشر الرد باسم الحساب عبر POST /<IG_ID>/mentions مع معرّف الوسائط، ومعرّف التعليق عندما تكون الإشارة في تعليق.
هل إشارات القصص متاحة عبر واجهة الإشارات؟
لا. تصل إشارة القصة إلى الحساب كرسالة مباشرة نوع مرفقها story_mention، ويمكن الرد عليها في تلك المحادثة.
لماذا لم تصل إشارة قط؟
قد تكون الوسائط تابعة لحساب خاص، وهذا لا يرسل إشعارات الإشارات، أو قد تكون الإشارة في قصة، وواجهة الإشارات لا تغطيها.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في