Instagram message_reactions वेबहुक: रिएक्ट और अनरिएक्ट पेलोड
Instagram का message_reactions फ़ील्ड किसी ऐप को सूचित करता है जब कोई व्यक्ति प्रोफ़ेशनल खाते के साथ अपनी बातचीत के किसी मैसेज पर रिएक्शन करता है, या उसे हटाता है। यह इवेंट messaging array में reaction object के साथ आता है: mid, उस मैसेज का ID जिस पर रिएक्शन हुआ; action, react या unreact; और केवल react पर, reaction, जैसे love, और emoji, यानी इमोजी स्वयं।
easyCoexistence हर जुड़े Instagram खाते को comments, messages और mentions की सदस्यता देता है और उन इवेंट्स को आते ही आपके HTTPS एंडपॉइंट पर भेजता है, हर इवेंट उस खाते के secret से साइन किया हुआ, हर मैसेज अपने mid के साथ।
reaction.action के दो मान हैं: रिएक्शन जुड़ा, या रिएक्शन हटाया गया।
Graph एपीआई का वह संस्करण जिससे Meta इस वेबहुक में angry, sad, wow, love, like, laugh और अन्य रिएक्शन का समर्थन करता है।
जब खाता स्वयं किसी व्यक्ति के मैसेज पर रिएक्ट या अनरिएक्ट करता है, तो Meta कोई सूचना नहीं भेजता।
message_reactions उन फ़ील्ड्स में है जिनकी सदस्यता App Dashboard में नया Instagram प्रोडक्ट शुरू से लेता है।
Send एपीआई कॉल की संख्या प्रति सेकंड प्रति खाता, टेक्स्ट, लिंक, रिएक्शन और स्टिकर के लिए।
message_reactions कब ट्रिगर होता है?
जब कोई व्यक्ति प्रोफ़ेशनल खाते के साथ अपनी बातचीत के किसी मैसेज पर रिएक्ट करता है, और फिर जब वह उस रिएक्शन को हटाता है, एक बार ऐप और खाता इस फ़ील्ड की सदस्यता ले चुके हों। Meta की Instagram Messaging गाइड दूसरी दिशा के बारे में स्पष्ट है: जब खाता स्वयं रिएक्ट या अनरिएक्ट करता है, तो कोई सूचना नहीं भेजी जाती, और messages भी उसके लिए कोई इको नहीं देता।
रिएक्शन की सूचना कैसी दिखती है?
object को instagram पर सेट करके एक POST, जिसके entry में messaging array होता है। DM के विपरीत, इस इवेंट में message object नहीं होता: रिएक्शन अपने reaction object में होता है, sender, recipient और timestamp के साथ। Instagram Login के लिए Meta का उदाहरण:
{
"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-scoped ID जिसने रिएक्ट किया।
- timestamp: इवेंट कब ट्रिगर हुआ, Meta के नमूनों में मिलीसेकंड में; entry[].time वह समय है जब Meta ने सूचना भेजी।
- reaction.mid: जिस मैसेज पर रिएक्शन हुआ उसका ID, वही mid जो उसके messages इवेंट में था।
- reaction.action: रिएक्शन जुड़ने पर react, हटने पर unreact।
- reaction.reaction: रिएक्शन का नाम, जैसे love; Meta सूची देता है angry, sad, wow, love, like, laugh और other।
- reaction.emoji: इमोजी यूनिकोड स्ट्रिंग के रूप में, जैसे love के लिए \u{2764}\u{FE0F}।
- unreact पर reaction और emoji छोड़ दिए जाते हैं।
unreact कैसा दिखता है?
वही इवेंट, जिसमें action unreact पर सेट है, और न reaction, न emoji, क्योंकि नाम देने के लिए कुछ बचा नहीं। इसे उस रिएक्शन से मिलाएं जिसे यह हटाता है, reaction.mid और sender.id से, और अपने रिकॉर्ड में उस व्यक्ति का रिएक्शन उस मैसेज से हटा दें।
"reaction": {
"mid": "<MESSAGE_ID>",
"action": "unreact"
}mid किस मैसेज की ओर इशारा करता है?
वह मैसेज जिस पर व्यक्ति ने रिएक्ट किया, उसी mid के तहत जो उसके messages इवेंट में था, खाते के अपने मैसेज के इको सहित। जो हैंडलर mids स्टोर करता है, वह रिएक्शन को बातचीत की सही पंक्ति से जोड़ सकता है। Meta एक कमी बताता है: carousel पोस्ट की किसी एक इमेज पर रिएक्शन, carousel की पहली इमेज दर्ज करता है, जो शायद चुनी गई इमेज न हो।
खाता किसी मैसेज पर रिएक्ट कैसे करता है?
POST /<IG_ID>/messages के साथ: recipient.id को व्यक्ति के Instagram-scoped ID पर सेट करके, sender_action को react पर सेट करके, और एक पेलोड के साथ जिसमें message_id और reaction हो, इमोजी या उसका UTF-8 रूप। दूसरे इमोजी के साथ कॉल दोहराने से रिएक्शन बदल जाता है, और sender_action को unreact पर सेट करके केवल message_id के साथ वह हट जाता है। दोनों कॉल से कोई वेबहुक नहीं बनता।
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 जिनका डेवलपर मालिक या प्रबंधक नहीं है। App Dashboard में नया Instagram प्रोडक्ट शुरू से message_reactions की सदस्यता लेता है, और हर खाता POST /<IG_ID>/subscribed_apps से सब्सक्राइब होता है। Meta की Send Messages गाइड इसे messaging_reactions लिखती है, पर उसकी फ़ील्ड टेबल, डैशबोर्ड के डिफ़ॉल्ट और वेबहुक रेफ़रेंस में message_reactions है।
क्या easyCoexistence रिएक्शन आगे भेजता है?
नहीं। easyCoexistence का ऐप और हर जुड़ा हुआ खाता केवल comments, messages और mentions की सदस्यता लेते हैं, इसलिए message_reactions इवेंट आपके एंडपॉइंट पर फ़ॉरवर्ड नहीं होते। जिन DM और इको की ओर रिएक्शन उनके mid से इशारा करते हैं, वे आपके एंडपॉइंट तक पहुँचते हैं, खाते के सीक्रेट से साइन किए हुए।
आम गड़बड़ियाँ
- reaction को message के भीतर खोजना। रिएक्शन इवेंट में message object नहीं होता; sender और recipient के बगल वाला reaction object पढ़ें।
- action जांचे बिना reaction या emoji पढ़ना। unreact पर दोनों छोड़ दिए जाते हैं, इसलिए जो कोड उन्हें मान लेता है, वह रिएक्शन हटने पर टूट जाता है।
- खाते के रिएक्ट करने के बाद वेबहुक का इंतज़ार करना। Meta खाते के अपने रिएक्शन के लिए कोई वेबहुक नहीं भेजता, इको तक नहीं, इसलिए जब आपका ऐप उन्हें भेजे तब उन्हें रिकॉर्ड करें।
- Meta की Send Messages गाइड से नाम messaging_reactions कॉपी करना। उसकी फ़ील्ड टेबल, डैशबोर्ड के डिफ़ॉल्ट और वेबहुक रेफ़रेंस में फ़ील्ड का नाम message_reactions है।
आपका एजेंट 24 घंटे की विंडो के भीतर send_social_dm से किसी व्यक्ति को जवाब देता है। प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75, कनेक्शन जोड़ने के साथ घटती दर, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
carousel पोस्ट पर रिएक्शन पहली इमेज की ओर क्यों इशारा करता है?
Meta जब carousel की किसी इमेज पर रिएक्शन होता है तो उसकी पहली इमेज दर्ज करता है, जो शायद वह इमेज न हो जिसे व्यक्ति ने चुना।
जब खाता किसी मैसेज पर रिएक्ट करता है, तो क्या Instagram वेबहुक भेजता है?
नहीं। जब खाता किसी मैसेज पर रिएक्ट या अनरिएक्ट करता है, तो Meta कोई message_reactions सूचना और कोई इको नहीं भेजता।
Instagram वेबहुक किन रिएक्शन की सूचना दे सकता है?
Meta की Instagram Messaging गाइड Graph एपीआई v12.0 से angry, sad, wow, love, like, laugh और other सूचीबद्ध करती है, इमोजी स्वयं reaction.emoji में।
वेबहुक फ़ील्ड message_reactions है या messaging_reactions?
message_reactions। Meta की Send Messages गाइड messaging_reactions लिखती है, पर उसकी फ़ील्ड टेबल, App Dashboard के डिफ़ॉल्ट और वेबहुक रेफ़रेंस सभी message_reactions इस्तेमाल करते हैं।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित