Uvoz i izvoz
Voxt nema dugme „izvezi chat“ ili „uvezi chat“ koje stvara ili čita fajl. Podaci se prenose kroz dva programska interfejsa:
- Izvoz čita poruke, priloge, članove i sažetke chata preko MCP-a ili RPC API-ja.
- Uvoz dodaje ranije poruke iz druge usluge u chat. Vlasnik pokreće način uvoza, članovi se slažu, a poruke se šalju preko MCP alata za uvoz ili servisa za uvoz RPC API-ja. U oba slučaja vlasnik može cijeli postupak pokrenuti iz asistenta.
Izvoz chata
Izvoz zahtijeva API ključ ili prijavu putem OAutha. Asistent ili skripta djeluje kao vi, pa može čitati tačno one chatove koje i vi možete čitati, i ništa drugo.
- Kreirajte API ključ ili povežite asistenta putem OAuth toka, kako je opisano u MCP-u.
- Zatražite izvoz od svog asistenta, na primjer: „Pročitaj sve poruke chata Trip photos i sačuvaj ih kao Markdown fajl s datumima i autorima.“ Asistent bira alate; ne morate znati njihova imena.
- Za skriptu pozovite alate direktno. Referenca alata navodi ih s njihovim argumentima.
Šta se može pročitati:
| Podaci | Alati | Napomene |
|---|---|---|
| Poruke | list_messages, get_id_range | Najstarije prvo, do 1.024 poruke po pozivu. Nastavite od ID-a posljednje poruke dok se ništa više ne vrati. Uklonjene poruke se izostavljaju. |
| Zakačene poruke i reakcije | list_pinned_messages, list_reactions | |
| Fotografije, video snimci, fajlovi i linkovi | list_media, list_files, list_links | Grupisano po mjesecima, najnoviji mjesec prvi. Svaki prilog ima URL sadržaja. |
| Članovi | list_members, list_place_members | |
| Chatovi i mjesta | list_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_place | Koristite ih da pronađete šta izvesti. Chatove koje ste arhivirali navodi samo list_archived_chats. |
| Sažeci | list_conversations, get_conversation | Sažeti dijelovi chata, kao što je glasovna sesija. |
| Rezultati pretrage | search_messages, search_contacts |
Šta treba znati prije izvoza velikog chata:
- Alati vraćaju stranice, a ne fajl. Asistent ili skripta sastavlja rezultat.
- Poruka koja se još strimuje još nema tekst. Pročitajte taj dio ponovo kasnije.
- Izmjene i uklanjanja poruka koje ste već pročitali se ne prijavljuju. Ponovo pročitajte raspon ako je chat još aktivan.
Uvoz historije u chat
Koristite način uvoza da biste razgovor iz druge usluge prenijeli u Voxt grupni chat ili mjesto. Poruke se čuvaju pod svojim izvornim autorima i izvornim datumima, pa se chat čita kao da je oduvijek bio u Voxtu.
Šta treba znati prvo:
- Samo vlasnik chata ili mjesta može pokrenuti i završiti uvoz.
- Radi za grupne chatove i za mjesta. Uvoz za cijelo mjesto obuhvata svaki chat u mjestu. U direktne chatove se ne može uvoziti.
- Svaki autor mora biti trenutni član chata i mora se složiti. Poruke nekoga ko se nije složio, ko je otišao ili ko nije član se odbijaju.
- Uvezene poruke moraju biti datirane u prošlosti, svaka kasnije od prethodne i kasnije od najnovije poruke koju chat već ima. Sistemske poruke se računaju, kao što je pridruživanje članova, pa u grupnom chatu historija mora biti datirana nakon što su se članovi pridružili. Računaju se samo poruke koje su još u chatu, pa se historija ne može umetnuti prije poruka koje tamo jesu, ali se može prilagoditi: tokom uvoza vlasnik može obrisati historiju chata ili ukloniti pojedinačne poruke, a zatim se može uvesti historija stara koliko i obrisane poruke. Brisanje tokom uvoza se ne može poništiti i ne objavljuje bilješku „historija obrisana“.
- Niko ne može objavljivati dok je način uvoza uključen, uključujući i vlasnika. Uvoz za cijelo mjesto zaustavlja objavljivanje u svakom chatu mjesta.
- Uvezene poruke ne šalju obavještenja.
Pokretanje načina uvoza
U aplikaciji:
- Otvorite postavke chata (na uskom ekranu odaberite dugme s tri tačke u zaglavlju chata, zatim Uredi chat; na širokom ekranu otvorite desni panel i odaberite dugme za uređivanje u njegovom zaglavlju), ili mjesta za uvoz za cijelo mjesto, i odaberite Pokreni uvoz. Stavka se prikazuje samo vlasnicima, a ne u nitima.
- Potvrdite Pokrenuti način uvoza?. Voxt izvršava nekoliko završnih provjera oko deset sekundi („Ulazak u način uvoza“). Ako je neko objavio poruku dok se pokretao, Voxt traži da uklonite tu poruku i počnete ponovo.
- Polje za poruke se za sve zamjenjuje natpisom Režim održavanja.



Asistent s MCP alatima za uvoz može isto uraditi pomoću start_import. Alat ne radi ništa osim ako poziv ne navede da ste potvrdili, jer zaustavlja objavljivanje za svakog člana.
Zamolite članove da dozvole uvoz
Dijalog za potvrdu, saglasnost članova i završetak uvoza prikazani su u Uvoz historije chata. Ukratko:
- Svaki član otvara chat, bira Dozvoli uvoz mojih poruka i medija tokom ove sesije i potvrđuje Dozvoliti uvoz?. Saglasnost se za taj uvoz ne može opozvati. Vlasnik također daje saglasnost, da bi se uvezle i njegove poruke.
- Vlasnik vidi udio članova koji su se složili („Dali saglasnost: 100% (3 od 3)“) i ko još nedostaje.
- Poruke članova koji se nisu složili se odbijaju, pa sačekajte dok se ne slože svi čiju historiju želite.
Članovi ne mogu pisati u chatu tokom uvoza, pa ih vlasnik tamo ne može podsjetiti. Umjesto toga im pišite u direktnim chatovima; oni ostaju otvoreni. Asistent to može uraditi: get_import navodi članove koji se nisu složili, svakog s direktnim chatom koji imate s njim, a asistent tamo objavljuje podsjetnik i ponovo provjerava dok se ne složi udio koji želite.
Napravite mjesta za stariju historiju
Ako je historija starija od poruka koje su već u chatu, na primjer sistemskih poruka o pridruživanju članova, prvo ih uklonite. S MCP alatima, wipe_history uklanja poruke chata od odabrane poruke nadalje (podrazumijevano sve), samo dok uvoz traje i samo za vlasnike, i vraća odgovor kada su obrisane; remove_message uklanja jednu poruku. Oba rade tokom uvoza. Brisanje se ne može poništiti, zato ga potvrdite s vlasnikom prije nego se izvrši. Nemojte ponovo brisati nakon što su poruke uvezene: uklonilo bi i njih.
Slanje poruka
Dok je način uvoza uključen, asistent ili program vlasnika šalje historiju:
- Pročitajte trenutni uvoz (
get_import); on sadrži ID uvoza koji je potreban svakom pozivu. - Prvo otpremite priloge, za člana koji ih je poslao; taj član mora biti saglasan. Svako otpremanje se veže za jednu poruku.
- Šaljite poruke u serijama od 1 do 100, najstarije prvo. Svaka poruka ima autora, izvorno vrijeme, tekst (do 64 KB), do 10 priloga i, opcionalno, poruku na koju odgovara. Serija ima svoj ID: ponovno slanje iste serije vraća raniji rezultat, pa ponovni pokušaj nakon greške mreže ne duplira poruke.
- Odgovor može upućivati samo na poruku koja je već u chatu, pa prvo pošaljite tu poruku, u ranijoj seriji, i koristite ID koji je vraćen.
- Pri uvozu za cijelo mjesto šaljite svaku poruku u konkretan chat mjesta kojem pripada. Provjerite rezultat svake poruke. Serija može djelimično uspjeti: odbijena poruka se vraća s razlogom (na primjer „Ovaj član nije dao saglasnost za uvoz.“), a ostale se čuvaju.
MCP alati za ove korake opisani su u Uvoz historije. Ista usluga dostupna je programima preko RPC API-ja, a tipovi podataka u Tipovi podataka uvoza. MCP-ov post_message nije uvoz: objavljuje kao vi, s trenutnim datumom.
Završetak načina uvoza
Kada su sve poruke poslane, vlasnik bira Završi uvoz u aplikaciji, ili asistent poziva end_import. Članovi ponovo mogu objavljivati, a uvezena historija se nalazi iznad prve nove poruke. Članovi koji se nikad nisu složili jednostavno nemaju uvezenih poruka.
Nakon uvoza pregledajte chat listajući ga: poruke prikazuju svoje izvorne autore i datume, a prva nova poruka ide iza njih. Uporedite nekoliko poruka s izvorom i pročitajte listu odbijenih poruka ako ju je vaš asistent vodio. Još bolje, pročitajte uvezene poruke prije nego završite način uvoza, dok još možete poslati one koje nedostaju.

Primjer: uvoz Telegram izvoza
Cijeli uvoz može obaviti asistent koji je povezan s Voxtom preko MCP-a i može čitati folder izvoza na vašem računaru, kao što je Claude Code ili drugi asistent s pristupom fajlovima. Ne treba vam vlastiti program. Asistent samo za chat koji ne može čitati vaše fajlove to ne može uraditi.
Prije nego počnete:
- U Telegram Desktopu izvezite chat: otvorite chat, odaberite Export chat history, izaberite Machine-readable JSON i uključite fotografije i fajlove ako ih želite. Folder izvoza sadrži
result.jsoni foldere kao što suphotosifiles. - Kreirajte Voxt grupni chat i dodajte ljude koji su pisali u Telegram chatu. Svako mora imati Voxt račun i biti član. Telegram imena koja nemaju Voxt člana ne mogu se uvesti.
- Odlučite kako se asistent prijavljuje: pomoću API ključa ili vašim Voxt računom preko OAutha (ispod).
- Dodajte Voxt svom asistentu kao MCP server (ispod).
Dodavanje Voxta kao MCP servera
Adresa servera je https://voxt.ai/mcp. Postoje dva načina prijave. U oba asistent djeluje kao vi.
S API ključem. Kreirajte ključ u Voxtu (Postavke → API i aplikacije → Kreirajte API ključ) i proslijedite ga u zaglavlju Authorization: Bearer. U Claude Codeu pokrenite:
claude mcp add --transport http voxt https://voxt.ai/mcp --header "Authorization: Bearer $VOXT_API_KEY"Prvo postavite VOXT_API_KEY u svom terminalu, da se ključ ne pojavi u upitu ili u fajlu.
S OAuthom. Izostavite zaglavlje i ključ:
claude mcp add --transport http voxt https://voxt.ai/mcpZatim pokrenite Claude Code, izvršite /mcp, odaberite voxt i izaberite autentifikaciju. Otvara se prozor preglednika sa stranicom za saglasnost Voxta; odobrite pristup i asistent je povezan, bez ključa koji treba kreirati ili čuvati.
Drugi asistenti imaju stranicu postavki za udaljene MCP servere ili konektore gdje unosite istu adresu, i zaglavlje ili prijavu. MCP opisuje oba načina. Zatražite od asistenta da navede vaše Voxt chatove da biste provjerili radi li veza.
Davanje uputa
Dajte asistentu uputu poput ove. Zamijenite folder i ime chata.
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.Napomene uz primjer:
- Telegram čuva vrijeme poruke bez vremenske zone. Provjerite prvih nekoliko uvezenih poruka s izvornim chatom prije slanja ostalih.
- Odbijene poruke ne zaustavljaju seriju. Otklonite uzrok (član koji nedostaje, pošiljalac koji nije dozvolio uvoz, vrijeme koje nije u redoslijedu) i pošaljite ih ponovo u novoj seriji.
- Poruke koje se ne mogu mapirati se izostavljaju, pa sačuvajte Telegram izvoz ako vam treba potpun zapis.
- Svaki fajl putuje kroz asistenta u dijelovima od 1 MB, pa chat s mnogo velikih fajlova zahtijeva mnogo poziva. Sam tekst je brz.
Srodni vodiči
- Chatovi za prikaz načina uvoza iz perspektive člana.
- MCP i njegova referenca alata.
- RPC API.