Gå til indholdet

Import og eksport ​

Voxt har ingen knap til at "eksportere chat" eller "importere chat", som danner eller læser en fil. Data flyttes gennem de to programmatiske grænseflader:

  • Eksport læser en chats beskeder, vedhæftede filer, medlemmer og resuméer via MCP eller RPC API'et.
  • Import føjer tidligere historik fra en anden tjeneste til en chat. Ejeren starter importtilstand, medlemmerne giver deres samtykke, og beskederne sendes med MCP's importværktøjer eller via importtjenesten i RPC API'et. I begge tilfælde kan ejeren køre hele processen fra en assistent.

Eksportér en chat ​

Eksport kræver en API-nøgle eller en OAuth-login. Assistenten eller scriptet handler som dig, så det kan læse præcis de chats, du selv kan læse, og ingen andre.

  1. Opret en API-nøgle, eller forbind en assistent med OAuth-flowet, som beskrevet i MCP.
  2. Bed din assistent om eksporten, for eksempel: "Læs alle beskeder i chatten Trip photos, og gem dem som en Markdown-fil med datoer og afsendere." Assistenten vælger værktøjerne; du behøver ikke kende deres navne.
  3. Til et script kalder du værktøjerne direkte. Værktøjsreferencen viser dem med deres argumenter.

Det kan læses:

DataVærktøjerBemærkninger
Beskederlist_messages, get_id_rangeÆldste først, op til 1.024 beskeder pr. kald. Fortsæt fra den sidste besked-ID, indtil der ikke returneres mere. Fjernede beskeder udelades.
Fastgjorte beskeder og reaktionerlist_pinned_messages, list_reactions
Fotos, videoer, filer og linkslist_media, list_files, list_linksGrupperet efter måned, nyeste måned først. Hver vedhæftet fil har en indholds-URL.
Medlemmerlist_members, list_place_members
Chats og stederlist_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_placeBrug dem til at finde det, der skal eksporteres. Chats, du har arkiveret, vises kun af list_archived_chats.
Resuméerlist_conversations, get_conversationResumerede stræk af en chat, for eksempel en stemmesession.
Søgeresultatersearch_messages, search_contacts

Det skal du vide, før du eksporterer en stor chat:

  • Værktøjerne returnerer sider, ikke en fil. Assistenten eller scriptet samler resultatet.
  • En besked, der stadig streames, har endnu ingen tekst. Læs den del igen senere.
  • Redigeringer og fjernelser af beskeder, du allerede har læst, rapporteres ikke. Læs intervallet igen, hvis chatten stadig er aktiv.

Importér historik til en chat ​

Brug importtilstand til at flytte en samtale fra en anden tjeneste ind i en Voxt-gruppechat eller et sted. Beskederne gemmes under deres oprindelige afsendere og oprindelige datoer, så chatten ser ud, som om den altid havde været i Voxt.

Det skal du vide først:

  • Kun chattens eller stedets ejer kan starte og afslutte en import.
  • Det virker for gruppechats og for steder. En import for hele stedet dækker alle chats på stedet. Direkte chats kan ikke importeres til.
  • Hver afsender skal være et nuværende medlem af chatten og skal give samtykke. Beskeder fra en, der ikke har givet samtykke, som har forladt chatten, eller som ikke er medlem, afvises.
  • Importerede beskeder skal være dateret i fortiden, hver senere end den foregående og senere end den nyeste besked, chatten allerede har. Systembeskeder tæller med, for eksempel når medlemmer kommer med, så i en gruppechat skal historikken være dateret efter, at medlemmerne kom med. Kun beskeder, der stadig er i chatten, tæller, så historik kan ikke indsættes før beskeder, der er der, men det kan lade sig gøre at få plads: under importen kan ejeren slette chattens historik eller fjerne enkelte beskeder, og derefter kan historik helt tilbage til de slettede beskeders alder importeres. En sletning under en import kan ikke fortrydes og opretter ingen note om "historik slettet".
  • Ingen kan skrive, mens importtilstand er slået til, heller ikke ejeren. En import for hele stedet stopper skrivning i alle stedets chats.
  • Importerede beskeder sender ingen notifikationer.

