حقول خطاف الويب (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 الخاصة بك فور وصولها، موقّعةً بسر ذلك الحساب.
الحقول التي يبدأ بها منتج Instagram جديد في لوحة تحكم التطبيق، ومن بينها comments وmessages وmessage_reactions.
تُحدَّد الحقول على مستوى التطبيق لا على مستوى كل حساب: يتلقى الحساب الحقول التي اختارها التطبيق.
مستوى الوصول الذي يذكره دليل إعداد Meta لـ webhooks مع Instagram Login، ويشترطه لإشعارات comments وlive_comments.
مُعلَّم كغير متاح لـ Instagram Login في جدول حقول Meta، الذي يتيحه مع Facebook Login وUnified Login.
متى أضافت 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.
أي الحقول غير متاحة مع 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 على الحقول المختارة في اللوحة، مفصولةً بفواصل.
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 ما دامت متاحة.
لا تُخزَّن الأحداث افتراضيًا؛ فالحساب الذي تكون فيه أتمتة مفعّلة يحتفظ برسائله المباشرة وتعليقاته لمدة 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.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في