Import va eksport
Voxt’da fayl yaratadigan yoki oʻqiydigan «chatni eksport qilish» yoki «chatni import qilish» tugmasi yoʻq. Maʼlumotlar ikkita dasturiy interfeys orqali koʻchiriladi:
- Eksport chatning xabarlari, qoʻshimchalari, aʼzolari va xulosalarini MCP yoki RPC API orqali oʻqiydi.
- Import chatga boshqa xizmatdagi avvalgi tarixni qoʻshadi. Egasi import rejimini boshlaydi, aʼzolar rozilik beradi, xabarlar esa MCP import vositalari yoki RPC API import xizmati orqali yuboriladi. Ikkala holatda ham egasi butun jarayonni yordamchidan boshqarishi mumkin.
Chatni eksport qilish
Eksport uchun API kaliti yoki OAuth orqali kirish kerak. Yordamchi yoki skript siz nomingizdan ish koʻradi, shuning uchun u aynan siz oʻqiy oladigan chatlarni oʻqiy oladi, boshqa hech narsani emas.
- MCP boʻlimida tasvirlanganidek, API kaliti yarating yoki yordamchini OAuth oqimi bilan ulang.
- Yordamchidan eksport qilishni soʻrang, masalan: «Trip photos chatining barcha xabarlarini oʻqib, sanalar va mualliflar bilan Markdown fayl sifatida saqla.» Vositalarni yordamchi tanlaydi; ularning nomlarini bilishingiz shart emas.
- Skript uchun vositalarni toʻgʻridan-toʻgʻri chaqiring. Vositalar maʼlumotnomasi ularni argumentlari bilan sanab beradi.
Nimani oʻqish mumkin:
| Maʼlumot | Vositalar | Izohlar |
|---|---|---|
| Xabarlar | list_messages, get_id_range | Eng eskisidan boshlab, bir chaqiruvda 1 024 tagacha xabar. Hech narsa qaytmaguncha oxirgi xabar ID’sidan davom eting. Oʻchirilgan xabarlar kiritilmaydi. |
| Qadalgan xabarlar va reaksiyalar | list_pinned_messages, list_reactions | |
| Rasmlar, videolar, fayllar va havolalar | list_media, list_files, list_links | Oylar boʻyicha guruhlangan, eng yangi oy birinchi. Har bir qoʻshimchada kontent URL’i bor. |
| Aʼzolar | list_members, list_place_members | |
| Chatlar va Makonlar | list_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_place | Nimani eksport qilishni topish uchun ulardan foydalaning. Arxivlagan chatlaringiz faqat list_archived_chats orqali koʻrsatiladi. |
| Xulosalar | list_conversations, get_conversation | Chatning xulosa qilingan qismlari, masalan, ovozli seans. |
| Qidiruv natijalari | search_messages, search_contacts |
Katta chatni eksport qilishdan oldin bilishingiz kerak boʻlgan narsalar:
- Vositalar fayl emas, sahifalar qaytaradi. Natijani yordamchi yoki skript yigʻadi.
- Hali oqim bilan kelayotgan xabarda matn hali yoʻq. Bu qismni keyinroq qayta oʻqing.
- Allaqachon oʻqigan xabarlaringizning tahrirlari va oʻchirilishlari haqida xabar berilmaydi. Chat hali faol boʻlsa, oraliqni qayta oʻqing.
Chatga tarixni import qilish
Boshqa xizmatdagi suhbatni Voxt guruh chatiga yoki Makonga olib kirish uchun import rejimidan foydalaning. Xabarlar asl mualliflari va asl sanalari bilan saqlanadi, shuning uchun chat sizda doim Voxt’da boʻlgandek oʻqiladi.
Avval nimani bilish kerak:
- Importni faqat chat yoki Makonning egasi boshlay va tugata oladi.
- U guruh chatlari va Makonlar uchun ishlaydi. Makon boʻyicha import Makondagi barcha chatlarni qamrab oladi. Shaxsiy chatlarga import qilib boʻlmaydi.
- Har bir muallif chatning joriy aʼzosi boʻlishi va rozilik berishi kerak. Rozilik bermagan, chiqib ketgan yoki aʼzo boʻlmagan odamning xabarlari rad etiladi.
- Import qilinadigan xabarlar oʻtmishdagi sanaga ega boʻlishi, har biri oldingisidan keyin va chatdagi eng yangi xabardan keyin boʻlishi kerak. Tizim xabarlari ham hisobga olinadi, masalan, aʼzolarning qoʻshilishi, shuning uchun guruh chatida tarix aʼzolar qoʻshilganidan keyingi sanaga ega boʻlishi kerak. Faqat chatda hali turgan xabarlar hisobga olinadi, shuning uchun u yerdagi xabarlardan oldingi tarixni qoʻshib boʻlmaydi, lekin uni moslashtirish mumkin: import paytida egasi chat tarixini tozalashi yoki alohida xabarlarni olib tashlashi mumkin, shunda tozalangan xabarlar kabi eski tarixni import qilish mumkin. Import paytidagi tozalashni bekor qilib boʻlmaydi va «tarix tozalandi» qaydi yuborilmaydi.
- Import rejimi yoqilgan paytda hech kim, jumladan egasi ham, yozolmaydi. Makon boʻyicha import Makondagi barcha chatlarda yozishni toʻxtatadi.
- Import qilingan xabarlar bildirishnoma yubormaydi.
Import rejimini boshlash
Ilovada:
- Chat sozlamalarini oching (tor ekranda chat sarlavhasidagi uch nuqta tugmasini, soʻng Chatni tahrirlash ni tanlang; keng ekranda oʻng panelni ochib, uning sarlavhasidagi tahrirlash tugmasini tanlang), Makon boʻyicha import uchun esa Makon sozlamalarini oching va Importni boshlash ni tanlang. Bu band faqat egalarga koʻrsatiladi, mavzularda koʻrsatilmaydi.
- Import rejimi boshlansinmi? ni tasdiqlang. Voxt taxminan oʻn soniya davomida bir necha yakuniy tekshiruv oʻtkazadi («Import rejimiga oʻtilmoqda»). Boshlanayotganda kimdir xabar yuborgan boʻlsa, Voxt sizdan oʻsha xabarni olib tashlab, qayta boshlashni soʻraydi.
- Hamma uchun xabar kiritish maydoni oʻrniga Texnik xizmat rejimi chiqadi.



