मेसेजेस वेबहुकमधील Instagram DM अटॅचमेंट्स
Instagram च्या मेसेजेस वेबहुकमध्ये DM मीडिया message.attachments मध्ये येतो: ही एक ॲरे असते, ज्यातील प्रत्येक ऑब्जेक्टमध्ये type आणि पेलोड असतो, आणि पेलोडमध्ये सहसा CDN यूआरएल असतो. Instagram Login साठीच्या Meta च्या यादीत image, video, audio, file, ig_post, ig_reel, reel, story_mention, media, story, ig_story आणि जुना share ही नावे आहेत, आणि एकदाच पाहता येणारा मीडिया यूआरएल नसलेला ephemeral अटॅचमेंट म्हणून येतो.
easyCoexistence प्रत्येक कनेक्टेड Instagram खात्याला messages साठी सबस्क्राइब करते आणि मीडिया अटॅचमेंटसह DM तुमच्या HTTPS एंडपॉइंटकडे Meta पाठवते तसे फॉरवर्ड करते, त्या खात्याच्या सीक्रेटने स्वाक्षरी केलेले, आणि वाटेत कोणतीही प्रत ठेवली जात नाही, त्यामुळे तुमचा एजंट किंवा कोड गरजेचा मीडिया स्वतः मिळवतो.
शेअर केलेल्या पोस्टचा अटॅचमेंट प्रकार; त्याच्या पेलोडमध्ये url सोबत ig_post_media_id आणि title जोडले जाते, जे पोस्टचे कॅप्शन आहे.
Instagram पोस्ट शेअरसाठी जुना share अटॅचमेंट प्रकार कधी समर्थित राहिला नाही.
डिसअपिअरिंग, एकदाच पाहता येणाऱ्या मीडियाचा अटॅचमेंट प्रकार, जो यूआरएल शिवाय येतो.
असमर्थित मीडिया असताना message इव्हेंटवर true सेट केले जाते.
कॅरोसेल पोस्टमधील एका इमेजवर कोणी प्रतिक्रिया दिली किंवा ती फॉरवर्ड केली तेव्हा सूचना काय नोंदवते.
कोणते अटॅचमेंट प्रकार DM इव्हेंटमध्ये असू शकतात?
Meta च्या Instagram Login उदाहरणांमध्ये message.attachments[].type साठी ही मूल्ये दिलेली आहेत, प्रत्येकासोबत payload ऑब्जेक्ट असतो. बहुतेक पेलोडमध्ये Meta च्या CDN वरील मीडियाचा url असतो, आणि Meta फक्त ig_post साठी अतिरिक्त पेलोड फील्ड्सचे दस्तऐवजीकरण करते, म्हणून पेलोड वाचण्यापूर्वी type तपासा.
DM मध्ये अटॅचमेंट असताना कसे दिसते?
एक मेसेजेस इव्हेंट ज्यामध्ये message ऑब्जेक्टमध्ये मजकुराऐवजी किंवा त्यासोबत 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 च्या आढाव्यात हे यूआरएल गोपनीयता-जागरूक असल्याचे म्हटले आहे: कंटेंट हटवला गेल्यावर किंवा कालबाह्य झाल्यावर ते काहीही परत करत नाहीत.
- payload.
ig_post_media_idआणि payload.title: फक्तig_postवर, शेअर केलेल्या पोस्टचा मीडिया ID आणि तिचे कॅप्शन. - message.text: केवळ तेव्हाच उपस्थित, जेव्हा मेसेजमध्ये मजकूरही असतो.
- message.
is_unsupported: true, जेव्हा मेसेजमध्ये webhook समर्थित न करणारा मीडिया असतो.
अटॅचमेंट यूआरएल किती काळ चालतात?
Meta त्यांना कंटेंटशी जोडते. त्यांच्या आढाव्यात म्हटले आहे की Instagram चे CDN यूआरएल गोपनीयता-जागरूक आहेत आणि कंटेंट हटवला गेल्यावर किंवा कालबाह्य झाल्यावर मीडिया परत करणे थांबवतात, आणि स्टोरी मेन्शन मार्गदर्शक सांगते की स्टोरी कालबाह्य झाल्यावर किंवा हटवल्यावर तिचा यूआरएल रेंडर होणे थांबते. ज्या अॅपला फाईल हवी आहे, त्याने इव्हेंट आल्यावर, Meta च्या नियमांच्या चौकटीत, ती मिळवावी: उदाहरणार्थ, स्टोरी मीडिया साठवला किंवा कॅश केला जाऊ नये.
कोणता मीडिया webhook वगळतो?
Meta च्या Instagram Messaging मार्गदर्शकात ही उणीव नमूद केली आहे, जी हँडलरने त्रुटी मानण्याऐवजी अपेक्षित धरावी:
- अदृश्य होणारा मीडिया, एकदाच पाहता येणारा किंवा replay ची परवानगी असलेला: ephemeral प्रकाराचा अटॅचमेंट, यूआरएल शिवाय.
- असमर्थित मीडिया: मेसेज
is_unsupportedtrue सेट करून येतो. - GIF आणि स्टिकर्स: त्या मार्गदर्शकानुसार ते कोणताही webhook ट्रिगर करत नाहीत, तर Meta च्या Instagram Login उदाहरणांमध्ये ते image अंतर्गत सूचीबद्ध आहेत.
- निवडलेली कॅरोसेल इमेज: कॅरोसेल पोस्टमधील एका इमेजवरील प्रतिक्रिया किंवा फॉरवर्ड पहिली इमेज नोंदवते.
- सर्वसाधारणपणे शेअर्स: Meta चे मेसेजिंग मार्गदर्शक अजूनही म्हणते की शेअर केलेल्या मीडियाचा फक्त यूआरएल समाविष्ट केला जातो, जरी
ig_postआता मीडिया ID आणि कॅप्शन जोडते.
easyCoexistence अटॅचमेंट कसे फॉरवर्ड करते?
entry च्या आत अपरिवर्तित: मीडिया असलेला DM तुमच्या एंडपॉइंटपर्यंत Meta ने पाठवल्याप्रमाणेच Meta चा attachments array घेऊन पोहोचतो, platform, account_id, external_id आणि entry च्या envelope मध्ये, X-EC-Signature सह स्वाक्षरीत. Attachments डाउनलोड केले जात नाहीत, आणि इव्हेंट्स डीफॉल्टने साठवले जात नाहीत: ऑटोमेशन चालू असलेले खाते DM चा मजकूर, मीडिया नव्हे, 7 दिवस ठेवते. इव्हेंट आल्यावर payload.url वरून तुम्हाला हवा तो मीडिया मिळवा आणि स्टोरी मीडिया साठवू नका.
सामान्य चुका
- फक्त पहिला अटॅचमेंट वाचणे. message.attachments ही एक ॲरे आहे, आणि Meta च्या नमुन्यात एका मेसेजमध्ये दोन आयटम आहेत, म्हणून त्यावर लूप चालवा.
- शेअर केलेल्या पोस्टसाठी अजूनही type share जुळवणे. Meta ने पोस्टसाठी ते 1 फेब्रुवारी 2026 पर्यंत समर्थित केले; ig_post वाचा, मीडिया ID आणि कॅप्शन त्याच्या पेलोडमध्ये असतात.
- नंतर आणण्यासाठी payload.url जतन करणे. कंटेंट हटवला गेल्यावर किंवा कालबाह्य झाल्यावर ते मीडिया परत करणे थांबवते, म्हणून आल्यावरच तुम्हाला हवा मीडिया डाउनलोड करा, स्टोरी मीडिया वगळता.
- type तपासल्याशिवाय payload.url वाचणे. एकदाच पाहता येणारा मीडिया ephemeral म्हणून यूआरएल शिवाय येतो, आणि असमर्थित मीडिया त्याऐवजी is_unsupported सेट करतो.
send_social_dm 24-तासांच्या विंडोमध्ये उत्तर देते. प्रति कनेक्शन प्रति महिना US$ 9 ते US$ 0.75, कनेक्शन जोडल्यावर कमी होत जाते, पहिले 3 दिवस मोफत.
वारंवार विचारले जाणारे प्रश्न
Instagram DM अटॅचमेंटमधील मीडिया साठवू शकतो का?
इव्हेंट आल्यावर गरजेचा मीडिया डाउनलोड करा, कारण कंटेंट हटवला गेल्यावर किंवा कालबाह्य झाल्यावर payload.url मीडिया परत करणे थांबवते. स्टोरी मीडिया अपवाद आहे: Meta च्या नियमांनुसार तो साठवला किंवा कॅश केला जाऊ नये.
Instagram DM webhook मध्ये मीडिया यूआरएल का नसतो?
सहसा कारण मीडिया एकदाच पाहता येणारा असतो, जो यूआरएल शिवाय ephemeral अटॅचमेंट म्हणून येतो, किंवा असमर्थित असतो, ज्यात is_unsupported true सेट होतो.
Instagram GIF आणि स्टिकर्स messages webhook ट्रिगर करतात का?
Meta च्या कागदपत्रांत विसंगती आहे: त्यांच्या Instagram Login उदाहरणांमध्ये GIF आणि स्टिकर्स image अंतर्गत सूचीबद्ध आहेत, तर Instagram Messaging मार्गदर्शक म्हणते की ते कोणताही webhook ट्रिगर करत नाहीत. प्रत्यक्ष खात्यासह चाचणी करा.
एका Instagram DM इव्हेंटमध्ये अनेक अटॅचमेंट असू शकतात का?
हो. message.attachments ही एक ॲरे आहे, आणि Meta च्या नमुन्यात एका मेसेजमध्ये दोन मीडिया आयटम दाखवले आहेत.
पुढे वाचा
तुमचे पहिले चॅनेल दोन मिनिटांत कनेक्ट करा.
कोणत्याही प्लॅटफॉर्म पुनरावलोकनाची वाट पाहावी लागत नाही. WhatsApp, Instagram, TikTok किंवा दुसरे चॅनेल कनेक्ट करा, मग तुमच्या AI ला पोस्ट करायला, उत्तर द्यायला किंवा रिपोर्ट द्यायला सांगा आणि ते काम करताना पाहा.
- 3 दिवस मोफत
- कधीही रद्द करा
- फक्त अधिकृत एपीआय
- 24/7 देखरेख
पडताळले: