Uvoz i izvoz
Voxt nema dugme „izvezi chat“ ili „uvezi chat“ koje pravi ili čita fajl. Podaci se prenose preko dva programska interfejsa:
- Izvoz čita poruke, priloge, članove i sažetke chata preko MCP-a ili RPC API-ja.
- Uvoz dodaje raniju istoriju 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 cijeli postupak može voditi iz asistenta.
Izvoz chata
Izvoz zahtijeva API ključ ili OAuth prijavu. Asistent ili skripta djeluje kao vi, pa može čitati tačno one chatove koje i vi možete čitati, i ništa više.
- Napravite API ključ, ili povežite asistenta putem OAuth toka, kako je opisano u MCP-u.
- Zatražite izvoz od 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 argumentima.
Šta se može pročitati:
| Podaci | Alati | Napomene |
|---|---|---|
| Poruke | list_messages, get_id_range | Od najstarije, do 1.024 poruke po pozivu. Nastavite od ID-a posljednje poruke dok se ništa ne vrati. Uklonjene poruke su izostavljene. |
| 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 nađete šta treba 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. Rezultat sastavlja asistent ili skripta.
- Poruka koja se još prenosi nema tekst. Taj dio pročitajte ponovo kasnije.
- Izmjene i uklanjanja poruka koje ste već pročitali se ne prijavljuju. Ako je chat još aktivan, ponovo pročitajte opseg.
Uvoz istorije u chat
Koristite način uvoza da prenesete razgovor iz druge usluge u Voxt grupni chat ili mjesto. Poruke se čuvaju pod originalnim autorima i originalnim datumima, pa chat izgleda 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 istorija mora biti datirana poslije pridruživanja članova. Računaju se samo poruke koje su još u chatu, pa se istorija ne može umetnuti prije poruka koje tamo jesu, ali se može prilagoditi: tokom uvoza vlasnik može obrisati istoriju chata ili ukloniti pojedinačne poruke, i tada se može uvesti istorija stara koliko i obrisane poruke. Brisanje tokom uvoza se ne može poništiti i ne objavljuje napomenu „istorija obrisana“.
- Dok je način uvoza uključen niko ne može slati poruke, ni vlasnik. Uvoz za cijelo mjesto zaustavlja slanje u svakom chatu mjesta.
- Uvezene poruke ne šalju obavještenja.
Pokretanje načina uvoza
U aplikaciji:
- Otvorite postavke chata (na uskom ekranu izaberite dugme s tri tačke u zaglavlju chata, pa Uredi chat; na širokom ekranu otvorite desni panel i izaberite dugme za uređivanje u njegovom zaglavlju), ili mjesta za uvoz za cijelo mjesto, i izaberite Pokreni uvoz. Stavku vide samo vlasnici, i ne vidi se u nitima.
- Potvrdite Pokrenuti način uvoza?. Voxt pokreće nekoliko završnih provjera oko deset sekundi („Ulazak u način uvoza“). Ako je neko poslao 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 dok poziv ne kaže da ste potvrdili, jer zaustavlja slanje za svakog člana.
Zamolite članove da dozvole uvoz
Dijalog za potvrdu, saglasnost članova i završetak uvoza prikazani su u Uvoz istorije 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 povući. Vlasnik se takođe saglašava, da bi se uvezle njegove poruke.
- Vlasnik vidi udio članova koji su se složili („Saglasno: 100% (3 od 3)“) i ko još nedostaje.
- Poruke članova koji se nisu složili se odbijaju, pa sačekajte da se slože svi čiju istoriju želite.
Članovi ne mogu pisati u chatu tokom uvoza, pa ih vlasnik tamo ne može podsjetiti. Umjesto toga pošaljite im poruku 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 šalje podsjetnik i ponovo provjerava dok se ne složi udio koji želite.
Oslobodite mjesto za stariju istoriju
Ako je istorija starija od poruka koje su već u chatu, na primjer od sistemskih poruka o pridruživanju članova, prvo ih uklonite. S MCP alatima, wipe_history uklanja poruke chata od izabrane poruke nadalje (podrazumijevano sve), samo dok uvoz traje i samo za vlasnike, i vraća se kada su poruke obrisane; remove_message uklanja jednu poruku. Oba rade tokom uvoza. Brisanje se ne može poništiti, pa ga potvrdite s vlasnikom prije nego što se izvrši. Ne brišite ponovo nakon što su poruke uvezene: uklonilo bi i njih.
Slanje poruka
Dok je način uvoza uključen, vlasnikov asistent ili program šalje istoriju:
- Pročitajte trenutni uvoz (
get_import); on nosi ID uvoza koji je potreban svakom pozivu. - Prvo otpremite priloge, za člana koji ih je poslao; taj član se mora složiti. Svako otpremanje se vezuje za jednu poruku.
- Šaljite poruke u grupama od 1 do 100, od najstarije. Svaka poruka ima autora, originalno vrijeme, tekst (do 64 KB), do 10 priloga i, opciono, poruku na koju odgovara. Grupa ima svoj ID: ponovno slanje iste grupe vraća raniji rezultat, pa ponovni pokušaj nakon mrežne greške ne duplira poruke.
- Odgovor može upućivati samo na poruku koja je već u chatu, pa prvo pošaljite tu poruku, u ranijoj grupi, i koristite njen vraćeni ID.
- U uvozu za cijelo mjesto svaku poruku šaljite u konkretan chat mjesta kojem pripada. Provjerite rezultat svake poruke. Grupa može djelimično uspjeti: odbijena poruka vraća se s razlogom (na primjer „Ovaj član nije dao saglasnost za uvoz.“), a ostale se čuvaju.
MCP alati za ove korake opisani su u Uvoz istorije. Ista usluga dostupna je programima preko RPC API-ja, a tipovi podataka su u tipovima podataka za uvoz. MCP-ov post_message nije uvoz: objavljuje kao vi, s datumom sada.
Završetak načina uvoza
Kad su sve poruke poslane, vlasnik bira Završi uvoz u aplikaciji, ili asistent poziva end_import. Članovi ponovo mogu objavljivati, a uvezena istorija nalazi se iznad prve nove poruke. Članovima koji se nikad nisu složili jednostavno nije uvezena nijedna poruka.
Poslije uvoza prođite kroz chat da ga provjerite: poruke prikazuju originalne autore i datume, a prva nova poruka ide iza njih. Uporedite nekoliko poruka s izvorom i pročitajte listu odbijenih poruka ako je vaš asistent vodio jednu. Još bolje, pročitajte uvezene poruke prije nego što 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 s Voxtom povezan preko MCP-a i može čitati fasciklu izvoza na vašem računaru, kao što je Claude Code ili drugi asistent s pristupom fajlovima. Ne treba vam nikakav vlastiti program. Asistent samo za chat koji ne može čitati vaše fajlove ne može to uraditi.
Prije nego što počnete:
- U Telegram Desktopu izvezite chat: otvorite chat, izaberite Export chat history, odaberite Machine-readable JSON i uključite fotografije i fajlove ako ih želite. Fascikla izvoza sadrži
result.jsoni fascikle kao što suphotosifiles. - Napravite Voxt grupni chat i dodajte ljude koji su pisali u Telegram chatu. Svako od njih treba Voxt račun i mora biti član. Telegram imena koja nemaju Voxt člana ne mogu se uvesti.
- Odlučite kako se asistent prijavljuje: API ključem ili vašim Voxt računom preko OAuth-a (dolje).
- Dodajte Voxt svom asistentu kao MCP server (dolje).
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. Napravite 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 terminalu, da se ključ ne pojavi u upitu ili fajlu.
S OAuth-om. Izostavite zaglavlje i ključ:
claude mcp add --transport http voxt https://voxt.ai/mcpZatim pokrenite Claude Code, izvršite /mcp, izaberite voxt i odaberite da se autentifikujete. Otvara se prozor pregledača sa stranicom Voxta za saglasnost; odobrite pristup i asistent je povezan, bez ključa koji treba praviti 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 provjerite radi li veza.
Davanje uputstva
Dajte asistentu uputstvo kao što je ovo. Zamijenite fasciklu 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 originalnim chatom prije slanja ostalih.
- Odbijene poruke ne zaustavljaju grupu. Otklonite uzrok (član koji nedostaje, pošiljalac koji nije dozvolio uvoz, vrijeme koje je van redoslijeda) i pošaljite ih ponovo u novoj grupi.
- Poruke koje se ne mogu mapirati se izostavljaju, pa zadržite Telegram izvoz ako vam treba cijeli zapis.
- Svaki fajl putuje kroz asistenta u dijelovima od 1 MB, pa chat s mnogo velikih fajlova traži mnogo poziva. Sam tekst je brz.
Povezani vodiči
- Chatovi za prikaz načina uvoza iz perspektive člana.
- MCP i njegova referenca alata.
- RPC API.