Start importtilstand ​

I appen:

  1. Åbn chattens indstillinger (på en smal skærm: vælg knappen med de tre prikker i chatoverskriften og derefter Rediger chat; på en bred skærm: åbn højre panel og vælg redigeringsknappen i dets overskrift), eller stedets indstillinger ved en import for hele stedet, og vælg Start import. Punktet vises kun for ejere og ikke i tråde.
  2. Bekræft Start importtilstand?. Voxt udfører nogle sidste kontroller i cirka ti sekunder ("Går i importtilstand"). Hvis nogen sendte en besked, mens den startede, beder Voxt dig om at fjerne beskeden og starte igen.
  3. Beskedfeltet erstattes af Vedligeholdelsestilstand for alle.
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.

En assistent med MCP's importværktøjer kan gøre det samme med start_import. Værktøjet gør intet, medmindre kaldet siger, at du har bekræftet det, fordi det stopper skrivning for alle medlemmer.

Bed medlemmerne tillade importen ​

Bekræftelsesdialogen, medlemmernes samtykke og afslutningen af importen vises i Importér en chats historik. Kort fortalt:

  1. Hvert medlem åbner chatten, vælger Tillad, at mine beskeder og medier importeres under denne session og bekræfter Tillad import?. Et samtykke kan ikke trækkes tilbage for den pågældende import. Ejeren giver også samtykke for at importere sine egne beskeder.
  2. Ejeren ser andelen af medlemmer, der har givet samtykke ("Samtykke: 100 % (3 ud af 3)"), og hvem der stadig mangler.
  3. Beskeder fra medlemmer, der ikke har givet samtykke, afvises, så vent, til alle, hvis historik du vil have med, har givet samtykke.

Medlemmerne kan ikke skrive i chatten under importen, så ejeren kan ikke minde dem om det dér. Skriv til dem i jeres direkte chats i stedet; de forbliver åbne. En assistent kan gøre det: get_import viser de medlemmer, der ikke har givet samtykke, hver med den direkte chat, du har med dem, og assistenten sender en påmindelse dér og tjekker igen, indtil den andel, du ønsker, har givet samtykke.

Gør plads til ældre historik ​

Hvis historikken er ældre end beskeder, der allerede er i chatten, for eksempel systembeskederne om, at medlemmer kom med, skal du fjerne dem først. Med MCP-værktøjerne fjerner wipe_history chattens beskeder fra en valgt besked og frem (som standard alle), kun mens importen kører og kun for ejere, og returnerer, når de er slettet; remove_message fjerner en enkelt besked. Begge virker under en import. En sletning kan ikke fortrydes, så få ejerens bekræftelse, før den køres. Slet ikke igen, efter at beskederne er importeret: det ville fjerne dem også.

Send beskederne ​

Mens importtilstand er slået til, sender ejerens assistent eller program historikken:

  1. Læs den aktuelle import (get_import); den indeholder import-ID'et, som hvert kald kræver.
  2. Upload først vedhæftede filer, for det medlem der sendte dem; det medlem skal have givet samtykke. Hver upload knyttes til én besked.
  3. Send beskeder i grupper på 1 til 100, ældste først. Hver besked har afsenderen, det oprindelige tidspunkt, teksten (op til 64 KB), op til 10 vedhæftede filer og eventuelt den besked, den svarer på. En gruppe har sit eget ID: sendes samme gruppe igen, returneres det tidligere resultat, så et nyt forsøg efter en netværksfejl ikke giver dubletter.
  4. Et svar kan kun pege på en besked, der allerede er i chatten, så send først beskeden i en tidligere gruppe, og brug det ID, der returneres.
  5. I en import for hele stedet sendes hver besked til den bestemte chat på stedet, den hører til i. Tjek resultatet af hver besked. En gruppe kan lykkes delvist: en afvist besked kommer tilbage med årsagen (for eksempel "Dette medlem har ikke givet samtykke til import."), og de andre gemmes.

