messages वेबहुक में Instagram DM अटैचमेंट
Instagram का messages वेबहुक DM मीडिया को message.attachments में भेजता है: यह ऑब्जेक्ट्स की एक ऐरे है, जिसमें हर ऑब्जेक्ट का type होता है और एक पेलोड, जिसमें आम तौर पर CDN यूआरएल होता है। Meta की Instagram Login सूची में image, video, audio, file, ig_post, ig_reel, reel, story_mention, media, story, ig_story और पुराना share नाम हैं। View-once मीडिया एक ephemeral अटैचमेंट के रूप में आता है, जिसमें कोई यूआरएल नहीं होता।
easyCoexistence हर जुड़े Instagram खाते को messages के लिए सब्सक्राइब करता है और DM को उसके अटैचमेंट के साथ आपके HTTPS एंडपॉइंट पर वैसे ही भेजता है जैसे Meta भेजता है, उस खाते के सीक्रेट से साइन करके और बिना कोई कॉपी रखे, ताकि आपका एजेंट या कोड ज़रूरी मीडिया खुद लाए।
शेयर किए गए पोस्ट का अटैचमेंट प्रकार; इसका पेलोड यूआरएल के साथ ig_post_media_id और title जोड़ता है, यानी पोस्ट का कैप्शन।
Instagram पोस्ट शेयर के लिए पुराने share अटैचमेंट प्रकार का समर्थन कब बंद हुआ।
गायब होने वाले मीडिया का अटैचमेंट प्रकार, view-once मीडिया, जो बिना यूआरएल के आता है।
जब मैसेज में असमर्थित मीडिया हो, तो मैसेज इवेंट पर इसे true सेट किया जाता है।
जब कोई carousel पोस्ट की एक इमेज पर रिएक्शन करता है या उसे फ़ॉरवर्ड करता है, तो नोटिफ़िकेशन क्या रिपोर्ट करता है।
किस प्रकार के अटैचमेंट DM इवेंट में आ सकते हैं?
Meta के Instagram Login उदाहरण message.attachments[].type के लिए ये मान सूचीबद्ध करते हैं, और हर एक के साथ एक पेलोड ऑब्जेक्ट होता है। ज़्यादातर पेलोड में Meta के CDN पर मीडिया का यूआरएल होता है। Meta ig_post के लिए ही अतिरिक्त पेलोड फ़ील्ड दर्ज करता है, इसलिए पेलोड पढ़ने से पहले type देखें।
अटैचमेंट वाले DM का इवेंट कैसा दिखता है?
एक messages इवेंट, जिसके मैसेज ऑब्जेक्ट में टेक्स्ट की जगह, या उसके साथ, attachments हों। Meta का नमूना एक ही मैसेज में दो मीडिया आइटम भेजता है, जिनमें से हर एक का अपना type और payload.url है, इसलिए हैंडलर को पहले आइटम को ही पढ़ने के बजाय ऐरे में लूप चलाना होगा:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{ "type": "image", "payload": { "url": "<CDN_URL>" } },
{ "type": "video", "payload": { "url": "<CDN_URL>" } }
]
}
}
]
}
]
}शेयर किए गए पोस्ट का इवेंट कैसा दिखता है?
एक ig_post अटैचमेंट। 3 नवंबर 2025 से Meta पोस्ट शेयर को share और ig_post, दोनों अटैचमेंट के साथ भेजता था; पोस्ट के लिए share 1 फ़रवरी 2026 तक समर्थित रहा, और Meta कहता है कि नए इंटीग्रेशन को ig_post का समर्थन करना होगा। इसका पेलोड पोस्ट का मीडिया ID जोड़ता है, और उसका कैप्शन title के रूप में:
"attachments": [
{
"type": "ig_post",
"payload": {
"ig_post_media_id": "<MEDIA_ID>",
"title": "<POST_CAPTION>",
"url": "<CDN_URL>"
}
}
]हर फ़ील्ड का क्या मतलब है?
DM इवेंट के लिए Meta जो अटैचमेंट फ़ील्ड दर्ज करता है, वे ऐरे से नीचे तक:
- message.attachments[]: हर मीडिया आइटम के लिए एक ऑब्जेक्ट; Meta के नमूने में एक ही मैसेज में दो हैं।
- type: आइटम क्या है, ऊपर की सूची से। पेलोड पढ़ने से पहले इसी के आधार पर ब्रांच करें।
- payload.url: मीडिया के लिए CDN यूआरएल। Meta का overview इन यूआरएल को privacy-aware कहता है: कंटेंट डिलीट होने या समाप्त होने के बाद ये कुछ नहीं लौटाते।
- payload.
ig_post_media_idऔर payload.title: सिर्फ़ig_postपर, शेयर किए गए पोस्ट का मीडिया ID और उसका कैप्शन। - message.text: केवल तब मौजूद, जब मैसेज में टेक्स्ट भी हो।
- message.
is_unsupported: true, जब मैसेज में ऐसा मीडिया हो जिसे वेबहुक समर्थित नहीं करता।
अटैचमेंट के यूआरएल कब तक काम करते हैं?
Meta इन्हें कंटेंट से जोड़ता है। उसका overview कहता है कि Instagram के CDN यूआरएल privacy-aware हैं और कंटेंट डिलीट होने या समाप्त होने के बाद मीडिया लौटाना बंद कर देते हैं। उसकी story mention गाइड कहती है कि Story का यूआरएल तब रेंडर होना बंद होता है जब Story समाप्त हो या डिलीट हो। जिस ऐप को फ़ाइल चाहिए, वह इवेंट आने पर, Meta के नियमों के भीतर रहते हुए, उसे लाए: Story मीडिया, उदाहरण के लिए, स्टोर या कैश नहीं किया जाना चाहिए।
वेबहुक कौन सा मीडिया छोड़ देता है?
Meta की Instagram Messaging गाइड ये अंतराल बताती है, जिन्हें हैंडलर को गड़बड़ी नहीं, बल्कि अपेक्षित स्थिति मानना चाहिए:
- गायब होने वाला मीडिया, view once या replay की अनुमति वाला: ephemeral प्रकार का अटैचमेंट, बिना यूआरएल के।
- असमर्थित मीडिया: मैसेज
is_unsupportedको true सेट करके आता है। - GIF और स्टिकर: वह गाइड कहती है कि इनसे कोई वेबहुक ट्रिगर नहीं होता, जबकि Meta के Instagram Login उदाहरण इन्हें image के तहत सूचीबद्ध करते हैं।
- चुनी गई carousel इमेज: carousel पोस्ट की एक इमेज पर रिएक्शन या उसके फ़ॉरवर्ड की रिपोर्ट पहली इमेज देती है।
- शेयर सामान्य रूप से: Meta की मैसेजिंग गाइड अब भी कहती हैं कि शेयर किए गए मीडिया का सिर्फ़ यूआरएल आता है, हालाँकि
ig_postअब मीडिया ID और कैप्शन जोड़ता है।
easyCoexistence अटैचमेंट कैसे फ़ॉरवर्ड करता है?
एंट्री के अंदर अपरिवर्तित: मीडिया वाला DM आपके एंडपॉइंट तक Meta के attachments ऐरे के साथ वैसे ही पहुँचता है जैसा Meta ने भेजा, platform, account_id, external_id और entry वाले एनवेलप में, जिस पर X-EC-Signature से हस्ताक्षर होता है। अटैचमेंट डाउनलोड नहीं होते, और इवेंट डिफ़ॉल्ट रूप से स्टोर नहीं होते: ऑटोमेशन चालू वाला खाता DM का टेक्स्ट 7 दिन तक रखता है, मीडिया नहीं। इवेंट आने पर payload.url से ज़रूरी मीडिया लाएँ, और Story मीडिया को बिना स्टोर किए छोड़ें।
आम गड़बड़ियाँ
- सिर्फ़ पहला अटैचमेंट पढ़ना। message.attachments एक ऐरे है, और Meta के नमूने में एक ही मैसेज में दो आइटम हैं, इसलिए इस पर लूप चलाएँ।
- शेयर किए गए पोस्ट के लिए अब भी type को share से मिलाना। Meta ने पोस्ट के लिए इसका समर्थन 1 फ़रवरी 2026 तक किया; ig_post पढ़ें, जिसके पेलोड में मीडिया ID और कैप्शन है।
- payload.url को बाद में लाने के लिए सहेजना। कंटेंट डिलीट या समाप्त होने के बाद यह मीडिया लौटाना बंद कर देता है, इसलिए आते ही ज़रूरी चीज़ डाउनलोड करें, Story मीडिया को छोड़कर।
- type जाँचे बिना payload.url पढ़ना। view-once मीडिया बिना यूआरएल के ephemeral के रूप में आता है, और असमर्थित मीडिया is_unsupported सेट करता है।
send_social_dm 24 घंटे की विंडो के भीतर जवाब देता है। US$ 9 से US$ 0.75 प्रति कनेक्शन प्रति माह, जैसे-जैसे कनेक्शन जुड़ते हैं वैसे घटती दर, और पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या मैं Instagram DM अटैचमेंट का मीडिया स्टोर कर सकता हूँ?
इवेंट आने पर ज़रूरी मीडिया डाउनलोड करें, क्योंकि payload.url कंटेंट डिलीट या समाप्त होने के बाद मीडिया लौटाना बंद कर देता है। Story मीडिया अपवाद है: Meta के नियम कहते हैं कि वह स्टोर या कैश नहीं किया जाना चाहिए।
Instagram DM वेबहुक में मीडिया का यूआरएल क्यों नहीं होता?
आम तौर पर इसलिए कि मीडिया view-once है, जो बिना यूआरएल के ephemeral अटैचमेंट के रूप में आता है, या असमर्थित है, जो is_unsupported को true सेट करता है।
क्या Instagram GIF और स्टिकर messages वेबहुक ट्रिगर करते हैं?
Meta के दस्तावेज़ आपस में असहमत हैं: उसके Instagram Login उदाहरण GIF और स्टिकर को image के तहत सूचीबद्ध करते हैं, जबकि उसकी Instagram Messaging गाइड कहती है कि इनसे कोई वेबहुक ट्रिगर नहीं होता। किसी असली खाते से जाँचें।
क्या एक Instagram DM इवेंट में कई अटैचमेंट हो सकते हैं?
हाँ। message.attachments एक ऐरे है, और Meta के नमूने में एक ही मैसेज में दो मीडिया आइटम दिखते हैं।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित