Import a export
Voxt nemá tlačítko „exportovat chat“ ani „importovat chat“, které by vytvářelo nebo četlo soubor. Data se přenášejí dvěma programovými rozhraními:
- Export čte zprávy chatu, přílohy, členy a shrnutí přes MCP nebo RPC API.
- Import přidá do chatu dřívější historii z jiné služby. Vlastník zahájí režim importu, členové souhlasí a zprávy se odešlou pomocí nástrojů importu MCP nebo služby importu v RPC API. V obou případech může vlastník celý proces řídit z asistenta.
Export chatu
Export vyžaduje klíč API nebo přihlášení přes OAuth. Asistent nebo skript jedná jako vy, takže může číst přesně ty chaty, které čtete vy, a nic víc.
- Vytvořte klíč API nebo připojte asistenta přes OAuth, jak je popsáno v MCP.
- Požádejte asistenta o export, například: „Přečti všechny zprávy chatu Fotky z výletu a ulož je jako soubor Markdown s daty a autory.“ Nástroje si asistent vybere sám; jejich názvy znát nemusíte.
- U skriptu volejte nástroje přímo. Přehled nástrojů je uvádí i s argumenty.
Co lze číst:
| Data | Nástroje | Poznámky |
|---|---|---|
| Zprávy | list_messages, get_id_range | Od nejstarších, nejvýše 1 024 zpráv na volání. Pokračujte od ID poslední zprávy, dokud se nic nevrátí. Odstraněné zprávy se vynechají. |
| Připnuté zprávy a reakce | list_pinned_messages, list_reactions | |
| Fotky, videa, soubory a odkazy | list_media, list_files, list_links | Seskupeno po měsících, nejnovější měsíc první. Každá příloha má adresu URL obsahu. |
| Členové | list_members, list_place_members | |
| Chaty a Místa | list_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_place | Pomocí nich zjistíte, co exportovat. Chaty, které jste archivovali, vypisuje jen list_archived_chats. |
| Shrnutí | list_conversations, get_conversation | Shrnuté úseky chatu, například hlasová relace. |
| Výsledky hledání | search_messages, search_contacts |
Co je dobré vědět před exportem velkého chatu:
- Nástroje vracejí stránky, ne soubor. Výsledek složí asistent nebo skript.
- Zpráva, která se stále streamuje, ještě nemá text. Tu část přečtěte znovu později.
- Úpravy a odstranění zpráv, které jste už přečetli, se nehlásí. Pokud je chat stále aktivní, přečtěte rozsah znovu.
Import historie do chatu
Režim importu použijte, když chcete do skupinového chatu nebo Místa ve Voxt přenést konverzaci z jiné služby. Zprávy se uloží pod původními autory a s původními daty, takže chat vypadá, jako by byl ve Voxt odjakživa.
Co je třeba vědět předem:
- Import může zahájit a ukončit jen vlastník chatu nebo Místa.
- Funguje pro skupinové chaty a pro Místa. Import pro celé Místo zahrnuje všechny chaty v Místě. Do přímých chatů importovat nelze.
- Každý autor musí být současným členem chatu a musí souhlasit. Zprávy toho, kdo nesouhlasil, odešel nebo není členem, se odmítnou.
- Importované zprávy musí být datovány v minulosti, každá později než předchozí a později než nejnovější zpráva, kterou chat už má. Počítají se i systémové zprávy, například připojení členů, takže ve skupinovém chatu musí být historie datována po připojení jeho členů. Počítají se jen zprávy, které v chatu stále jsou, takže historii nelze vložit před zprávy, které tam jsou, ale lze ji přizpůsobit: během importu může vlastník vymazat historii chatu nebo odstranit jednotlivé zprávy a pak lze importovat historii tak starou, jako byly vymazané zprávy. Vymazání během importu nelze vrátit a nepřidá poznámku „historie byla vymazána“.
- Když je režim importu zapnutý, nikdo nemůže psát, ani vlastník. Import pro celé Místo zastaví psaní ve všech chatech Místa.
- Importované zprávy neposílají oznámení.
Zahájení režimu importu
V aplikaci:
- Otevřete nastavení chatu (na úzké obrazovce vyberte tlačítko se třemi tečkami v záhlaví chatu a pak Upravit chat; na široké obrazovce otevřete pravý panel a vyberte tlačítko úprav v jeho záhlaví), nebo Místa pro import celého Místa, a vyberte Zahájit import. Položku vidí jen vlastníci a ve vláknech se nezobrazuje.
- Potvrďte Zahájit režim importu?. Voxt asi deset sekund provádí několik závěrečných kontrol („Přechod do režimu importu“). Pokud během spouštění někdo odeslal zprávu, Voxt vás vyzve, abyste tu zprávu odstranili a začali znovu.
- Pole pro psaní zpráv se pro všechny nahradí hlášením Režim údržby.



