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

webhook التعليقات على Instagram: الحمولة، حقلاً حقلاً

يُخطر حقل التعليقات في webhook الخاص بـ Instagram التطبيقَ عند تعليق شخص على الوسائط الخاصة بحساب احترافي، بما فيها Reels، أو عند الرد على تعليق. يُرسل Meta تغييراً يكون حقله comments، وقيمته تتضمن معرّف التعليق ونصه، ومعرّف المؤلف المقيّد بـ Instagram واسم مستخدمه في from، ومعرّف الوسائط ونوع المنتج، وparent_id عندما يكون التعليق رداً.

يشترك easyCoexistence في التعليقات لكل حساب Instagram متصل، ويمرر أحداث comments التي تسلمها من Meta إلى endpoint الخاص بك عبر HTTPS فور وصولها، موقّعة بسر ذلك الحساب، دون حفظ أي نسخة.

parent_id

يظهر عندما يكون التعليق رداً، ويحمل معرّف التعليق الذي يرد عليه.

self_ig_scoped_id

يُضاف إلى from عندما يعلّق الحساب على وسائطه، بجانب معرّف الحساب نفسه.

live_comments

حقل منفصل للتعليقات أثناء بث مباشر، وتتوقف إشعاراته عند انتهاء البث.

Advanced Access

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

7 days

المهلة المتبقية لإرسال رد خاص واحد إلى المعلِّق، ويُحدَّد الرد بمعرّف التعليق.

متى يُطلق حقل التعليقات؟

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

  • تعليق جديد على منشور أو 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:

A comments notification, as Meta sends it
{
  "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 عام. لا تُحفظ أي نسخة ولا تُعاد المحاولة أبداً.
A forwarded comment, headers included
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، الذي يحتاج إلى اشتراك خاص به ويصمت عند انتهاء البث.
إنجاز ذلك باستخدام EasyCoexistence

تعمل قواعد التعليق إلى رسالة مباشرة والأتمتة على التعليقات ذاتها على مدار الساعة. من 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، فلا يحتاج الأمر إلى استدعاء إضافي لعرض من علّق.

تابع القراءة

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

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

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

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

تم التحقق في