Импортиране и експортиране
Voxt няма бутон „експортиране на чат“ или „импортиране на чат“, който създава или чете файл. Данните се движат през двата програмни интерфейса:
- Експортирането чете съобщенията, прикачените файлове, участниците и обобщенията на чат чрез MCP или RPC API.
- Импортирането добавя по-ранна история от друга услуга към чат. Собственикът започва режим на импорт, участниците се съгласяват, а съобщенията се изпращат чрез инструментите за импорт на MCP или услугата за импорт на RPC API. И в двата случая собственикът може да изпълни целия процес от асистент.
Експортиране на чат
Експортирането изисква API ключ или вход с OAuth. Асистентът или скриптът действа от ваше име, така че може да чете точно чатовете, които можете да четете вие, и нищо друго.
- Създайте API ключ или свържете асистент с OAuth потока, както е описано в MCP.
- Поискайте експорта от вашия асистент, например: „Прочети всички съобщения на чата Trip photos и ги запази като Markdown файл с дати и автори.“ Асистентът избира инструментите; не е нужно да знаете имената им.
- За скрипт извиквайте инструментите директно. Справочникът с инструменти ги изброява с аргументите им.
Какво може да се чете:
| Данни | Инструменти | Бележки |
|---|---|---|
| Съобщения | list_messages, get_id_range | Първо най-старите, до 1 024 съобщения на извикване. Продължавайте от ID на последното съобщение, докато не се върне нищо. Премахнатите съобщения се пропускат. |
| Закачени съобщения и реакции | list_pinned_messages, list_reactions | |
| Снимки, видеа, файлове и линкове | list_media, list_files, list_links | Групирани по месец, първо най-новият месец. Всеки прикачен файл носи URL адрес на съдържанието. |
| Участници | list_members, list_place_members | |
| Чатове и места | list_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_place | Използвайте ги, за да намерите какво да експортирате. Архивираните от вас чатове се връщат само от list_archived_chats. |
| Обобщения | list_conversations, get_conversation | Обобщени отсечки от чат, например гласова сесия. |
| Резултати от търсене | search_messages, search_contacts |
Неща, които трябва да знаете, преди да експортирате голям чат:
- Инструментите връщат страници, а не файл. Асистентът или скриптът сглобява резултата.
- Съобщение, което още се предава на потоци, още няма текст. Прочетете тази част отново по-късно.
- Редакциите и премахванията на съобщения, които вече сте прочели, не се докладват. Прочетете диапазона отново, ако чатът още е активен.
Импортиране на история в чат
Използвайте режима на импорт, за да пренесете разговор от друга услуга в групов чат или място във Voxt. Съобщенията се запазват под първоначалните си автори и първоначални дати, така че чатът изглежда, сякаш винаги е бил във Voxt.
Какво да знаете първо:
- Само собственикът на чата или мястото може да започне и да приключи импорт.
- Работи за групови чатове и за места. Импорт за цялото място обхваща всеки чат в мястото. В лични чатове не може да се импортира.
- Всеки автор трябва да е текущ участник в чата и трябва да е съгласен. Съобщенията на някой, който не е съгласен, е напуснал или не е участник, се отхвърлят.
- Импортираните съобщения трябва да са датирани в миналото, всяко по-късно от предишното и по-късно от най-новото съобщение, което чатът вече има. Системните съобщения се броят, например присъединяването на участници, така че в групов чат историята трябва да е датирана след присъединяването на участниците му. Броят се само съобщенията, които още са в чата, така че история не може да се вмъква преди съобщения, които са там, но може да се направи място: по време на импорта собственикът може да изтрие историята на чата или да премахне отделни съобщения и тогава може да се импортира история, толкова стара, колкото изтритите съобщения. Изтриване по време на импорт не може да бъде отменено и не публикува бележка „историята е изтрита“.
- Никой не може да публикува, докато режимът на импорт е включен, включително собственикът. Импорт за цялото място спира публикуването във всеки чат на мястото.
- Импортираните съобщения не изпращат известия.
Започване на режима на импорт
В приложението:
- Отворете настройките на чата (на тесен екран изберете бутона с три точки в заглавната част на чата, после Редактиране на чата; на широк екран отворете десния панел и изберете бутона за редактиране в заглавната му част) или на мястото при импорт за цялото място и изберете Започни импортиране. Елементът се показва само на собственици и не се показва в нишки.
- Потвърдете Да се включи ли режим на импорт?. Voxt прави няколко последни проверки за около десет секунди („Влизане в режим на импорт“). Ако някой е публикувал съобщение, докато е започвало, Voxt ви моли да премахнете това съобщение и да започнете отново.
- Полето за съобщения се заменя с Режим на поддръжка за всички.



Асистент с инструментите за импорт на MCP може да направи същото с start_import. Инструментът не прави нищо, освен ако извикването не казва, че сте потвърдили, защото спира публикуването за всеки участник.
Помолете участниците да разрешат импорта
Диалогът за потвърждение, съгласието на участниците и приключването на импорта са показани в Импортиране на историята на чат. Накратко:
- Всеки участник отваря чата, избира Разрешавам импортиране на моите съобщения и медийни файлове в тази сесия и потвърждава Да се разреши ли импортът?. Съгласието не може да бъде оттеглено за този импорт. Собственикът също се съгласява, за да импортира собствените си съобщения.
- Собственикът вижда дела на участниците, които са се съгласили („Съгласни: 100% (3 от 3)“), и кой още липсва.
- Съобщенията на участници, които не са се съгласили, се отхвърлят, затова изчакайте, докато се съгласят всички, чиято история искате.
Участниците не могат да пишат в чата по време на импорта, така че собственикът не може да им напомня там. Пишете им в личните си чатове; те остават отворени. Асистент може да го направи: get_import изброява участниците, които не са се съгласили, всеки с личния чат, който имате с него, а асистентът публикува напомняне там и проверява отново, докато не се съгласи желаният дял.
Направете място за по-стара история
Ако историята е по-стара от съобщения, които вече са в чата, например системните съобщения за присъединяване на участници, първо ги премахнете. С MCP инструментите wipe_history премахва съобщенията на чата от избрано съобщение нататък (по подразбиране всички), само докато импортът върви и само за собственици, и връща резултат, след като са изтрити; remove_message премахва отделно съобщение. И двата работят по време на импорт. Изтриването не може да бъде отменено, затова го потвърдете със собственика, преди да се изпълни. Не изтривайте отново, след като съобщенията са импортирани: така ще се премахнат и те.
Изпращане на съобщенията
Докато режимът на импорт е включен, асистентът или програмата на собственика изпраща историята:
- Прочетете текущия импорт (
get_import); той носи ID на импорта, от който се нуждае всяко извикване. - Първо качете прикачените файлове, за участника, който ги е изпратил; този участник трябва да е съгласен. Всяко качване се прикачва към едно съобщение.
- Изпращайте съобщенията на партиди от 1 до 100, първо най-старите. Всяко съобщение има автор, първоначално време, текст (до 64 KB), до 10 прикачени файла и по желание съобщението, на което отговаря. Партидата има собствен ID: повторното изпращане на същата партида връща по-ранния резултат, така че повторен опит след мрежова грешка не дублира съобщения.
- Отговорът може да сочи само към съобщение, което вече е в чата, затова изпратете първо съобщението, в по-ранна партида, и използвайте върнатия му ID.
- При импорт за цялото място изпращайте всяко съобщение до конкретния чат на мястото, към който принадлежи. Проверявайте резултата на всяко съобщение. Партидата може да успее частично: отхвърленото съобщение се връща с причината (например „Този участник не е дал съгласие за импорт.“), а останалите се запазват.
MCP инструментите за тези стъпки са описани в Импортиране на история. Същата услуга е достъпна за програми чрез RPC API, а типовете данни са в Типове данни за импорт. post_message на MCP не е импорт: той публикува от ваше име, с текуща дата.
Приключване на режима на импорт
Когато всички съобщения са изпратени, собственикът избира Завърши импортирането в приложението или асистентът извиква end_import. Участниците отново могат да публикуват, а импортираната история стои над първото ново съобщение. Участниците, които никога не са се съгласили, просто нямат импортирани съобщения.
След импорта прегледайте чата, за да го проверите: съобщенията показват първоначалните си автори и дати, а първото ново съобщение върви след тях. Сравнете няколко съобщения с източника и прочетете списъка с отхвърлените съобщения, ако асистентът ви е водил такъв. Още по-добре е да прочетете импортираните съобщения обратно, преди да приключите режима на импорт, докато още можете да изпратите липсващите.

Пример: импортиране на експорт от Telegram
Целият импорт може да бъде направен от асистент, свързан с Voxt чрез MCP и способен да чете папката с експорта на вашия компютър, като Claude Code или друг асистент с достъп до файлове. Не са нужни собствени програми. Асистент само за чат, който не може да чете файловете ви, не може да го направи.
Преди да започнете:
- В Telegram Desktop експортирайте чата: отворете чата, изберете Export chat history, изберете Machine-readable JSON и включете снимки и файлове, ако ги искате. Папката с експорта съдържа
result.jsonи папки катоphotosиfiles. - Създайте групов чат във Voxt и добавете хората, които са писали в чата в Telegram. Всеки има нужда от профил във Voxt и трябва да е участник. Имена от Telegram, които нямат участник във Voxt, не могат да бъдат импортирани.
- Решете как асистентът влиза: с API ключ или с вашия профил във Voxt чрез OAuth (по-долу).
- Добавете Voxt към вашия асистент като MCP сървър (по-долу).
Добавяне на Voxt като MCP сървър
Адресът на сървъра е https://voxt.ai/mcp. Има два начина за вход. И в двата асистентът действа от ваше име.
С API ключ. Създайте ключ във Voxt (Настройки → API и приложения → Създайте API ключ) и го подайте в заглавие Authorization: Bearer. В Claude Code изпълнете:
claude mcp add --transport http voxt https://voxt.ai/mcp --header "Authorization: Bearer $VOXT_API_KEY"Първо задайте VOXT_API_KEY в терминала си, така че ключът да не се появява в заявка или във файл.
С OAuth. Пропуснете заглавието и ключа:
claude mcp add --transport http voxt https://voxt.ai/mcpПосле стартирайте Claude Code, изпълнете /mcp, изберете voxt и изберете удостоверяване. Отваря се прозорец на браузъра със страницата за съгласие на Voxt; одобрете достъпа и асистентът е свързан, без ключ за създаване или съхраняване.
Другите асистенти имат страница с настройки за отдалечени MCP сървъри или конектори, където въвеждате същия адрес и или заглавието, или входа. MCP описва и двата начина. Помолете асистента да изброи вашите чатове във Voxt, за да проверите дали връзката работи.
Дайте инструкцията
Дайте на асистента инструкция като тази. Заменете папката и името на чата.
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.Бележки към примера:
- Telegram съхранява времето на съобщението без часова зона. Сверете първите импортирани съобщения с оригиналния чат, преди да изпратите останалите.
- Отхвърлените съобщения не спират партидата. Отстранете причината (липсващ участник, подател, който не е разрешил импорта, час извън реда) и ги изпратете отново в нова партида.
- Съобщенията, които не могат да бъдат съпоставени, се пропускат, затова запазете експорта от Telegram, ако ви трябва пълният запис.
- Всеки файл пътува на парчета от 1 MB през асистента, така че чат с много големи файлове изисква много извиквания. Само текстът е бърз.
Свързани ръководства
- Чатове за изгледа на участника към режима на импорт.
- MCP и неговия справочник с инструменти.
- RPC API.