MCP import vositalari bor yordamchi buni start_import bilan qila oladi. Chaqiruvda tasdiqlaganingiz aytilmasa, vosita hech narsa qilmaydi, chunki u har bir aʼzo uchun yozishni toʻxtatadi.
Aʼzolardan importga ruxsat berishni soʻrash
Tasdiq oynasi, aʼzolarning roziligi va importni tugatish Chat tarixini import qilish boʻlimida koʻrsatilgan. Qisqacha:
- Har bir aʼzo chatni ochadi, Bu seans davomida xabarlarim va mediam import qilinishiga ruxsat berish ni tanlaydi va Importga ruxsat berilsinmi? ni tasdiqlaydi. Rozilikni shu import uchun bekor qilib boʻlmaydi. Egasi ham oʻz xabarlarini import qilish uchun rozilik beradi.
- Egasi rozilik bergan aʼzolar ulushini («Rozilik berganlar: 100% (3 tadan 3 tasi)») va kim hali yetishmayotganini koʻradi.
- Rozilik bermagan aʼzolarning xabarlari rad etiladi, shuning uchun tarixini xohlagan hamma rozilik berguncha kuting.
Import paytida aʼzolar chatda yozolmaydi, shuning uchun egasi ularga u yerda eslatma yubora olmaydi. Buning oʻrniga ularga shaxsiy chatlaringizda yozing; ular ochiq qoladi. Buni yordamchi qila oladi: get_import rozilik bermagan aʼzolarni, har biri bilan sizning shaxsiy chatingiz bilan birga sanab beradi, yordamchi esa u yerga eslatma yuboradi va siz xohlagan ulush rozilik bergunga qadar yana tekshiradi.
Eski tarix uchun joy ochish
Tarix chatda allaqachon bor xabarlardan eskiroq boʻlsa, masalan, aʼzolarning qoʻshilishini qayd etuvchi tizim xabarlaridan, avval ularni olib tashlang. MCP vositalarida wipe_history chat xabarlarini tanlangan xabardan boshlab (sukut boʻyicha hammasini) olib tashlaydi, faqat import davom etayotganda va faqat egalar uchun, hamda ular oʻchirilgach qaytadi; remove_message bitta xabarni olib tashlaydi. Ikkalasi ham import paytida ishlaydi. Tozalashni bekor qilib boʻlmaydi, shuning uchun ishga tushishidan oldin egasi bilan tasdiqlang. Xabarlar import qilingandan keyin yana tozalamang: bu ularni ham olib tashlaydi.
Xabarlarni yuborish
Import rejimi yoqilgan paytda egasining yordamchisi yoki dasturi tarixni yuboradi:
- Joriy importni oʻqing (
get_import); unda har bir chaqiruvga kerak boʻladigan import ID’si bor. - Avval qoʻshimchalarni ularni yuborgan aʼzo uchun yuklang; shu aʼzo rozilik bergan boʻlishi kerak. Har bir yuklash bitta xabarga biriktiriladi.
- Xabarlarni 1 tadan 100 tagacha boʻlgan paketlarda, eng eskisidan boshlab yuboring. Har bir xabarda muallif, asl vaqt, matn (64 KB gacha), 10 tagacha qoʻshimcha va ixtiyoriy ravishda u javob berayotgan xabar bor. Paketning oʻz ID’si bor: bir xil paketni qayta yuborish oldingi natijani qaytaradi, shuning uchun tarmoq xatosidan keyingi qayta urinish xabarlarni takrorlamaydi.
- Javob faqat chatda allaqachon mavjud xabarga ishora qila oladi, shuning uchun avval xabarni oldingi paketda yuboring va uning qaytarilgan ID’sidan foydalaning.
- Makon boʻyicha importda har bir xabarni Makonning u tegishli boʻlgan aniq chatiga yuboring. Har bir xabar natijasini tekshiring. Paket qisman muvaffaqiyatli boʻlishi mumkin: rad etilgan xabar sababi bilan qaytadi (masalan, «Bu aʼzo importga rozilik bermagan.»), qolganlari saqlanadi.
Bu qadamlar uchun MCP vositalari Tarixni import qilish boʻlimida tasvirlangan. Xuddi shu xizmat dasturlar uchun RPC API orqali mavjud, maʼlumot turlari esa Import maʼlumot turlari boʻlimida. MCP’ning post_message vositasi import emas: u sizning nomingizdan, hozirgi sana bilan yuboradi.
Import rejimini tugatish
Barcha xabarlar yuborilgach, egasi ilovada Importni tugatish ni tanlaydi yoki yordamchi end_import ni chaqiradi. Aʼzolar yana yoza oladi, import qilingan tarix esa birinchi yangi xabardan yuqorida turadi. Hech qachon rozilik bermagan aʼzolarning xabarlari shunchaki import qilinmaydi.
Importdan keyin tekshirish uchun chatni varaqlab chiqing: xabarlar asl mualliflari va sanalarini koʻrsatadi, birinchi yangi xabar ulardan keyin keladi. Bir nechta xabarni manba bilan solishtiring va yordamchingiz rad etilganlar roʻyxatini yuritgan boʻlsa, uni oʻqing. Yanada yaxshisi, import rejimini tugatishdan oldin, yetishmayotganlarini hali yuborish mumkin boʻlganda, import qilingan xabarlarni qayta oʻqing.

