webhook التعليقات على Instagram: الحمولة، حقلاً حقلاً
يُخطر حقل التعليقات في webhook الخاص بـ Instagram التطبيقَ عند تعليق شخص على الوسائط الخاصة بحساب احترافي، بما فيها Reels، أو عند الرد على تعليق. يُرسل Meta تغييراً يكون حقله comments، وقيمته تتضمن معرّف التعليق ونصه، ومعرّف المؤلف المقيّد بـ Instagram واسم مستخدمه في from، ومعرّف الوسائط ونوع المنتج، وparent_id عندما يكون التعليق رداً.
يشترك easyCoexistence في التعليقات لكل حساب Instagram متصل، ويمرر أحداث comments التي تسلمها من Meta إلى endpoint الخاص بك عبر HTTPS فور وصولها، موقّعة بسر ذلك الحساب، دون حفظ أي نسخة.
يظهر عندما يكون التعليق رداً، ويحمل معرّف التعليق الذي يرد عليه.
يُضاف إلى from عندما يعلّق الحساب على وسائطه، بجانب معرّف الحساب نفسه.
حقل منفصل للتعليقات أثناء بث مباشر، وتتوقف إشعاراته عند انتهاء البث.
مطلوب لإشعارات comments وlive_comments، ولا تُطلق وسائط الحسابات الخاصة أي إشعار.
المهلة المتبقية لإرسال رد خاص واحد إلى المعلِّق، ويُحدَّد الرد بمعرّف التعليق.
متى يُطلق حقل التعليقات؟
عندما يعلّق شخص على وسائط يملكها الحساب الاحترافي، أو يذكر الحساب، بعد اشتراك التطبيق والحساب في الحقل كلاهما. كل تعليق هو تغيير واحد في الإشعار، وهذه الحالات تتشارك الشكل نفسه:
- تعليق جديد على منشور أو Reel أو Story أو إعلان، مع media.
media_product_typeالذي يحدد سطح الوسائط. - رد تحت تعليق موجود، ويحمل
parent_idبمعرّف التعليق الذي يرد عليه. - تعليق يكتبه الحساب على وسائطه، بما فيها ردوده: from.id هو معرّف الحساب نفسه، وتُضاف إلى from الخاصية
self_ig_scoped_id. - إشارة @ إلى الحساب: مع Instagram Login، يضمّن Meta الإشارات ضمن إشعار التعليقات بدلاً من حقل خاص بها.
- تعليق أثناء بث مباشر يصل على حقل منفصل هو
live_comments، بالشكل نفسه للقيمة، ويتوقف عند انتهاء البث.
كيف يبدو إشعار التعليقات؟
طلب POST يحمل JSON فيه object بقيمة instagram ومصفوفة entry. كل عنصر في entry يمثل حساباً احترافياً واحداً: معرّفه، ووقت إرسال Meta للإشعار، ومصفوفة changes تحوي تغييراً واحداً لكل تعليق. هكذا يبدو رد على Reel:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"parent_id": "<PARENT_COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": {
"id": "<INSTAGRAM_SCOPED_ID>",
"username": "<USERNAME>"
},
"media": {
"id": "<MEDIA_ID>",
"media_product_type": "REELS"
}
}
}
]
}
]
}ما معنى كل حقل؟
الحقول التي يدرجها مرجع الـ webhook لدى Meta للتعليق، من الخارج إلى الداخل:
- entry[].id: معرّف الحساب الاحترافي، وهو
user_idالذي يعيده /me لهذا الحساب. يخبرك بالحساب الذي يتبع له التعليق. - entry[].time: وقت إرسال Meta للإشعار بصيغة Unix timestamp، وليس وقت كتابة التعليق.
- changes[].field: comments، أو
live_commentsفي حالة البث المباشر. تحقق منه قبل قراءة value. - value.id: معرّف التعليق، وهو ما تستخدمه للرد علناً أو خاصة، أو للإخفاء أو الحذف.
- value.text: نص التعليق، ويكون موجوداً عندما يحتوي التعليق على نص.
- value.from.id و value.from.username: معرّف المؤلف المقيّد بـ Instagram واسم مستخدمه. يظهر value.from.
self_ig_scoped_idعندما يكون الحساب نفسه هو من كتب التعليق. - value.media.id و value.media.
media_product_type: الوسائط المعلَّق عليها وسطحها؛ ويسمّي مرجع الوسائط لدى Meta الأنواع AD وFEED وSTORY وREELS. - value.
parent_id: في حالة الرد، معرّف التعليق الذي يرد عليه. التعليق في المستوى الأعلى لا يحمله. - value.media.
ad_idوad_titleوoriginal_media_id: مذكورة في المرجع للتعليقات على الإعلانات.
ما الذي لا يُبلغ عنه حقل التعليقات؟
بعض ما قد يتوقعه المعالج غير موجود في الحدث، أو لا يُرسل أبداً، بحسب دليل الإعداد ومراجع Meta:
- تعليقات على وسائط يملكها حساب خاص: لا يُرسل Meta إشعارات تعليق أو إشارة لها.
- معرّفات الألبومات: لا يتضمنها الحدث، وتقول Meta إن الألبوم يُبحث عنه بمعرّف التعليق.
- معرّفات الإعلانات للوسائط المستخدمة في الإعلانات الديناميكية.
- وقت إنشاء التعليق: يعيده GET /<
COMMENT_ID>?fields=timestamp بصيغة ISO 8601. - تعليقات البث المباشر بعد انتهاء البث، حين تتوقف إشعارات الوسائط المباشرة.
- الإشارات في القصص Story Mentions، إذ لا تدعمها واجهة الإشارات لدى Meta، وتصل إلى الحساب كرسائل مباشرة بدلاً من ذلك.
- الأحداث السابقة: لا تحتفظ Meta بسجل إشعارات يمكن الاستعلام عنه، لذا خزّن ما تحتاجه عند وصول كل حدث.
ما الذي يحتاجه حقل التعليقات؟
مع Instagram Login: الصلاحيتان instagram_business_basic وinstagram_business_manage_comments، والوصول المتقدم Advanced Access الذي تشترطه Meta لإشعارات comments وlive_comments. يجب أن يكون التطبيق في وضع Live ومشتركاً في التعليقات من لوحة تحكم التطبيق، ويجب اشتراك كل حساب عبر POST /<IG_ID>/subscribed_apps مع comments ضمن subscribed_fields. توصي Meta بشدة بهذا الـ webhook بدلاً من الاستطلاع المتكرر للتعليقات، لأنه يوفر حدّ المعدل.
كيف ترد على تعليق من الحدث؟
بالمعرّفات التي يحملها. POST /<COMMENT_ID>/replies مع message ينشر رداً علنياً تحت التعليق، باستخدام value.id. POST /<IG_ID>/messages مع recipient.comment_id بقيمة value.id يرسل إلى المؤلف رداً خاصاً واحداً، خلال 7 أيام من التعليق، أو طالما البث المباشر مستمر. from.id معرّف مقيّد بـ Instagram، لكن الرسالة المباشرة المرسلة إليه مباشرة تفشل حتى يراسل الشخص الحساب، لذلك يكون الرد الخاص هو الطريقة للوصول إليه برسالة مباشرة.
كيف يمرر easyCoexistence التعليق؟
فور وصوله، بعد ضبط نقطة النهاية (endpoint) للحساب باستخدام set_social_webhook_destination من Claude أو ChatGPT، أو عبر PUT /channels/:id/webhook في Partner API. يشترك easyCoexistence كل حساب متصل في الحقول التي تحمل تعليقاته وإشاراته ورسائله المباشرة، ويتحقق من توقيع Meta على كل إرسال، ويرد على Meta فوراً، ويرسل POST لكل entry خاص بالحساب إلى عنوان URL الخاص بك عبر HTTPS داخل غلاف:
- platform و
external_id: القيمة instagram، ومعرّف حساب Instagram، ويساوي entry.id. account_id: معرّف الاتصال في easyCoexistence، وهو المعرّف الذي تعيدهlist_social_accountsوتستخدمه أدوات MCP.- entry: إدخال Meta للحساب دون تغيير، بحيث يصبح التسليم المجمّع POST واحداً لكل entry. لا يُمرَّر حقل object لدى Meta ولا X-Hub-Signature-256.
- التسليم: محاولة واحدة، بانتظار حتى 8 ثوانٍ، دون اتباع أي إعادة توجيه، إلى عنوان HTTPS يُحلّ إلى IP عام. لا تُحفظ أي نسخة ولا تُعاد المحاولة أبداً.
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"media": { "id": "<MEDIA_ID>", "media_product_type": "FEED" }
}
}
]
}
}ماذا تفعل قواعد التعليق إلى رسالة مباشرة بالحدث نفسه؟
تقرأه بجانب التمرير. تتطابق القاعدة عندما يحتوي التعليق على إحدى كلماتها المفتاحية، دون حساسية لحالة الأحرف، على منشور واحد تختاره أو على كل المنشورات، فترسل إلى المؤلف رسالة القاعدة المباشرة كرد خاص، إضافة إلى رد علني إن كان للقاعدة واحد. تُتخطى التعليقات التي يكتبها الحساب نفسه، وتأخذ الأتمتة التي تبدأ بالتعليق التعليقات التي لم ترد عليها أي قاعدة، ويصل التعليق الذي ردت عليه قاعدة إلى endpoint الخاص بك أيضاً. قد يعود الرد العلني للقاعدة كحدث تعليقات جديد من الحساب نفسه.
الأخطاء الشائعة
- البحث عن comment_id. في Instagram Login يوجد معرّف التعليق في value.id، أما comment_id فيخص حمولات إعدادات تسجيل الدخول الأخرى لدى Meta.
- الرد على تعليقات الحساب نفسه. تعود ردوده كأحداث comments بقيمة from.id مساوية لـ entry.id، فتجد الأتمتة التي ترد عليها نفسها تحاور ذاتها.
- قراءة entry.time كوقت للتعليق. إنه يسجل وقت إرسال Meta للإشعار، أما حقل الوقت الخاص بالتعليق فيحدد متى كُتب.
- انتظار تعليقات البث المباشر على حقل comments. إنها تصل على live_comments، الذي يحتاج إلى اشتراك خاص به ويصمت عند انتهاء البث.
تعمل قواعد التعليق إلى رسالة مباشرة والأتمتة على التعليقات ذاتها على مدار الساعة. من US$ 9 إلى US$ 0.75 لكل اتصال في الشهر، وتنخفض كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل يتضمن webhook التعليقات على Instagram الردود على التعليقات؟
نعم. يصل الرد كحدث comments مستقل، ويحمل parent_id معرّف التعليق الذي يرد عليه.
هل تُطلق تعليقات Reels webhook التعليقات على Instagram؟
نعم. يصل التعليق على Reel عبر حقل comments مثل التعليق على منشور، ويفرّق media.media_product_type بينهما.
لماذا لا يُطلق webhook التعليقات على Instagram عندي؟
غالباً لأن التطبيق ليس في وضع Live أو لا يملك Advanced Access، أو أن الحساب لم يُشترك عبر /subscribed_apps، أو أن الوسائط تعود لحساب خاص، أو أن التعليق كان على بث مباشر، وهو يستخدم live_comments.
هل يتضمن webhook التعليقات اسم مستخدم المعلِّق؟
نعم. يحمل value.from اسم مستخدم الشخص بجانب معرّفه المقيّد بـ Instagram، فلا يحتاج الأمر إلى استدعاء إضافي لعرض من علّق.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في