Impor dan ekspor
Voxt tidak memiliki tombol "ekspor obrolan" atau "impor obrolan" yang menghasilkan atau membaca file. Data berpindah lewat dua antarmuka pemrograman:
- Ekspor membaca pesan, lampiran, anggota, dan ringkasan sebuah obrolan lewat MCP atau RPC API.
- Impor menambahkan riwayat lama dari layanan lain ke sebuah obrolan. Pemilik memulai mode impor, para anggota menyetujui, dan pesan dikirim lewat alat impor MCP atau layanan impor RPC API. Dalam kedua cara, pemilik dapat menjalankan seluruh proses dari sebuah asisten.
Ekspor obrolan
Ekspor memerlukan kunci API atau masuk lewat OAuth. Asisten atau skrip bertindak sebagai Anda, sehingga hanya dapat membaca obrolan yang bisa Anda baca, dan tidak lebih.
- Buat kunci API, atau hubungkan asisten dengan alur OAuth, seperti dijelaskan di MCP.
- Minta ekspor kepada asisten Anda, misalnya: "Baca semua pesan di obrolan Foto perjalanan dan simpan sebagai file Markdown dengan tanggal dan penulisnya." Asisten memilih alatnya; Anda tidak perlu tahu namanya.
- Untuk skrip, panggil alat secara langsung. Referensi alat mencantumkannya beserta argumennya.
Yang dapat dibaca:
| Data | Alat | Catatan |
|---|---|---|
| Pesan | list_messages, get_id_range | Dari yang terlama, hingga 1.024 pesan per panggilan. Lanjutkan dari ID pesan terakhir sampai tidak ada lagi yang dikembalikan. Pesan yang dihapus dilewati. |
| Pesan yang disematkan dan reaksi | list_pinned_messages, list_reactions | |
| Foto, video, file, dan tautan | list_media, list_files, list_links | Dikelompokkan per bulan, bulan terbaru lebih dulu. Setiap lampiran membawa URL konten. |
| Anggota | list_members, list_place_members | |
| Obrolan dan tempat | list_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_place | Gunakan untuk menemukan apa yang akan diekspor. Obrolan yang Anda arsipkan hanya dicantumkan oleh list_archived_chats. |
| Ringkasan | list_conversations, get_conversation | Bagian obrolan yang diringkas, seperti sesi suara. |
| Hasil pencarian | search_messages, search_contacts |
Hal yang perlu diketahui sebelum Anda mengekspor obrolan besar:
- Alat mengembalikan halaman, bukan file. Asisten atau skrip yang menyusun hasilnya.
- Pesan yang masih dialirkan belum memiliki teks. Baca bagian itu lagi nanti.
- Pengeditan dan penghapusan pesan yang sudah Anda baca tidak dilaporkan. Baca ulang rentangnya jika obrolan masih aktif.
Impor riwayat ke obrolan
Gunakan mode impor untuk membawa percakapan dari layanan lain ke obrolan grup Voxt atau tempat. Pesan disimpan dengan penulis dan tanggal aslinya, sehingga obrolan terbaca seolah-olah sejak awal ada di Voxt.
Yang perlu diketahui lebih dulu:
- Hanya pemilik obrolan atau tempat yang dapat memulai dan mengakhiri impor.
- Impor berlaku untuk obrolan grup dan tempat. Impor seluruh tempat mencakup setiap obrolan di tempat itu. Obrolan langsung tidak dapat menjadi tujuan impor.
- Setiap penulis harus menjadi anggota saat ini dari obrolan dan harus menyetujui. Pesan dari orang yang belum menyetujui, yang sudah keluar, atau yang bukan anggota akan ditolak.
- Pesan yang diimpor harus bertanggal di masa lalu, masing-masing lebih baru dari pesan sebelumnya, dan lebih baru dari pesan terbaru yang sudah ada di obrolan. Pesan sistem dihitung, seperti anggota yang bergabung, jadi di obrolan grup riwayat harus bertanggal setelah anggotanya bergabung. Hanya pesan yang masih ada di obrolan yang dihitung, jadi riwayat tidak dapat disisipkan sebelum pesan yang ada di sana, tetapi hal itu bisa diatasi: selama impor pemilik dapat menghapus bersih riwayat obrolan, atau menghapus pesan tertentu, lalu riwayat yang sama tuanya dengan pesan yang dihapus bersih itu dapat diimpor. Penghapusan bersih selama impor tidak dapat dibatalkan dan tidak mengirim catatan "riwayat dihapus".
- Tidak ada yang dapat mengirim pesan selama mode impor aktif, termasuk pemilik. Impor seluruh tempat menghentikan pengiriman pesan di setiap obrolan di tempat itu.
- Pesan yang diimpor tidak mengirim notifikasi.
Mulai mode impor
Di aplikasi:
- Buka pengaturan obrolan (di layar sempit, pilih tombol tiga titik di header obrolan, lalu Edit obrolan; di layar lebar, buka panel kanan dan pilih tombol edit di headernya), atau tempat untuk impor seluruh tempat, dan pilih Mulai impor. Entri ini hanya ditampilkan kepada pemilik, dan tidak di utas.
- Konfirmasi Mulai mode impor?. Voxt menjalankan beberapa pemeriksaan akhir selama sekitar sepuluh detik ("Memasuki mode impor"). Jika seseorang mengirim pesan saat proses dimulai, Voxt meminta Anda menghapus pesan itu dan memulai lagi.
- Kotak pesan diganti dengan Mode pemeliharaan untuk semua orang.



Asisten dengan alat impor MCP dapat melakukan hal yang sama dengan start_import. Alat itu tidak melakukan apa pun kecuali panggilannya menyatakan bahwa Anda sudah mengonfirmasi, karena alat ini menghentikan pengiriman pesan untuk setiap anggota.
Minta anggota mengizinkan impor
Dialog konfirmasi, persetujuan anggota, dan cara mengakhiri impor ditampilkan di Impor riwayat obrolan. Singkatnya:
- Setiap anggota membuka obrolan, memilih Izinkan pesan dan media saya diimpor selama sesi ini, dan mengonfirmasi Izinkan impor?. Persetujuan tidak dapat dicabut untuk impor itu. Pemilik juga menyetujui, agar pesannya sendiri dapat diimpor.
- Pemilik melihat persentase anggota yang sudah menyetujui ("Disetujui: 100% (3 dari 3)") dan siapa yang masih kurang.
- Pesan dari anggota yang belum menyetujui akan ditolak, jadi tunggu sampai semua orang yang riwayatnya ingin Anda impor sudah menyetujui.
Anggota tidak dapat menulis di obrolan selama impor, jadi pemilik tidak dapat mengingatkan mereka di sana. Kirimkan pesan lewat obrolan langsung Anda; obrolan itu tetap terbuka. Asisten dapat melakukannya: get_import mencantumkan anggota yang belum menyetujui, masing-masing dengan obrolan langsung yang Anda miliki dengannya, dan asisten mengirim pengingat di sana lalu memeriksa lagi sampai persentase yang Anda inginkan sudah menyetujui.
Sediakan ruang untuk riwayat yang lebih lama
Jika riwayat lebih lama daripada pesan yang sudah ada di obrolan, misalnya pesan sistem yang mencatat anggota bergabung, hapus pesan itu lebih dulu. Dengan alat MCP, wipe_history menghapus pesan obrolan mulai dari pesan yang dipilih (secara default semuanya), hanya selama impor berjalan dan hanya untuk pemilik, dan selesai setelah pesan-pesan itu terhapus; remove_message menghapus satu pesan. Keduanya bekerja selama impor. Penghapusan bersih tidak dapat dibatalkan, jadi konfirmasikan dengan pemilik sebelum dijalankan. Jangan menghapus bersih lagi setelah pesan diimpor: pesan yang diimpor ikut terhapus.
Kirim pesan
Selama mode impor aktif, asisten atau program pemilik mengirim riwayat:
- Baca impor saat ini (
get_import); hasilnya memuat ID impor yang diperlukan setiap panggilan. - Unggah lampiran lebih dulu, atas nama anggota yang mengirimnya; anggota itu harus sudah menyetujui. Setiap unggahan dilampirkan ke satu pesan.
- Kirim pesan dalam kelompok 1 sampai 100, dari yang terlama. Setiap pesan memiliki penulis, waktu aslinya, teks (hingga 64 KB), hingga 10 lampiran, dan, secara opsional, pesan yang dibalasnya. Setiap kelompok memiliki ID sendiri: mengirim kelompok yang sama lagi mengembalikan hasil sebelumnya, jadi percobaan ulang setelah kesalahan jaringan tidak menggandakan pesan.
- Balasan hanya dapat menunjuk ke pesan yang sudah ada di obrolan, jadi kirim pesannya lebih dulu, di kelompok sebelumnya, dan gunakan ID yang dikembalikan.
- Pada impor seluruh tempat, kirim setiap pesan ke obrolan tertentu di tempat tempat pesan itu berada. Periksa hasil setiap pesan. Satu kelompok bisa berhasil sebagian: pesan yang ditolak kembali dengan alasannya (misalnya "Anggota ini belum menyetujui impor."), dan yang lain disimpan.
Alat MCP untuk langkah-langkah ini dijelaskan di Impor riwayat. Layanan yang sama tersedia untuk program lewat RPC API, dengan tipe data di Tipe data Impor. post_message milik MCP bukan impor: ia mengirim sebagai Anda, bertanggal sekarang.
Akhiri mode impor
Setelah semua pesan terkirim, pemilik memilih Akhiri impor di aplikasi, atau asisten memanggil end_import. Anggota dapat mengirim pesan lagi, dan riwayat yang diimpor berada di atas pesan baru yang pertama. Anggota yang tidak pernah menyetujui tidak memiliki pesan yang diimpor.
Setelah impor, gulir obrolan untuk memeriksanya: pesan menampilkan penulis dan tanggal aslinya, dan pesan baru yang pertama mengikutinya. Bandingkan beberapa pesan dengan sumbernya, dan baca daftar pesan yang ditolak jika asisten Anda menyimpannya. Lebih baik lagi, baca kembali pesan yang diimpor sebelum Anda mengakhiri mode impor, selagi Anda masih dapat mengirim pesan yang kurang.

Contoh: impor hasil ekspor Telegram
Seluruh impor dapat dilakukan oleh asisten yang terhubung ke Voxt lewat MCP dan dapat membaca folder ekspor di komputer Anda, seperti Claude Code atau asisten lain dengan akses file. Anda tidak memerlukan program sendiri. Asisten yang hanya untuk obrolan dan tidak dapat membaca file Anda tidak bisa melakukannya.
Sebelum Anda mulai:
- Di Telegram Desktop, ekspor obrolan: buka obrolan, pilih Ekspor riwayat obrolan, pilih JSON yang dapat dibaca mesin dan sertakan foto dan file jika Anda mau. Folder ekspor berisi
result.jsondan folder sepertiphotosdanfiles. - Buat obrolan grup Voxt dan tambahkan orang-orang yang menulis di obrolan Telegram. Masing-masing memerlukan akun Voxt dan harus menjadi anggota. Nama Telegram yang tidak memiliki anggota Voxt tidak dapat diimpor.
- Tentukan cara asisten masuk: dengan kunci API, atau dengan akun Voxt Anda lewat OAuth (di bawah).
- Tambahkan Voxt ke asisten Anda sebagai server MCP (di bawah).
Tambahkan Voxt sebagai server MCP
Alamat servernya adalah https://voxt.ai/mcp. Ada dua cara masuk. Dalam keduanya, asisten bertindak sebagai Anda.
Dengan kunci API. Buat kunci di Voxt (Pengaturan → API & aplikasi → Buat kunci API) dan kirim dalam header Authorization: Bearer. Di Claude Code, jalankan:
claude mcp add --transport http voxt https://voxt.ai/mcp --header "Authorization: Bearer $VOXT_API_KEY"Atur VOXT_API_KEY di terminal Anda lebih dulu, agar kunci tidak muncul di prompt atau di file.
Dengan OAuth. Hilangkan header dan kuncinya:
claude mcp add --transport http voxt https://voxt.ai/mcpLalu jalankan Claude Code, jalankan /mcp, pilih voxt dan pilih untuk mengautentikasi. Jendela browser terbuka dengan halaman persetujuan Voxt; setujui aksesnya dan asisten terhubung, tanpa kunci yang perlu dibuat atau disimpan.
Asisten lain memiliki halaman pengaturan untuk server atau konektor MCP jarak jauh tempat Anda memasukkan alamat yang sama, dan header atau cara masuknya. MCP menjelaskan kedua cara. Minta asisten mencantumkan obrolan Voxt Anda untuk memeriksa bahwa koneksinya berfungsi.
Berikan instruksi
Berikan instruksi seperti ini kepada asisten. Ganti folder dan nama obrolannya.
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 ini:
- Telegram menyimpan waktu pesan tanpa zona waktu. Periksa beberapa pesan pertama yang diimpor dengan obrolan aslinya sebelum mengirim sisanya.
- Pesan yang ditolak tidak menghentikan kelompoknya. Perbaiki penyebabnya (anggota yang tidak ada, pengirim yang belum mengizinkan impor, waktu yang tidak berurutan) dan kirim lagi dalam kelompok baru.
- Pesan yang tidak dapat dipetakan dilewati, jadi simpan hasil ekspor Telegram jika Anda memerlukan catatan lengkapnya.
- Setiap file berjalan dalam potongan 1 MB lewat asisten, jadi obrolan dengan banyak file besar memerlukan banyak panggilan. Teks saja cepat.
Panduan terkait
- Obrolan untuk tampilan anggota tentang mode impor.
- MCP dan referensi alatnya.
- RPC API.