عمليات الذِكر

يمكنك تحديد الشروحات التوضيحية والتعليقات ووسائط IG التي تمت بها الإشارة إلى الاسم المستعار لحساب Instagram للأعمال أو لحساب منشئ المحتوى على Instagram أو @ذكره.

القيود

  • عمليات الذكر في القصص غير مدعومة.
  • يكون التعليق على الصور التي تمت فيها الإشارة إليك غير مدعوم.
  • لن يتم إرسال أحداث Webhooks في حالة إنشاء الوسائط التي يظهر التعليق أو @الذكر عليها من قِبل حساب يتم تعيينه إلى خاص.

نقاط النهاية

تتكون واجهة API من نقاط النهاية التالية:

  • GET /{ig-user-id}/tags — يمكن استخدامه للحصول على كائنات الوسائط التي تمت فيها الإشارة إلى حساب الأعمال أو حساب منشئ المحتوى
  • GET /{ig-user-id}?fields=mentioned_comment — يمكن استخدامه للحصول على بيانات حول التعليق الذي تم فيه @ذكر حساب الأعمال أو حساب منشئ المحتوى
  • GET /{ig-user-id}?fields=mentioned_media — يمكن استخدامه للحصول على بيانات حول كائن الوسائط الذي تم فيه @ذكر حساب الأعمال أو حساب منشئ المحتوى ضمن الشرح التوضيحي
  • POST /{ig-user-id}/mentions — يمكن استخدامه للرد على تعليق أو شرح توضيحي لكائن الوسائط الذي تم فيه @ذكر حساب الأعمال أو حساب منشئ المحتوى بواسطة مستخدم Instagram آخر

يمكنك الرجوع إلى المستند المرجعي لكل نقطة نهاية للحصول على تعليمات الاستخدام.

أحداث Webhooks

اشترك في الحقل mentions لتلقي إشعارات أحداث Webhooks في Instagram عندما يذكر مستخدم Instagram حساب Instagram للأعمال أو حساب منشئ المحتوى على Instagram. ولاحظ أننا لا نخزن البيانات المتعلقة بإشعارات أحداث Webhooks، لذلك إذا كنت تحاول إعداد Webhook يسجّل عمليات الذِكر، فيجب عليك تخزين أي بيانات يتم تلقيها إذا كنت تخطط لاستخدامها لاحقًا.

الأمثلة

تسجيل @عمليات الذِكر في التعليق والرد عليها

يمكنك تسجيل @عمليات الذِكر في التعليق والرد على أي عمليات ذِكر تلبي المعايير التي تحددها:

  1. يمكنك إعداد حدث webhook في Instagram يكون مشتركًا في الحقل mentions.
  2. يمكنك إعداد برنامج نصي يمكنه تحليل إشعارات أحداث Webhooks وتحديد معرفات التعليقات.
  3. يمكنك استخدام المعرفات للاستعلام عن نقطة النهاية GET /{ig-user-id}/mentioned_comment للحصول على المزيد من المعلومات حول كل تعليق.
  4. يمكنك تحليل النتائج التي تم إرجاعها لتحديد التعليقات التي تلبي المعايير التي تحددها.
  5. يمكنك استخدام نقطة النهاية POST /{ig-user-id}/mentions من أجل الرد على هذه التعليقات.

سيظهر الرد في صورة تعليق تابع لسلسلة فرعية على التعليق الذي تم فيه ذكر حساب الأعمال أو حساب منشئ المحتوى.

تسجيل @عمليات الذِكر في الشرح التوضيحي والرد عليها

يمكنك تسجيل @عمليات الذِكر في الشرح التوضيحي والرد على أي عمليات ذِكر تلبي المعايير التي تحددها:

  1. يمكنك إعداد حدث webhook في Instagram يكون مشتركًا في الحقل mentions.
  2. يمكنك إعداد برنامج نصي يمكنه تحليل إشعارات أحداث Webhooks وتحديد معرفات الوسائط.
  3. يمكنك استخدام المعرفات للاستعلام عن نقطة النهاية GET /{ig-user-id}/mentioned_media لمعرفة المزيد من المعلومات حول كل كائن وسائط.
  4. يمكنك تحليل النتائج التي تم إرجاعها لتحديد كائنات الوسائط التي تتضمن شروحات توضيحية تلبي المعايير التي تحددها.
  5. يمكنك استخدام نقطة النهاية POST /{ig-user-id}/mentions من أجل التعليق على كائنات الوسائط هذه.