Asistent s nástroji importu MCP může totéž provést pomocí start_import. Nástroj nic neudělá, pokud volání neuvádí, že jste to potvrdili, protože zastaví psaní pro všechny členy.
Požádejte členy o povolení importu
Potvrzovací dialog, souhlas členů a ukončení importu jsou popsány v Import historie chatu. Ve zkratce:
- Každý člen otevře chat, vybere Povolit import mých zpráv a médií během této relace a potvrdí Povolit import?. Souhlas nelze pro daný import odvolat. Souhlasí i vlastník, aby se naimportovaly jeho vlastní zprávy.
- Vlastník vidí podíl členů, kteří souhlasili („Souhlasili: 100 % (3 ze 3)“), a kdo ještě chybí.
- Zprávy členů, kteří nesouhlasili, se odmítnou, takže počkejte, dokud nesouhlasí všichni, jejichž historii chcete.
Členové během importu nemohou v chatu psát, takže jim vlastník nemůže připomenout souhlas tam. Napište jim raději do přímých chatů; ty zůstávají otevřené. Může to udělat asistent: get_import vypíše členy, kteří nesouhlasili, každého s přímým chatem, který s ním máte, a asistent tam pošle připomenutí a znovu kontroluje, dokud nesouhlasí požadovaný podíl.
Uvolnění místa pro starší historii
Pokud je historie starší než zprávy, které už v chatu jsou, například systémové zprávy zaznamenávající připojení členů, nejdřív je odstraňte. Pomocí nástrojů MCP wipe_history odstraní zprávy chatu od zvolené zprávy dál (ve výchozím nastavení všechny), a to jen během běžícího importu a jen pro vlastníky, a vrátí se, jakmile jsou smazány; remove_message odstraní jednu zprávu. Obojí funguje během importu. Vymazání nelze vrátit, proto ho před spuštěním potvrďte s vlastníkem. Po naimportování zpráv už nemažte znovu: odstranilo by i je.
Odeslání zpráv
Když je režim importu zapnutý, historii odešle asistent nebo program vlastníka:
- Přečtěte aktuální import (
get_import); obsahuje ID importu, které vyžaduje každé volání. - Nejdřív nahrajte přílohy, za člena, který je poslal; ten člen musel souhlasit. Každé nahrání se připojí k jedné zprávě.
- Odesílejte zprávy v dávkách po 1 až 100, od nejstarších. Každá zpráva má autora, původní čas, text (až 64 KB), až 10 příloh a případně zprávu, na kterou odpovídá. Dávka má vlastní ID: opětovné odeslání téže dávky vrátí dřívější výsledek, takže opakování po chybě sítě zprávy nezdvojí.
- Odpověď může odkazovat jen na zprávu, která už v chatu je, takže tu zprávu odešlete nejdřív, v dřívější dávce, a použijte vrácené ID.
- Při importu celého Místa odesílejte každou zprávu do konkrétního chatu Místa, kam patří. Zkontrolujte výsledek každé zprávy. Dávka může uspět jen částečně: odmítnutá zpráva se vrátí s důvodem (například „Tento člen nesouhlasil s importem.“) a ostatní se uloží.
Nástroje MCP pro tyto kroky jsou popsány v Import historie. Stejná služba je pro programy dostupná přes RPC API, s datovými typy v Datové typy importu. post_message z MCP není import: odešle zprávu jako vy, s aktuálním datem.
Ukončení režimu importu
Když jsou všechny zprávy odeslány, vlastník v aplikaci vybere Ukončit import nebo asistent zavolá end_import. Členové mohou zase psát a importovaná historie leží nad první novou zprávou. Členům, kteří nikdy nesouhlasili, se prostě nic neimportuje.
Po importu chat projděte a zkontrolujte: zprávy ukazují původní autory a data a první nová zpráva následuje za nimi. Porovnejte několik zpráv se zdrojem a přečtěte si seznam odmítnutých zpráv, pokud ho váš asistent vedl. Ještě lépe si importované zprávy přečtěte zpět před ukončením režimu importu, dokud ještě můžete poslat chybějící.

