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

إشارات @mentions على Instagram عبر API: استقبالها والرد عليها

تبلغ واجهة برمجة التطبيقات (API) الخاصة بـ Instagram عن إشارات @ لحساب احترافي في التعليقات والتسميات التوضيحية على المنشورات العامة، وتتيح للحساب الرد في المكان نفسه. مع Instagram Login تصل الإشارات عبر خطاف الويب (webhook) للتعليقات، ويتم الرد عبر POST /<IG_ID>/mentions مع معرّف الوسائط media ID، ومعرّف التعليق comment ID عند الرد على تعليق، فينشر الرد تعليقًا في المكان نفسه.

يمرر easyCoexistence تعليقات حساب Instagram وإشاراته ورسائله المباشرة إلى نقطة النهاية (endpoint) الخاصة بك فور وصولها، موقعة بسر خاص بذلك الحساب، بعد ضبطه باستخدام set_social_webhook_destination.

comments

إشعار webhook يتضمن الإشارات للتطبيقات التي تستخدم Instagram Login.

POST /mentions

نقطة النهاية (endpoint) التي ترد على تعليق أو تسمية توضيحية أشار فيها مستخدم Instagram آخر إلى الحساب بـ @.

Private

لا يُطلق أي webhook لتعليق أو إشارة @ على وسائط يملكها حساب خاص.

2

الأذونات المطلوبة للإشارات مع 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.

Replying to a mention in a comment
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 بسجل للإشعارات، لذا احفظ كل إشارة فور وصولها.
إنجاز ذلك باستخدام EasyCoexistence

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

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

هل يمكنني التعليق على صورة وُسم فيها حسابي؟

لا. تعرض GET /<IG_ID>/tags الوسائط التي وُسم فيها الحساب، لكن Meta لا تدعم التعليق على الصور التي وُسم فيها الحساب فقط.

هل يمكنني الرد على إشارة في منشور لشخص آخر؟

نعم. يُنشر الرد باسم الحساب عبر POST /<IG_ID>/mentions مع معرّف الوسائط، ومعرّف التعليق عندما تكون الإشارة في تعليق.

هل إشارات القصص متاحة عبر واجهة الإشارات؟

لا. تصل إشارة القصة إلى الحساب كرسالة مباشرة نوع مرفقها story_mention، ويمكن الرد عليها في تلك المحادثة.

لماذا لم تصل إشارة قط؟

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

تابع القراءة

واجهة برمجة التطبيقات (API) للردود الخاصة على Instagram: الرد على تعليق برسالة مباشرةأرسل ردًا خاصًا على Instagram عبر API من Meta: POST /<IG_ID>/messages بمعرّف التعليق، مرة واحدة لكل تعليق خلال 7 أيام، ويعيد الخطأ 2534025 عند تعذّر ذلك.أذونات واجهة برمجة التطبيقات (API) في Instagram: النطاقات وراء كل ميزةالأذونات التي تستخدمها Instagram API مع تسجيل الدخول عبر Instagram، من instagram_business_basic إلى manage_insights، وأي ميزة تحتاج أيّاً منها.أحداث Instagram عبر خطاف الويب (webhook): التعليقات والإشارات والرسائل المباشرةكيف تصل تعليقات Instagram والإشارات والرسائل المباشرة إلى نقطة النهاية (endpoint) كأحداث webhook، وما تحمله كل حمولة، وكيف يُوقَّع كل تسليم.إدارة تعليقات Instagram عبر واجهة برمجة التطبيقات (API)كيف تقرأ واجهة Instagram البرمجية التعليقات وترد عليها وتخفيها وتحذفها: ردود علنية، ورد خاص واحد لكل تعليق خلال 7 أيام، والقواعد المعمول بها.رسائل Instagram المباشرة عبر API ونافذة الـ24 ساعةطريقة عمل رسائل Instagram المباشرة عبر API: من يمكن للحساب مراسلته، ونافذة الرسائل 24 ساعة، والردود الخاصة، وإعداد السماح بالوصول.webhook التعليقات على Instagram: الحمولة، حقلاً حقلاًما يرسله webhook التعليقات في Instagram عند التعليق على منشورات الحساب وReels: الحمولة حقلاً حقلاً، وما تغفله، والمحاذير.

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

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

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

تم التحقق في