Preskoči na sadržaj

Uvoz i izvoz ​

Voxt nema gumb „izvezi chat“ ni „uvezi chat“ koji bi stvarao ili čitao datoteku. Podaci se prenose preko dva programska sučelja:

  • Izvoz čita poruke, privitke, članove i sažetke chata preko MCP-a ili RPC API-ja.
  • Uvoz dodaje raniju povijest 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 usluge uvoza RPC API-ja. U oba slučaja vlasnik može cijeli proces provesti preko asistenta.

Izvoz chata ​

Izvoz zahtijeva API ključ ili OAuth prijavu. Asistent ili skripta djeluje kao vi, pa može čitati točno one chatove koje možete čitati vi, i ništa drugo.

  1. Stvorite API ključ ili povežite asistenta OAuth tokom, kako je opisano u MCP-u.
  2. Zatražite izvoz od svog asistenta, na primjer: „Pročitaj sve poruke chata Trip photos i spremi ih kao Markdown datoteku s datumima i autorima.“ Asistent bira alate; ne trebate znati njihova imena.
  3. Za skriptu pozovite alate izravno. Referenca alata navodi ih s argumentima.

Što se može čitati:

PodaciAlatiNapomene
Porukelist_messages, get_id_rangeNajstarije prvo, do 1.024 poruke po pozivu. Nastavite od ID-a zadnje poruke dok se ništa ne vrati. Uklonjene poruke se izostavljaju.
Zakačene poruke i reakcijelist_pinned_messages, list_reactions
Fotografije, videi, datoteke i linkovilist_media, list_files, list_linksGrupirano po mjesecima, najnoviji mjesec prvi. Svaki privitak ima URL sadržaja.
Članovilist_members, list_place_members
Chatovi i Mjestalist_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_placeKoristite ih da pronađete što izvesti. Chatove koje ste arhivirali navodi samo list_archived_chats.
Sažetcilist_conversations, get_conversationSažeti dijelovi chata, na primjer glasovna sesija.
Rezultati pretragesearch_messages, search_contacts

Što valja znati prije izvoza velikog chata:

  • Alati vraćaju stranice, a ne datoteku. Asistent ili skripta sastavlja rezultat.
  • Poruka koja se još prenosi nema još teksta. Pročitajte taj dio ponovo kasnije.
  • Izmjene i uklanjanja poruka koje ste već pročitali ne prijavljuju se. Ponovo pročitajte raspon ako je chat još aktivan.

Uvoz povijesti u chat ​

Koristite način uvoza da biste razgovor iz druge usluge prenijeli u Voxt grupni chat ili Mjesto. Poruke se pohranjuju pod izvornim autorima i izvornim datumima, pa chat izgleda kao da je oduvijek bio u Voxtu.

Što valja 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 obuhvaća svaki chat u Mjestu. U izravne chatove ne može se uvoziti.
  • Svaki autor mora biti trenutni član chata i mora se složiti. Poruke nekoga tko se nije složio, tko je otišao ili tko nije član odbijaju se.
  • Uvezene poruke moraju imati datum u prošlosti, svaka kasniji od prethodne i kasniji od najnovije poruke koju chat već ima. Sistemske poruke se računaju, na primjer pridruživanje članova, pa u grupnom chatu povijest mora biti datirana nakon pridruživanja članova. Računaju se samo poruke koje su još u chatu, pa se povijest ne može umetnuti prije poruka koje postoje, ali se može prilagoditi: tijekom uvoza vlasnik može obrisati povijest chata ili ukloniti pojedine poruke, i tada se može uvesti povijest stara koliko i obrisane poruke. Brisanje tijekom uvoza ne može se poništiti i ne objavljuje bilješku „povijest obrisana“.
  • Dok je način uvoza uključen nitko ne može objavljivati, ni vlasnik. Uvoz za cijelo Mjesto zaustavlja objavljivanje u svakom chatu Mjesta.
  • Uvezene poruke ne šalju obavijesti.

Pokretanje načina uvoza ​

U aplikaciji:

  1. Otvorite postavke chata (na uskom ekranu odaberite gumb s tri točke u zaglavlju chata, zatim Uredi chat; na širokom ekranu otvorite desni panel i odaberite gumb za uređivanje u njegovu zaglavlju), ili Mjesta za uvoz za cijelo Mjesto, i odaberite Pokreni uvoz. Stavka se prikazuje samo vlasnicima i ne prikazuje se u nitima.
  2. Potvrdite Pokrenuti način uvoza?. Voxt izvodi nekoliko završnih provjera oko deset sekundi („Ulazak u način uvoza“). Ako je netko objavio poruku dok je započinjao, Voxt traži da uklonite tu poruku i počnete ponovo.
  3. Okvir za poruke zamjenjuje se tekstom Režim održavanja za sve.
The header of the group chat Trip photos with the three-dot menu button.
The chat header menu of Trip photos with the Edit chat entry.
The chat settings of an owner with the Start import entry marked.

Asistent s MCP alatima za uvoz može isto učiniti s start_import. Alat ne radi ništa osim ako poziv ne kaže da ste potvrdili, jer zaustavlja objavljivanje za sve članove.

Zamolite članove da dozvole uvoz ​

Dijalog za potvrdu, pristanak članova i završetak uvoza prikazani su u odjeljku Uvoz povijesti chata. Ukratko:

  1. Svaki član otvara chat, odabire Dozvoli uvoz mojih poruka i medija tokom ove sesije i potvrđuje Dozvoliti uvoz?. Pristanak se ne može opozvati za taj uvoz. Vlasnik također pristaje, da bi se uvezle njegove poruke.
  2. Vlasnik vidi udio članova koji su se složili („Pristalo: 100% (3 od 3)“) i tko još nedostaje.
  3. Poruke članova koji se nisu složili odbijaju se, pa pričekajte dok se ne slože svi čiju povijest želite.

Članovi ne mogu pisati u chatu tijekom uvoza, pa ih vlasnik tamo ne može podsjetiti. Pošaljite im poruku u izravnim chatovima; oni ostaju otvoreni. Asistent to može učiniti: get_import navodi članove koji se nisu složili, svakoga s izravnim chatom koji imate s njim, a asistent tamo objavljuje podsjetnik i ponovo provjerava dok se ne složi udio koji želite.

Oslobađanje mjesta za stariju povijest ​

Ako je povijest starija od poruka koje su već u chatu, na primjer sistemskih poruka koje bilježe pridruživanje članova, prvo ih uklonite. S MCP alatima wipe_history uklanja poruke chata od odabrane poruke nadalje (prema zadanim postavkama sve), samo dok uvoz traje i samo za vlasnike, i vraća se kada su izbrisane; remove_message uklanja pojedinu poruku. Oba rade tijekom uvoza. Brisanje se ne može poništiti, pa ga potvrdite s vlasnikom prije izvođenja. 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 povijest:

  1. Pročitajte trenutni uvoz (get_import); sadrži ID uvoza koji je potreban svakom pozivu.
  2. Prvo učitajte privitke, za člana koji ih je poslao; taj član mora se složiti. Svako učitavanje pridružuje se jednoj poruci.
  3. Šaljite poruke u skupinama od 1 do 100, najstarije prvo. Svaka poruka ima autora, izvorno vrijeme, tekst (do 64 KB), do 10 privitaka i, neobavezno, poruku na koju odgovara. Skupina ima vlastiti ID: ponovno slanje iste skupine vraća raniji rezultat, pa ponavljanje nakon mrežne greške ne udvostručuje poruke.
  4. Odgovor može upućivati samo na poruku koja je već u chatu, pa prvo pošaljite tu poruku, u ranijoj skupini, i upotrijebite njezin vraćeni ID.
  5. U uvozu za cijelo Mjesto svaku poruku šaljite u određeni chat Mjesta kojem pripada. Provjerite rezultat svake poruke. Skupina može djelomično uspjeti: odbijena poruka vraća se s razlogom (na primjer „Ovaj član nije pristao na uvoz.“), a ostale se pohranjuju.

MCP alati za ove korake opisani su u Uvozu povijesti. Ista usluga dostupna je programima preko RPC API-ja, s tipovima podataka u Tipovima podataka uvoza. MCP-ov post_message nije uvoz: objavljuje kao vi, s današnjim datumom.

Završetak načina uvoza ​

Kad su sve poruke poslane, vlasnik odabire Završi uvoz u aplikaciji, ili asistent poziva end_import. Članovi opet mogu objavljivati, a uvezena povijest nalazi se iznad prve nove poruke. Članovi koji se nikad nisu složili jednostavno nemaju uvezenih poruka.

Nakon uvoza pregledajte chat listanjem: poruke prikazuju svoje izvorne autore i datume, a prva nova poruka slijedi iza njih. Usporedite nekoliko poruka s izvorom i pročitajte popis odbijenih poruka ako ga je vaš asistent vodio. Još bolje, pročitajte uvezene poruke prije nego što završite način uvoza, dok još možete poslati one koje nedostaju.

A chat with older imported messages followed by a new message.

Primjer: uvoz Telegram izvoza ​

Cijeli uvoz može provesti asistent koji je povezan s Voxtom preko MCP-a i može čitati mapu s izvozom na vašem računalu, kao što je Claude Code ili drugi asistent s pristupom datotekama. Ne treba vam vlastiti program. Asistent samo za chat koji ne može čitati vaše datoteke ne može to učiniti.

Prije početka:

  1. U Telegram Desktopu izvezite chat: otvorite chat, odaberite Export chat history, izaberite Machine-readable JSON i uključite fotografije i datoteke ako ih želite. Mapa izvoza sadrži result.json i mape kao što su photos i files.
  2. Stvorite Voxt grupni chat i dodajte ljude koji su pisali u Telegram chatu. Svatko treba Voxt račun i mora biti član. Telegram imena koja nemaju Voxt člana ne mogu se uvesti.
  3. Odlučite kako se asistent prijavljuje: API ključem ili vašim Voxt računom preko OAutha (dolje).
  4. 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. Stvorite ključ u Voxtu (Postavke → API i aplikacije → Stvorite API ključ) i proslijedite ga u zaglavlju Authorization: Bearer. U Claude Codeu pokrenite:

bash
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 datoteci.

S OAuthom. Izostavite zaglavlje i ključ:

bash
claude mcp add --transport http voxt https://voxt.ai/mcp

Zatim pokrenite Claude Code, pokrenite /mcp, odaberite voxt i odaberite autentifikaciju. Otvara se prozor preglednika sa stranicom za pristanak Voxta; odobrite pristup i asistent je povezan, bez ključa za stvaranje ili pohranu.

Drugi asistenti imaju stranicu postavki za udaljene MCP servere ili konektore gdje unosite istu adresu, te ili zaglavlje ili prijavu. MCP opisuje oba načina. Zatražite od asistenta da navede vaše Voxt chatove kako biste provjerili radi li veza.

Davanje uputa ​

Dajte asistentu upute poput ovih. Zamijenite mapu i naziv chata.

text
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 pohranjuje vrijeme poruke bez vremenske zone. Provjerite prvih nekoliko uvezenih poruka s izvornim chatom prije slanja ostalih.
  • Odbijene poruke ne zaustavljaju skupinu. Otklonite uzrok (član koji nedostaje, pošiljatelj koji nije dozvolio uvoz, vrijeme izvan redoslijeda) i pošaljite ih ponovo u novoj skupini.
  • Poruke koje se ne mogu mapirati izostavljaju se, pa sačuvajte Telegram izvoz ako vam treba cjelovit zapis.
  • Svaka datoteka putuje u dijelovima od 1 MB preko asistenta, pa chat s mnogo velikih datoteka zahtijeva mnogo poziva. Sam tekst ide brzo.