Імпорт та експорт
У 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.
- В імпорті на рівні Місця надсилайте кожне повідомлення в конкретний чат Місця, до якого воно належить. Перевіряйте результат кожного повідомлення. Пакет може бути виконаний частково: відхилене повідомлення повертається з причиною (наприклад «Цей учасник не дав згоди на імпорт.»), а інші зберігаються.
Інструменти 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.