Импорт и экспорт
В Voxt нет кнопки «экспортировать чат» или «импортировать чат», которая создаёт или читает файл. Данные передаются через два программных интерфейса:
- Экспорт читает сообщения, вложения, участников и сводки чата через MCP или RPC API.
- Импорт добавляет в чат более раннюю историю из другого сервиса. Владелец запускает режим импорта, участники соглашаются, и сообщения отправляются через инструменты импорта MCP или сервис импорта RPC API. В обоих случаях владелец может провести весь процесс из ассистента.
Экспорт чата
Для экспорта нужен API-ключ или вход через OAuth. Ассистент или скрипт действует от вашего имени, поэтому может читать ровно те чаты, которые можете читать вы, и ничего больше.
- Создайте API-ключ или подключите ассистента через OAuth, как описано в разделе MCP.
- Попросите ассистента выполнить экспорт, например: «Прочитай все сообщения чата Trip photos и сохрани их в файл Markdown с датами и авторами». Инструменты ассистент выберет сам; знать их названия не нужно.
- Для скрипта вызывайте инструменты напрямую. Справочник инструментов перечисляет их с аргументами.
Что можно прочитать:
| Данные | Инструменты | Примечания |
|---|---|---|
| Сообщения | list_messages, get_id_range | Сначала старые, до 1024 сообщений за вызов. Продолжайте с 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 КБ), до 10 вложений и, при необходимости, сообщение, на которое оно отвечает. У пакета есть свой ID: повторная отправка того же пакета возвращает прежний результат, поэтому повтор после сетевой ошибки не дублирует сообщения.
- Ответ может указывать только на сообщение, которое уже есть в чате, поэтому сначала отправьте это сообщение в более раннем пакете и используйте возвращённый ID.
- При импорте на уровне места отправляйте каждое сообщение в тот чат места, которому оно принадлежит. Проверяйте результат каждого сообщения. Пакет может пройти частично: отклонённое сообщение возвращается с причиной (например, «This member has not consented to import.»), а остальные сохраняются.
Инструменты 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 МБ, поэтому чат с большим числом крупных файлов требует много вызовов. Один только текст импортируется быстро.
Связанные руководства
- Чаты: как режим импорта выглядит для участника.
- MCP и его справочник инструментов.
- RPC API.