MCP-værktøjerne til disse trin er beskrevet i Import af historik. Den samme tjeneste er tilgængelig for programmer via RPC API'et, med datatyperne i Datatyper for import. MCP's post_message er ikke en import: den sender som dig, dateret nu.

Afslut importtilstand ​

Når alle beskeder er sendt, vælger ejeren Afslut import i appen, eller assistenten kalder end_import. Medlemmerne kan skrive igen, og den importerede historik ligger over den første nye besked. Medlemmer, der aldrig gav samtykke, får simpelthen ingen beskeder importeret.

Efter importen skal du rulle igennem chatten for at kontrollere den: beskederne viser deres oprindelige afsendere og datoer, og den første nye besked følger efter dem. Sammenlign nogle få beskeder med kilden, og læs listen over afviste beskeder, hvis din assistent har ført en. Endnu bedre er det at læse de importerede beskeder tilbage, før du afslutter importtilstand, så du stadig kan sende dem, der mangler.

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

Eksempel: importér en Telegram-eksport ​

Hele importen kan udføres af en assistent, der er forbundet til Voxt via MCP og kan læse eksportmappen på din computer, for eksempel Claude Code eller en anden assistent med adgang til filer. Du behøver intet eget program. En assistent, der kun kan chatte og ikke kan læse dine filer, kan ikke gøre det.

Før du begynder:

  1. Eksportér chatten i Telegram Desktop: åbn chatten, vælg Export chat history, vælg Machine-readable JSON, og tag fotos og filer med, hvis du vil have dem. Eksportmappen indeholder result.json og mapper som photos og files.
  2. Opret Voxt-gruppechatten, og tilføj de personer, der skrev i Telegram-chatten. Hver af dem skal have en Voxt-konto og være medlem. Telegram-navne uden et tilsvarende Voxt-medlem kan ikke importeres.
  3. Bestem, hvordan assistenten logger ind: med en API-nøgle eller med din Voxt-konto via OAuth (se nedenfor).
  4. Føj Voxt til din assistent som en MCP-server (se nedenfor).

Føj Voxt til som MCP-server ​

Serveradressen er https://voxt.ai/mcp. Der er to måder at logge ind på. I begge tilfælde handler assistenten som dig.

Med en API-nøgle. Opret en nøgle i Voxt (Indstillinger → API og apps → Opret API-nøgle), og send den i en Authorization: Bearer-header. I Claude Code kører du:

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

Angiv først VOXT_API_KEY i din terminal, så nøglen ikke optræder i en prompt eller i en fil.

Med OAuth. Udelad headeren og nøglen:

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

Start derefter Claude Code, kør /mcp, vælg voxt, og vælg at godkende. Et browservindue åbner med Voxts samtykkeside; godkend adgangen, og assistenten er forbundet, uden at du behøver oprette eller gemme en nøgle.

Andre assistenter har en indstillingsside til eksterne MCP-servere eller konnektorer, hvor du indtaster den samme adresse og enten headeren eller loginnet. MCP beskriver begge måder. Bed assistenten vise dine Voxt-chats for at kontrollere, at forbindelsen virker.

Giv instruktionen ​

Giv assistenten en instruktion som denne. Udskift mappen og chatnavnet.

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.

Bemærkninger til eksemplet:

  • Telegram gemmer en beskeds tidspunkt uden tidszone. Kontrollér de første importerede beskeder mod den oprindelige chat, før du sender resten.
  • Afviste beskeder stopper ikke gruppen. Ret årsagen (et manglende medlem, en afsender der ikke har tilladt importen, et tidspunkt uden for rækkefølge), og send dem igen i en ny gruppe.
  • Beskeder, der ikke kan tilordnes, udelades, så behold Telegram-eksporten, hvis du har brug for hele optegnelsen.
  • Hver fil rejser i 1 MB-stykker gennem assistenten, så en chat med mange store filer kræver mange kald. Tekst alene går hurtigt.