Instagram मैसेज वेबहुक: DM पेलोड, इको और फ़ील्ड
Instagram का messages वेबहुक फ़ील्ड किसी प्रोफ़ेशनल अकाउंट के DM को आते ही भेजता है: टेक्स्ट, अटैचमेंट, शेयर, स्टोरी रिप्लाई और मेंशन, इनलाइन रिप्लाई और डिलीट किए गए मैसेज। हर इवेंट एक messaging ऐरे में होता है, जिसमें भेजने वाले का Instagram-scoped ID, प्राप्तकर्ता, timestamp और मैसेज ऑब्जेक्ट होता है, और अकाउंट द्वारा खुद भेजे गए मैसेज उसी फ़ील्ड पर is_echo true के साथ लौटते हैं।
easyCoexistence हर जुड़े Instagram अकाउंट को messages की सदस्यता देता है और उसके DM, इको सहित, आते ही आपके HTTPS एंडपॉइंट पर भेजता है, उस अकाउंट के सीक्रेट से साइन किए हुए; फ़ॉरवर्ड करते समय कोई कॉपी नहीं रखी जाती, और DM डिफ़ॉल्ट रूप से स्टोर नहीं होते।
मैसेज इवेंट पर true सेट होता है, जब मैसेज अकाउंट ने खुद भेजा हो।
ज़्यादातर यूज़र एक्शन के लिए मानक मैसेजिंग विंडो, जिसके दौरान ऐप उस व्यक्ति को जवाब दे सकता है।
शेयर किए गए पोस्ट का अटैचमेंट टाइप; पुराना शेयर टाइप केवल 1 फ़रवरी 2026 तक समर्थित था।
उस DM इवेंट का अटैचमेंट टाइप जो Meta भेजता है, जब कोई अपनी स्टोरी में अकाउंट का ज़िक्र करता है।
एरर सबकोड, कोड 200 के अंतर्गत, जब अकाउंट के मालिक ने Instagram डायरेक्ट मैसेज की पहुँच बंद की हो।
messages फ़ील्ड कब चलता है?
जब कोई व्यक्ति प्रोफ़ेशनल अकाउंट को DM भेजता है, और जब अकाउंट खुद कोई DM भेजता है। Meta के उदाहरण और संदर्भ ये मामले सूचीबद्ध करते हैं, हर एक मैसेज ऑब्जेक्ट वाला मैसेजिंग इवेंट है:
- टेक्स्ट, और मीडिया अटैचमेंट के रूप में: इमेज, वीडियो, ऑडियो और फ़ाइलें।
- शेयर किया गया पोस्ट या रील,
ig_post,ig_reelया reel अटैचमेंट के रूप में। - अकाउंट की स्टोरी पर रिप्लाई,
reply_to.story के साथ, और स्टोरी जो अकाउंट का ज़िक्र करती है,story_mentionअटैचमेंट के रूप में। - किसी पुराने मैसेज का इनलाइन रिप्लाई,
reply_to.mid के साथ, और क्विक रिप्लाई,quick_reply.payload के साथ। - वह मैसेज जिसे व्यक्ति ने डिलीट किया (
is_deleted), अनसपोर्टेड मीडिया (is_unsupported), और वह मैसेज जो Click-to-Direct विज्ञापन पर क्लिक करने वाले व्यक्ति से आया (referral)। - अकाउंट का भेजा मैसेज, जो
is_echotrue के साथ लौटता है।
मैसेज नोटिफ़िकेशन कैसा दिखता है?
एक POST, जिसके JSON में object का मान instagram है। कमेंट से अलग, मैसेज अकाउंट की entry के भीतर एक messaging ऐरे में होता है, और हर एलिमेंट में sender, recipient, timestamp और message होते हैं। अकाउंट की स्टोरी पर रिप्लाई ऐसा दिखता है:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"text": "<MESSAGE_TEXT>",
"reply_to": {
"story": {
"url": "<CDN_URL_FOR_THE_STORY>",
"id": "<STORY_ID>"
}
}
}
}
]
}
]
}हर फ़ील्ड का क्या मतलब है?
Instagram Login के तहत मैसेज इवेंट के लिए Meta जो फ़ील्ड दस्तावेज़ित करता है, बाहर से अंदर तक:
- entry[].id: प्रोफ़ेशनल अकाउंट का ID। entry[].time: Meta ने नोटिफ़िकेशन कब भेजा; Meta के मैसेजिंग नमूनों में यह मिलीसेकंड में है।
- sender.id और recipient.id: आने वाले DM पर, व्यक्ति का Instagram-scoped ID और अकाउंट का ID; इको पर, वही दोनों उल्टे क्रम में।
- timestamp: मैसेज कब भेजा गया; Meta के नमूनों में मिलीसेकंड में। मैसेज को इसी से क्रम में लगाएँ, आने के क्रम से नहीं।
- message.mid: मैसेज ID, डुप्लिकेट हटाने, रिएक्शन और
reply_to.mid से उस मैसेज का जवाब देने के लिए। - message.text: जब मैसेज में टेक्स्ट हो, तब शामिल।
- message.attachments[]: हर एक में type और पेलोड, आम तौर पर यूआरएल। शेयर किए गए पोस्ट के
ig_postपेलोड मेंig_post_media_idऔर title जुड़ते हैं, जो उसका कैप्शन है। - message.
reply_to: इनलाइन रिप्लाई के लिए mid, या स्टोरी रिप्लाई के लिए story, जिसमें स्टोरी का यूआरएल और id होता है। - message.
quick_reply.payload और message.referral: चुना गया क्विक रिप्लाई, और Click-to-Direct विज्ञापन का ref,ad_id, source, type औरads_context_data। - message.
is_deleted,is_echo,is_selfऔरis_unsupported: केवल true होने पर शामिल। - message.
admin_textऔरhandoff_reason: योग्य ऐप्स पर, एक सूचना कि Meta ऐप, जैसे Meta Business Agent, ने बातचीत सौंपी; यह बिना mid या टेक्स्ट के भी आ सकती है।
इको कैसे काम करते हैं?
जब अकाउंट कोई मैसेज भेजता है, तो Meta उसके लिए भी messages इवेंट भेजता है, जिसमें is_echo true होता है। तब sender.id अकाउंट होता है और recipient.id व्यक्ति का Instagram-scoped ID, और अकाउंट जो टेस्ट मैसेज खुद को भेजता है उसमें is_self भी होता है। इको यह दर्ज करते हैं कि अकाउंट ने क्या कहा, जिसकी बातचीत-लॉग को ज़रूरत होती है, पर जो हैंडलर तय करता है कि जवाब देना है या नहीं, उसे इन्हें छोड़ना होता है। जब अकाउंट किसी मैसेज पर रिएक्शन देता है या उसे हटाता है, तो Meta कोई इको नहीं भेजता।
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448061203,
"messaging": [
{
"sender": { "id": "<IG_ID>" },
"recipient": { "id": "<IGSID>" },
"timestamp": 1793448060950,
"message": {
"mid": "<MESSAGE_ID>",
"text": "<REPLY_TEXT>",
"is_echo": true
}
}
]
}
]
}किस ID पर जवाब देते हैं?
sender.id, यानी व्यक्ति का Instagram-scoped ID। यह तब बनता है जब कोई अकाउंट को मैसेज करता है या उसके मीडिया पर कमेंट करता है, और यह उस व्यक्ति और उस अकाउंट के लिए ख़ास है। POST /<IG_ID>/messages के साथ recipient.id इसी पर सेट करके जवाब भेजा जाता है। इवेंट में नाम या यूज़रनेम नहीं होता; name और username जैसे फ़ील्ड के साथ GET /<IGSID> उन्हें लौटाता है, क्योंकि जिस व्यक्ति ने अकाउंट को मैसेज किया है, उसने वह सहमति दी है जो इस लुकअप के लिए ज़रूरी है।
मैसेज 24 घंटे की विंडो कैसे खोलता है?
कोई ऐप किसी व्यक्ति को तभी मैसेज कर सकता है जब उसने अकाउंट को पहले मैसेज किया हो, और केवल उस मानक मैसेजिंग विंडो के भीतर जो उसकी कार्रवाई खोलती है। ज़्यादातर कार्रवाइयों के लिए यह 24 घंटे चलती है, और Click-to-Direct विज्ञापन पर क्लिक के बाद भेजे गए पहले मैसेज से 7 दिन तक। व्यक्ति का नया मैसेज नई विंडो खोलता है, इसलिए उसका ताज़ा timestamp ही ट्रैक करना है; इको अकाउंट का अपना मैसेज है और कुछ नहीं बढ़ाता। व्यक्ति द्वारा लिखे जवाब Meta की अलग 7 दिन की Human Agent विंडो का उपयोग कर सकते हैं, जिसे human_agent टैग किया जाता है।
messages इवेंट में क्या नहीं होता?
Meta के मैसेजिंग संदर्भों के अनुसार, कुछ चीज़ें जो हैंडलर ढूँढ सकता है, इसमें नहीं होतीं:
- व्यक्ति का नाम या यूज़रनेम: केवल Instagram-scoped ID, जिसे GET /<IGSID> हल करता है।
- एक बार देखे जाने वाला मीडिया: यह बिना यूआरएल के अस्थायी अटैचमेंट के रूप में आता है।
- कैरोसेल की सटीक इमेज: कैरोसेल पोस्ट की एक इमेज पर रिएक्शन या फ़ॉरवर्ड पहली इमेज दर्ज करता है।
- रिएक्शन, एडिट और रीड रिसीप्ट, जो अपने अलग फ़ील्ड पर आते हैं।
- रीड मार्क: वेबहुक से मिला मैसेज Instagram इनबॉक्स में तब तक अनरीड रहता है जब तक जवाब न भेजा जाए।
Meta और कौन से मैसेजिंग फ़ील्ड सूचीबद्ध करता है?
Instagram Login के लिए Meta की फ़ील्ड-सूची और उदाहरण messages के अलावा इन्हें नाम देते हैं, जिनमें से हर एक का अपना मैसेजिंग इवेंट है। easyCoexistence हर अकाउंट को केवल messages, comments और mentions की सदस्यता देता है, इसलिए इनमें से कोई भी वह नहीं है जो वह आगे भेजता है:
message_reactions: व्यक्ति किसी मैसेज पर रिएक्ट करता है या रिएक्शन हटाता है, reaction.mid, action जिसका मान react या unreact होता है, और reaction व इमोजी के साथ।message_edit: व्यक्ति मैसेज एडिट करता है,message_edit.mid, नए टेक्स्ट औरnum_editके साथ।messaging_postbacks: व्यक्ति आइसब्रेकर या टेम्पलेट बटन पर टैप करता है, postback.mid, title और पेलोड के साथ।messaging_referral: बातचीत में पहले से मौजूद व्यक्ति ref पैरामीटर वाला ig.me लिंक खोलता है।messaging_seen: व्यक्ति मैसेज पढ़ता है, read.mid के साथ।messaging_optins,messaging_handoverऔर standby: आखिरी दो उन ऐप्स के लिए जो Meta के हैंडओवर प्रोटोकॉल के तहत बातचीत साझा करते हैं।
अकाउंट पर क्या चालू करना होगा?
Allow access to messages चालू करें। Meta माँगता है कि प्रोफ़ेशनल अकाउंट इसे चालू करे, तभी उसके मैसेज एपीआई से प्रबंधित हो सकते हैं। यह Instagram ऐप में Settings, Messages and story replies, Message controls, Connected tools के अंतर्गत है। जब यह बंद होता है, भेजना कोड 200, सबकोड 2534041 के साथ विफल होता है। ऐप को instagram_business_basic और instagram_business_manage_messages भी चाहिए, और जिन अकाउंट का वह मालिक या प्रबंधक नहीं है, उनकी सेवा के लिए Advanced Access।
easyCoexistence DM कैसे आगे भेजता है?
कमेंट की तरह: अकाउंट के लिए Meta जो भी entry भेजता है, वह platform, account_id, external_id और entry वाले एनवेलप में आपके HTTPS एंडपॉइंट पर POST होता है, X-EC-Signature में अकाउंट के सीक्रेट से साइन किया हुआ, एक बार, और कोई कॉपी रखे बिना। इको बाक़ी के साथ आगे भेजे जाते हैं, इसलिए जवाब देने से पहले is_echo जाँचें। जवाब देने के लिए, account_id और इवेंट का sender.id recipient_id के रूप में देकर send_social_dm कॉल करें, 24 घंटे की विंडो के भीतर। DM पर शुरू होने वाले ऑटोमेशन उन्हीं इवेंट पर चलते हैं।
{
"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": "image", "payload": { "url": "<URL_FOR_THE_MEDIA>" } }
]
}
}
]
}
}आम गड़बड़ियाँ
- इको पर जवाब देना। जिस इवेंट पर is_echo सेट हो, वह अकाउंट का अपना मैसेज है, और उसका जवाब अकाउंट को खुद के साथ लूप में भेज देता है।
- मान लेना कि मैसेज में हमेशा टेक्स्ट होगा। अटैचमेंट, शेयर, स्टोरी मेंशन और डिलीट बिना text फ़ील्ड के आते हैं, इसलिए मैसेज ऑब्जेक्ट में जो है उसी के अनुसार ब्रांच करें।
- आने के क्रम से मैसेज लगाना। विफलता के बाद Meta मैसेज बेतरतीब क्रम में भेज सकता है, इसलिए उन्हें timestamp से छाँटें।
- time और timestamp को सेकंड मानकर पढ़ना। Meta के मैसेजिंग नमूने दोनों मिलीसेकंड में देते हैं, और सेकंड मानकर पढ़ने पर वे बहुत दूर भविष्य की तारीखें बन जाते हैं।
send_social_dm 24 घंटे की विंडो के भीतर जवाब देता है, और ऑटोमेशन निश्चित टेक्स्ट या AI से खुद जवाब दे सकते हैं। प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, कनेक्शन बढ़ने पर घटते हुए, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
Instagram मैसेज वेबहुक के timestamp सेकंड में हैं या मिलीसेकंड में?
Meta के मैसेजिंग नमूनों में मिलीसेकंड में, timestamp और entry time दोनों के लिए। सेकंड मानकर पढ़ने पर वे बहुत दूर भविष्य की तारीखें बन जाते हैं।
Instagram DM वेबहुक से भेजने वाले का यूज़रनेम कैसे मिलेगा?
name और username जैसे फ़ील्ड के साथ GET /<IGSID> कॉल करें। इवेंट में केवल व्यक्ति का Instagram-scoped ID होता है।
मेरे Instagram DM वेबहुक क्यों नहीं आ रहे हैं?
जाँचें कि अकाउंट ने Allow access to messages चालू किया है, वह /subscribed_apps के ज़रिए messages की सदस्यता ले चुका है, और ऐप उन अकाउंट के लिए Advanced Access के साथ Live है जिनका वह मालिक नहीं है।
क्या easyCoexistence Instagram मैसेज रिएक्शन आगे भेजता है?
नहीं। रिएक्शन message_reactions पर आते हैं, और easyCoexistence अकाउंट को केवल messages, comments और mentions की सदस्यता देता है।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित