Import at export
Walang button na "i-export ang chat" o "i-import ang chat" sa Voxt na gumagawa o bumabasa ng file. Dumadaan ang data sa dalawang programmatic na interface:
- Ang Export ay nagbabasa ng mga mensahe, attachment, miyembro at buod ng isang chat sa pamamagitan ng MCP o ng RPC API.
- Ang Import ay nagdaragdag ng mas naunang kasaysayan mula sa ibang serbisyo sa isang chat. Sisimulan ng may-ari ang import mode, papayag ang mga miyembro, at ipapadala ang mga mensahe gamit ang mga import tool ng MCP o ang import service ng RPC API. Sa parehong paraan, maaaring patakbuhin ng may-ari ang buong proseso mula sa isang assistant.
Mag-export ng chat
Kailangan ng API key o OAuth sign-in para mag-export. Kumikilos bilang ikaw ang assistant o script, kaya mababasa lang nito ang mga chat na mababasa mo, at wala nang iba.
- Gumawa ng API key, o ikonekta ang isang assistant gamit ang OAuth flow, ayon sa paliwanag sa MCP.
- Hilingin sa assistant mo ang export, halimbawa: "Basahin ang lahat ng mensahe ng chat na Trip photos at i-save bilang Markdown file na may mga petsa at may-akda." Ang assistant ang pipili ng mga tool; hindi mo kailangang malaman ang mga pangalan nito.
- Kung script ang gagamit, tawagin nang direkta ang mga tool. Nakalista ang mga ito kasama ang mga argument nila sa tool reference.
Ang mga mababasa:
| Data | Mga tool | Mga tala |
|---|---|---|
| Mga mensahe | list_messages, get_id_range | Pinakaluma muna, hanggang 1,024 mensahe bawat tawag. Magpatuloy mula sa ID ng huling mensahe hanggang wala nang ibalik. Hindi isinasama ang mga inalis na mensahe. |
| Mga naka-pin na mensahe at reaksyon | list_pinned_messages, list_reactions | |
| Mga larawan, video, file at link | list_media, list_files, list_links | Naka-grupo ayon sa buwan, pinakabagong buwan muna. May content URL ang bawat attachment. |
| Mga miyembro | list_members, list_place_members | |
| Mga chat at place | list_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_place | Gamitin ang mga ito para hanapin kung ano ang ie-export. Ang mga chat na na-archive mo ay nakalista lang sa list_archived_chats. |
| Mga buod | list_conversations, get_conversation | Mga bahagi ng chat na may buod, gaya ng isang voice session. |
| Mga resulta ng paghahanap | search_messages, search_contacts |
Mga dapat malaman bago mag-export ng malaking chat:
- Mga pahina ang ibinabalik ng mga tool, hindi file. Ang assistant o script ang bubuo ng resulta.
- Ang mensaheng kasalukuyang ini-stream ay wala pang text. Basahin ulit ang bahaging iyon mamaya.
- Hindi iniuulat ang mga pag-edit at pag-alis ng mga mensaheng nabasa mo na. Basahin ulit ang saklaw kung aktibo pa ang chat.
Mag-import ng kasaysayan sa isang chat
Gamitin ang import mode para dalhin ang isang usapan mula sa ibang serbisyo papunta sa isang group chat o place sa Voxt. Iniimbak ang mga mensahe sa ilalim ng orihinal nilang may-akda at orihinal na petsa, kaya mukhang laging nasa Voxt ang chat.
Mga dapat malaman muna:
- Ang may-ari lang ng chat o place ang puwedeng magsimula at magtapos ng import.
- Gumagana ito para sa mga group chat at sa mga place. Sinasaklaw ng place-wide na import ang bawat chat sa place. Hindi puwedeng mag-import sa mga direktang chat.
- Ang bawat may-akda ay dapat kasalukuyang miyembro ng chat at dapat pumayag. Tinatanggihan ang mga mensahe ng taong hindi pa pumapayag, umalis na, o hindi miyembro.
- Ang mga na-import na mensahe ay dapat may petsa sa nakaraan, bawat isa ay mas huli kaysa sa nauna, at mas huli kaysa sa pinakabagong mensahe na nasa chat na. Kasama sa bilang ang mga system message, gaya ng pagsali ng mga miyembro, kaya sa isang group chat, dapat mas huli ang petsa ng kasaysayan kaysa sa pagsali ng mga miyembro. Ang mga mensaheng nasa chat pa lang ang binibilang, kaya hindi makapagpapasok ng kasaysayan bago ang mga mensaheng nandoon na, pero maaari itong ayusin: habang may import, puwedeng burahin ng may-ari ang kasaysayan ng chat, o alisin ang mga indibidwal na mensahe, at saka makakapag-import ng kasaysayang kasingluma ng mga naburang mensahe. Hindi na maibabalik ang pagbura habang may import, at walang ipo-post na tala na "nabura ang kasaysayan".
- Walang makakapag-post habang naka-on ang import mode, kasama ang may-ari. Ang place-wide na import ay humihinto sa pag-post sa bawat chat ng place.
- Hindi nagpapadala ng mga notification ang mga na-import na mensahe.
Simulan ang import mode
Sa app:
- Buksan ang mga setting ng chat (sa makitid na screen, piliin ang three-dot button sa header ng chat, saka I-edit ang chat; sa malapad na screen, buksan ang kanang panel at piliin ang edit button sa header nito), o ng place para sa place-wide na import, at piliin ang Simulan ang import. Ipinapakita lang ang opsyong ito sa mga may-ari, at hindi sa mga thread.
- Kumpirmahin ang Simulan ang import mode?. Magpapatakbo ang Voxt ng ilang huling pagsusuri sa loob ng humigit-kumulang sampung segundo ("Pumapasok sa import mode"). Kung may nag-post ng mensahe habang nagsisimula ito, hihilingin ng Voxt na alisin mo ang mensaheng iyon at magsimulang muli.
- Ang message box ay papalitan ng Maintenance mode para sa lahat.



Magagawa rin ito ng isang assistant na may mga import tool ng MCP gamit ang start_import. Walang ginagawa ang tool maliban kung sinasabi ng tawag na kinumpirma mo ito, dahil pinahihinto nito ang pag-post para sa bawat miyembro.
Hilingin sa mga miyembro na payagan ang import
Ipinapakita ang dialog ng kumpirmasyon, ang pagpayag ng mga miyembro at ang pagtatapos ng import sa Mag-import ng kasaysayan ng chat. Sa madaling salita:
- Bubuksan ng bawat miyembro ang chat, pipiliin ang Payagang ma-import ang mga mensahe at media ko sa session na ito at kukumpirmahin ang Payagan ang import?. Hindi na mababawi ang pagpayag para sa import na iyon. Pumapayag din ang may-ari, para ma-import ang sarili niyang mga mensahe.
- Makikita ng may-ari ang bahagdan ng mga miyembrong pumayag ("Pumayag: 100% (3 sa 3)") at kung sino pa ang kulang.
- Tinatanggihan ang mga mensahe ng mga miyembrong hindi pa pumapayag, kaya hintayin na pumayag ang lahat ng gusto mong maisama ang kasaysayan.
Hindi makakasulat ang mga miyembro sa chat habang may import, kaya hindi sila matatandaan ng may-ari doon. Sa halip, padalhan sila ng mensahe sa mga direktang chat ninyo; nananatiling bukas ang mga iyon. Magagawa ito ng isang assistant: inililista ng get_import ang mga miyembrong hindi pa pumapayag, kasama ang direktang chat mo sa bawat isa, at magpo-post ang assistant ng paalala doon at susuriin ulit hanggang pumayag ang bahagdang gusto mo.
Maglaan ng espasyo para sa mas lumang kasaysayan
Kung mas luma ang kasaysayan kaysa sa mga mensaheng nasa chat na, halimbawa ang mga system message na nagtatala ng pagsali ng mga miyembro, alisin muna ang mga iyon. Sa mga MCP tool, inaalis ng wipe_history ang mga mensahe ng chat mula sa napiling mensahe pataas (bilang default, lahat), habang may import lang at para sa mga may-ari lang, at bumabalik ito kapag nabura na ang mga ito; inaalis naman ng remove_message ang isang mensahe. Parehong gumagana ang dalawa habang may import. Hindi na maibabalik ang pagbura, kaya kumpirmahin ito sa may-ari bago patakbuhin. Huwag nang magbura ulit pagkatapos ma-import ang mga mensahe: aalisin din nito ang mga iyon.
Ipadala ang mga mensahe
Habang naka-on ang import mode, ipinapadala ng assistant o program ng may-ari ang kasaysayan:
- Basahin ang kasalukuyang import (
get_import); dala nito ang import ID na kailangan ng bawat tawag. - I-upload muna ang mga attachment, para sa miyembrong nagpadala ng mga ito; dapat pumayag ang miyembrong iyon. Ang bawat upload ay nakakabit sa isang mensahe.
- Magpadala ng mga mensahe sa mga batch na 1 hanggang 100, pinakaluma muna. Ang bawat mensahe ay may may-akda, orihinal na oras, text (hanggang 64 KB), hanggang 10 attachment at, opsyonal, ang mensaheng sinasagot nito. May sariling ID ang bawat batch: ang pagpapadala ulit ng parehong batch ay nagbabalik ng naunang resulta, kaya hindi nadodoble ang mga mensahe kapag nag-retry pagkatapos ng network error.
- Ang sagot ay puwede lang tumukoy sa mensaheng nasa chat na, kaya ipadala muna ang mensahe, sa naunang batch, at gamitin ang ibinalik nitong ID.
- Sa place-wide na import, ipadala ang bawat mensahe sa partikular na chat ng place na kinabibilangan nito. Suriin ang resulta ng bawat mensahe. Maaaring bahagyang magtagumpay ang isang batch: ang tinanggihang mensahe ay babalik kasama ang dahilan (halimbawa "Hindi pumayag ang miyembrong ito sa import."), at iniimbak ang iba.
Inilalarawan ang mga MCP tool para sa mga hakbang na ito sa Import ng kasaysayan. Magagamit din ng mga program ang parehong serbisyo sa pamamagitan ng RPC API, at nasa Mga data type ng Imports ang mga data type. Hindi import ang post_message ng MCP: nagpo-post ito bilang ikaw, na may petsa ng ngayon.
Tapusin ang import mode
Kapag naipadala na ang lahat ng mensahe, pipiliin ng may-ari ang Tapusin ang import sa app, o tatawagin ng assistant ang end_import. Makakapag-post na ulit ang mga miyembro, at ang na-import na kasaysayan ay nasa itaas ng unang bagong mensahe. Ang mga miyembrong hindi pumayag ay walang na-import na mensahe.
Pagkatapos ng import, mag-scroll sa chat para suriin ito: ipinapakita ng mga mensahe ang orihinal nilang may-akda at petsa, at sumusunod sa kanila ang unang bagong mensahe. Ihambing ang ilang mensahe sa pinagmulan, at basahin ang listahan ng mga tinanggihang mensahe kung nagtago nito ang assistant mo. Mas mainam pa, basahin ulit ang mga na-import na mensahe bago tapusin ang import mode, habang maipapadala mo pa ang mga kulang.