Misol: Telegram eksportini import qilish
Butun importni MCP orqali Voxt’ga ulangan va kompyuteringizdagi eksport papkasini oʻqiy oladigan yordamchi, masalan, Claude Code yoki fayllarga kirish imkoni bor boshqa yordamchi bajarishi mumkin. Buning uchun oʻz dasturingiz kerak emas. Fayllaringizni oʻqiy olmaydigan faqat chatdagi yordamchi buni bajara olmaydi.
Boshlashdan oldin:
- Telegram Desktop’da chatni eksport qiling: chatni oching, Export chat history ni tanlang, Machine-readable JSON ni belgilang va xohlasangiz, rasmlar va fayllarni qoʻshing. Eksport papkasida
result.jsonvaphotos,fileskabi papkalar boʻladi. - Voxt guruh chatini yarating va Telegram chatida yozgan odamlarni qoʻshing. Har birida Voxt hisobi boʻlishi va aʼzo boʻlishi kerak. Voxt aʼzosi yoʻq Telegram nomlarini import qilib boʻlmaydi.
- Yordamchi qanday kirishini hal qiling: API kaliti bilan yoki Voxt hisobingiz bilan OAuth orqali (quyida).
- Voxt’ni yordamchingizga MCP server sifatida qoʻshing (quyida).
Voxt’ni MCP server sifatida qoʻshish
Server manzili https://voxt.ai/mcp. Kirishning ikki yoʻli bor. Ikkalasida ham yordamchi sizning nomingizdan ish koʻradi.
API kaliti bilan. Voxt’da kalit yarating (Sozlamalar → API va ilovalar → API kaliti yaratish) va uni Authorization: Bearer sarlavhasida uzating. Claude Code’da quyidagini ishga tushiring:
claude mcp add --transport http voxt https://voxt.ai/mcp --header "Authorization: Bearer $VOXT_API_KEY"Avval terminalingizda VOXT_API_KEY ni belgilang, shunda kalit buyruqda yoki faylda koʻrinmaydi.
OAuth bilan. Sarlavha va kalitni qoldiring:
claude mcp add --transport http voxt https://voxt.ai/mcpSoʻng Claude Code’ni ishga tushiring, /mcp ni bajaring, voxt ni tanlang va autentifikatsiyani tanlang. Voxt rozilik sahifasi bilan brauzer oynasi ochiladi; kirishni tasdiqlang va yordamchi ulanadi, yaratish yoki saqlash kerak boʻlgan kalit boʻlmaydi.
Boshqa yordamchilarda masofaviy MCP serverlar yoki ulagichlar uchun sozlamalar sahifasi bor, u yerda xuddi shu manzilni va sarlavhani yoki kirishni kiritasiz. MCP ikkala yoʻlni tasvirlaydi. Ulanish ishlayotganini tekshirish uchun yordamchidan Voxt chatlaringiz roʻyxatini soʻrang.
Koʻrsatma berish
Yordamchiga shunga oʻxshash koʻrsatma bering. Papka va chat nomini almashtiring.
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.Misol boʻyicha izohlar:
- Telegram xabar vaqtini vaqt mintaqasisiz saqlaydi. Qolganini yuborishdan oldin birinchi import qilingan xabarlarni asl chat bilan solishtiring.
- Rad etilgan xabarlar paketni toʻxtatmaydi. Sababni tuzating (yetishmayotgan aʼzo, importga ruxsat bermagan yuboruvchi, tartibdan tashqari vaqt) va ularni yangi paketda qayta yuboring.
- Moslashtirib boʻlmaydigan xabarlar kiritilmaydi, shuning uchun toʻliq yozuv kerak boʻlsa, Telegram eksportini saqlab qoʻying.
- Har bir fayl yordamchi orqali 1 MB boʻlaklarda oʻtadi, shuning uchun koʻp katta fayllar bor chat koʻp chaqiruv talab qiladi. Faqat matn tez bajariladi.
Tegishli qoʻllanmalar
- Import rejimini aʼzo nuqtayi nazaridan koʻrish uchun Chatlar.
- MCP va uning vositalar maʼlumotnomasi.
- RPC API.