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

خطاف الويب (webhook) live_comments في Instagram: التعليقات أثناء البث المباشر

يُعلم حقل live_comments في webhook الخاص بـ Instagram التطبيقَ بالتعليقات على البث المباشر للحساب الاحترافي أثناء بثه. يصل كل تعليق كعنصر في changes حقله live_comments، وبالشكل نفسه لبيانات حقل comments: معرّف التعليق ونصه، ومعرّف Instagram المحدد لنطاق التطبيق للمؤلف واسمه في from، ومعرّف الوسائط. تتوقف الإشعارات عند انتهاء البث.

يشترك easyCoexistence في comments وmessages وmentions لكل حساب Instagram متصل، ويمرر التعليقات على منشوراته وReels إلى endpoint في HTTPS الخاصة بك فور وصولها، موقّعةً بسر ذلك الحساب.

Advanced Access

يتطلب إشعارات live_comments ما يتطلبه comments، ولا ترسل الوسائط التي يملكها حساب خاص أي إشعارات.

100/sec

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

Broadcast end

متى تتوقف إشعارات التعليقات لوسائط البث المباشر.

During the Live

متى يمكن إرسال رد خاص على تعليق في البث المباشر، فبعد انتهاء البث لم يعد ذلك ممكنًا.

9 Nov 2021

live_comments: متى قدّمته Meta، للتعليقات على الفيديوهات المباشرة أثناء بثها.

live_comments: متى يُطلَق؟

يصل التعليق عندما يعلّق أحد على فيديو البث المباشر للحساب الاحترافي أثناء بثه، بعد اشتراك التطبيق والحساب في الحقل. وهو منفصل عن comments: التعليق على منشور أو Reel أو Story أو إعلان يصل عبر comments، والتعليق أثناء البث يصل عبر live_comments. تتوقف إشعارات الوسائط المباشرة عند انتهاء البث، ولا ترسل الوسائط التي يملكها حساب خاص أي إشعار.

live_comments: كيف يبدو الإشعار؟

هيكل الإشعار للتعليق نفسه: object بقيمة instagram، وسطر entry لكل حساب، ومصفوفة changes يكون حقلها live_comments. وتعرض وثيقة Meta الخاصة بتسجيل الدخول عبر Instagram شكل قيمة واحدًا للتعليقات و live_comments، لذلك يُميز اسم الحقل بينهما:

A live_comments notification, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000,
      "changes": [
        {
          "field": "live_comments",
          "value": {
            "id": "<COMMENT_ID>",
            "text": "<COMMENT_TEXT>",
            "from": {
              "id": "<INSTAGRAM_SCOPED_ID>",
              "username": "<USERNAME>"
            },
            "media": {
              "id": "<LIVE_MEDIA_ID>",
              "media_product_type": "<MEDIA_PRODUCT_TYPE>"
            }
          }
        }
      ]
    }
  ]
}

ما معنى كل حقل؟

الحقول التي تسردها وثيقة Meta المرجعية لـ live_comments، من الخارج إلى الداخل:

  • entry[].id: الحساب الاحترافي. entry[].time: وقت إرسال Meta للإشعار، لا وقت كتابة التعليق.
  • changes[].field: live_comments. تحقق منه قبل قراءة value، لأن شكل البيانات يطابق شكل comments.
  • value.id: معرّف التعليق، وهو المعرّف الذي يُوجَّه إليه الرد الخاص.
  • value.text: نص التعليق.
  • value.from.id و value.from.username: معرّف المؤلف المحدد لنطاق Instagram واسمه، ويظهر from.self_ig_scoped_id عندما يعلّق الحساب على نفسه.
  • value.media.id و value.media.media_product_type: الفيديو المباشر والمكان الذي يظهر فيه.
  • value.parent_id: في المرجع، للتعليق الذي يرد على تعليق آخر.

live_comments: ما الفرق عن comments؟

الحمولة متطابقة، لكن القواعد مختلفة. تعامل مراجع التعليقات في Meta التعليقات على الفيديو المباشر كحالة قائمة بذاتها، وتعطيها حدود المعدل وقواعد الردود الخاصة أرقامًا مختلفة. فيما يلي جنبًا إلى جنب، مع حقل comments في العمود الأول:

commentslive_comments
Fires forComments on posts, Reels, Stories and adsComments on a Live while it broadcasts
NotificationsAs each comment is madeStop when the broadcast ends
Public replyPOST /<COMMENT_ID>/repliesNot supported on live video
Hide or deleteSupportedNot supported on live video
Private replyWithin 7 days of the commentOnly during the broadcast
Private reply rate750 per hour per account100 per second per account

كيف ترد على تعليق من بث مباشر؟

بردّ خاص، أثناء البث. يؤدي الطلب POST /<IG_ID>/messages مع recipient.comment_id مساويًا لمعرّف التعليق إلى إرسال رسالة مباشرة واحدة لصاحبه، تصل إلى صندوق الوارد إن كان يتابع الحساب، وإلى طلبات الرسائل إن لم يكن يتابعه. وتستبعد مراجع Meta المسارات العامة على الفيديو المباشر، فالرد على التعليقات أو إنشاؤها أو إخفاؤها أو حذفها هناك غير مدعوم. وبعد انتهاء البث لا يمكن إرسال ردود خاصة على تعليقاته.

A private reply to a Live comment
POST https://graph.instagram.com/<IG_ID>/messages
Authorization: Bearer <INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json

{
  "recipient": { "comment_id": "<COMMENT_ID>" },
  "message": { "text": "<REPLY_TEXT>" }
}

هل تُقرأ تعليقات البث دون الاعتماد على الإشعارات؟

فقط ما دام البث مستمرًا. تنص مرجعية التعليقات في Meta على أن التعليقات على الفيديو المباشر لا يمكن قراءتها إلا أثناء بث الوسائط، وتقول مرجعية الوسائط الشيء نفسه عن الفيديو المباشر ذاته. أما الحافة live_media، التي تسرد البث المباشر الحالي للحساب، فموثقة لتسجيل الدخول عبر Facebook على graph.facebook.com. ولا تحتفظ Meta بسجل إشعارات يمكن الاستعلام عنه، لذا احفظ ما تحتاجه من كل حدث فور وصوله.

live_comments: ما الذي يحتاجه؟

مع Instagram Login: instagram_business_basic و instagram_business_manage_comments، وهما الزوج نفسه المستخدم مع comments، إضافة إلى الوصول المتقدم Advanced Access الذي تشترطه Meta لإشعارات comments وlive_comments. يبدأ منتج Instagram الجديد في لوحة تحكم التطبيق مشتركًا في live_comments تلقائيًا، ويُشترك كل حساب عبر POST /<IG_ID>/subscribed_apps. ويجب أن يكون حساب مالك البث عامًا.

هل يُمرّر easyCoexistence تعليقات البث المباشر؟

لا. يشترك تطبيق easyCoexistence وكل حساب متصل في التعليقات والرسائل والإشارات، لا في live_comments، لذلك لا تُمرَّر التعليقات التي تُكتب أثناء البث المباشر. أما التعليقات على المنشورات وReels فتُمرَّر، ويمكن لـ reply_to_comment وhide_comment وقواعد comment-to-DM والأتمتة أن تتصرف فيها.

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

  • انتظار تعليقات البث في حقل comments. فهي تصل عبر live_comments، ويجب تفعيل هذا الحقل في التطبيق.
  • الرد علنًا على تعليق من البث المباشر. لا تدعم Meta الردود أو الإخفاء أو الحذف على تعليقات الفيديو المباشر، والطريق هو الرد الخاص أثناء البث.
  • تأجيل الردود الخاصة إلى ما بعد البث. بعد انتهاء البث لا يمكن إرسالها، لذا رد أثناء بثه.
  • معاملة live_comments كسجل. تتوقف الإشعارات عند انتهاء البث، ولا تحتفظ Meta بسجل تستعلم عنه، لذا احفظ ما تحتاجه فور وصول كل إشعار.
إنجاز ذلك باستخدام EasyCoexistence

ويتيح reply_to_comment الرد علنًا أو بردّ خاص، وتعمل قواعد comment-to-DM على مدار الساعة. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.

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

هل يتضمن webhook التعليقات على Instagram تعليقات البث المباشر؟

لا. تصل التعليقات التي تُكتب أثناء البث المباشر على الحقل المنفصل live_comments، وبالشكل نفسه في البيانات.

live_comments: متى أضافته Meta؟

في 9 نوفمبر 2021، للتعليقات على الفيديوهات المباشرة أثناء بثها.

لماذا توقف webhook الخاص بـ live_comments عن العمل؟

الأرجح أن البث قد انتهى، فذلك يوقف إشعارات التعليقات لوسائط البث. وإن لم يبدأ البث أصلًا، فتحقق من Advanced Access واشتراك الحساب وأن الحساب عام.

كم عدد الردود الخاصة في الثانية التي يمكن للتطبيق إرسالها على تعليقات البث المباشر لكل حساب؟

حتى 100 في الثانية لكل حساب، وهو معدل Meta للردود الخاصة على تعليقات البث، مقابل 750 في الساعة للتعليقات على المنشورات وReels. ويجب إرسال كل رد قبل انتهاء البث.

تابع القراءة

webhook التعليقات على Instagram: الحمولة، حقلاً حقلاًما يرسله webhook التعليقات في Instagram عند التعليق على منشورات الحساب وReels: الحمولة حقلاً حقلاً، وما تغفله، والمحاذير.واجهة برمجة التطبيقات (API) للردود الخاصة على Instagram: الرد على تعليق برسالة مباشرةأرسل ردًا خاصًا على Instagram عبر API من Meta: POST /<IG_ID>/messages بمعرّف التعليق، مرة واحدة لكل تعليق خلال 7 أيام، ويعيد الخطأ 2534025 عند تعذّر ذلك.حقول خطاف الويب (webhook) في Instagram: القائمة الكاملةحقول webhook التي تُدرجها Meta لـ Instagram Login: ما يُطلق كل حقل، والإذن الذي يلزمه، والحقول المتروكة لـ Facebook Login.إدارة تعليقات Instagram عبر واجهة برمجة التطبيقات (API)كيف تقرأ واجهة Instagram البرمجية التعليقات وترد عليها وتخفيها وتحذفها: ردود علنية، ورد خاص واحد لكل تعليق خلال 7 أيام، والقواعد المعمول بها.التحقق من خطاف الويب (webhook) في Instagram: hub.challenge وX-Hub-Signature-256إعداد webhook لـ Instagram: الرد على hub.challenge، والتحقق من X-Hub-Signature-256 بسر التطبيق، واشتراك كل حساب، ومعالجة إعادة المحاولات.

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

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

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

تم التحقق في