Tuonti ja vienti
Voxtissa ei ole "vie keskustelu"- tai "tuo keskustelu" -painiketta, joka tuottaisi tai lukisi tiedoston. Tiedot siirtyvät kahden ohjelmallisen rajapinnan kautta:
- Vienti lukee keskustelun viestit, liitteet, jäsenet ja yhteenvedot MCP:n tai RPC API:n kautta.
- Tuonti lisää keskusteluun aiempaa historiaa toisesta palvelusta. Omistaja aloittaa tuontitilan, jäsenet hyväksyvät sen, ja viestit lähetetään MCP:n tuontityökaluilla tai RPC API:n tuontipalvelulla. Kummassakin tapauksessa omistaja voi ajaa koko prosessin avustajan kautta.
Keskustelun vieminen
Vienti vaatii API-avaimen tai OAuth-kirjautumisen. Avustaja tai skripti toimii sinuna, joten se voi lukea täsmälleen ne keskustelut, jotka sinäkin voit lukea, eikä muita.
- Luo API-avain tai yhdistä avustaja OAuth-kululla, kuten MCP kuvaa.
- Pyydä avustajaltasi vienti, esimerkiksi: "Lue keskustelun Trip photos kaikki viestit ja tallenna ne Markdown-tiedostoksi päivämäärineen ja kirjoittajineen." Avustaja valitsee työkalut; sinun ei tarvitse tietää niiden nimiä.
- Skriptissä kutsu työkaluja suoraan. Työkaluviite listaa ne argumentteineen.
Mitä voi lukea:
| Tiedot | Työkalut | Huomautuksia |
|---|---|---|
| Viestit | list_messages, get_id_range | Vanhimmat ensin, enintään 1 024 viestiä kutsua kohden. Jatka viimeisen viestin tunnisteesta, kunnes mitään ei palaudu. Poistetut viestit jätetään pois. |
| Kiinnitetyt viestit ja reaktiot | list_pinned_messages, list_reactions | |
| Valokuvat, videot, tiedostot ja linkit | list_media, list_files, list_links | Ryhmiteltynä kuukausittain, uusin kuukausi ensin. Jokaisella liitteellä on sisällön URL-osoite. |
| Jäsenet | list_members, list_place_members | |
| Keskustelut ja paikat | list_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_place | Käytä niitä löytääksesi, mitä viedä. Arkistoimasi keskustelut listaa vain list_archived_chats. |
| Yhteenvedot | list_conversations, get_conversation | Keskustelun tiivistetyt jaksot, kuten ääni-istunto. |
| Hakutulokset | search_messages, search_contacts |
Asioita, jotka kannattaa tietää ennen suuren keskustelun vientiä:
- Työkalut palauttavat sivuja, eivät tiedostoa. Avustaja tai skripti kokoaa tuloksen.
- Viestillä, jota vielä suoratoistetaan, ei ole vielä tekstiä. Lue kyseinen kohta myöhemmin uudelleen.
- Jo lukemiesi viestien muokkauksia ja poistoja ei ilmoiteta. Lue väli uudelleen, jos keskustelu on yhä aktiivinen.
Historian tuominen keskusteluun
Käytä tuontitilaa tuodaksesi keskustelun toisesta palvelusta Voxtin ryhmäkeskusteluun tai paikkaan. Viestit tallennetaan alkuperäisten kirjoittajien ja alkuperäisten päivämäärien kanssa, joten keskustelu näyttää siltä kuin se olisi aina ollut Voxtissa.
Mitä tulee tietää ensin:
- Vain keskustelun tai paikan omistaja voi aloittaa ja lopettaa tuonnin.
- Se toimii ryhmäkeskusteluille ja paikoille. Koko paikan tuonti kattaa kaikki paikan keskustelut. Suoriin keskusteluihin ei voi tuoda.
- Jokaisen kirjoittajan on oltava keskustelun nykyinen jäsen ja hänen on hyväksyttävä tuonti. Jäsenen viestit, joka ei ole hyväksynyt, on poistunut tai ei ole jäsen, hylätään.
- Tuotujen viestien on oltava päivätty menneisyyteen, kukin edellistä myöhemmäksi ja keskustelun uusinta olemassa olevaa viestiä myöhemmäksi. Järjestelmäviestit lasketaan mukaan, kuten jäsenten liittyminen, joten ryhmäkeskustelussa historian on oltava päivätty jäsenten liittymisen jälkeen. Vain keskustelussa yhä olevat viestit lasketaan, joten historiaa ei voi lisätä ennen olemassa olevia viestejä, mutta tilaa voi tehdä: tuonnin aikana omistaja voi tyhjentää keskustelun historian tai poistaa yksittäisiä viestejä, ja sen jälkeen voi tuoda historiaa yhtä vanhalta ajalta kuin tyhjennetyt viestit. Tuonnin aikainen tyhjennys on peruuttamaton, eikä se lähetä "historia tyhjennetty" -merkintää.
- Kukaan ei voi lähettää viestejä tuontitilan ollessa päällä, omistaja mukaan lukien. Koko paikan tuonti pysäyttää viestien lähettämisen kaikissa paikan keskusteluissa.
- Tuodut viestit eivät lähetä ilmoituksia.
Tuontitilan aloittaminen
Sovelluksessa:
- Avaa keskustelun asetukset (kapealla näytöllä valitse keskustelun yläpalkin kolmen pisteen painike ja sitten Muokkaa keskustelua; leveällä näytöllä avaa oikea paneeli ja valitse sen yläpalkin muokkauspainike) tai koko paikan tuontia varten paikan asetukset, ja valitse Aloita tuonti. Kohta näkyy vain omistajille, eikä ketjuissa.
- Vahvista Aloitetaanko tuontitila?. Voxt tekee muutaman loppuntarkistuksen noin kymmenen sekunnin ajan ("Siirrytään tuontitilaan"). Jos joku lähetti viestin sen käynnistyessä, Voxt pyytää sinua poistamaan kyseisen viestin ja aloittamaan uudelleen.
- Viestikenttä korvautuu kaikilla tekstillä Huoltotila.



MCP:n tuontityökaluilla varustettu avustaja voi tehdä saman komennolla start_import. Työkalu ei tee mitään, ellei kutsussa kerrota, että vahvistit sen, koska se pysäyttää viestien lähettämisen kaikilta jäseniltä.
Jäsenten pyytäminen sallimaan tuonti
Vahvistusikkuna, jäsenten suostumus ja tuonnin lopettaminen on esitetty kohdassa Keskustelun historian tuonti. Lyhyesti:
- Jokainen jäsen avaa keskustelun, valitsee Salli viestieni ja mediani tuonti tämän istunnon aikana ja vahvistaa Sallitaanko tuonti?. Suostumusta ei voi peruuttaa kyseisen tuonnin osalta. Myös omistaja antaa suostumuksensa tuodakseen omat viestinsä.
- Omistaja näkee suostuneiden jäsenten osuuden ("Suostuneet: 100 % (3 / 3)") ja kuka vielä puuttuu.
- Jäsenten viestit, jotka eivät ole suostuneet, hylätään, joten odota, kunnes kaikki, joiden historiaa haluat, ovat suostuneet.
Jäsenet eivät voi kirjoittaa keskusteluun tuonnin aikana, joten omistaja ei voi muistuttaa heitä siellä. Lähetä heille viesti suorissa keskusteluissanne; ne pysyvät auki. Avustaja voi tehdä tämän: get_import listaa jäsenet, jotka eivät ole suostuneet, kunkin kanssa sinulla olevan suoran keskustelun, ja avustaja lähettää muistutuksen sinne ja tarkistaa uudelleen, kunnes haluamasi osuus on suostunut.
Tilan tekeminen vanhemmalle historialle
Jos historia on vanhempaa kuin keskustelussa jo olevat viestit, esimerkiksi järjestelmäviestit, jotka kirjaavat jäsenten liittymisen, poista ne ensin. MCP-työkaluilla wipe_history poistaa keskustelun viestit valitusta viestistä alkaen (oletuksena kaikki), vain tuonnin ollessa käynnissä ja vain omistajille, ja palaa, kun ne on poistettu; remove_message poistaa yksittäisen viestin. Molemmat toimivat tuonnin aikana. Tyhjennystä ei voi peruuttaa, joten vahvista se omistajalta ennen sen ajamista. Älä tyhjennä uudelleen viestien tuonnin jälkeen: se poistaisi myös ne.
Viestien lähettäminen
Tuontitilan ollessa päällä omistajan avustaja tai ohjelma lähettää historian:
- Lue nykyinen tuonti (
get_import); se sisältää tuonnin tunnisteen, jota jokainen kutsu tarvitsee. - Lähetä liitteet ensin, sen jäsenen puolesta, joka ne lähetti; kyseisen jäsenen on täytynyt suostua. Jokainen lähetys liitetään yhteen viestiin.
- Lähetä viestit 1–100 erissä, vanhimmat ensin. Jokaisella viestillä on kirjoittaja, alkuperäinen aika, teksti (enintään 64 kt), enintään 10 liitettä ja valinnaisesti viesti, johon se vastaa. Erällä on oma tunnisteensa: saman erän lähettäminen uudelleen palauttaa aiemman tuloksen, joten uudelleenyritys verkkovirheen jälkeen ei kaksinkertaista viestejä.
- Vastaus voi osoittaa vain viestiin, joka on jo keskustelussa, joten lähetä viesti ensin, aiemmassa erässä, ja käytä sen palautettua tunnistetta.
- Koko paikan tuonnissa lähetä jokainen viesti paikan siihen keskusteluun, johon se kuuluu. Tarkista jokaisen viestin tulos. Erä voi onnistua osittain: hylätty viesti palaa syyn kanssa (esimerkiksi "This member has not consented to import."), ja muut tallennetaan.
Näiden vaiheiden MCP-työkalut on kuvattu kohdassa Historian tuonti. Sama palvelu on ohjelmien käytettävissä RPC API:n kautta, tietotyypit ovat kohdassa Tuonnin tietotyypit. MCP:n post_message ei ole tuonti: se lähettää sinuna, päivättynä nykyhetkeen.
Tuontitilan lopettaminen
Kun kaikki viestit on lähetetty, omistaja valitsee sovelluksessa Lopeta tuonti tai avustaja kutsuu end_import. Jäsenet voivat taas lähettää viestejä, ja tuotu historia on ensimmäisen uuden viestin yläpuolella. Jäsenillä, jotka eivät koskaan suostuneet, ei yksinkertaisesti ole tuotuja viestejä.
Tuonnin jälkeen selaa keskustelua tarkistaaksesi sen: viestit näyttävät alkuperäiset kirjoittajansa ja päivämääränsä, ja ensimmäinen uusi viesti seuraa niitä. Vertaa muutamaa viestiä lähteeseen ja lue hylättyjen viestien luettelo, jos avustajasi piti sellaista. Vielä parempi: lue tuodut viestit takaisin ennen tuontitilan lopettamista, kun voit vielä lähettää puuttuvat.

Esimerkki: Telegram-viennin tuominen
Koko tuonnin voi tehdä avustaja, joka on yhdistetty Voxtiin MCP:n kautta ja joka voi lukea tietokoneesi vientikansiota, kuten Claude Code tai muu tiedostoihin pääsevä avustaja. Se ei vaadi omaa ohjelmaa. Pelkkä keskusteluavustaja, joka ei voi lukea tiedostojasi, ei voi tehdä sitä.
Ennen kuin aloitat:
- Vie keskustelu Telegram Desktopissa: avaa keskustelu, valitse Export chat history, valitse Machine-readable JSON ja sisällytä valokuvat ja tiedostot, jos haluat ne. Vientikansio sisältää tiedoston
result.jsonja kansioita, kutenphotosjafiles. - Luo Voxt-ryhmäkeskustelu ja lisää siihen ihmiset, jotka kirjoittivat Telegram-keskustelussa. Jokaisella on oltava Voxt-tili ja heidän on oltava jäseniä. Telegram-nimiä, joita vastaavaa Voxt-jäsentä ei ole, ei voi tuoda.
- Päätä, miten avustaja kirjautuu: API-avaimella vai Voxt-tililläsi OAuthin kautta (alla).
- Lisää Voxt avustajaasi MCP-palvelimena (alla).
Voxtin lisääminen MCP-palvelimena
Palvelimen osoite on https://voxt.ai/mcp. Kirjautumiseen on kaksi tapaa. Kummassakin avustaja toimii sinuna.
API-avaimella. Luo avain Voxtissa (Asetukset → API ja sovellukset → Luo API-avain) ja välitä se Authorization: Bearer -otsakkeessa. Claude Codessa aja:
claude mcp add --transport http voxt https://voxt.ai/mcp --header "Authorization: Bearer $VOXT_API_KEY"Aseta VOXT_API_KEY ensin päätteessäsi, jotta avain ei näy kehotteessa tai tiedostossa.
OAuthilla. Jätä otsake ja avain pois:
claude mcp add --transport http voxt https://voxt.ai/mcpKäynnistä sitten Claude Code, aja /mcp, valitse voxt ja valitse todennus. Selainikkuna avautuu Voxtin suostumussivulle; hyväksy pääsy, niin avustaja on yhdistetty, eikä avainta tarvitse luoda tai tallentaa.
Muilla avustajilla on asetussivu etä-MCP-palvelimille tai liittimille, johon syötät saman osoitteen sekä joko otsakkeen tai kirjautumisen. MCP kuvaa molemmat tavat. Pyydä avustajaa listaamaan Voxt-keskustelusi tarkistaaksesi, että yhteys toimii.
Ohjeen antaminen
Anna avustajalle tällainen ohje. Vaihda kansio ja keskustelun nimi.
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.Huomautuksia esimerkistä:
- Telegram tallentaa viestin ajan ilman aikavyöhykettä. Tarkista ensimmäiset tuodut viestit alkuperäistä keskustelua vasten ennen kuin lähetät loput.
- Hylätyt viestit eivät pysäytä erää. Korjaa syy (puuttuva jäsen, lähettäjä, joka ei ole sallinut tuontia, tai järjestyksestä poikkeava aika) ja lähetä ne uudelleen uudessa erässä.
- Viestit, joita ei voi yhdistää, jätetään pois, joten säilytä Telegram-vienti, jos tarvitset täydellisen tallenteen.
- Jokainen tiedosto kulkee avustajan kautta 1 Mt:n paloina, joten keskustelu, jossa on paljon suuria tiedostoja, vaatii paljon kutsuja. Pelkkä teksti on nopea.
Aiheeseen liittyvät oppaat
- Keskustelut jäsenen näkymästä tuontitilaan.
- MCP ja sen työkaluviite.
- RPC API.