Instagram स्टोरी मेंशन और जवाब, वेबहुक में
Instagram स्टोरी मेंशन और स्टोरी के जवाब messages फ़ील्ड पर DM के रूप में वेबहुक तक पहुँचाता है। मेंशन एक ऐसे मैसेज के रूप में आता है जिसके attachments में story_mention टाइप का आइटम होता है, और स्टोरी का CDN यूआरएल payload.url में होता है। जवाब में व्यक्ति का टेक्स्ट और reply_to.story होता है, जिसमें स्टोरी का url और id होता है, और लिंक स्टिकर वाली स्टोरी के लिए link_sticker_url।
easyCoexistence हर जुड़े Instagram खाते को messages की सदस्यता देता है, इसलिए स्टोरी मेंशन और स्टोरी जवाब आते ही आपके HTTPS एंडपॉइंट तक बाकी DM के साथ पहुँचते हैं, उस खाते के सीक्रेट से हस्ताक्षरित और बिना कोई कॉपी रखे।
messages इवेंट का अटैचमेंट टाइप जो Meta भेजता है, जब कोई अपनी स्टोरी में खाते का मेंशन करता है।
वह फ़ील्ड जो Meta ने 12 दिसंबर 2025 को reply_to.story में जोड़ा, जिसमें उस स्टोरी का लिंक स्टिकर यूआरएल होता है जिसका जवाब दिया गया।
स्टोरी कितने समय तक चलती है; एक बार समाप्त या डिलीट होने पर उसका मेंशन यूआरएल रेंडर होना बंद हो जाता है।
वे खाते जिनके स्टोरी मेंशन आते हैं; प्राइवेट खाते का मेंशन तभी आता है जब वह प्रोफ़ेशनल खाते को फ़ॉलो करता हो।
वे स्टोरी जवाब जिन्हें वेबहुक सपोर्ट नहीं करता, Meta की Instagram Messaging गाइड के अनुसार।
स्टोरी मेंशन कैसे आता है?
DM के रूप में। जब कोई व्यक्ति अपनी स्टोरी में प्रोफ़ेशनल खाते का मेंशन करता है, तो Instagram उस स्टोरी का संदर्भ देने वाला एक मैसेज खाते के इनबॉक्स में डालता है, और Meta उसके लिए messages इवेंट भेजता है। sender.id व्यक्ति का Instagram-scoped ID है, और message.attachments में story_mention टाइप का एक आइटम होता है जिसका payload.url स्टोरी का CDN यूआरएल है। Meta के सैंपल में कोई टेक्स्ट नहीं होता, इसलिए अटैचमेंट को पढ़ें:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{
"type": "story_mention",
"payload": { "url": "<CDN_URL>" }
}
]
}
}
]
}
]
}स्टोरी का जवाब कैसे आता है?
वह भी DM के रूप में, व्यक्ति के मैसेज के साथ और एक reply_to ऑब्जेक्ट के साथ जो खाते की स्टोरी की ओर इशारा करता है। reply_to.story में स्टोरी का CDN यूआरएल और उसका id होता है। Meta के वेबहुक रेफ़रेंस में वहाँ link_sticker_url भी सूचीबद्ध है, जो दिसंबर 2025 में लिंक स्टिकर वाली स्टोरी के जवाबों के लिए जोड़ा गया था, और Meta लिंक के आधार पर ऑटोमेशन रूट करने के लिए इसका सुझाव देता है। किसी पिछले मैसेज के इनलाइन जवाब के लिए reply_to.mid इस्तेमाल होता है।
"message": {
"mid": "<MESSAGE_ID>",
"text": "<MESSAGE_TEXT>",
"reply_to": {
"story": {
"url": "<CDN_URL>",
"id": "<STORY_ID>"
}
}
}हर फ़ील्ड का क्या अर्थ है?
Meta इन दो इवेंट के लिए जो फ़ील्ड दस्तावेज़ करता है, वे बाहर से अंदर की ओर:
- entry[].id और recipient.id: प्रोफ़ेशनल खाता। sender.id: व्यक्ति का Instagram-scoped ID, वह ID जिस पर जवाब जाता है।
- timestamp: मैसेज कब भेजा गया, Meta के सैंपल में मिलीसेकंड में; entry[].time वह समय है जब Meta ने सूचना भेजी।
- message.mid: मैसेज ID, दोबारा भेजे गए अनुरोधों को डुप्लीकेट हटाने के लिए और
reply_to.mid से जवाब देने के लिए। - attachments[].type
story_mentionऔर payload.url: एक मेंशन, और उस स्टोरी का CDN यूआरएल जिसने उसे बनाया। reply_to.story.url औरreply_to.story.id: खाते की वह स्टोरी जिसका व्यक्ति ने जवाब दिया।reply_to.story.link_sticker_url: उस स्टोरी के लिंक स्टिकर पर का यूआरएल।- message.text: जवाब के शब्द, जब मैसेज में टेक्स्ट हो तब शामिल।
स्टोरी यूआरएल कब तक काम करता है?
जब तक स्टोरी रहती है। स्टोरी 24 घंटे बाद या जब उसका लेखक उसे डिलीट करे तब गायब हो जाती है, और Meta की story mention गाइड कहती है कि फिर यूआरएल रेंडर होना बंद कर देता है; उसका ओवरव्यू जोड़ता है कि Instagram के CDN यूआरएल प्राइवेसी-अवेयर होते हैं और डिलीट या समाप्त कंटेंट के लिए कुछ नहीं लौटाते। वही गाइड CDN यूआरएल रखने की अनुमति देती है, मीडिया की नहीं: कोई ऐप स्टोरी का कंटेंट अपने सर्वर पर स्टोर या कैश नहीं कर सकता, और स्टोरी जाने के बाद उसे प्लेसहोल्डर दिखाना चाहिए।
कब कोई भी इवेंट नहीं चलता?
Meta की गाइड ऐसे मामले बताती हैं, जहाँ स्टोरी इवेंट का इंतज़ार करने वाले हैंडलर को कुछ नहीं मिलता:
- कोई प्राइवेट खाता जो प्रोफ़ेशनल खाते को फ़ॉलो नहीं करता, उसका स्टोरी मेंशन।
- सामान्य पोस्ट पर टैग: Meta कहता है कि केवल स्टोरी मेंशन messages वेबहुक को ट्रिगर करते हैं, पोस्ट पर टैगिंग नहीं।
- GIF या स्टिकर के साथ किया गया स्टोरी जवाब, जिसे वेबहुक सपोर्ट नहीं करता।
- mentions एपीआई के ज़रिए स्टोरी: GET /<
IG_ID>/tags और POST /<IG_ID>/mentions इन्हें सपोर्ट नहीं करते, इसलिए स्टोरी मेंशन DM के ज़रिए ही आता है।
क्या स्टोरी मेंशन और जवाब मैसेजिंग विंडो खोलते हैं?
जवाब व्यक्ति का मैसेज है, और Meta स्टोरी मेंशन को उन चैनलों में गिनता है जिनसे व्यक्ति बातचीत शुरू करता है। उनकी कार्रवाई से खुलने वाली विंडो ज़्यादातर कार्रवाइयों के लिए 24 घंटे चलती है, इसलिए खाता तब तक POST /<IG_ID>/messages से जवाब दे सकता है जब recipient.id इवेंट के sender.id पर सेट हो। खाते का जवाब messages पर is_echo के true सेट के साथ इको के रूप में लौटता है।
easyCoexistence इन्हें कैसे भेजता है?
messages फ़ील्ड पर, जिसकी सदस्यता हर जुड़ा खाता लेता है, इसलिए स्टोरी मेंशन और स्टोरी जवाब खाते के बाकी DM के साथ आपके एंडपॉइंट तक पहुँचते हैं: हर entry platform, account_id, external_id और entry वाले एक एनवेलप के भीतर, X-EC-Signature में खाते के सीक्रेट से हस्ताक्षरित, एक बार भेजी गई और बिना कोई कॉपी रखे। send_social_dm व्यक्ति को जवाब देता है, recipient_id के रूप में इवेंट के sender.id के साथ, 24 घंटे की विंडो के भीतर।
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": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{ "type": "story_mention", "payload": { "url": "<CDN_URL>" } }
]
}
}
]
}
}आम गड़बड़ियाँ
- स्टोरी का मीडिया स्टोर करना। Meta की story mention गाइड CDN यूआरएल रखने की अनुमति देती है, कंटेंट की नहीं, जिसे आपके सर्वर पर स्टोर या कैश नहीं करना चाहिए।
- केवल message.text पढ़ना। स्टोरी मेंशन में story_mention टाइप का अटैचमेंट होता है और Meta के सैंपल में कोई टेक्स्ट नहीं होता, इसलिए केवल-टेक्स्ट हैंडलर को खाली मैसेज दिखता है।
- दिनों बाद स्टोरी यूआरएल रेंडर करना। 24 घंटे बाद समाप्त होने या डिलीट होने पर वह काम करना बंद कर देता है, इसलिए उसके बाद प्लेसहोल्डर दिखाएँ।
- comments फ़ील्ड या mentions एपीआई में स्टोरी मेंशन ढूँढना। Meta उन्हें messages पर DM के रूप में भेजता है।
send_social_dm 24 घंटे की विंडो के भीतर व्यक्ति को जवाब देता है, Claude, ChatGPT या आपके अपने कोड से। US$ 9 से लेकर US$ 0.75 तक प्रति कनेक्शन प्रति माह, जैसे-जैसे कनेक्शन जुड़ते हैं घटता हुआ, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या Instagram स्टोरी मेंशन इवेंट में टेक्स्ट होता है?
Meta के सैंपल में नहीं। स्टोरी मेंशन में story_mention टाइप का अटैचमेंट होता है जिसमें स्टोरी का CDN यूआरएल होता है, इसलिए जो हैंडलर केवल message.text पढ़ता है उसे खाली मैसेज दिखता है।
Instagram स्टोरी जवाब में link_sticker_url क्या है?
उस स्टोरी के लिंक स्टिकर पर का यूआरएल जिसका व्यक्ति ने जवाब दिया, reply_to.story.link_sticker_url में। Meta ने इसे 12 दिसंबर 2025 को जोड़ा और लिंक के आधार पर ऑटोमेशन रूट करने के लिए इसका सुझाव देता है।
क्या स्टोरी के GIF या स्टिकर वाले जवाब वेबहुक ट्रिगर करते हैं?
नहीं। Meta की Instagram Messaging गाइड कहती है कि वेबहुक GIF या स्टिकर से किए गए स्टोरी जवाबों को सपोर्ट नहीं करता।
क्या प्राइवेट खाते स्टोरी मेंशन वेबहुक ट्रिगर करते हैं?
केवल तब जब प्राइवेट खाता प्रोफ़ेशनल खाते को फ़ॉलो करता हो। सार्वजनिक खातों के मेंशन होते ही आते हैं।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित