Мазмұнға өту

Импорт және экспорт ​

Voxt-та файл жасайтын немесе оқитын "чатты экспорттау" немесе "чатты импорттау" түймесі жоқ. Деректер екі бағдарламалық интерфейс арқылы жылжиды:

  • Экспорт чаттың хабарламаларын, тіркемелерін, мүшелерін және қысқаша мазмұндарын MCP немесе RPC API арқылы оқиды.
  • Импорт басқа қызметтен бұрынғы тарихты чатқа қосады. Иесі импорт режимін бастайды, мүшелер келіседі, ал хабарламалар MCP импорт құралдары немесе RPC API-дің импорт қызметі арқылы жіберіледі. Екі жағдайда да иесі бүкіл процесті көмекшіден жүргізе алады.

Чатты экспорттау ​

Экспорттау үшін API кілті немесе OAuth арқылы кіру қажет. Көмекші немесе скрипт сіздің атыңыздан әрекет етеді, сондықтан ол сіз оқи алатын чаттарды ғана оқи алады, басқасын емес.

  1. API кілтін жасаңыз немесе көмекшіні MCP бөлімінде сипатталғандай OAuth арқылы қосыңыз.
  2. Көмекшіден экспортты сұраңыз, мысалы: "Read all messages of the chat Trip photos and save them as a Markdown file with dates and authors." Құралдарды көмекші таңдайды; олардың атын білудің қажеті жоқ.
  3. Скрипт үшін құралдарды тікелей шақырыңыз. Құралдар анықтамасы оларды аргументтерімен бірге тізімдейді.

Не оқуға болады:

ДеректерҚұралдарЕскертпелер
Хабарламалар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-та болғандай оқылады.

Алдымен не білу керек:

  • Импортты тек чаттың немесе орынның иесі бастай және аяқтай алады.
  • Ол топтық чаттар мен орындар үшін жұмыс істейді. Орын бойынша импорт орындағы әр чатты қамтиды. Жеке чаттарға импорттау мүмкін емес.
  • Әр автор чаттың ағымдағы мүшесі болуы және келісуі керек. Келіспеген, шығып кеткен немесе мүше емес адамның хабарламалары қабылданбайды.
  • Импортталатын хабарламалар өткен күнмен белгіленуі, әрқайсысы алдыңғысынан кейін және чатта бұрыннан бар ең жаңа хабарламадан кейін болуы керек. Жүйелік хабарламалар да есептеледі, мысалы, мүшелердің қосылуы, сондықтан топтық чатта тарих мүшелер қосылғаннан кейінгі күнмен белгіленуі керек. Тек чатта әлі бар хабарламалар есептеледі, сондықтан тарихты бар хабарламалардың алдына қою мүмкін емес, бірақ оны сыйғызуға болады: импорт кезінде иесі чат тарихын тазалай немесе жеке хабарламаларды жоя алады, сонда тазаланған хабарламалар сияқты ескі тарихты импорттауға болады. Импорт кезіндегі тазалауды болдырмау мүмкін емес және ол "чат тарихын тазалады" жазбасын қоспайды.
  • Импорт режимі қосулы кезде ешкім, иесін қоса алғанда, жібере алмайды. Орын бойынша импорт орындағы әр чатта жіберуді тоқтатады.
  • Импортталған хабарламалар хабарландыру жібермейді.

Импорт режимін бастау ​

Қолданбада:

  1. Чаттың параметрлерін (тар экранда чат тақырыбындағы үш нүкте түймесін, содан кейін Чатты өңдеуді таңдаңыз; кең экранда оң жақ панельді ашып, оның тақырыбындағы өңдеу түймесін таңдаңыз) немесе орын бойынша импорт үшін орынның параметрлерін ашып, Импортты бастауды таңдаңыз. Тармақ тек иелерге көрсетіледі және тармақтарда жоқ.
  2. Импорт режимі басталсын ба? растаңыз. Voxt шамамен он секунд бойы бірнеше соңғы тексеру жүргізеді ("Импорт режиміне өту"). Ол басталып жатқанда біреу хабарлама жіберсе, Voxt сол хабарламаны жойып, қайта бастауды сұрайды.
  3. Хабарлама өрісі барлығы үшін Техникалық қызмет көрсету режимімен ауыстырылады.
The header of the group chat Trip photos with the three-dot menu button.
The chat header menu of Trip photos with the Edit chat entry.
The chat settings of an owner with the Start import entry marked.

MCP импорт құралдары бар көмекші мұны start_import арқылы жасай алады. Құрал шақыруда сіздің растағаныңыз айтылмаса, ештеңе жасамайды, себебі ол әр мүше үшін жіберуді тоқтатады.

Мүшелерден импортқа рұқсат сұрау ​

Растау диалогы, мүшелердің келісімі және импортты аяқтау Чат тарихын импорттау бөлімінде көрсетілген. Қысқаша:

  1. Әр мүше чатты ашып, Осы сеанс барысында хабарламаларым мен медиамды импорттауға рұқсат беремін таңдап, Импортқа рұқсат беру керек пе? растайды. Келісімді сол импорт үшін қайтарып алу мүмкін емес. Иесі де өз хабарламаларын импорттау үшін келіседі.
  2. Иесі келіскен мүшелердің үлесін ("Келісім бергендер: 100% (3 ішінен 3)") және кімнің жетіспейтінін көреді.
  3. Келіспеген мүшелердің хабарламалары қабылданбайды, сондықтан тарихы керек барлық адам келіскенше күтіңіз.

Мүшелер импорт кезінде чатқа жаза алмайды, сондықтан иесі оларға сонда еске сала алмайды. Оның орнына жеке чаттарыңызда жазыңыз; олар ашық қалады. Мұны көмекші жасай алады: get_import келіспеген мүшелерді, әрқайсысы өзіңізбен бар жеке чатымен тізімдейді, ал көмекші сонда еске салу жібереді және қалаған үлес келіскенше қайта тексереді.

Ескі тарих үшін орын босату ​

Тарих чатта бұрыннан бар хабарламалардан ескірек болса, мысалы, мүшелердің қосылуын жазатын жүйелік хабарламалардан, алдымен оларды жойыңыз. MCP құралдарымен wipe_history чат хабарламаларын таңдалған хабарламадан бастап (әдепкі бойынша барлығын) жояды, тек импорт жүріп жатқанда және тек иелер үшін, ал олар жойылғаннан кейін қайтарады; remove_message жеке хабарламаны жояды. Екеуі де импорт кезінде жұмыс істейді. Тазалауды болдырмау мүмкін емес, сондықтан оны іске қоспас бұрын иесімен растаңыз. Хабарламалар импортталғаннан кейін қайта тазаламаңыз: ол оларды да жояды.

Хабарламаларды жіберу ​

Импорт режимі қосулы кезде иенің көмекшісі немесе бағдарламасы тарихты жібереді:

  1. Ағымдағы импортты оқыңыз (get_import); онда әр шақыруға қажет импорт ID-і бар.
  2. Алдымен тіркемелерді оларды жіберген мүше үшін жүктеңіз; сол мүше келісуі керек. Әр жүктеу бір хабарламаға тіркеледі.
  3. Хабарламаларды 1-ден 100-ге дейінгі топтамалармен, ескіден бастап жіберіңіз. Әр хабарламада автор, түпнұсқа уақыт, мәтін (64 КБ-қа дейін), 10 тіркемеге дейін және қалауы бойынша жауап берілетін хабарлама бар. Топтаманың өз ID-і бар: сол топтаманы қайта жіберу алдыңғы нәтижені қайтарады, сондықтан желі қатесінен кейінгі қайталау хабарламаларды көшірмейді.
  4. Жауап чатта бұрыннан бар хабарламаға ғана сілтей алады, сондықтан хабарламаны алдымен, алдыңғы топтамада жіберіп, қайтарылған ID-ін пайдаланыңыз.
  5. Орын бойынша импортта әр хабарламаны оған тиесілі орынның нақты чатына жіберіңіз. Әр хабарламаның нәтижесін тексеріңіз. Топтама ішінара сәтті болуы мүмкін: қабылданбаған хабарлама себебімен қайтады (мысалы, "Бұл қатысушы импортқа келісім берген жоқ."), ал қалғаны сақталады.

Бұл қадамдарға арналған MCP құралдары Тарихты импорттау бөлімінде сипатталған. Дәл сол қызмет бағдарламаларға RPC API арқылы қолжетімді, деректер түрлері Импорт деректер түрлерінде. MCP-дің post_message әрекеті импорт емес: ол сіздің атыңыздан, қазіргі күнмен жібереді.

Импорт режимін аяқтау ​

Барлық хабарлама жіберілгенде иесі қолданбада Импортты аяқтауды таңдайды немесе көмекші end_import шақырады. Мүшелер қайтадан жібере алады, ал импортталған тарих бірінші жаңа хабарламаның үстінде тұрады. Ешқашан келіспеген мүшелерде жай ғана импортталған хабарлама болмайды.

Импорттан кейін оны тексеру үшін чатты айналдырыңыз: хабарламалар түпнұсқа авторлары мен күндерін көрсетеді, ал бірінші жаңа хабарлама солардан кейін тұрады. Бірнеше хабарламаны бастапқы көзбен салыстырыңыз және көмекшіңіз тізім жүргізсе, қабылданбаған хабарламалар тізімін оқыңыз. Тіпті жақсырағы — жетіспейтіндерді әлі жібере алатын кезде, импорт режимін аяқтамас бұрын импортталған хабарламаларды қайта оқыңыз.

A chat with older imported messages followed by a new message.

Мысал: Telegram экспортын импорттау ​

Бүкіл импортты MCP арқылы Voxt-қа қосылған және компьютеріңіздегі экспорт қалтасын оқи алатын көмекші, мысалы, Claude Code немесе файлдарға қатынауы бар басқа көмекші жасай алады. Ол үшін өз бағдарламаңыз қажет емес. Файлдарыңызды оқи алмайтын тек чат көмекшісі мұны істей алмайды.

Бастамас бұрын:

  1. Telegram Desktop-та чатты экспорттаңыз: чатты ашып, Чат тарихын экспорттау таңдаңыз, Машинамен оқылатын JSON таңдаңыз және қаласаңыз, фотолар мен файлдарды қосыңыз. Экспорт қалтасында result.json және photos мен files сияқты қалталар бар.
  2. Voxt топтық чатын жасап, Telegram чатында жазған адамдарды қосыңыз. Әрқайсысының Voxt аккаунты болуы және мүше болуы керек. Voxt мүшесі жоқ Telegram аттарын импорттау мүмкін емес.
  3. Көмекшінің қалай кіретінін шешіңіз: API кілтімен немесе OAuth арқылы Voxt аккаунтыңызбен (төменде).
  4. Voxt-ты көмекшіңізге MCP сервері ретінде қосыңыз (төменде).

Voxt-ты MCP сервері ретінде қосу ​

Сервер мекенжайы https://voxt.ai/mcp. Кірудің екі жолы бар. Екеуінде де көмекші сіздің атыңыздан әрекет етеді.

API кілтімен. Voxt-та кілт жасаңыз (Параметрлер → API және қолданбалар → API кілтін жасау) және оны Authorization: Bearer тақырыбында беріңіз. Claude Code-та мынаны іске қосыңыз:

bash
claude mcp add --transport http voxt https://voxt.ai/mcp --header "Authorization: Bearer $VOXT_API_KEY"

Кілт сұрауда немесе файлда көрінбеу үшін, алдымен терминалда VOXT_API_KEY орнатыңыз.

OAuth арқылы. Тақырыпты және кілтті алып тастаңыз:

bash
claude mcp add --transport http voxt https://voxt.ai/mcp

Содан кейін Claude Code-ты іске қосып, /mcp орындап, voxt таңдап, аутентификацияны таңдаңыз. Voxt келісім беті бар браузер терезесі ашылады; қатынауды бекітіңіз, сонда көмекші қосылады, кілт жасаудың немесе сақтаудың қажеті жоқ.

Басқа көмекшілерде қашықтағы MCP серверлері немесе коннекторлар параметрлері беті бар, онда сол мекенжайды және тақырыпты немесе кіруді енгізесіз. MCP екі тәсілді де сипаттайды. Қосылымның жұмыс істейтінін тексеру үшін көмекшіден Voxt чаттарыңызды тізімдеуін сұраңыз.

Нұсқау беру ​

Көмекшіге осындай нұсқау беріңіз. Қалта мен чат атын ауыстырыңыз.

text
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 МБ бөліктермен жүреді, сондықтан көп үлкен файлы бар чат көп шақыруды қажет етеді. Тек мәтін жылдам.