API के ज़रिए Messenger बातचीत का इतिहास पढ़ना
Facebook पेज का Messenger इतिहास GET /{page-id}/conversations?platform=messenger से पढ़ा जाता है, जो बातचीत के ID उनके आखिरी अपडेट के समय के साथ सूचीबद्ध करता है। फिर मैसेज के ID पाने के लिए GET /{conversation-id}?fields=messages, और हर मैसेज के भेजने वाले, पाने वाले, टेक्स्ट और अटैचमेंट के लिए GET /{message-id} कॉल किया जाता है। Meta किसी बातचीत के 20 सबसे नए मैसेज का विवरण लौटाता है, और इन कॉल्स के लिए pages_messaging वाला Page टोकन चाहिए।
easyCoexistence किसी Page के नए Messenger मैसेज आते ही आपके एंडपॉइंट पर आगे भेजता है, और Claude, ChatGPT या आपके अपने कोड से send_social_dm 24 घंटे की विंडो के भीतर जवाब भेजता है।
केवल किसी बातचीत के 20 सबसे नए मैसेज का विवरण मिलता है; पुराने मैसेज के लिए गड़बड़ी आती है कि मैसेज हटा दिया गया है।
एक ऐप हर Facebook पेज के लिए Conversations API से कितनी कॉल कर सकता है।
अनुरोध फ़ोल्डर में वे बातचीत जो इतने समय से सक्रिय नहीं रही हैं, API नतीजों से बाहर रहती हैं।
वह Page टास्क जो टोकन के पीछे के व्यक्ति को बातचीत पढ़ने के लिए करने में सक्षम होना चाहिए।
इस Page खाते पर बहुत ज़्यादा Messenger API कॉल की गड़बड़ी; Meta कहता है कि थोड़ी देर बाद फिर कोशिश करें।
पेज की बातचीत कैसे सूचीबद्ध करें?
GET /{page-id}/conversations के साथ platform को messenger सेट करके। नतीजे में बातचीत के ID की एक data array आती है, हर ID के साथ updated_time, यानी आखिरी मैसेज जुड़ने का समय, और एक paging ऑब्जेक्ट। Meta के रेफ़रेंस के अनुसार इस एंडपॉइंट पर समय-आधारित पेजिनेशन उपलब्ध नहीं है, इसलिए सूची में आगे बढ़ने के लिए paging ऑब्जेक्ट को फ़ॉलो करें।
GET /{page-id}/conversations?platform=messenger
{
"data": [
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" },
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" }
],
"paging": { ... }
}किसी एक व्यक्ति की बातचीत कैसे खोजें?
उसी अनुरोध में user_id जोड़ें, जिसमें उस व्यक्ति का Page-scoped ID हो। Meta पेज और उस व्यक्ति के बीच की बातचीत का ID लौटाता है। यह सबसे छोटा रास्ता है messages वेबहुक से उस इतिहास तक पहुंचने का, जिसमें PSID sender.id के रूप में आता है:
GET /{page-id}/conversations?platform=messenger&user_id=<PSID>
{ "data": [ { "id": "<CONVERSATION_ID>" } ] }किसी बातचीत के मैसेज कैसे पढ़ें?
दो चरणों में। fields=messages के साथ GET /{conversation-id} बातचीत के मैसेज ID लौटाता है, हर ID के साथ created_time, सबसे नए पहले; फिर GET /{message-id} के साथ ज़रूरी फ़ील्ड, जैसे id, created_time, from, to, message और reply_to, एक मैसेज की सामग्री लौटाता है। डिफ़ॉल्ट फ़ील्ड id और created_time हैं, और जिस फ़ील्ड में कोई डेटा नहीं होता, वह जवाब में नहीं आता।
कौन-से फ़ील्ड पढ़े जा सकते हैं?
बातचीत और मैसेज अलग-अलग फ़ील्ड दिखाते हैं। ये वे हैं जो Meta के रेफ़रेंस Page मैसेजिंग के लिए सूचीबद्ध करते हैं:
- बातचीत: id,
updated_time, participants उनके ID, name और email के साथ, messages, और Conversation Routing चालू होने परis_owner। - मैसेज: id,
created_time, from और to, हर एक के ID, name और email के साथ, और message, यानी टेक्स्ट, जो न होने पर खाली रहता है। - attachments: फ़ाइलें, इमेज और वीडियो उनके CDN यूआरएल के साथ, और
is_unsupported, जो तभी लौटता है जब मैसेज में असमर्थित सामग्री हो। - reactions,
reply_toजिसमें वह mid है जिसका यह जवाब है, औरis_self_reply, और साझा किए गए पोस्ट और रील के लिए shares। - tags: मैसेज का फ़ोल्डर और स्रोत, जैसे inbox, read या source:chat।
कितने पीछे तक पढ़ा जा सकता है?
ID के लिए जितना पीछे बातचीत जाती है, उतना; सामग्री के लिए नहीं। Meta की गाइड कहती है कि बातचीत वाला एंडपॉइंट बातचीत के सभी मैसेज ID लौटाता है, जबकि विवरण सिर्फ़ 20 सबसे नए मैसेज के आते हैं; किसी पुराने मैसेज को मांगने पर गड़बड़ी आती है कि मैसेज हटा दिया गया है। अनुरोध फ़ोल्डर में वे बातचीत जो 30 दिन से सक्रिय नहीं रहीं, बिल्कुल नहीं लौटाई जातीं।
कौन-सी अनुमतियां और टास्क चाहिए?
Page एक्सेस टोकन उस व्यक्ति का होना चाहिए जो पेज पर MESSAGING या MODERATE टास्क कर सकता है, साथ में pages_manage_metadata, pages_read_engagement और pages_messaging अनुमतियां। ऐसे लोगों के साथ बातचीत पढ़ने के लिए, जिनकी ऐप, पेज या कारोबार में कोई भूमिका नहीं है, Advanced Access चाहिए, जिसे Meta App Review के ज़रिए देता है।
कॉल पर कौन-सी सीमाएं लागू होती हैं?
Meta की रेट लिमिट Conversations API को हर पेज के लिए 2 कॉल प्रति सेकंड देती है, और सीमा पार होने पर कॉल 613 या 80006 के साथ लौटती है, जिसका मतलब है कि इस Page खाते पर बहुत ज़्यादा Messenger API कॉल हो चुकी हैं। जो पेज Meta की हाई-वॉल्यूम सीमा तक पहुंच जाता है, जैसे 40 से ज़्यादा मैसेज प्रति सेकंड भेजना, वह तब तक अपनी बातचीत की सूची नहीं ले सकता जब तक वॉल्यूम न गिरे, हालांकि किसी एक बातचीत के नए मैसेज अब भी पढ़े जा सकते हैं।
वेबहुक की बजाय API कब उपयोग करें?
बीते समय के लिए। वेबहुक नए मैसेज उसी समय पहुंचाते हैं जब वे होते हैं, और Meta बताता है कि पुराने नोटिफ़िकेशन बाद में क्वेरी नहीं किए जा सकते। इसलिए Conversations API वह तरीका है जिससे कोई इंटीग्रेशन उन मैसेज को पढ़ता है जो उसके सुनना शुरू करने से पहले आए, या डाउनटाइम के बाद छूटे मैसेज पकड़ता है। Conversation Routing चालू होने पर is_owner फ़ील्ड सूची को उन्हीं बातचीत तक सीमित कर देता है जिनका जवाब देने की ज़िम्मेदारी ऐप की है, जिसे Meta डाउनटाइम के बाद रिकवरी के लिए सुझाता है।
easyCoexistence Messenger इतिहास कैसे पढ़ता है?
यह इतिहास नहीं पढ़ता। Page pages_messaging, pages_manage_metadata और pages_read_engagement अनुमतियों के साथ कनेक्ट होता है, लेकिन कोई टूल Conversations API को कॉल नहीं करता, और Page टोकन सौंपे नहीं जाते। नए मैसेज set_social_webhook_destination के ज़रिए आते ही आपके एंडपॉइंट तक पहुंचते हैं, बिना कॉपी रखे आगे भेजे जाते हैं, ताकि आपका अपना सिस्टम ज़रूरी इतिहास रखे।
आम गड़बड़ियाँ
- सूची कॉल में मैसेज की सामग्री की उम्मीद करना। बातचीत वाला एंडपॉइंट मैसेज ID लौटाता है; हर मैसेज के फ़ील्ड /{message-id} से पढ़ें।
- पूरे इतिहास पर भरोसा करना। विवरण 20 सबसे नए मैसेज पर रुक जाता है, इसलिए जो ज़रूरी है उसे वेबहुक से मैसेज आते ही स्टोर करें।
- नए मैसेज के लिए पोलिंग करना। Page के लिए 2 कॉल प्रति सेकंड पर पोल लूप जल्दी रेट लिमिट तक पहुंच जाता है, जबकि मैसेज वेबहुक उन्हें उसी समय पहुंचा देता है।
- since और until के साथ तारीख के हिसाब से बातचीत का पेजिनेशन करना। Conversations एंडपॉइंट पर समय-आधारित पेजिनेशन उपलब्ध नहीं है; इसकी जगह paging ऑब्जेक्ट को फ़ॉलो करें।
इसमें Conversations API के लिए कोई टूल नहीं है, इसलिए पुराना इतिहास पेज इनबॉक्स में पढ़ा जाता है। प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, कनेक्शन जोड़ने के साथ घटती हुई कीमत, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या Conversations API में पेज के अपने मैसेज शामिल हैं?
हां। मैसेज के from और to फ़ील्ड व्यक्ति या पेज का नाम बताते हैं, इसलिए किसी बातचीत के मैसेज में दोनों ओर के मैसेज होते हैं।
क्या मैं App Review के बिना Messenger बातचीत पढ़ सकता हूं?
ऐप या पेज में भूमिका वाले लोगों के लिए Standard Access काफ़ी है। किसी भी और के साथ की बातचीत के लिए Advanced Access चाहिए, जो App Review से मिलता है।
क्या Conversations API जवाब भेज सकता है?
नहीं। Meta का बातचीत वाला रेफ़रेंस कहता है कि यह एंडपॉइंट प्रकाशित नहीं कर सकता; जवाब /{page-id}/messages पर Send API से भेजे जाते हैं।
क्या easyCoexistence मेरी Messenger बातचीत स्टोर करता है?
डिफ़ॉल्ट रूप से नहीं। आगे भेजे गए इवेंट बिना कॉपी रखे आगे बढ़ाए जाते हैं; ऑटोमेशन चालू होने पर मैसेज का टेक्स्ट 7 दिन और ऑटोमेशन रन के लॉग 30 दिन तक रखे जाते हैं।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित