خطاف الويب (webhook) message_reactions على إنستغرام: حمولة react وunreact
يُخطر حقلُ خطاف الويب (webhook) المسمّى message_reactions التطبيقَ عندما يتفاعل شخص مع رسالة في محادثته مع حساب احترافي، أو عندما يزيل هذا التفاعل. يرد الحدث في مصفوفة messaging داخل كائن reaction يحتوي على: mid، وهو معرّف الرسالة التي وقع عليها التفاعل؛ وaction، وقيمته react أو unreact؛ وفي حالة react فقط، reaction، مثل love، وemoji، وهو الرمز التعبيري نفسه.
يشترك easyCoexistence في comments وmessages وmentions لكل حساب Instagram متصل، ويمرّر هذه الأحداث إلى نقطة النهاية HTTPS الخاصة بك فور وصولها، موقّعةً بسر ذلك الحساب، ومع كل رسالة mid الخاص بها.
قيمتا reaction.action: إضافة تفاعل، أو إزالة تفاعل.
من إصدار Graph API الذي تدعم فيه Meta التفاعلات angry وsad وwow وlove وlike وlaugh وغيرها في هذا webhook.
لا ترسل Meta أي إشعار عندما يتفاعل الحساب نفسه مع رسالة شخص ما أو يزيل تفاعله.
message_reactions من الحقول التي يشترك فيها منتج Instagram جديد في لوحة التحكم تلقائياً.
عدد استدعاءات Send API في الثانية لكل حساب للنصوص والروابط والتفاعلات والملصقات.
متى يُطلق message_reactions؟
عندما يتفاعل شخص مع رسالة في محادثته مع الحساب الاحترافي، ثم عندما يزيل هذا التفاعل، بعد أن يشترك التطبيق والحساب في هذا الحقل. يوضح دليل Meta للمراسلة على Instagram الاتجاه الآخر بجلاء: حين يتفاعل الحساب نفسه أو يزيل تفاعله، لا يُرسل أي إشعار، ولا تُرسل messages صدى (echo) لذلك أيضاً.
كيف يبدو إشعار التفاعل؟
طلب POST بقيمة object تساوي instagram، يحتوي entry على مصفوفة messaging. على عكس الرسالة الخاصة، لا يحمل الحدث كائن الرسالة: يقع التفاعل في كائن reaction خاص به، بجانب sender وrecipient وtimestamp. هذا مثال Meta لـ Instagram Login:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"reaction": {
"mid": "<MESSAGE_ID>",
"action": "react",
"reaction": "love",
"emoji": "\u{2764}\u{FE0F}"
}
}
]
}
]
}ما معنى كل حقل؟
الحقول التي توثّقها Meta لحدث التفاعل، من الخارج إلى الداخل:
- entry[].id وrecipient.id: الحساب الاحترافي. sender.id: المعرّف المحدد بنطاق Instagram للشخص الذي تفاعل.
- timestamp: وقت تشغيل الحدث، بالمللي ثانية في عينات Meta؛ أما entry[].time فهو وقت إرسال Meta للإشعار.
- reaction.mid: معرّف الرسالة التي وقع عليها التفاعل، وهو نفس mid الذي كانت تحمله في حدث messages.
- reaction.action: react عند إضافة تفاعل، وunreact عند إزالته.
- reaction.reaction: اسم التفاعل، مثل love؛ وتدرج Meta: angry وsad وwow وlove وlike وlaugh وother.
- reaction.emoji: الرمز التعبيري كسلسلة Unicode، مثل \u{2764}\u{FE0F} لـ love.
- عند unreact، لا يُرسل reaction وemoji.
كيف يبدو unreact؟
الحدث نفسه مع action بقيمة unreact، دون reaction وemoji، إذ لم يبقَ ما يُسمّى. طابق الحدث مع التفاعل الذي يزيله عبر reaction.mid وsender.id، واحذف تفاعل ذلك الشخص من الرسالة في سجلاتك.
"reaction": {
"mid": "<MESSAGE_ID>",
"action": "unreact"
}إلى أي رسالة يشير mid؟
الرسالة التي تفاعل معها الشخص، تحت mid نفسه الذي حملته في حدث messages، بما فيها الأصداء (echo) لرسائل الحساب نفسه. يمكن للمعالج الذي يخزّن mids أن يربط التفاعل بالسطر الصحيح من المحادثة. وتشير Meta إلى فجوة واحدة: التفاعل مع صورة من منشور carousel يُبلّغ عن الصورة الأولى من المنشور، وقد لا تكون الصورة التي اختارها الشخص.
كيف يتفاعل الحساب مع رسالة؟
عبر POST /<IG_ID>/messages: مع recipient.id بقيمة معرّف Instagram المحدد للشخص، وsender_action بقيمة react، وحمولة تحمل message_id وreaction، وهو رمز تعبيري أو صيغته UTF-8. يغيّر تكرار الطلب برمز تعبيري آخر التفاعل، أما sender_action بقيمة unreact مع message_id فقط فيزيله. لا ينتج أيٌّ من الطلبين webhook.
POST https://graph.instagram.com/<IG_ID>/messages
Authorization: Bearer <INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json
{
"recipient": { "id": "<IGSID>" },
"sender_action": "react",
"payload": {
"message_id": "<MESSAGE_ID>",
"reaction": "<EMOJI>"
}
}ما الذي يحتاجه message_reactions؟
مع Instagram Login: instagram_business_basic وinstagram_business_manage_messages، ومع Advanced Access للحسابات التي لا يملكها المطور أو لا يديرها. يشترك منتج Instagram جديد في لوحة التحكم تلقائياً في message_reactions، ويشترك كل حساب عبر POST /<IG_ID>/subscribed_apps. يسمّيه دليل Meta لإرسال الرسائل messaging_reactions، لكن جدول حقوله وإعدادات لوحة التحكم ومرجع webhook يسمّونه message_reactions.
هل يمرّر easyCoexistence التفاعلات؟
لا. يشترك تطبيق easyCoexistence وكل حساب متصل في التعليقات والرسائل والإشارات فقط، لذلك لا تُمرَّر أحداث message_reactions إلى endpoint الخاص بك. أما الرسائل المباشرة والأصداء التي تشير إليها التفاعلات بمعرّفها mid فتصل إليه، موقّعةً بسرّ الحساب.
الأخطاء الشائعة
- البحث عن التفاعل داخل كائن الرسالة. حدث التفاعل لا يحمل كائن الرسالة؛ اقرأ كائن reaction الموجود بجانب sender وrecipient.
- قراءة reaction أو emoji دون التحقق من action. كلاهما غائب عند unreact، فالكود الذي يفترض وجودهما ينهار عند إزالة التفاعل.
- انتظار webhook بعد أن يتفاعل الحساب. لا ترسل Meta أي حدث لتفاعلات الحساب نفسه، ولا حتى صدى، لذا سجّلها في سجلاتك عندما يرسلها تطبيقك.
- نسخ اسم messaging_reactions من دليل Meta لإرسال الرسائل. الحقل في جدول حقوله وإعدادات لوحة التحكم ومرجع webhook هو message_reactions.
يرد وكيلك على الشخص بالأداة send_social_dm ضمن نافذة 24 ساعة. من US$ 9 إلى US$ 0.75 لكل اتصال في الشهر، ينخفض السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
لماذا يشير التفاعل مع منشور carousel إلى الصورة الأولى؟
تُبلّغ Meta عن الصورة الأولى من المنشور عندما يتفاعل شخص مع إحدى صوره، وقد لا تكون الصورة التي اختارها الشخص.
هل يرسل Instagram webhook عندما يتفاعل الحساب الاحترافي مع رسالة؟
لا. لا ترسل Meta إشعار message_reactions ولا صدى عندما يتفاعل الحساب مع رسالة أو يزيل تفاعله.
ما التفاعلات التي يمكن أن يبلّغ عنها webhook في Instagram؟
يدرج دليل Meta للمراسلة على Instagram التفاعلات angry وsad وwow وlove وlike وlaugh وother من Graph API v12.0، مع الرمز التعبيري نفسه في reaction.emoji.
هل اسم الحقل في webhook هو message_reactions أم messaging_reactions؟
message_reactions. يكتب دليل Meta لإرسال الرسائل messaging_reactions، لكن جدول الحقول وإعدادات لوحة التحكم ومرجع webhook تستخدم جميعها message_reactions.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في