Halimbawa: mag-import ng Telegram export
Magagawa ng isang assistant na nakakonekta sa Voxt sa pamamagitan ng MCP at nakakabasa ng export folder sa computer mo ang buong import, gaya ng Claude Code o ibang assistant na may access sa file. Hindi na kailangan ng sarili mong program. Hindi ito magagawa ng chat-only na assistant na hindi nakakabasa ng mga file mo.
Bago magsimula:
- Sa Telegram Desktop, i-export ang chat: buksan ang chat, piliin ang Export chat history, piliin ang Machine-readable JSON at isama ang mga larawan at file kung gusto mo. Naglalaman ang export folder ng
result.jsonat mga folder gaya ngphotosatfiles. - Gumawa ng group chat sa Voxt at idagdag ang mga taong sumulat sa Telegram chat. Kailangan ng bawat isa ng Voxt account at dapat siyang miyembro. Hindi mai-import ang mga pangalan sa Telegram na walang katumbas na miyembro sa Voxt.
- Magpasya kung paano magsa-sign in ang assistant: gamit ang API key, o gamit ang Voxt account mo sa pamamagitan ng OAuth (sa ibaba).
- Idagdag ang Voxt sa assistant mo bilang MCP server (sa ibaba).
Idagdag ang Voxt bilang MCP server
Ang address ng server ay https://voxt.ai/mcp. May dalawang paraan para mag-sign in. Sa parehong paraan, kumikilos bilang ikaw ang assistant.
Gamit ang API key. Gumawa ng key sa Voxt (Mga Setting → API at Mga App → Gumawa ng API Key) at ipasa ito sa isang Authorization: Bearer header. Sa Claude Code, patakbuhin ang:
claude mcp add --transport http voxt https://voxt.ai/mcp --header "Authorization: Bearer $VOXT_API_KEY"I-set muna ang VOXT_API_KEY sa terminal mo, para hindi lumabas ang key sa isang prompt o sa isang file.
Gamit ang OAuth. Huwag isama ang header at ang key:
claude mcp add --transport http voxt https://voxt.ai/mcpPagkatapos, simulan ang Claude Code, patakbuhin ang /mcp, piliin ang voxt at piliing mag-authenticate. Magbubukas ang isang browser window na may consent page ng Voxt; aprubahan ang access at konektado na ang assistant, nang walang key na gagawin o iingatan.
May settings page ang ibang mga assistant para sa mga remote MCP server o connector kung saan ilalagay mo ang parehong address, at alinman sa header o sa sign-in. Inilalarawan ng MCP ang dalawang paraan. Hilingin sa assistant na ilista ang mga Voxt chat mo para tingnan kung gumagana ang koneksyon.
Ibigay ang instruksyon
Bigyan ang assistant ng instruksyon na tulad nito. Palitan ang folder at ang pangalan ng chat.
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.Mga tala tungkol sa halimbawa:
- Nag-iimbak ang Telegram ng oras ng mensahe nang walang time zone. Ihambing ang mga unang na-import na mensahe sa orihinal na chat bago ipadala ang iba.
- Hindi pinahihinto ng mga tinanggihang mensahe ang batch. Ayusin ang sanhi (kulang na miyembro, nagpadalang hindi pa pumapayag sa import, oras na wala sa ayos) at ipadala ulit ang mga ito sa bagong batch.
- Ang mga mensaheng hindi ma-map ay hindi isinasama, kaya itago ang Telegram export kung kailangan mo ang buong talaan.
- Dumadaan ang bawat file sa assistant sa mga piraso na 1 MB, kaya ang chat na maraming malalaking file ay nangangailangan ng maraming tawag. Mabilis ang text lang.
Mga kaugnay na gabay
- Mga Chat para sa tanaw ng miyembro sa import mode.
- MCP at ang tool reference nito.
- RPC API.