Instagram DM इतिहास पढ़ना: Conversations API
Instagram का Conversations API graph.instagram.com पर किसी प्रोफ़ेशनल खाते का DM इतिहास पढ़ता है। GET /me/conversations?platform=instagram हर बातचीत को उसके updated_time के साथ सूचीबद्ध करता है, GET /<CONVERSATION_ID>?fields=messages किसी बातचीत के मैसेज को ID और समय के अनुसार सूचीबद्ध करता है, और GET /<MESSAGE_ID>?fields=id,created_time,from,to,message एक मैसेज लौटाता है। हर बातचीत के सबसे नए 20 मैसेज का विवरण उपलब्ध है।
easyCoexistence हर नए Instagram DM को आते ही आपके एंडपॉइंट तक पहुँचाता है और 24 घंटे की विंडो के भीतर send_social_dm से जवाब देता है, Claude, ChatGPT या आपके अपने कोड से, Meta के आधिकारिक API पर; Conversations API के इतिहास के लिए इसमें कोई टूल नहीं है।
हर बातचीत के सबसे नए मैसेज, जिनका विवरण API लौटाता है; पुराने मैसेज के लिए गड़बड़ी का जवाब आता है कि वे हटाए जा चुके हैं।
वह निष्क्रियता अवधि, जिसके बाद Requests फ़ोल्डर की बातचीतें नहीं लौटाई जातीं।
एक ऐप प्रति सेकंड जितनी Conversations API कॉल कर सकता है, हर Instagram प्रोफ़ेशनल खाते के लिए।
instagram_business_basic और instagram_business_manage_messages, उस टोकन के साथ जो खाते के मैसेज प्रबंधित कर सकने वाले किसी व्यक्ति का हो।
किसी खाते की बातचीतें कैसे सूचीबद्ध करें?
GET /me/conversations, या /<IG_ID>/conversations, के साथ platform=instagram लिखकर, और उस Instagram User access token के साथ जो खाते के मैसेज प्रबंधित कर सकता हो। data array की हर प्रविष्टि एक बातचीत है, जिसकी id और updated_time होते हैं।
GET https://graph.instagram.com/me/conversations
?platform=instagram
&access_token=<ACCESS_TOKEN>
{
"data": [
{ "id": "<CONVERSATION_ID>", "updated_time": "<UPDATED_TIME>" }
]
}किसी एक व्यक्ति के साथ की बातचीत कैसे खोजें?
user_id जोड़ें, उस व्यक्ति का Instagram-scoped ID, यानी IGSID, जो खाते को मैसेज करने पर sender.id के रूप में आता है। जवाब में उस बातचीत की id लौटती है। इससे पूरी सूची पेज दर पेज देखे बिना वेबहुक इवेंट को उसके थ्रेड से जोड़ा जा सकता है।
GET https://graph.instagram.com/me/conversations
?user_id=<IGSID>
&access_token=<ACCESS_TOKEN>मैसेज कैसे पढ़ें?
दो चरणों में। GET /<CONVERSATION_ID>?fields=messages बातचीत के मैसेज को id और created_time के साथ सूचीबद्ध करता है, जो डिफ़ॉल्ट फ़ील्ड हैं। फिर GET /<MESSAGE_ID> के साथ fields=id,created_time,from,to,message एक मैसेज लौटाता है: किसने और किसे भेजा, हर एक के username और ID के साथ, और उसका टेक्स्ट।
GET https://graph.instagram.com/<CONVERSATION_ID>
?fields=messages
&access_token=<ACCESS_TOKEN>
GET https://graph.instagram.com/<MESSAGE_ID>
?fields=id,created_time,from,to,message
&access_token=<ACCESS_TOKEN>कितने पीछे तक पढ़ा जा सकता है?
Meta की गाइड और ओवरव्यू लौटने वाली चीज़ों पर चार सीमाएँ तय करते हैं:
- मैसेज का विवरण: हर बातचीत के सबसे नए 20 मैसेज; इससे पुराने मैसेज का अनुरोध करने पर गड़बड़ी आती है कि वह हटाया जा चुका है।
- Requests: Requests फ़ोल्डर की वे बातचीतें जिनमें 30 दिन से कोई गतिविधि नहीं हुई, नहीं लौटाई जातीं।
- शेयर: साझा किया गया पोस्ट या Reel केवल उसके इमेज या वीडियो URL के रूप में लौटता है।
- दर: हर Instagram प्रोफ़ेशनल खाते के लिए प्रति सेकंड 2 कॉल।
इसके लिए क्या चाहिए?
Instagram Login के साथ instagram_business_basic और instagram_business_manage_messages अनुमतियाँ, और उस व्यक्ति का टोकन जो खाते के मैसेज प्रबंधित कर सकता हो। जिन खातों के आप मालिक या प्रबंधक हैं और जिन्हें आपने ऐप में जोड़ा है, उनके लिए Standard Access काफ़ी है; दूसरे खातों की सेवा के लिए Advanced Access चाहिए। खाते की Instagram ऐप सेटिंग में "Allow access to messages" भी चालू होना चाहिए।
वेबहुक से रिकॉर्ड क्यों रखें?
क्योंकि API हर बातचीत के सबसे नए 20 मैसेज का ही विवरण लौटाता है, इसलिए पूरा इतिहास जैसे-जैसे घटित हो, वैसे संग्रहित करना होगा। messages वेबहुक DM को जैसे ही वे आते हैं भेजता है, जिसमें व्यक्ति का IGSID sender.id के रूप में होता है। खाते द्वारा भेजे गए मैसेज भी आते हैं, जिनमें ID उलटे क्रम में होते हैं, ताकि बातचीत के दोनों पक्ष रिकॉर्ड किए जा सकें।
easyCoexistence के ज़रिए DM इतिहास कैसे पढ़ें?
यह DM आगे भेजता है, इतिहास नहीं पढ़ता। set_social_webhook_destination से एक सेट करने के बाद नए DM आते ही आपके एंडपॉइंट तक पहुँचते हैं, बिना कॉपी रखे आगे भेजे जाते हैं, और send_social_dm 24 घंटे की विंडो के भीतर जवाब देता है, Claude, ChatGPT या आपके अपने कोड से। कोई टूल me/conversations को कॉल नहीं करता, इसलिए पुराने मैसेज Instagram ऐप में पढ़े जाते हैं, या आपका अपना सिस्टम उन्हें आते ही रख लेता है।
आम गड़बड़ियाँ
- API से पूरे थ्रेड की अपेक्षा करना। विवरण सबसे नए 20 मैसेज पर रुक जाता है, इसलिए messages वेबहुक से आते ही DM संग्रहित करें।
- नए DM के लिए बातचीतों को पोल करना। API खाते पर प्रति सेकंड 2 कॉल देता है, जबकि messages वेबहुक हर DM को उसके आते ही भेजता है।
- पुराना मैसेज अनुरोध खोजना। Requests में 30 दिन की निष्क्रियता वाली बातचीतें अब नहीं लौटाई जातीं।
- हटाए जाने की गड़बड़ी को व्यक्ति द्वारा मैसेज हटाना समझ लेना। Meta नए 20 से पुराने हर मैसेज के लिए यही जवाब देता है।
प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, कनेक्शन बढ़ने पर घटता हुआ, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या Instagram खाते का पूरा DM इतिहास निर्यात कर सकता हूँ?
API के ज़रिए पूरा नहीं: वह बातचीतों की सूची देता है, पर हर एक के सबसे नए 20 मैसेज का ही विवरण लौटाता है। पूरा रिकॉर्ड तब बनता है जब वेबहुक से आते ही DM संग्रहित किए जाएँ।
क्या API से मैसेज पढ़ने पर वे पढ़ा हुआ चिह्नित हो जाते हैं?
नहीं। Meta कहता है कि API से पढ़े गए मैसेज Instagram ऐप में तब तक पढ़ा हुआ चिह्नित नहीं होते जब तक जवाब न भेजा जाए।
क्या Conversations API, Instagram Login के साथ काम करता है?
हाँ। इसकी Meta गाइड Instagram Login के लिए लिखी गई है, जिसमें graph.instagram.com पर कॉल और instagram_business_* अनुमतियाँ हैं।
बातचीत से व्यक्ति का username कैसे मिलेगा?
किसी मैसेज पर from फ़ील्ड का अनुरोध करें, जो भेजने वाले का username और ID लौटाता है। User Profile API अधिक जानकारी देता है, जैसे नाम, IGSID से, जब वे खाते को मैसेज कर चुके हों।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित