خطاف الويب (webhook) live_comments في Instagram: التعليقات أثناء البث المباشر
يُعلم حقل live_comments في webhook الخاص بـ Instagram التطبيقَ بالتعليقات على البث المباشر للحساب الاحترافي أثناء بثه. يصل كل تعليق كعنصر في changes حقله live_comments، وبالشكل نفسه لبيانات حقل comments: معرّف التعليق ونصه، ومعرّف Instagram المحدد لنطاق التطبيق للمؤلف واسمه في from، ومعرّف الوسائط. تتوقف الإشعارات عند انتهاء البث.
يشترك easyCoexistence في comments وmessages وmentions لكل حساب Instagram متصل، ويمرر التعليقات على منشوراته وReels إلى endpoint في HTTPS الخاصة بك فور وصولها، موقّعةً بسر ذلك الحساب.
يتطلب إشعارات live_comments ما يتطلبه comments، ولا ترسل الوسائط التي يملكها حساب خاص أي إشعارات.
عدد الردود الخاصة في الثانية الواحدة لكل حساب على تعليقات البث المباشر في Instagram، التي يمكن للتطبيق إرسالها.
متى تتوقف إشعارات التعليقات لوسائط البث المباشر.
متى يمكن إرسال رد خاص على تعليق في البث المباشر، فبعد انتهاء البث لم يعد ذلك ممكنًا.
live_comments: متى قدّمته Meta، للتعليقات على الفيديوهات المباشرة أثناء بثها.
live_comments: متى يُطلَق؟
يصل التعليق عندما يعلّق أحد على فيديو البث المباشر للحساب الاحترافي أثناء بثه، بعد اشتراك التطبيق والحساب في الحقل. وهو منفصل عن comments: التعليق على منشور أو Reel أو Story أو إعلان يصل عبر comments، والتعليق أثناء البث يصل عبر live_comments. تتوقف إشعارات الوسائط المباشرة عند انتهاء البث، ولا ترسل الوسائط التي يملكها حساب خاص أي إشعار.
live_comments: كيف يبدو الإشعار؟
هيكل الإشعار للتعليق نفسه: object بقيمة instagram، وسطر entry لكل حساب، ومصفوفة changes يكون حقلها live_comments. وتعرض وثيقة Meta الخاصة بتسجيل الدخول عبر Instagram شكل قيمة واحدًا للتعليقات و live_comments، لذلك يُميز اسم الحقل بينهما:
{
"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 في العمود الأول:
| comments | live_comments | |
|---|---|---|
| Fires for | Comments on posts, Reels, Stories and ads | Comments on a Live while it broadcasts |
| Notifications | As each comment is made | Stop when the broadcast ends |
| Public reply | POST /<COMMENT_ID>/replies | Not supported on live video |
| Hide or delete | Supported | Not supported on live video |
| Private reply | Within 7 days of the comment | Only during the broadcast |
| Private reply rate | 750 per hour per account | 100 per second per account |
كيف ترد على تعليق من بث مباشر؟
بردّ خاص، أثناء البث. يؤدي الطلب POST /<IG_ID>/messages مع recipient.comment_id مساويًا لمعرّف التعليق إلى إرسال رسالة مباشرة واحدة لصاحبه، تصل إلى صندوق الوارد إن كان يتابع الحساب، وإلى طلبات الرسائل إن لم يكن يتابعه. وتستبعد مراجع Meta المسارات العامة على الفيديو المباشر، فالرد على التعليقات أو إنشاؤها أو إخفاؤها أو حذفها هناك غير مدعوم. وبعد انتهاء البث لا يمكن إرسال ردود خاصة على تعليقاته.
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 بسجل تستعلم عنه، لذا احفظ ما تحتاجه فور وصول كل إشعار.
ويتيح 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. ويجب إرسال كل رد قبل انتهاء البث.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في