Příklad: import exportu z Telegramu
Celý import může provést asistent, který je k Voxt připojen přes MCP a umí číst složku s exportem na vašem počítači, například Claude Code nebo jiný asistent s přístupem k souborům. Nepotřebuje žádný váš vlastní program. Asistent jen pro chat, který nečte vaše soubory, to nezvládne.
Než začnete:
- V Telegram Desktop exportujte chat: otevřete chat, zvolte Export chat history, vyberte Machine-readable JSON a případně zahrňte fotky a soubory. Složka s exportem obsahuje
result.jsona složky jakophotosafiles. - Vytvořte skupinový chat ve Voxt a přidejte lidi, kteří psali v chatu v Telegramu. Každý potřebuje účet ve Voxt a musí být členem. Jména z Telegramu bez člena ve Voxt nelze importovat.
- Rozhodněte, jak se asistent přihlásí: klíčem API, nebo vaším účtem ve Voxt přes OAuth (viz níže).
- Přidejte Voxt do svého asistenta jako server MCP (viz níže).
Přidání Voxt jako serveru MCP
Adresa serveru je https://voxt.ai/mcp. Přihlásit se lze dvěma způsoby. V obou případech asistent jedná jako vy.
Klíčem API. Vytvořte klíč ve Voxt (Nastavení → API a aplikace → Vytvořit klíč API) a předejte ho v hlavičce Authorization: Bearer. V Claude Code spusťte:
claude mcp add --transport http voxt https://voxt.ai/mcp --header "Authorization: Bearer $VOXT_API_KEY"Nejdřív nastavte VOXT_API_KEY ve svém terminálu, aby se klíč neobjevil v promptu ani v souboru.
Přes OAuth. Vynechte hlavičku i klíč:
claude mcp add --transport http voxt https://voxt.ai/mcpPotom spusťte Claude Code, zadejte /mcp, vyberte voxt a zvolte ověření. Otevře se okno prohlížeče se stránkou souhlasu Voxt; schvalte přístup a asistent je připojen, bez klíče, který by bylo třeba vytvářet a ukládat.
Jiní asistenti mají stránku nastavení pro vzdálené servery MCP nebo konektory, kam zadáte stejnou adresu a buď hlavičku, nebo přihlášení. MCP popisuje oba způsoby. Požádejte asistenta, aby vypsal vaše chaty ve Voxt, a ověřte tak, že připojení funguje.
Zadání pokynu
Dejte asistentovi pokyn podobný tomuto. Nahraďte složku a název chatu.
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.Poznámky k příkladu:
- Telegram ukládá čas zprávy bez časového pásma. Než odešlete zbytek, porovnejte prvních pár importovaných zpráv s původním chatem.
- Odmítnuté zprávy dávku nezastaví. Odstraňte příčinu (chybějící člen, odesílatel, který import nepovolil, čas mimo pořadí) a odešlete je znovu v nové dávce.
- Zprávy, které nelze přiřadit, se vynechají, takže si exportovaná data z Telegramu ponechte, pokud potřebujete úplný záznam.
- Každý soubor putuje přes asistenta po 1 MB částech, takže chat s mnoha velkými soubory vyžaduje mnoho volání. Samotný text je rychlý.
Související příručky
- Chaty – pohled člena na režim importu.
- MCP a jeho přehled nástrojů.
- RPC API.