Instagram मेसेज वेबहुक: DM पेलोड, इको आणि फील्ड्स
Instagram च्या messages वेबहुक फील्डमध्ये प्रोफेशनल खात्यांचे DM त्यांच्या येण्याच्या क्षणी येतात: मजकूर, अटॅचमेंट, शेअर, स्टोरी रिप्लाय आणि मेन्शन, इनलाइन रिप्लाय आणि डिलीशन. प्रत्येक इव्हेंट messaging ॲरेमध्ये असतो, ज्यात प्रेषकाचा Instagram-स्कोप्ड आयडी, प्राप्तकर्ता, टाइमस्टँप आणि मेसेज ऑब्जेक्ट असतो, आणि खाते स्वतः पाठवलेले मेसेज त्याच फील्डवर is_echo true सेट करून परत येतात.
easyCoexistence जोडलेल्या प्रत्येक Instagram खात्याला मेसेजेसचे सबस्क्रिप्शन देते आणि त्याचे DM, इकोंसह, येताच तुमच्या HTTPS एंडपॉइंटला फॉरवर्ड करते, त्या खात्याच्या सीक्रेटने साइन करून; फॉरवर्डिंग कोणतीही प्रत ठेवत नाही, आणि DM डीफॉल्टने साठवले जात नाहीत.
मेसेज इव्हेंटवर true सेट केलेले, जेव्हा खात्याने स्वतः पाठवलेला मेसेज असतो.
बहुतांश वापरकर्त्याच्या कृतींसाठी मानक मेसेजिंग विंडो, जिच्या आत ॲप व्यक्तीला रिप्लाय देऊ शकते.
शेअर केलेल्या पोस्टसाठी अटॅचमेंट प्रकार; जुना शेअर प्रकार फक्त 1 फेब्रुवारी 2026 पर्यंत समर्थित होता.
जेव्हा कोणी खात्याचा उल्लेख त्यांच्या स्टोरीमध्ये करतो, तेव्हा Meta पाठवणाऱ्या DM इव्हेंटचा अटॅचमेंट प्रकार.
कोड 200 अंतर्गत त्रुटी उपकोड, जेव्हा खात्याच्या मालकाने Instagram डायरेक्ट मेसेजेसचा ॲक्सेस बंद केलेला असतो.
messages फील्ड कधी ट्रिगर होते?
जेव्हा एखादी व्यक्ती प्रोफेशनल खात्याला 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: प्रोफेशनल खात्याचा आयडी. entry[].time: Meta ने नोटिफिकेशन कधी पाठवले; Meta च्या मेसेजिंग नमुन्यांत ते मिलिसेकंदात दिलेले असते.
- sender.id आणि recipient.id: येणाऱ्या DM वर, व्यक्तीचा Instagram-स्कोप्ड आयडी आणि खात्याचा आयडी; इकोवर, तेच दोन उलट क्रमात.
- timestamp: मेसेज कधी पाठवला गेला, Meta च्या नमुन्यांत मिलिसेकंदात. मेसेज येण्याच्या क्रमाने नव्हे, तर त्यानुसार लावा.
- message.mid: मेसेजचा आयडी, डुप्लिकेट ओळखण्यासाठी, प्रतिक्रियेसाठी आणि
reply_to.mid वापरून त्या मेसेजला रिप्लाय करण्यासाठी. - message.text: मेसेजमध्ये मजकूर असेल तेव्हा समाविष्ट.
- message.attachments[]: प्रत्येकात type आणि payload, सहसा url. शेअर केलेल्या पोस्टच्या
ig_postpayload मध्येig_post_media_idआणि title जोडले जातात, title म्हणजे त्याचे कॅप्शन. - message.
reply_to: इनलाइन रिप्लायसाठी mid, किंवा स्टोरी रिप्लायसाठी story, त्या स्टोरीच्या url आणि 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 Business Agent सारख्या Meta ॲप्लिकेशनने संभाषण हस्तांतरित केले; ते mid किंवा text शिवाय येऊ शकते.
इको कसे काम करतात?
जेव्हा खाते मेसेज पाठवते, तेव्हा Meta त्यासाठी देखील is_echo true सेट करून मेसेज इव्हेंट पाठवते. तेव्हा sender.id हे खाते असते आणि recipient.id व्यक्तीचा Instagram-स्कोप्ड आयडी असतो, आणि खात्याने स्वतःला पाठवलेल्या चाचणी मेसेजमध्ये 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-स्कोप्ड आयडी. कोणी खात्याला मेसेज करते किंवा त्याच्या मीडियावर कमेंट करते तेव्हा Meta तो तयार करते, आणि तो त्या व्यक्तीसाठी आणि त्या खात्यासाठी विशिष्ट असतो. recipient.id त्यावर सेट करून POST /<IG_ID>/messages पाठवल्यास रिप्लाय जातो. इव्हेंटमध्ये नाव किंवा वापरकर्तानाव नसते; GET /<IGSID> वर name आणि username सारखी फील्ड मागितली तर ती मिळतात, कारण ज्या व्यक्तीने खात्याला मेसेज केला आहे, तिने ती लुकअप करण्यासाठी आवश्यक संमती दिलेली असते.
मेसेज 24 तासांची विंडो कशी उघडतो?
व्यक्तीने खात्याला मेसेज केल्यानंतरच ॲप तिला मेसेज करू शकते, आणि तिच्या कृतीने उघडलेल्या मानक मेसेजिंग विंडोमध्येच. बहुतांश कृतींसाठी ती 24 तास चालते, आणि Click-to-Direct जाहिरातीवर क्लिक केल्यानंतर पाठवलेल्या पहिल्या मेसेजपासून 7 दिवसांपर्यंत. व्यक्तीचा नवीन मेसेज नवीन विंडो उघडतो, म्हणून त्यांचा सर्वात नवीन timestamp ट्रॅक करा; इको हा खात्याचा स्वतःचा मेसेज असल्याने काहीही वाढवत नाही. व्यक्तीने लिहिलेल्या रिप्लायसाठी Meta ची वेगळी 7 दिवसांची Human Agent विंडो वापरता येते, ती human_agent टॅगसह.
मेसेज इव्हेंटमध्ये काय नसते?
Meta च्या मेसेजिंग संदर्भांनुसार, हँडलर शोधू शकणाऱ्या काही गोष्टी त्यात नसतात:
- व्यक्तीचे नाव किंवा वापरकर्तानाव: फक्त Instagram-स्कोप्ड आयडी, जो GET /<IGSID> उकलतो.
- एकदाच पाहता येणारा मीडिया: तो URL शिवाय क्षणिक अटॅचमेंट म्हणून येतो.
- कॅरोसेल इमेजचा नेमका भाग: कॅरोसेल पोस्टमधील एका इमेजवरील प्रतिक्रिया किंवा फॉरवर्ड पहिली इमेज दर्शवते.
- प्रतिक्रिया, एडिट आणि वाचल्याच्या पावत्या, ज्या स्वतःच्या फील्डवर येतात.
- वाचल्याची खूण: वेबहुकद्वारे मिळालेला मेसेज रिप्लाय पाठवला जाईपर्यंत Instagram इनबॉक्समध्ये न वाचलेला राहतो.
Meta इतर कोणते मेसेजिंग फील्ड्स सूचीबद्ध करते?
Instagram Login साठी Meta ची फील्ड यादी आणि उदाहरणे messages व्यतिरिक्त या नावांनी आहेत, प्रत्येक स्वतंत्र मेसेजिंग इव्हेंट. easyCoexistence प्रत्येक खाते केवळ messages, comments आणि mentions ला सबस्क्राइब करते, त्यामुळे यापैकी कोणतेही ते फॉरवर्ड करत नाही:
message_reactions: व्यक्ती मेसेजवर प्रतिक्रिया देते किंवा ती काढते, reaction.mid, action मध्ये react किंवा unreact, आणि reaction व emoji सह.message_edit: व्यक्ती मेसेज एडिट करते,message_edit.mid, नवीन मजकूर आणिnum_editसह.messaging_postbacks: व्यक्ती आइसब्रेकर किंवा टेम्प्लेट बटण टॅप करते, postback.mid, title आणि payload सह.messaging_referral: संभाषणात आधीपासून असलेली व्यक्ती ref पॅरामीटर असलेली ig.me लिंक उघडते.messaging_seen: व्यक्ती मेसेज वाचते, read.mid सह.messaging_optins,messaging_handoverआणि standby: शेवटचे दोन, Meta च्या हँडओव्हर प्रोटोकॉलअंतर्गत संभाषण शेअर करणाऱ्या ॲप्ससाठी.
खात्याने काय सुरू करायचे?
मेसेजला ॲक्सेस द्या. API द्वारे मेसेज व्यवस्थापित करण्यापूर्वी प्रोफेशनल खात्याने ती सुरू करणे Meta आवश्यक करते, Instagram ॲपमध्ये सेटिंग्ज, मेसेजेस आणि स्टोरी रिप्लाय, मेसेज कंट्रोल्स, कनेक्टेड टूल्स या मार्गाने. ती बंद असताना, कोड 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 तपासा. रिप्लाय द्यायचा असल्यास, 24 तासांच्या विंडोत, account_id आणि इव्हेंटचा sender.id recipient_id म्हणून देऊन send_social_dm कॉल करा. 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 मेसेज वेबहुकचे टाइमस्टँप सेकंदात आहेत की मिलिसेकंदात?
Meta च्या मेसेजिंग नमुन्यांत, timestamp आणि entry time दोन्ही मिलिसेकंदात. सेकंद म्हणून वाचल्यास ते खूप दूरच्या भविष्यातील तारखा बनतात.
Instagram DM वेबहुकवरून पाठवणाऱ्याचे वापरकर्तानाव कसे मिळवायचे?
name आणि username सारख्या फील्डसह GET /<IGSID> कॉल करा. इव्हेंटमध्ये फक्त व्यक्तीचा Instagram-स्कोप्ड आयडी असतो.
माझे Instagram DM वेबहुक का येत नाहीत?
खात्याने मेसेजला ॲक्सेस देणे सुरू केले आहे का ते तपासा, /subscribed_apps द्वारे ते messages ला सबस्क्राइब आहे का ते पाहा, आणि ॲप ज्या खात्यांचे मालक नाही त्यांच्यासाठी Advanced Access सह लाइव्ह आहे का ते पाहा.
easyCoexistence Instagram मेसेजच्या प्रतिक्रिया फॉरवर्ड करते का?
नाही. प्रतिक्रिया message_reactions वर येतात, आणि easyCoexistence खाती केवळ messages, comments आणि mentions ला सबस्क्राइब करते.
पुढे वाचा
तुमचे पहिले चॅनेल दोन मिनिटांत कनेक्ट करा.
कोणत्याही प्लॅटफॉर्म पुनरावलोकनाची वाट पाहावी लागत नाही. WhatsApp, Instagram, TikTok किंवा दुसरे चॅनेल कनेक्ट करा, मग तुमच्या AI ला पोस्ट करायला, उत्तर द्यायला किंवा रिपोर्ट द्यायला सांगा आणि ते काम करताना पाहा.
- 3 दिवस मोफत
- कधीही रद्द करा
- फक्त अधिकृत एपीआय
- 24/7 देखरेख
पडताळले: