इम्पोर्ट और एक्सपोर्ट
Voxt में कोई "चैट एक्सपोर्ट करें" या "चैट इम्पोर्ट करें" बटन नहीं है जो फ़ाइल बनाए या पढ़े। डेटा दो प्रोग्रामेटिक इंटरफ़ेस से आता-जाता है:
- एक्सपोर्ट किसी चैट के संदेश, अटैचमेंट, सदस्य और सारांश MCP या RPC API से पढ़ता है।
- इम्पोर्ट किसी दूसरी सेवा का पुराना इतिहास किसी चैट में जोड़ता है। स्वामी इम्पोर्ट मोड शुरू करता है, सदस्य सहमति देते हैं, और संदेश MCP के इम्पोर्ट टूल्स या RPC API की इम्पोर्ट सेवा से भेजे जाते हैं। दोनों तरीकों में स्वामी पूरी प्रक्रिया किसी असिस्टेंट से चला सकता है।
चैट एक्सपोर्ट करें
एक्सपोर्ट के लिए API कुंजी या OAuth साइन-इन चाहिए। असिस्टेंट या स्क्रिप्ट आपकी तरह काम करती है, इसलिए वह ठीक वही चैट पढ़ सकती है जो आप पढ़ सकते हैं, और कुछ नहीं।
- API कुंजी बनाएँ, या OAuth फ़्लो से असिस्टेंट को जोड़ें, जैसा MCP में बताया है।
- अपने असिस्टेंट से एक्सपोर्ट माँगें, उदाहरण के लिए: "Trip photos चैट के सभी संदेश पढ़ो और उन्हें तारीखों और लेखकों के साथ Markdown फ़ाइल में सहेजो।" टूल्स असिस्टेंट चुनता है; आपको उनके नाम जानने की ज़रूरत नहीं।
- स्क्रिप्ट के लिए टूल्स को सीधे कॉल करें। टूल संदर्भ उन्हें उनके आर्ग्युमेंट के साथ सूचीबद्ध करता है।
क्या पढ़ा जा सकता है:
| डेटा | टूल्स | टिप्पणियाँ |
|---|---|---|
| संदेश | list_messages, get_id_range | सबसे पुराना पहले, एक कॉल में 1,024 संदेश तक। आख़िरी संदेश की ID से तब तक आगे बढ़ें जब तक कुछ न लौटे। हटाए गए संदेश छोड़ दिए जाते हैं। |
| पिन किए गए संदेश और रिएक्शन | list_pinned_messages, list_reactions | |
| फ़ोटो, वीडियो, फ़ाइलें और लिंक | list_media, list_files, list_links | महीने के अनुसार समूहित, सबसे नया महीना पहले। हर अटैचमेंट के साथ एक कंटेंट URL होता है। |
| सदस्य | list_members, list_place_members | |
| चैट और प्लेस | list_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_place | इनसे पता करें कि क्या एक्सपोर्ट करना है। आपकी संग्रहित की गई चैट केवल list_archived_chats से सूचीबद्ध होती हैं। |
| सारांश | list_conversations, get_conversation | चैट के सारांशित हिस्से, जैसे कोई वॉइस सत्र। |
| खोज के नतीजे | search_messages, search_contacts |
बड़ी चैट एक्सपोर्ट करने से पहले ये बातें जानें:
- टूल्स फ़ाइल नहीं, पेज लौटाते हैं। नतीजा असिस्टेंट या स्क्रिप्ट जोड़ती है।
- जो संदेश अभी स्ट्रीम हो रहा है, उसमें अभी टेक्स्ट नहीं होता। उस हिस्से को बाद में फिर पढ़ें।
- जिन संदेशों को आप पहले पढ़ चुके हैं, उनके संपादन और हटाए जाने की सूचना नहीं मिलती। चैट अब भी सक्रिय हो तो वह दायरा फिर पढ़ें।
चैट में इतिहास इम्पोर्ट करें
किसी दूसरी सेवा की बातचीत को Voxt की ग्रुप चैट या प्लेस में लाने के लिए इम्पोर्ट मोड इस्तेमाल करें। संदेश उनके मूल लेखकों और मूल तारीखों के साथ सहेजे जाते हैं, इसलिए चैट ऐसे पढ़ी जाती है मानो वह हमेशा से Voxt में रही हो।
पहले यह जान लें:
- केवल चैट या प्लेस का स्वामी इम्पोर्ट शुरू और खत्म कर सकता है।
- यह ग्रुप चैट और प्लेस के लिए काम करता है। पूरे प्लेस का इम्पोर्ट प्लेस की हर चैट को कवर करता है। डायरेक्ट चैट में इम्पोर्ट नहीं किया जा सकता।
- हर लेखक चैट का मौजूदा सदस्य होना चाहिए और उसे सहमति देनी होगी। जिसने सहमति नहीं दी, जो छोड़ चुका है, या जो सदस्य नहीं है, उसके संदेश अस्वीकार कर दिए जाते हैं।
- इम्पोर्ट किए गए संदेशों की तारीख़ अतीत की होनी चाहिए, हर संदेश अपने पिछले से बाद का हो, और चैट के सबसे नए मौजूदा संदेश से बाद का हो। सिस्टम संदेश भी गिने जाते हैं, जैसे सदस्यों का जुड़ना, इसलिए ग्रुप चैट में इतिहास की तारीख़ सदस्यों के जुड़ने के बाद की होनी चाहिए। केवल वे संदेश गिने जाते हैं जो अब भी चैट में हैं, इसलिए इतिहास को चैट में मौजूद संदेशों से पहले नहीं डाला जा सकता, लेकिन उसे फिट कराया जा सकता है: इम्पोर्ट के दौरान स्वामी चैट का इतिहास मिटा सकता है, या अलग-अलग संदेश हटा सकता है, और तब मिटाए गए संदेशों जितना पुराना इतिहास इम्पोर्ट किया जा सकता है। इम्पोर्ट के दौरान मिटाया गया इतिहास वापस नहीं आता और "इतिहास मिटाया गया" का कोई नोट पोस्ट नहीं होता।
- इम्पोर्ट मोड चालू होने पर कोई पोस्ट नहीं कर सकता, स्वामी भी नहीं। पूरे प्लेस का इम्पोर्ट प्लेस की हर चैट में पोस्ट करना रोक देता है।
- इम्पोर्ट किए गए संदेश सूचनाएँ नहीं भेजते।
इम्पोर्ट मोड शुरू करें
ऐप में:
- चैट की सेटिंग्स खोलें (संकरी स्क्रीन पर चैट हेडर का तीन-बिंदु बटन चुनें, फिर चैट संपादित करें; चौड़ी स्क्रीन पर दायाँ पैनल खोलें और उसके हेडर का संपादन बटन चुनें), या पूरे प्लेस के इम्पोर्ट के लिए प्लेस की, और आयात शुरू करें चुनें। यह प्रविष्टि केवल स्वामियों को दिखती है, और थ्रेड में नहीं दिखती।
- इम्पोर्ट मोड शुरू करें? की पुष्टि करें। Voxt करीब दस सेकंड कुछ अंतिम जाँचें चलाता है ("इम्पोर्ट मोड शुरू हो रहा है")। यदि शुरू होते समय किसी ने संदेश पोस्ट किया, तो Voxt आपसे उस संदेश को हटाने और फिर शुरू करने को कहता है।
- सबके लिए संदेश बॉक्स की जगह रखरखाव मोड आ जाता है।



MCP इम्पोर्ट टूल्स वाला असिस्टेंट यही start_import से कर सकता है। जब तक कॉल यह न कहे कि आपने पुष्टि की है, टूल कुछ नहीं करता, क्योंकि वह हर सदस्य के लिए पोस्ट करना रोक देता है।
सदस्यों से इम्पोर्ट की अनुमति देने को कहें
पुष्टि का डायलॉग, सदस्यों की सहमति और इम्पोर्ट खत्म करना चैट का इतिहास इम्पोर्ट करें में दिखाए गए हैं। संक्षेप में:
- हर सदस्य चैट खोलता है, इस सत्र में मेरे संदेशों और मीडिया के आयात की अनुमति दें चुनता है और इम्पोर्ट की अनुमति दें? की पुष्टि करता है। उस इम्पोर्ट के लिए दी गई सहमति वापस नहीं ली जा सकती। स्वामी भी अपने संदेश इम्पोर्ट करने के लिए सहमति देता है।
- स्वामी को सहमत सदस्यों का अनुपात दिखता है ("सहमत: 100% (3 में से 3)") और यह भी कि कौन बाकी है।
- जिन सदस्यों ने सहमति नहीं दी, उनके संदेश अस्वीकार कर दिए जाते हैं, इसलिए तब तक रुकें जब तक वे सब सहमत न हों जिनका इतिहास आपको चाहिए।
इम्पोर्ट के दौरान सदस्य चैट में नहीं लिख सकते, इसलिए स्वामी उन्हें वहाँ याद नहीं दिला सकता। इसके बजाय अपनी डायरेक्ट चैट में उन्हें संदेश भेजें; वे खुली रहती हैं। असिस्टेंट यह कर सकता है: get_import उन सदस्यों को सूचीबद्ध करता है जिन्होंने सहमति नहीं दी, हर एक के साथ आपकी डायरेक्ट चैट, और असिस्टेंट वहाँ याद दिलाने वाला संदेश पोस्ट करता है और तब तक फिर जाँचता है जब तक आपका चाहा अनुपात सहमत न हो जाए।
पुराने इतिहास के लिए जगह बनाएँ
यदि इतिहास चैट में पहले से मौजूद संदेशों से पुराना है, उदाहरण के लिए सदस्यों के जुड़ने को दर्ज करने वाले सिस्टम संदेशों से, तो पहले उन्हें हटाएँ। MCP टूल्स के साथ, wipe_history चुने गए संदेश से आगे चैट के संदेश हटाता है (डिफ़ॉल्ट रूप से सभी), केवल इम्पोर्ट चलने के दौरान और केवल स्वामियों के लिए, और उनके हट जाने के बाद ही लौटता है; remove_message एक संदेश हटाता है। दोनों इम्पोर्ट के दौरान काम करते हैं। मिटाया गया वापस नहीं आता, इसलिए चलाने से पहले स्वामी से पुष्टि करें। संदेश इम्पोर्ट होने के बाद दोबारा न मिटाएँ: इससे वे भी हट जाएँगे।
संदेश भेजें
इम्पोर्ट मोड चालू रहते हुए स्वामी का असिस्टेंट या प्रोग्राम इतिहास भेजता है:
- मौजूदा इम्पोर्ट पढ़ें (
get_import); इसमें इम्पोर्ट की ID होती है जो हर कॉल को चाहिए। - पहले अटैचमेंट अपलोड करें, उस सदस्य के लिए जिसने उन्हें भेजा था; उस सदस्य ने सहमति दी होनी चाहिए। हर अपलोड एक संदेश से जुड़ता है।
- संदेश 1 से 100 के बैच में भेजें, सबसे पुराना पहले। हर संदेश में लेखक, मूल समय, टेक्स्ट (64 KB तक), 10 अटैचमेंट तक और, वैकल्पिक रूप से, वह संदेश होता है जिसका वह जवाब है। बैच की अपनी ID होती है: वही बैच फिर भेजने पर पहले का नतीजा लौटता है, इसलिए नेटवर्क त्रुटि के बाद दोबारा कोशिश करने से संदेश दोहराए नहीं जाते।
- जवाब केवल उस संदेश की ओर इशारा कर सकता है जो चैट में पहले से है, इसलिए संदेश पहले, किसी पिछले बैच में, भेजें और उसकी लौटी ID इस्तेमाल करें।
- पूरे प्लेस के इम्पोर्ट में हर संदेश प्लेस की उसी खास चैट में भेजें जिसका वह है। हर संदेश का नतीजा जाँचें। बैच आंशिक रूप से सफल हो सकता है: अस्वीकार किया गया संदेश कारण के साथ लौटता है (उदाहरण के लिए "इस सदस्य ने इम्पोर्ट की सहमति नहीं दी है।"), और बाकी सहेज लिए जाते हैं।
इन चरणों के MCP टूल्स का वर्णन इतिहास इम्पोर्ट करें में है। वही सेवा प्रोग्रामों के लिए RPC API से उपलब्ध है, डेटा प्रकार इम्पोर्ट डेटा प्रकार में हैं। MCP का post_message इम्पोर्ट नहीं है: वह आपकी तरह पोस्ट करता है, अभी की तारीख़ के साथ।
इम्पोर्ट मोड खत्म करें
जब सभी संदेश भेज दिए जाएँ, तो स्वामी ऐप में आयात समाप्त करें चुनता है, या असिस्टेंट end_import कॉल करता है। सदस्य फिर पोस्ट कर सकते हैं, और इम्पोर्ट किया गया इतिहास पहले नए संदेश के ऊपर रहता है। जिन सदस्यों ने कभी सहमति नहीं दी, उनके कोई संदेश इम्पोर्ट नहीं होते।
इम्पोर्ट के बाद चैट को स्क्रॉल करके जाँचें: संदेश अपने मूल लेखकों और तारीखों के साथ दिखते हैं, और पहला नया संदेश उनके बाद आता है। कुछ संदेशों की स्रोत से तुलना करें, और यदि आपके असिस्टेंट ने अस्वीकार किए गए संदेशों की सूची रखी हो तो उसे पढ़ें। इससे भी बेहतर, इम्पोर्ट मोड खत्म करने से पहले इम्पोर्ट किए गए संदेश वापस पढ़ें, जब आप छूटे हुए संदेश अब भी भेज सकते हैं।

उदाहरण: Telegram एक्सपोर्ट इम्पोर्ट करें
पूरा इम्पोर्ट ऐसा असिस्टेंट कर सकता है जो MCP से Voxt से जुड़ा हो और आपके कंप्यूटर पर एक्सपोर्ट फ़ोल्डर पढ़ सके, जैसे Claude Code या फ़ाइल पहुँच वाला कोई और असिस्टेंट। इसके लिए आपको अपना कोई प्रोग्राम नहीं चाहिए। केवल चैट वाला असिस्टेंट, जो आपकी फ़ाइलें नहीं पढ़ सकता, यह नहीं कर सकता।
शुरू करने से पहले:
- Telegram Desktop में चैट एक्सपोर्ट करें: चैट खोलें, Export chat history चुनें, Machine-readable JSON चुनें और चाहें तो फ़ोटो और फ़ाइलें शामिल करें। एक्सपोर्ट फ़ोल्डर में
result.jsonऔरphotosतथाfilesजैसे फ़ोल्डर होते हैं। - Voxt की ग्रुप चैट बनाएँ और उन लोगों को जोड़ें जिन्होंने Telegram चैट में लिखा था। हर एक का Voxt खाता होना चाहिए और वह सदस्य होना चाहिए। जिन Telegram नामों का कोई Voxt सदस्य नहीं है, उन्हें इम्पोर्ट नहीं किया जा सकता।
- तय करें कि असिस्टेंट कैसे साइन इन करे: API कुंजी से, या OAuth के ज़रिए आपके Voxt खाते से (नीचे)।
- अपने असिस्टेंट में Voxt को MCP सर्वर के रूप में जोड़ें (नीचे)।
Voxt को MCP सर्वर के रूप में जोड़ें
सर्वर का पता https://voxt.ai/mcp है। साइन इन करने के दो तरीके हैं। दोनों में असिस्टेंट आपकी तरह काम करता है।
API कुंजी से। Voxt में कुंजी बनाएँ (सेटिंग्स → API और ऐप्स → API कुंजी बनाएँ) और उसे Authorization: Bearer हेडर में दें। Claude Code में यह चलाएँ:
claude mcp add --transport http voxt https://voxt.ai/mcp --header "Authorization: Bearer $VOXT_API_KEY"पहले अपने टर्मिनल में VOXT_API_KEY सेट करें, ताकि कुंजी किसी प्रॉम्प्ट या फ़ाइल में न दिखे।
OAuth से। हेडर और कुंजी छोड़ दें:
claude mcp add --transport http voxt https://voxt.ai/mcpफिर Claude Code शुरू करें, /mcp चलाएँ, voxt चुनें और प्रमाणित करना चुनें। Voxt की सहमति वाले पेज के साथ एक ब्राउज़र विंडो खुलती है; पहुँच स्वीकार करें और असिस्टेंट जुड़ जाता है, बिना कोई कुंजी बनाए या सहेजे।
दूसरे असिस्टेंट में रिमोट MCP सर्वर या कनेक्टर के लिए सेटिंग्स पेज होता है, जहाँ आप यही पता दर्ज करते हैं, और या तो हेडर या साइन-इन। MCP दोनों तरीके बताता है। कनेक्शन काम करता है या नहीं, यह जाँचने के लिए असिस्टेंट से अपनी Voxt चैट सूचीबद्ध करने को कहें।
निर्देश दें
असिस्टेंट को इस तरह का निर्देश दें। फ़ोल्डर और चैट का नाम बदलें।
I want to import a Telegram chat export into a Voxt group chat. I am its owner.
Read these pages first. They describe the import tools and the rules:
- https://docs.voxt.ai/users/import-export/
- https://docs.voxt.ai/developers/mcp/tools
Inputs:
- The Telegram export is in the folder D:\exports\trip-chat (result.json, photos, files).
- The target is my Voxt group chat "Trip photos", which the Voxt MCP server can see.
Do this, and stop to ask me where it says so:
1. Read result.json. List the distinct senders (the "from" field) with their message counts, and give the date range. Skip service messages (type "service").
2. Use the Voxt MCP server to find "Trip photos" and list its members. Propose a mapping from Telegram senders to Voxt members and ask me to confirm it. Messages of senders without a Voxt member will be left out.
3. Call get_import to check that no import is running. Tell me that starting the import stops posting for every member of the chat until it ends, and ask me to confirm. Then call start_import with confirm true.
4. Compare the date of the earliest message with the chat. Imported messages must be later than the chat's newest message, system messages such as "joined" included. If the history starts earlier, tell me; if I confirm (it cannot be undone), call wipe_history with the importId from start_import to remove what is in the way, and wait until it reports isPurged.
5. Call get_import to see who has not consented. Post a short reminder to each of them in their direct chat (peerChatId), asking them to open "Trip photos" and allow the import. Call consent_to_import for me. Check get_import every minute and tell me the consented share; ask me when to go on.
6. Convert the messages: author = the mapped member's userId, sentAt = the message date in Unix milliseconds (ask me which time zone the export used; Telegram stores local time without a zone), text = the message text (join the pieces when "text" is a list), replyToId = the Voxt ID of the message that reply_to_message_id points to, if that one was imported in an earlier batch.
7. Send the photos and files named in "photo" and "file" first: begin_import_upload, append_upload in chunks of at most 1 MB, finish_import_upload, and put the upload IDs into the message. If there are many large files, import the text first and ask me about the files.
8. Import with import_messages in batches of at most 100, oldest first, with a different batchId for every batch. Check the result of every message and keep a list of the ones that were rejected, with the reason.
9. Read the imported messages back with list_messages and check the count, the authors and the dates against the export. Show me the result and the rejected messages.
10. Do not call end_import until I say so.उदाहरण पर टिप्पणियाँ:
- Telegram संदेश का समय बिना समय क्षेत्र के सहेजता है। बाकी भेजने से पहले पहले इम्पोर्ट किए गए संदेशों को मूल चैट से मिलाकर देखें।
- अस्वीकार किए गए संदेश बैच को नहीं रोकते। कारण ठीक करें (कोई सदस्य न होना, ऐसा भेजने वाला जिसने इम्पोर्ट की अनुमति नहीं दी, क्रम से बाहर का समय) और उन्हें नए बैच में फिर भेजें।
- जिन संदेशों को मैप नहीं किया जा सकता, वे छोड़ दिए जाते हैं, इसलिए पूरा रिकॉर्ड चाहिए तो Telegram एक्सपोर्ट रखें।
- हर फ़ाइल असिस्टेंट के ज़रिए 1 MB के टुकड़ों में जाती है, इसलिए कई बड़ी फ़ाइलों वाली चैट में कई कॉल लगते हैं। केवल टेक्स्ट तेज़ है।
संबंधित गाइड
- चैट इम्पोर्ट मोड के सदस्य वाले दृश्य के लिए।
- MCP और उसका टूल संदर्भ।
- RPC API।