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

حقول خطاف الويب (webhook) في Instagram: القائمة الكاملة

بالنسبة إلى حساب احترافي على Instagram Login، يسرد جدول حقول webhook لدى Meta الحقول التالية: comments وlive_comments وmessages وmessage_echoes وmessage_reactions وmessaging_postbacks وmessaging_referral وmessaging_seen وmessaging_optins وmessaging_handover وstandby، مع تسليم الإشارات (mentions) داخل comments، وتضيف أمثلته message_edit. يحتاج كل حقل إلى instagram_business_basic إضافةً إلى instagram_business_manage_comments، أو إلى instagram_business_manage_messages في معظم حقول الرسائل. لا يُتاح story_insights مع Instagram Login.

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

8

الحقول التي يبدأ بها منتج Instagram جديد في لوحة تحكم التطبيق، ومن بينها comments وmessages وmessage_reactions.

Per app

تُحدَّد الحقول على مستوى التطبيق لا على مستوى كل حساب: يتلقى الحساب الحقول التي اختارها التطبيق.

Advanced Access

مستوى الوصول الذي يذكره دليل إعداد Meta لـ webhooks مع Instagram Login، ويشترطه لإشعارات comments وlive_comments.

story_insights

مُعلَّم كغير متاح لـ Instagram Login في جدول حقول Meta، الذي يتيحه مع Facebook Login وUnified Login.

10 Sep 2025

متى أضافت Meta webhook الحقل message_edit لـ Business Login for Instagram وFacebook Login for Business.

أي حقول webhook يتيحها Instagram Login؟

هذه الحقول، من جدول حقول Meta، مع ما يُطلق كل منها مأخوذًا من أمثلته ومرجع webhook. يحتاج كل حقل أيضًا إلى instagram_business_basic إضافةً إلى الإذن الموضح، وتشترط Meta Advanced Access لإشعارات comments وlive_comments.

commentsA comment or reply on the account's posts, Reels, Stories or ads, @mentions included. instagram_business_manage_comments.
live_commentsA comment on the account's Live while it is broadcast. instagram_business_manage_comments.
mentionsNo field of its own with Instagram Login: Meta includes mentions in the comments notification.
messagesA DM: text, attachments, shares, Story replies and mentions, quick replies, deletions, and echoes of the account's own messages. instagram_business_manage_messages.
message_echoesListed with instagram_business_manage_comments; the account's own messages arrive on messages with is_echo set to true.
message_reactionsA person reacts to a message or removes the reaction. instagram_business_manage_messages.
message_editA person edits a message, with mid, text and num_edit. In Meta's examples and changelog, not in its fields table.
messaging_postbacksA tap on an ice breaker, a template's postback button or a persistent menu item. instagram_business_manage_messages.
messaging_referralAn ig.me link with a ref parameter, opened in an existing conversation. instagram_business_manage_messages.
messaging_seenA person reads a message, reported as read.mid. instagram_business_manage_messages.
messaging_optinsListed with instagram_business_manage_messages; Meta's Instagram examples show no payload for it.
messaging_handoverThread control passed, taken or requested between apps under the handover protocol. instagram_business_manage_messages.
standbyA message that arrives while another app controls the conversation. instagram_business_manage_messages.

أي الحقول غير متاحة مع Instagram Login؟

ثلاثة صفوف في جدول حقول Meta لا تحمل إذن Instagram Login، فلا يتلقاها تطبيق على Instagram Login، وحقل آخر لا يوجد إلا خارجه:

  • story_insights: مقاييس الستوري عند انتهائه، مع Facebook Login أو Unified Login وinstagram_manage_insights. يذكر مرجع media insights لدى Meta أن insights webhook غير مدعوم مع Instagram Login.
  • messaging_policy_enforcement وresponse_feedback: فقط في العمود الخاص بواجهة Instagram Messaging API لدى Meta.
  • mentions كحقل مستقل: يسرده Facebook Login وUnified Login مع instagram_manage_comments، بينما يدمج Instagram Login الإشارات داخل comments.

كيف تُفعّل الحقول؟

في مكانين. في إعدادات webhook لمنتج Instagram ضمن لوحة تحكم التطبيق، احفظ عنوان URL الخاص بالاستدعاء ورمز التحقق (verify token)، فيُطلق ذلك طلب التحقق من Meta، ثم اختر الحقول؛ ويبدأ منتج Instagram الجديد مشتركًا في ثمانية منها. ثم فعّل كل حساب بالطلب POST /<IG_ID>/subscribed_apps على graph.instagram.com، مع ضبط subscribed_fields على الحقول المختارة في اللوحة، مفصولةً بفواصل.

Subscribing one account to three fields
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
  ?subscribed_fields=comments,messages,message_reactions
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{ "success": true }

هل يمكن أن يحصل كل حساب على حقول مختلفة؟

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

كيف تميّز الحقول في الإشعار؟

من شكل المدخل. تصل حقول التعليقات في مصفوفة changes، ويسمي كل تغيير حقله. وتصل حقول الرسائل في مصفوفة messaging دون اسم حقل، ويميّزها المفتاح الذي يجاور sender وrecipient وtimestamp:

  • changes[].field: comments أو live_comments، والتعليق في value.
  • message: messages، بما فيها صدى رسائل الحساب نفسه، وهي التي تحمل is_echo بقيمة true.
  • reaction: message_reactions. postback: messaging_postbacks. read: messaging_seen. message_edit: message_edit.
  • referral بجانب sender: messaging_referral. أما referral داخل message فيتبع messages، ويأتي من محادثة جديدة أو إعلان Click-to-Direct.
  • pass_thread_control أو take_thread_control أو request_thread_control: messaging_handover، كما يسردها مرجع webhook لدى Meta.

أي الحقول تُفعّلها easyCoexistence؟

comments وmessages وmentions، وهي القائمة التي يُفعَّل بها كل حساب Instagram عند ربطه. ومع Instagram Login تأتي الإشارات (mentions) داخل comments، فيشمل اشتراك الاتصال التعليقات والرسائل المباشرة، مع الصدى وردود الستوري وإشارات الستوري والمرفقات ضمن الرسائل المباشرة. تُسلّم Meta بقية الحقول في الجدول إلى تطبيق مشترك فيها، وليست جزءًا من اشتراك الاتصال. وبعد ضبط نقطة النهاية (endpoint) عبر set_social_webhook_destination أو Partner API، يتحقق easyCoexistence من توقيع Meta، ويرد عليها فورًا، ويرسل POST بكل مدخل للحساب إليها:

  • platform وexternal_id: instagram، ومعرّف حساب Instagram، ويساوي entry.id.
  • account_id: معرّف الاتصال في easyCoexistence، وهو الذي تستخدمه أدوات MCP.
  • entry: مدخل Meta الخاص بالحساب كما هو دون تعديل. لا يُمرَّر حقل object لدى Meta ولا ترويسة X-Hub-Signature-256.
  • X-EC-Signature: t=<unix>,v1=<hex>، وهو HMAC-SHA256 للطابع الزمني ثم نقطة ثم النص الخام للطلب، مفتاحه سر الحساب نفسه.
  • التسليم: محاولة واحدة بمهلة تصل إلى 8 ثوانٍ، دون اتباع إعادة التوجيه، ودون الاحتفاظ بنسخة، ودون إعادة محاولة.

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

  • انتظار حقل mentions مع Instagram Login. تدمج Meta الإشارات في إشعار comments، فلا يعمل معالج مرتبط بالحقل mentions أبدًا.
  • افتراض أن الحساب يتلقى فقط الحقول التي سمّاها اشتراكه. تسلّم Meta الحقول التي اختارها التطبيق، فينبغي تفريع المنطق حسب ما يحمله كل حدث.
  • معاملة message.referral وreferral على المستوى الأعلى كحدث واحد. الأول يأتي ضمن messages، والثاني هو messaging_referral، لرابط ig.me مفتوح في محادثة قائمة.
  • انتظار story_insights مع Instagram Login. تُعلّم Meta الحقل غير متاح هناك، فاقرأ مقاييس الستوري من نقطة نهاية insights ما دامت متاحة.
إنجاز ذلك باستخدام EasyCoexistence

لا تُخزَّن الأحداث افتراضيًا؛ فالحساب الذي تكون فيه أتمتة مفعّلة يحتفظ برسائله المباشرة وتعليقاته لمدة 7 أيام. اضبط نقطة النهاية بـ set_social_webhook_destination من Claude أو ChatGPT، أو عبر Partner API. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.

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

هل لدى Instagram Login حقل webhook خاص بالإشارات (mentions)؟

لا كحقل منفصل. تُدرج Meta الإشارات في إشعار comments مع Instagram Login، أما mentions فهو حقل مستقل مع Facebook Login وUnified Login.

هل story_insights متاح مع Instagram Login؟

لا. يُعلّم جدول حقول Meta الحقل بأنه غير متاح لـ Instagram Login، ويذكر مرجع media insights أن insights webhook غير مدعوم هناك.

ما الأذونات التي يحتاجها webhook الرسائل في Instagram؟

instagram_business_basic وinstagram_business_manage_messages، مع Advanced Access، وهو ما يذكره دليل إعداد Meta لـ webhooks مع Instagram Login.

متى أضافت Meta webhook الحقل message_edit لـ Instagram؟

في 10 سبتمبر 2025، لـ Business Login for Instagram وFacebook Login for Business. يصل التعديل ضمن مصفوفة messaging تحت المفتاح message_edit.

تابع القراءة

webhook التعليقات على Instagram: الحمولة، حقلاً حقلاًما يرسله webhook التعليقات في Instagram عند التعليق على منشورات الحساب وReels: الحمولة حقلاً حقلاً، وما تغفله، والمحاذير.خطاف الويب (webhook) للرسائل على Instagram: حمولة الرسالة المباشرة (DM) والأصداء والحقولما يرسله webhook الرسائل على Instagram لكل رسالة مباشرة: معرّف المرسل المحدود والنص والمرفقات والردود على القصص والأصداء، حقلاً حقلاً، مع نافذة 24 ساعة.خطاف الويب (webhook) message_reactions على إنستغرام: حمولة react وunreactما يرسله webhook الخاص بـ message_reactions على إنستغرام عند تفاعل شخص مع رسالة خاصة أو يزيله: mid وaction وreaction وemoji، ومتى يبقى صامتاً.خطاف الويب (webhook) messaging_postbacks في Instagram: كاسرات الجمود والأزرارما يرسله خطاف messaging_postbacks من Instagram عند نقر شخص على كاسر الجمود أو زر أو عنصر قائمة: العنوان وpayload وmid، وطريقة الإعداد.خطاف الويب (webhook) messaging_referral في Instagram: روابط ig.me وإحالات الإعلاناتما يرسله webhook من نوع messaging_referral عند فتح رابط ig.me يحمل ref، وأين تصل إحالات المحادثات الجديدة والإعلانات.خطاف الويب (webhook) live_comments في Instagram: التعليقات أثناء البث المباشرما يرسله حقل live_comments في webhook من Instagram أثناء بث مباشر للحساب: البيانات، والفرق عن التعليقات، وكيفية الرد على تعليق من البث.

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

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

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

تم التحقق في