Import i eksport
Voxt nie ma przycisku „eksportuj czat” ani „importuj czat”, który tworzyłby lub wczytywał plik. Dane przepływają przez dwa interfejsy programistyczne:
- Eksport odczytuje wiadomości czatu, załączniki, uczestników i podsumowania przez MCP lub RPC API.
- Import dodaje do czatu wcześniejszą historię z innej usługi. Właściciel rozpoczyna tryb importu, uczestnicy wyrażają zgodę, a wiadomości są wysyłane przez narzędzia importu MCP lub usługę importu RPC API. W obu przypadkach właściciel może poprowadzić cały proces z poziomu asystenta.
Eksport czatu
Eksport wymaga klucza API lub logowania OAuth. Asystent albo skrypt działa jako Ty, więc może odczytać dokładnie te czaty, które możesz czytać Ty, i żadnych innych.
- Utwórz klucz API albo połącz asystenta przez OAuth, jak opisano w MCP.
- Poproś asystenta o eksport, na przykład: „Przeczytaj wszystkie wiadomości czatu Trip photos i zapisz je jako plik Markdown z datami i autorami.” Asystent wybierze narzędzia; nie musisz znać ich nazw.
- W przypadku skryptu wywołuj narzędzia bezpośrednio. Opis narzędzi zawiera ich listę wraz z argumentami.
Co można odczytać:
| Dane | Narzędzia | Uwagi |
|---|---|---|
| Wiadomości | list_messages, get_id_range | Od najstarszych, do 1024 wiadomości na wywołanie. Kontynuuj od ID ostatniej wiadomości, aż nic nie zostanie zwrócone. Usunięte wiadomości są pomijane. |
| Przypięte wiadomości i reakcje | list_pinned_messages, list_reactions | |
| Zdjęcia, filmy, pliki i linki | list_media, list_files, list_links | Grupowane według miesięcy, od najnowszego miesiąca. Każdy załącznik ma adres URL zawartości. |
| Uczestnicy | list_members, list_place_members | |
| Czaty i Miejsca | list_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_place | Użyj ich, aby znaleźć to, co chcesz wyeksportować. Zarchiwizowane przez Ciebie czaty zwraca tylko list_archived_chats. |
| Podsumowania | list_conversations, get_conversation | Podsumowane fragmenty czatu, na przykład sesja głosowa. |
| Wyniki wyszukiwania | search_messages, search_contacts |
Co warto wiedzieć przed eksportem dużego czatu:
- Narzędzia zwracają strony, a nie plik. Wynik składa asystent lub skrypt.
- Wiadomość, która jest jeszcze przesyłana strumieniowo, nie ma jeszcze tekstu. Przeczytaj tę część ponownie później.
- Edycje i usunięcia wiadomości, które już przeczytałeś(-aś), nie są zgłaszane. Jeśli czat jest nadal aktywny, przeczytaj zakres ponownie.
Import historii do czatu
Użyj trybu importu, aby przenieść rozmowę z innej usługi do czatu grupowego lub Miejsca w Voxt. Wiadomości są zapisywane pod ich pierwotnymi autorami i z pierwotnymi datami, więc czat wygląda tak, jakby od zawsze był w Voxt.
Co warto wiedzieć najpierw:
- Tylko właściciel czatu lub Miejsca może rozpocząć i zakończyć import.
- Działa dla czatów grupowych i dla Miejsc. Import obejmujący całe Miejsce dotyczy każdego czatu w tym Miejscu. Do czatów bezpośrednich nie można importować.
- Każdy autor musi być obecnym uczestnikiem czatu i musi wyrazić zgodę. Wiadomości osoby, która nie wyraziła zgody, opuściła czat lub nie jest uczestnikiem, są odrzucane.
- Importowane wiadomości muszą mieć daty z przeszłości, każda późniejszą niż poprzednia i późniejszą niż najnowsza wiadomość, którą czat już ma. Wiadomości systemowe się liczą, na przykład dołączenie uczestników, więc w czacie grupowym historia musi mieć daty późniejsze niż dołączenie uczestników. Liczą się tylko wiadomości, które nadal są w czacie, więc historii nie można wstawić przed wiadomości, które tam są, ale można zrobić dla niej miejsce: podczas importu właściciel może wyczyścić historię czatu albo usunąć pojedyncze wiadomości, a wtedy można zaimportować historię tak starą jak wyczyszczone wiadomości. Wyczyszczenia podczas importu nie można cofnąć i nie dodaje ono notatki „historia wyczyszczona”.
- Gdy tryb importu jest włączony, nikt nie może pisać, łącznie z właścicielem. Import obejmujący całe Miejsce wstrzymuje pisanie we wszystkich czatach tego Miejsca.
- Importowane wiadomości nie wysyłają powiadomień.
Rozpoczęcie trybu importu
W aplikacji:
- Otwórz ustawienia czatu (na wąskim ekranie wybierz przycisk z trzema kropkami w nagłówku czatu, a potem Edytuj czat; na szerokim ekranie otwórz prawy panel i wybierz przycisk edycji w jego nagłówku), a przy imporcie obejmującym całe Miejsce ustawienia Miejsca, i wybierz Rozpocznij import. Ten wpis widzą tylko właściciele i nie ma go w wątkach.
- Potwierdź Start import mode?. Voxt wykonuje kilka końcowych sprawdzeń przez około dziesięć sekund („Przechodzenie w tryb importu”). Jeśli ktoś wysłał wiadomość podczas uruchamiania, Voxt poprosi Cię o usunięcie tej wiadomości i ponowne rozpoczęcie.
- Pole wiadomości jest u wszystkich zastąpione napisem Tryb konserwacji.



Asystent z narzędziami importu MCP może zrobić to samo przez start_import. Narzędzie nic nie robi, jeśli w wywołaniu nie ma informacji, że potwierdziłeś(-aś), ponieważ wstrzymuje pisanie dla wszystkich uczestników.
Prośba do uczestników o zgodę na import
Okno potwierdzenia, zgody uczestników i zakończenie importu opisano w Import historii czatu. W skrócie:
- Każdy uczestnik otwiera czat, wybiera Zezwól na import moich wiadomości i multimediów podczas tej sesji i potwierdza Allow import?. Zgody nie można cofnąć w ramach tego importu. Właściciel też wyraża zgodę, aby zaimportować własne wiadomości.
- Właściciel widzi odsetek uczestników, którzy się zgodzili („Consented: 100% (3 out of 3)”), i kogo jeszcze brakuje.
- Wiadomości uczestników, którzy nie wyrazili zgody, są odrzucane, więc poczekaj, aż zgodzą się wszyscy, których historię chcesz zaimportować.
Uczestnicy nie mogą pisać w czacie podczas importu, więc właściciel nie może tam o tym przypomnieć. Napisz do nich w czatach bezpośrednich; te pozostają otwarte. Może to zrobić asystent: get_import wyświetla uczestników, którzy nie wyrazili zgody, każdego z czatem bezpośrednim, który z nim masz, a asystent wysyła tam przypomnienie i sprawdza ponownie, aż zgodzi się odsetek, który chcesz.
Zrobienie miejsca na starszą historię
Jeśli historia jest starsza niż wiadomości, które już są w czacie, na przykład wiadomości systemowe zapisujące dołączenie uczestników, najpierw je usuń. W narzędziach MCP wipe_history usuwa wiadomości czatu od wybranej wiadomości wzwyż (domyślnie wszystkie), tylko podczas trwania importu i tylko dla właścicieli, i kończy działanie, gdy zostaną usunięte; remove_message usuwa pojedynczą wiadomość. Oba działają podczas importu. Wyczyszczenia nie można cofnąć, więc potwierdź je z właścicielem, zanim zostanie wykonane. Nie czyść ponownie po zaimportowaniu wiadomości: usunęłoby to także je.
Wysyłanie wiadomości
Gdy tryb importu jest włączony, asystent lub program właściciela wysyła historię:
- Odczytaj bieżący import (
get_import); zawiera on ID importu, którego wymaga każde wywołanie. - Najpierw wgraj załączniki, w imieniu uczestnika, który je wysłał; ten uczestnik musi wyrazić zgodę. Każde wgranie jest dołączane do jednej wiadomości.
- Wysyłaj wiadomości w partiach po 1 do 100, od najstarszych. Każda wiadomość ma autora, pierwotny czas, tekst (do 64 KB), do 10 załączników i opcjonalnie wiadomość, na którą odpowiada. Partia ma własne ID: ponowne wysłanie tej samej partii zwraca wcześniejszy wynik, więc ponowienie po błędzie sieci nie duplikuje wiadomości.
- Odpowiedź może wskazywać tylko wiadomość, która jest już w czacie, więc najpierw wyślij tę wiadomość, we wcześniejszej partii, i użyj zwróconego ID.
- W imporcie obejmującym całe Miejsce wysyłaj każdą wiadomość do konkretnego czatu Miejsca, do którego należy. Sprawdzaj wynik każdej wiadomości. Partia może się powieść częściowo: odrzucona wiadomość wraca z powodem (na przykład „This member has not consented to import.”), a pozostałe są zapisane.
Narzędzia MCP do tych kroków opisano w Import history. Ta sama usługa jest dostępna dla programów przez RPC API, a typy danych w Imports data types. post_message w MCP to nie import: publikuje jako Ty, z bieżącą datą.
Zakończenie trybu importu
Gdy wszystkie wiadomości zostaną wysłane, właściciel wybiera w aplikacji Zakończ import albo asystent wywołuje end_import. Uczestnicy znów mogą pisać, a zaimportowana historia znajduje się nad pierwszą nową wiadomością. Uczestnicy, którzy nigdy nie wyrazili zgody, po prostu nie mają zaimportowanych wiadomości.
Po imporcie przewiń czat, aby go sprawdzić: wiadomości pokazują swoich pierwotnych autorów i daty, a pierwsza nowa wiadomość następuje po nich. Porównaj kilka wiadomości ze źródłem i przeczytaj listę odrzuconych wiadomości, jeśli asystent ją prowadził. Jeszcze lepiej przeczytaj zaimportowane wiadomości z powrotem, zanim zakończysz tryb importu, gdy nadal możesz wysłać brakujące.

Przykład: import eksportu z Telegrama
Cały import może wykonać asystent połączony z Voxt przez MCP, który potrafi czytać folder eksportu na Twoim komputerze, na przykład Claude Code lub inny asystent z dostępem do plików. Nie potrzebuje żadnego własnego programu. Asystent tylko do czatu, który nie może czytać Twoich plików, tego nie zrobi.
Zanim zaczniesz:
- W Telegram Desktop wyeksportuj czat: otwórz czat, wybierz Export chat history, wybierz Machine-readable JSON i dołącz zdjęcia oraz pliki, jeśli chcesz. Folder eksportu zawiera
result.jsonoraz foldery takie jakphotosifiles. - Utwórz czat grupowy w Voxt i dodaj osoby, które pisały w czacie na Telegramie. Każda z nich potrzebuje konta Voxt i musi być uczestnikiem. Nazw z Telegrama, które nie mają uczestnika w Voxt, nie można zaimportować.
- Zdecyduj, jak asystent się loguje: kluczem API albo Twoim kontem Voxt przez OAuth (poniżej).
- Dodaj Voxt do swojego asystenta jako serwer MCP (poniżej).
Dodanie Voxt jako serwera MCP
Adres serwera to https://voxt.ai/mcp. Są dwa sposoby logowania. W obu asystent działa jako Ty.
Z kluczem API. Utwórz klucz w Voxt (Ustawienia → API i aplikacje → Utwórz klucz API) i przekaż go w nagłówku Authorization: Bearer. W Claude Code uruchom:
claude mcp add --transport http voxt https://voxt.ai/mcp --header "Authorization: Bearer $VOXT_API_KEY"Najpierw ustaw VOXT_API_KEY w terminalu, aby klucz nie pojawił się w poleceniu ani w pliku.
Z OAuth. Pomiń nagłówek i klucz:
claude mcp add --transport http voxt https://voxt.ai/mcpNastępnie uruchom Claude Code, wpisz /mcp, wybierz voxt i wybierz uwierzytelnienie. Otworzy się okno przeglądarki ze stroną zgody Voxt; zatwierdź dostęp, a asystent będzie połączony, bez klucza do utworzenia i przechowywania.
Inni asystenci mają stronę ustawień zdalnych serwerów MCP lub konektorów, gdzie wpisujesz ten sam adres oraz nagłówek albo logowanie. MCP opisuje oba sposoby. Poproś asystenta o wyświetlenie Twoich czatów Voxt, aby sprawdzić, czy połączenie działa.
Przekazanie polecenia
Daj asystentowi polecenie takie jak poniżej. Zamień folder i nazwę czatu.
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.Uwagi do przykładu:
- Telegram zapisuje czas wiadomości bez strefy czasowej. Sprawdź pierwsze zaimportowane wiadomości z oryginalnym czatem, zanim wyślesz resztę.
- Odrzucone wiadomości nie zatrzymują partii. Usuń przyczynę (brakujący uczestnik, nadawca, który nie zezwolił na import, czas poza kolejnością) i wyślij je ponownie w nowej partii.
- Wiadomości, których nie można przypisać, są pomijane, więc zachowaj eksport z Telegrama, jeśli potrzebujesz pełnego zapisu.
- Każdy plik jest przesyłany przez asystenta w kawałkach po 1 MB, więc czat z wieloma dużymi plikami wymaga wielu wywołań. Sam tekst idzie szybko.
Powiązane przewodniki
- Czaty o widoku trybu importu z perspektywy uczestnika.
- MCP i jego opis narzędzi.
- RPC API.