Import dan eksport
Voxt tidak mempunyai butang "eksport sembang" atau "import sembang" yang menghasilkan atau membaca fail. Data berpindah melalui dua antara muka pengaturcaraan:
- Eksport membaca mesej, lampiran, ahli dan ringkasan sesebuah sembang melalui MCP atau API RPC.
- Import menambah sejarah terdahulu daripada perkhidmatan lain ke dalam sembang. Pemilik memulakan mod import, ahli bersetuju, dan mesej dihantar melalui alat import MCP atau perkhidmatan import API RPC. Dalam kedua-dua kes pemilik boleh menjalankan keseluruhan proses daripada pembantu.
Eksport sembang
Eksport memerlukan kunci API atau log masuk OAuth. Pembantu atau skrip bertindak sebagai anda, jadi ia boleh membaca tepat sembang yang boleh anda baca, dan tiada yang lain.
- Cipta kunci API, atau sambungkan pembantu dengan aliran OAuth, seperti yang diterangkan dalam MCP.
- Minta pembantu anda untuk eksport, contohnya: "Baca semua mesej sembang Trip photos dan simpan sebagai fail Markdown dengan tarikh dan pengarang." Pembantu memilih alat; anda tidak perlu tahu namanya.
- Untuk skrip, panggil alat secara terus. Rujukan alat menyenaraikannya dengan argumennya.
Apa yang boleh dibaca:
| Data | Alat | Catatan |
|---|---|---|
| Mesej | list_messages, get_id_range | Yang paling lama dahulu, sehingga 1,024 mesej setiap panggilan. Teruskan daripada ID mesej terakhir sehingga tiada apa-apa dikembalikan. Mesej yang dialih keluar ditinggalkan. |
| Mesej tersemat dan reaksi | list_pinned_messages, list_reactions | |
| Foto, video, fail dan pautan | list_media, list_files, list_links | Dikumpulkan mengikut bulan, bulan terbaharu dahulu. Setiap lampiran membawa URL kandungan. |
| Ahli | list_members, list_place_members | |
| Sembang dan tempat | list_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_place | Gunakannya untuk mencari apa yang hendak dieksport. Sembang yang anda arkibkan disenaraikan hanya oleh list_archived_chats. |
| Ringkasan | list_conversations, get_conversation | Bahagian sembang yang diringkaskan, seperti sesi suara. |
| Hasil carian | search_messages, search_contacts |
Perkara yang perlu diketahui sebelum anda mengeksport sembang yang besar:
- Alat mengembalikan halaman, bukan fail. Pembantu atau skrip menghimpun hasilnya.
- Mesej yang masih distrim belum mempunyai teks. Baca bahagian itu semula kemudian.
- Suntingan dan pengalihan keluar mesej yang telah anda baca tidak dilaporkan. Baca julat itu semula jika sembang masih aktif.
Import sejarah ke dalam sembang
Gunakan mod import untuk membawa perbualan daripada perkhidmatan lain ke dalam sembang kumpulan Voxt atau tempat. Mesej disimpan di bawah pengarang asal dan tarikh asalnya, jadi sembang kelihatan seolah-olah sentiasa berada dalam Voxt.
Perkara yang perlu diketahui dahulu:
- Hanya pemilik sembang atau tempat boleh memulakan dan menamatkan import.
- Ia berfungsi untuk sembang kumpulan dan untuk tempat. Import seluruh tempat merangkumi setiap sembang dalam tempat itu. Sembang terus tidak boleh diimport ke dalamnya.
- Setiap pengarang mesti ahli semasa sembang dan mesti bersetuju. Mesej seseorang yang belum bersetuju, yang telah keluar, atau yang bukan ahli ditolak.
- Mesej yang diimport mesti bertarikh pada masa lalu, setiap satu lebih lewat daripada yang sebelumnya, dan lebih lewat daripada mesej terbaharu yang sudah ada dalam sembang. Mesej sistem diambil kira, seperti ahli menyertai, jadi dalam sembang kumpulan sejarah mesti bertarikh selepas ahlinya menyertai. Hanya mesej yang masih ada dalam sembang diambil kira, jadi sejarah tidak boleh disisipkan sebelum mesej yang ada, tetapi ia boleh disesuaikan: semasa import pemilik boleh mengosongkan sejarah sembang, atau mengalih keluar mesej tunggal, dan kemudian sejarah selama mesej yang dikosongkan boleh diimport. Pengosongan semasa import tidak boleh dibuat asal dan tidak menyiarkan nota "sejarah dikosongkan".
- Tiada sesiapa boleh menyiarkan semasa mod import hidup, termasuk pemilik. Import seluruh tempat menghentikan penyiaran dalam setiap sembang tempat itu.
- Mesej yang diimport tidak menghantar pemberitahuan.
Mulakan mod import
Dalam aplikasi:
- Buka tetapan sembang (pada skrin sempit, pilih butang tiga titik dalam pengepala sembang, kemudian Edit sembang; pada skrin lebar, buka panel kanan dan pilih butang sunting dalam pengepalanya), atau tetapan tempat untuk import seluruh tempat, dan pilih Mulakan import. Entri itu dipaparkan hanya kepada pemilik, dan tidak dalam bebenang.
- Sahkan Mulakan mod import?. Voxt menjalankan beberapa semakan akhir selama kira-kira sepuluh saat ("Memasuki mod import"). Jika seseorang menyiarkan mesej semasa ia bermula, Voxt meminta anda mengalih keluar mesej itu dan bermula semula.
- Kotak mesej digantikan dengan Mod penyelenggaraan untuk semua orang.



Pembantu dengan alat import MCP boleh melakukan perkara yang sama dengan start_import. Alat itu tidak melakukan apa-apa melainkan panggilan menyatakan bahawa anda telah mengesahkan, kerana ia menghentikan penyiaran untuk setiap ahli.
Minta ahli membenarkan import
Dialog pengesahan, persetujuan ahli dan menamatkan import ditunjukkan dalam Import sejarah sembang. Ringkasnya:
- Setiap ahli membuka sembang, memilih Benarkan mesej dan media saya diimport semasa sesi ini dan mengesahkan Benarkan import?. Persetujuan tidak boleh ditarik balik untuk import itu. Pemilik juga bersetuju, untuk mengimport mesejnya sendiri.
- Pemilik melihat bahagian ahli yang bersetuju ("Bersetuju: 100% (3 daripada 3)") dan siapa yang masih belum.
- Mesej ahli yang belum bersetuju ditolak, jadi tunggu sehingga semua orang yang sejarahnya anda mahu telah bersetuju.
Ahli tidak boleh menulis dalam sembang semasa import, jadi pemilik tidak boleh mengingatkan mereka di sana. Hantar mesej kepada mereka dalam sembang terus anda sebaliknya; itu kekal terbuka. Pembantu boleh melakukannya: get_import menyenaraikan ahli yang belum bersetuju, masing-masing dengan sembang terus yang anda miliki dengan mereka, dan pembantu menyiarkan peringatan di sana dan menyemak semula sehingga bahagian yang anda mahu telah bersetuju.
Sediakan ruang untuk sejarah yang lebih lama
Jika sejarah lebih lama daripada mesej yang sudah ada dalam sembang, contohnya mesej sistem yang merekodkan ahli menyertai, alih keluarnya dahulu. Dengan alat MCP, wipe_history mengalih keluar mesej sembang dari mesej yang dipilih seterusnya (secara lalai semuanya), hanya semasa import berjalan dan hanya untuk pemilik, dan kembali setelah ia dipadam; remove_message mengalih keluar satu mesej. Kedua-duanya berfungsi semasa import. Pengosongan tidak boleh dibuat asal, jadi sahkan dengan pemilik sebelum ia dijalankan. Jangan kosongkan lagi selepas mesej diimport: ia akan mengalih keluarnya juga.
Hantar mesej
Semasa mod import hidup, pembantu atau program pemilik menghantar sejarah:
- Baca import semasa (
get_import); ia membawa ID import yang diperlukan oleh setiap panggilan. - Muat naik lampiran dahulu, untuk ahli yang menghantarnya; ahli itu mesti telah bersetuju. Setiap muat naik dilampirkan pada satu mesej.
- Hantar mesej dalam kelompok 1 hingga 100, yang paling lama dahulu. Setiap mesej mempunyai pengarang, masa asal, teks (sehingga 64 KB), sehingga 10 lampiran dan, pilihan, mesej yang dibalasnya. Kelompok mempunyai ID sendiri: menghantar kelompok yang sama sekali lagi mengembalikan hasil terdahulu, jadi percubaan semula selepas ralat rangkaian tidak menduplikasi mesej.
- Balasan hanya boleh menunjuk ke mesej yang sudah ada dalam sembang, jadi hantar mesej itu dahulu, dalam kelompok terdahulu, dan gunakan ID yang dikembalikannya.
- Dalam import seluruh tempat, hantar setiap mesej ke sembang tempat tertentu yang menjadi miliknya. Semak hasil setiap mesej. Kelompok boleh berjaya sebahagian: mesej yang ditolak kembali dengan sebabnya (contohnya "Ahli ini belum bersetuju dengan import."), dan yang lain disimpan.
Alat MCP untuk langkah ini diterangkan dalam Import sejarah. Perkhidmatan yang sama tersedia kepada program melalui API RPC, dengan jenis data dalam Jenis data Import. post_message MCP bukan import: ia menyiarkan sebagai anda, bertarikh sekarang.
Tamatkan mod import
Apabila semua mesej dihantar, pemilik memilih Tamatkan import dalam aplikasi, atau pembantu memanggil end_import. Ahli boleh menyiarkan semula, dan sejarah yang diimport berada di atas mesej baharu yang pertama. Ahli yang tidak pernah bersetuju hanya tidak mempunyai mesej yang diimport.
Selepas import, tatal sembang untuk menyemaknya: mesej menunjukkan pengarang dan tarikh asalnya, dan mesej baharu yang pertama mengikutinya. Bandingkan beberapa mesej dengan sumber, dan baca senarai mesej yang ditolak jika pembantu anda menyimpannya. Lebih baik lagi, baca semula mesej yang diimport sebelum anda menamatkan mod import, semasa anda masih boleh menghantar yang tiada.

Contoh: import eksport Telegram
Keseluruhan import boleh dilakukan oleh pembantu yang disambungkan ke Voxt melalui MCP dan boleh membaca folder eksport pada komputer anda, seperti Claude Code atau pembantu lain dengan akses fail. Ia tidak memerlukan program anda sendiri. Pembantu sembang sahaja yang tidak boleh membaca fail anda tidak dapat melakukannya.
Sebelum anda bermula:
- Dalam Telegram Desktop, eksport sembang: buka sembang, pilih Export chat history, pilih Machine-readable JSON dan sertakan foto dan fail jika anda mahu. Folder eksport mengandungi
result.jsondan folder sepertiphotosdanfiles. - Cipta sembang kumpulan Voxt dan tambah orang yang menulis dalam sembang Telegram. Setiap orang memerlukan akaun Voxt dan mesti ahli. Nama Telegram yang tiada ahli Voxt tidak boleh diimport.
- Tentukan cara pembantu log masuk: dengan kunci API, atau dengan akaun Voxt anda melalui OAuth (di bawah).
- Tambah Voxt ke pembantu anda sebagai pelayan MCP (di bawah).
Tambah Voxt sebagai pelayan MCP
Alamat pelayan ialah https://voxt.ai/mcp. Terdapat dua cara untuk log masuk. Dalam kedua-duanya, pembantu bertindak sebagai anda.
Dengan kunci API. Cipta kunci dalam Voxt (Tetapan → API & aplikasi → Cipta kunci API) dan hantarnya dalam pengepala Authorization: Bearer. Dalam Claude Code, jalankan:
claude mcp add --transport http voxt https://voxt.ai/mcp --header "Authorization: Bearer $VOXT_API_KEY"Tetapkan VOXT_API_KEY dalam terminal anda dahulu, supaya kunci tidak muncul dalam gesaan atau dalam fail.
Dengan OAuth. Tinggalkan pengepala dan kunci:
claude mcp add --transport http voxt https://voxt.ai/mcpKemudian mulakan Claude Code, jalankan /mcp, pilih voxt dan pilih untuk mengesahkan. Tetingkap pelayar dibuka dengan halaman persetujuan Voxt; luluskan akses dan pembantu disambungkan, tanpa kunci untuk dicipta atau disimpan.
Pembantu lain mempunyai halaman tetapan untuk pelayan MCP jauh atau penyambung tempat anda memasukkan alamat yang sama, dan sama ada pengepala atau log masuk. MCP menerangkan kedua-dua cara. Minta pembantu menyenaraikan sembang Voxt anda untuk menyemak bahawa sambungan berfungsi.
Berikan arahan
Berikan pembantu arahan seperti ini. Gantikan folder dan nama sembang.
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.Catatan tentang contoh:
- Telegram menyimpan masa mesej tanpa zon waktu. Semak mesej pertama yang diimport dengan sembang asal sebelum menghantar yang selebihnya.
- Mesej yang ditolak tidak menghentikan kelompok. Betulkan puncanya (ahli yang tiada, pengirim yang belum membenarkan import, masa yang tidak mengikut susunan) dan hantar semula dalam kelompok baharu.
- Mesej yang tidak boleh dipetakan ditinggalkan, jadi simpan eksport Telegram jika anda memerlukan rekod penuh.
- Setiap fail bergerak dalam kepingan 1 MB melalui pembantu, jadi sembang dengan banyak fail besar mengambil banyak panggilan. Teks sahaja cepat.
Panduan berkaitan
- Sembang untuk pandangan ahli tentang mod import.
- MCP dan rujukan alatnya.
- API RPC.