Hoppa till innehållet

Import och export ​

Voxt har ingen knapp för att "exportera chatt" eller "importera chatt" som skapar eller läser en fil. Data flyttas via de två programmatiska gränssnitten:

  • Export läser en chatts meddelanden, bilagor, medlemmar och sammanfattningar via MCP eller RPC API.
  • Import lägger till tidigare historik från en annan tjänst i en chatt. Ägaren startar importläge, medlemmarna godkänner, och meddelandena skickas via importverktygen i MCP eller importtjänsten i RPC API. I båda fallen kan ägaren köra hela processen från en assistent.

Exportera en chatt ​

Export kräver en API-nyckel eller en OAuth-inloggning. Assistenten eller skriptet agerar som du, så det kan läsa exakt de chattar du kan läsa, och inget annat.

  1. Skapa en API-nyckel, eller anslut en assistent med OAuth-flödet, enligt beskrivningen i MCP.
  2. Be din assistent om exporten, till exempel: "Läs alla meddelanden i chatten Trip photos och spara dem som en Markdown-fil med datum och författare." Assistenten väljer verktygen; du behöver inte känna till deras namn.
  3. För ett skript anropar du verktygen direkt. Verktygsreferensen listar dem med deras argument.

Vad som kan läsas:

DataVerktygAnmärkningar
Meddelandenlist_messages, get_id_rangeÄldst först, upp till 1 024 meddelanden per anrop. Fortsätt från det sista meddelande-ID:t tills ingenting returneras. Borttagna meddelanden utelämnas.
Fästa meddelanden och reaktionerlist_pinned_messages, list_reactions
Foton, videor, filer och länkarlist_media, list_files, list_linksGrupperade per månad, senaste månaden först. Varje bilaga har en innehålls-URL.
Medlemmarlist_members, list_place_members
Chattar och Platserlist_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_placeAnvänd dem för att hitta vad som ska exporteras. Chattar du har arkiverat listas bara av list_archived_chats.
Sammanfattningarlist_conversations, get_conversationSammanfattade avsnitt av en chatt, till exempel en röstsession.
Sökresultatsearch_messages, search_contacts

Saker att veta innan du exporterar en stor chatt:

  • Verktygen returnerar sidor, inte en fil. Assistenten eller skriptet sätter ihop resultatet.
  • Ett meddelande som fortfarande strömmas har ingen text än. Läs den delen igen senare.
  • Redigeringar och borttagningar av meddelanden som du redan har läst rapporteras inte. Läs intervallet igen om chatten fortfarande är aktiv.

Importera historik till en chatt ​

Använd importläge för att föra in ett samtal från en annan tjänst i en Voxt-gruppchatt eller en Plats. Meddelandena lagras under sina ursprungliga författare och ursprungliga datum, så att chatten läses som om den alltid hade funnits i Voxt.

Vad du bör veta först:

  • Bara ägaren av chatten eller Platsen kan starta och avsluta en import.
  • Det fungerar för gruppchattar och för Platser. En import för hela Platsen omfattar varje chatt på Platsen. Direktchattar kan inte importeras till.
  • Varje författare måste vara en nuvarande medlem i chatten och måste ha godkänt. Meddelanden från någon som inte har godkänt, som har lämnat eller som inte är medlem avvisas.
  • Importerade meddelanden måste vara daterade i det förflutna, vart och ett senare än det föregående och senare än chattens nyaste meddelande. Systemmeddelanden räknas, till exempel att medlemmar går med, så i en gruppchatt måste historiken vara daterad efter att medlemmarna gick med. Bara meddelanden som fortfarande finns i chatten räknas, så historik kan inte läggas in före meddelanden som finns där, men den kan göras att passa: under importen kan ägaren rensa chattens historik, eller ta bort enstaka meddelanden, och då kan historik så gammal som de rensade meddelandena importeras. En rensning under en import kan inte ångras och lägger inte upp någon anteckning om "historik rensad".
  • Ingen kan skriva medan importläget är på, ägaren inte heller. En import för hela Platsen stoppar skrivandet i varje chatt på Platsen.
  • Importerade meddelanden skickar inga aviseringar.

Starta importläge ​

I appen:

  1. Öppna chattens inställningar (på en smal skärm väljer du knappen med tre punkter i chattens huvud och sedan Redigera chatt; på en bred skärm öppnar du högerpanelen och väljer redigeringsknappen i dess huvud), eller Platsens inställningar för en import för hela Platsen, och välj Starta import. Posten visas bara för ägare, och inte i trådar.
  2. Bekräfta Starta importläge?. Voxt kör några sista kontroller i ungefär tio sekunder ("Går in i importläge"). Om någon skickade ett meddelande medan det startade ber Voxt dig ta bort det meddelandet och starta om.
  3. Meddelanderutan ersätts av Underhållsläge för alla.
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 importverktyg kan göra detsamma med start_import. Verktyget gör ingenting om inte anropet anger att du har bekräftat, eftersom det stoppar skrivandet för alla medlemmar.

Be medlemmarna tillåta importen ​

Bekräftelsedialogen, medlemmarnas samtycke och hur importen avslutas visas i Importera en chatts historik. I korthet:

  1. Varje medlem öppnar chatten, väljer Tillåt att mina meddelanden och medier importeras under den här sessionen och bekräftar Tillåta import?. Ett samtycke kan inte återkallas för den importen. Ägaren samtycker också, för att importera sina egna meddelanden.
  2. Ägaren ser andelen medlemmar som har godkänt ("Samtyckt: 100 % (3 av 3)") och vilka som fortfarande saknas.
  3. Meddelanden från medlemmar som inte har godkänt avvisas, så vänta tills alla vars historik du vill ha har godkänt.

Medlemmar kan inte skriva i chatten under importen, så ägaren kan inte påminna dem där. Skriv till dem i era direktchattar i stället; de förblir öppna. En assistent kan göra detta: get_import listar de medlemmar som inte har godkänt, var och en med direktchatten du har med dem, och assistenten lägger upp en påminnelse där och kontrollerar igen tills den andel du vill ha har godkänt.

Gör plats för äldre historik ​

Om historiken är äldre än meddelanden som redan finns i chatten, till exempel systemmeddelandena som registrerar att medlemmar går med, ta bort dem först. Med MCP-verktygen tar wipe_history bort chattens meddelanden från ett valt meddelande och framåt (som standard alla), bara medan importen pågår och bara för ägare, och returnerar när de är borttagna; remove_message tar bort ett enstaka meddelande. Båda fungerar under en import. Rensning kan inte ångras, så bekräfta den med ägaren innan den körs. Rensa inte igen efter att meddelandena har importerats: då skulle de tas bort också.

Skicka meddelandena ​

Medan importläget är på skickar ägarens assistent eller program historiken:

  1. Läs den aktuella importen (get_import); den innehåller import-ID:t som varje anrop behöver.
  2. Ladda upp bilagor först, för den medlem som skickade dem; den medlemmen måste ha godkänt. Varje uppladdning fästs vid ett meddelande.
  3. Skicka meddelanden i grupper om 1 till 100, äldst först. Varje meddelande har författaren, den ursprungliga tiden, texten (upp till 64 KB), upp till 10 bilagor och, om du vill, meddelandet det svarar på. En grupp har ett eget ID: om du skickar samma grupp igen returneras det tidigare resultatet, så ett nytt försök efter ett nätverksfel skapar inga dubbletter.
  4. Ett svar kan bara peka på ett meddelande som redan finns i chatten, så skicka meddelandet först, i en tidigare grupp, och använd dess returnerade ID.
  5. I en import för hela Platsen skickar du varje meddelande till den specifika chatt på Platsen det hör till. Kontrollera resultatet för varje meddelande. En grupp kan lyckas delvis: ett avvisat meddelande kommer tillbaka med orsaken (till exempel "Den här medlemmen har inte samtyckt till import."), och de andra lagras.

MCP-verktygen för de här stegen beskrivs i Importera historik. Samma tjänst finns för program via RPC API, med datatyperna i Datatyper för import. MCP:s post_message är ingen import: det lägger upp som du, daterat nu.

Avsluta importläget ​

När alla meddelanden är skickade väljer ägaren Avsluta import i appen, eller så anropar assistenten end_import. Medlemmar kan skriva igen, och den importerade historiken ligger ovanför det första nya meddelandet. Medlemmar som aldrig godkände får helt enkelt inga meddelanden importerade.

Efter importen bläddrar du genom chatten för att kontrollera den: meddelandena visar sina ursprungliga författare och datum, och det första nya meddelandet följer efter dem. Jämför några meddelanden med källan och läs listan över avvisade meddelanden om din assistent har fört en. Ännu bättre är att läsa tillbaka de importerade meddelandena innan du avslutar importläget, medan du fortfarande kan skicka de som saknas.

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

Exempel: importera en Telegram-export ​

Hela importen kan göras av en assistent som är ansluten till Voxt via MCP och kan läsa exportmappen på din dator, till exempel Claude Code eller en annan assistent med filåtkomst. Den behöver inget eget program. En assistent som bara chattar och inte kan läsa dina filer kan inte göra det.

Innan du börjar:

  1. Exportera chatten i Telegram Desktop: öppna chatten, välj Export chat history, välj Machine-readable JSON och ta med foton och filer om du vill ha dem. Exportmappen innehåller result.json och mappar som photos och files.
  2. Skapa Voxt-gruppchatten och lägg till personerna som skrev i Telegram-chatten. Var och en behöver ett Voxt-konto och måste vara medlem. Telegram-namn som saknar Voxt-medlem kan inte importeras.
  3. Bestäm hur assistenten loggar in: med en API-nyckel, eller med ditt Voxt-konto via OAuth (nedan).
  4. Lägg till Voxt i din assistent som en MCP-server (nedan).

Lägg till Voxt som MCP-server ​

Serveradressen är https://voxt.ai/mcp. Det finns två sätt att logga in. I båda agerar assistenten som du.

Med en API-nyckel. Skapa en nyckel i Voxt (Inställningar → API och appar → Skapa API-nyckel) och skicka den i ett Authorization: Bearer-huvud. I Claude Code kör du:

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

Ställ först in VOXT_API_KEY i din terminal, så att nyckeln inte syns i en prompt eller i en fil.

Med OAuth. Utelämna huvudet och nyckeln:

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

Starta sedan Claude Code, kör /mcp, välj voxt och välj att autentisera. Ett webbläsarfönster öppnas med Voxts samtyckessida; godkänn åtkomsten så är assistenten ansluten, utan nyckel att skapa eller lagra.

Andra assistenter har en inställningssida för fjärranslutna MCP-servrar eller kopplingar där du anger samma adress och antingen huvudet eller inloggningen. MCP beskriver båda sätten. Be assistenten lista dina Voxt-chattar för att kontrollera att anslutningen fungerar.

Ge instruktionen ​

Ge assistenten en instruktion som den här. Byt ut mappen och chattnamnet.

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.

Anmärkningar till exemplet:

  • Telegram lagrar en meddelandetid utan tidszon. Kontrollera de första importerade meddelandena mot den ursprungliga chatten innan du skickar resten.
  • Avvisade meddelanden stoppar inte gruppen. Åtgärda orsaken (en medlem som saknas, en avsändare som inte har tillåtit importen, en tid som är i fel ordning) och skicka dem igen i en ny grupp.
  • Meddelanden som inte kan kopplas utelämnas, så behåll Telegram-exporten om du behöver hela underlaget.
  • Varje fil färdas i bitar om 1 MB genom assistenten, så en chatt med många stora filer tar många anrop. Enbart text går snabbt.