Importeren en exporteren
Voxt heeft geen knop "chat exporteren" of "chat importeren" die een bestand maakt of leest. Gegevens gaan via de twee programmeerbare interfaces:
- Exporteren leest de berichten, bijlagen, leden en samenvattingen van een chat via MCP of de RPC API.
- Importeren voegt eerdere geschiedenis van een andere dienst toe aan een chat. De eigenaar start de importmodus, de leden geven toestemming en de berichten worden verzonden met de MCP-importtools of met de importservice van de RPC API. In beide gevallen kan de eigenaar het hele proces vanuit een assistent uitvoeren.
Een chat exporteren
Voor exporteren heb je een API-sleutel of een OAuth-aanmelding nodig. De assistent of het script handelt namens jou, dus het kan precies de chats lezen die jij kunt lezen, en niets anders.
- Maak een API-sleutel, of koppel een assistent met de OAuth-flow, zoals beschreven in MCP.
- Vraag je assistent om de export, bijvoorbeeld: "Lees alle berichten van de chat Trip photos en sla ze op als Markdown-bestand met datums en auteurs." De assistent kiest de tools; je hoeft hun namen niet te kennen.
- Roep voor een script de tools rechtstreeks aan. De toolreferentie toont ze met hun argumenten.
Wat kan worden gelezen:
| Gegevens | Tools | Opmerkingen |
|---|---|---|
| Berichten | list_messages, get_id_range | Oudste eerst, tot 1.024 berichten per aanroep. Ga door vanaf de ID van het laatste bericht tot er niets meer wordt teruggegeven. Verwijderde berichten worden weggelaten. |
| Vastgezette berichten en reacties | list_pinned_messages, list_reactions | |
| Foto's, video's, bestanden en links | list_media, list_files, list_links | Gegroepeerd per maand, de nieuwste maand eerst. Elke bijlage heeft een inhouds-URL. |
| Leden | list_members, list_place_members | |
| Chats en Plekken | list_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_place | Gebruik ze om te vinden wat je wilt exporteren. Chats die je hebt gearchiveerd, worden alleen door list_archived_chats getoond. |
| Samenvattingen | list_conversations, get_conversation | Samengevatte delen van een chat, zoals een spraaksessie. |
| Zoekresultaten | search_messages, search_contacts |
Wat je moet weten voordat je een grote chat exporteert:
- De tools geven pagina's terug, geen bestand. De assistent of het script stelt het resultaat samen.
- Een bericht dat nog wordt gestreamd, heeft nog geen tekst. Lees dat deel later opnieuw.
- Bewerkingen en verwijderingen van berichten die je al hebt gelezen, worden niet gemeld. Lees het bereik opnieuw als de chat nog actief is.
Geschiedenis in een chat importeren
Gebruik de importmodus om een gesprek van een andere dienst over te brengen naar een Voxt-groepschat of een Plek. Berichten worden opgeslagen onder hun oorspronkelijke auteurs en oorspronkelijke datums, zodat de chat leest alsof hij altijd in Voxt heeft gestaan.
Wat je eerst moet weten:
- Alleen de eigenaar van de chat of Plek kan een import starten en beëindigen.
- Het werkt voor groepschats en voor Plekken. Een import voor een hele Plek omvat elke chat in die Plek. In directe chats kun je niet importeren.
- Elke auteur moet een huidig lid van de chat zijn en toestemming geven. Berichten van iemand die geen toestemming heeft gegeven, die is vertrokken of die geen lid is, worden geweigerd.
- Geïmporteerde berichten moeten in het verleden gedateerd zijn, elk later dan het vorige en later dan het nieuwste bericht dat de chat al heeft. Systeemberichten tellen mee, zoals leden die lid worden, dus in een groepschat moet de geschiedenis na het lid worden van de leden gedateerd zijn. Alleen berichten die nog in de chat staan tellen mee, dus je kunt geen geschiedenis invoegen vóór berichten die er zijn, maar je kunt ruimte maken: tijdens de import kan de eigenaar de geschiedenis van de chat wissen, of afzonderlijke berichten verwijderen, en dan kan geschiedenis worden geïmporteerd die zo oud is als de gewiste berichten. Een wisactie tijdens een import kan niet ongedaan worden gemaakt en plaatst geen melding "geschiedenis gewist".
- Niemand kan berichten plaatsen zolang de importmodus aanstaat, ook de eigenaar niet. Bij een import voor een hele Plek kan er in geen enkele chat van de Plek worden gepost.
- Geïmporteerde berichten sturen geen meldingen.
De importmodus starten
In de app:
- Open de instellingen van de chat (selecteer op een smal scherm de knop met de drie puntjes in de chatkop en dan Chat bewerken; open op een breed scherm het rechterpaneel en selecteer de bewerkknop in de kop), of van de Plek voor een import voor de hele Plek, en selecteer Import starten. Dit item wordt alleen aan eigenaren getoond, en niet in threads.
- Bevestig Importmodus starten?. Voxt voert ongeveer tien seconden een paar laatste controles uit ("Importmodus wordt gestart"). Als iemand tijdens het starten een bericht heeft geplaatst, vraagt Voxt je dat bericht te verwijderen en opnieuw te beginnen.
- Het berichtvak wordt voor iedereen vervangen door Onderhoudsmodus.



Een assistent met de MCP-importtools kan hetzelfde doen met start_import. De tool doet niets tenzij de aanroep aangeeft dat jij hebt bevestigd, omdat het plaatsen van berichten voor elk lid stopt.
De leden vragen de import toe te staan
Het bevestigingsdialoogvenster, de toestemming van de leden en het beëindigen van de import staan in De geschiedenis van een chat importeren. In het kort:
- Elk lid opent de chat, selecteert Toestaan dat mijn berichten en media tijdens deze sessie worden geïmporteerd en bevestigt Import toestaan?. Een toestemming kan voor die import niet worden ingetrokken. De eigenaar geeft ook toestemming, om zijn eigen berichten te importeren.
- De eigenaar ziet het aandeel leden dat toestemming heeft gegeven ("Toestemming: 100% (3 van 3)") en wie nog ontbreekt.
- Berichten van leden die geen toestemming hebben gegeven, worden geweigerd, dus wacht tot iedereen van wie je de geschiedenis wilt, toestemming heeft gegeven.
Leden kunnen tijdens de import niet in de chat schrijven, dus de eigenaar kan ze daar niet herinneren. Stuur ze in plaats daarvan een bericht in je directe chats; die blijven open. Een assistent kan dit doen: get_import toont de leden die geen toestemming hebben gegeven, elk met de directe chat die je met ze hebt, en de assistent plaatst daar een herinnering en controleert opnieuw tot het gewenste aandeel toestemming heeft gegeven.
Ruimte maken voor oudere geschiedenis
Als de geschiedenis ouder is dan berichten die al in de chat staan, bijvoorbeeld de systeemberichten die leden die lid worden vastleggen, verwijder die dan eerst. Met de MCP-tools verwijdert wipe_history de berichten van de chat vanaf een gekozen bericht (standaard alle), alleen terwijl de import loopt en alleen voor eigenaren, en keert terug zodra ze zijn verwijderd; remove_message verwijdert één bericht. Beide werken tijdens een import. Wissen kan niet ongedaan worden gemaakt, dus laat het de eigenaar bevestigen voordat het wordt uitgevoerd. Wis niet opnieuw nadat de berichten zijn geïmporteerd: dan worden ook die verwijderd.
De berichten verzenden
Zolang de importmodus aanstaat, verzendt de assistent of het programma van de eigenaar de geschiedenis:
- Lees de huidige import (
get_import); die bevat de import-ID die elke aanroep nodig heeft. - Upload eerst bijlagen, voor het lid dat ze heeft verzonden; dat lid moet toestemming hebben gegeven. Elke upload hoort bij één bericht.
- Verzend berichten in batches van 1 tot 100, oudste eerst. Elk bericht heeft de auteur, de oorspronkelijke tijd, de tekst (tot 64 KB), maximaal 10 bijlagen en eventueel het bericht waarop het antwoordt. Een batch heeft een eigen ID: dezelfde batch opnieuw verzenden geeft het eerdere resultaat terug, zodat een nieuwe poging na een netwerkfout geen berichten dubbel plaatst.
- Een antwoord kan alleen verwijzen naar een bericht dat al in de chat staat, dus verzend dat bericht eerst, in een eerdere batch, en gebruik de teruggegeven ID.
- Verzend bij een import voor een hele Plek elk bericht naar de specifieke chat van de Plek waartoe het behoort. Controleer het resultaat van elk bericht. Een batch kan gedeeltelijk slagen: een geweigerd bericht komt terug met de reden (bijvoorbeeld "Dit lid heeft geen toestemming gegeven voor import.") en de andere worden opgeslagen.
De MCP-tools voor deze stappen worden beschreven in Geschiedenis importeren. Dezelfde service is voor programma's beschikbaar via de RPC API, met de gegevenstypen in Gegevenstypen voor import. post_message van MCP is geen import: het plaatst als jou, gedateerd op nu.
De importmodus beëindigen
Als alle berichten zijn verzonden, selecteert de eigenaar Import beëindigen in de app, of roept de assistent end_import aan. Leden kunnen weer berichten plaatsen en de geïmporteerde geschiedenis staat boven het eerste nieuwe bericht. Leden die nooit toestemming hebben gegeven, hebben gewoon geen geïmporteerde berichten.
Scroll na de import door de chat om hem te controleren: de berichten tonen hun oorspronkelijke auteurs en datums en het eerste nieuwe bericht volgt erna. Vergelijk een paar berichten met de bron en lees de lijst met geweigerde berichten als je assistent er een heeft bijgehouden. Nog beter is het om de geïmporteerde berichten terug te lezen voordat je de importmodus beëindigt, zolang je de ontbrekende nog kunt verzenden.

Voorbeeld: een Telegram-export importeren
De hele import kan worden gedaan door een assistent die via MCP met Voxt is verbonden en de exportmap op je computer kan lezen, zoals Claude Code of een andere assistent met bestandstoegang. Je hebt geen eigen programma nodig. Een assistent die alleen chat biedt en je bestanden niet kan lezen, kan het niet.
Voordat je begint:
- Exporteer de chat in Telegram Desktop: open de chat, kies Export chat history, kies Machine-readable JSON en voeg foto's en bestanden toe als je ze wilt. De exportmap bevat
result.jsonen mappen zoalsphotosenfiles. - Maak de Voxt-groepschat en voeg de mensen toe die in de Telegram-chat hebben geschreven. Ieder van hen heeft een Voxt-account nodig en moet lid zijn. Telegram-namen zonder Voxt-lid kunnen niet worden geïmporteerd.
- Bepaal hoe de assistent zich aanmeldt: met een API-sleutel, of met je Voxt-account via OAuth (hieronder).
- Voeg Voxt als MCP-server toe aan je assistent (hieronder).
Voxt als MCP-server toevoegen
Het serveradres is https://voxt.ai/mcp. Er zijn twee manieren om je aan te melden. In beide gevallen handelt de assistent namens jou.
Met een API-sleutel. Maak een sleutel in Voxt (Instellingen → API en apps → API-sleutel maken) en geef die mee in een Authorization: Bearer-header. Voer in Claude Code uit:
claude mcp add --transport http voxt https://voxt.ai/mcp --header "Authorization: Bearer $VOXT_API_KEY"Stel eerst VOXT_API_KEY in je terminal in, zodat de sleutel niet in een prompt of bestand verschijnt.
Met OAuth. Laat de header en de sleutel weg:
claude mcp add --transport http voxt https://voxt.ai/mcpStart daarna Claude Code, voer /mcp uit, selecteer voxt en kies voor authenticeren. Er opent een browservenster met de toestemmingspagina van Voxt; keur de toegang goed en de assistent is verbonden, zonder sleutel om te maken of te bewaren.
Andere assistenten hebben een instellingenpagina voor externe MCP-servers of connectors waar je hetzelfde adres invoert, en ofwel de header ofwel de aanmelding. MCP beschrijft beide manieren. Vraag de assistent je Voxt-chats op te sommen om te controleren of de verbinding werkt.
De instructie geven
Geef de assistent een instructie zoals deze. Vervang de map en de chatnaam.
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.Opmerkingen bij het voorbeeld:
- Telegram slaat de tijd van een bericht op zonder tijdzone. Controleer de eerste geïmporteerde berichten aan de hand van de oorspronkelijke chat voordat je de rest verzendt.
- Geweigerde berichten stoppen de batch niet. Los de oorzaak op (een ontbrekend lid, een afzender die de import niet heeft toegestaan, een tijd die niet in de juiste volgorde staat) en verzend ze opnieuw in een nieuwe batch.
- Berichten die niet kunnen worden gekoppeld, worden weggelaten, dus bewaar de Telegram-export als je het volledige archief nodig hebt.
- Elk bestand reist in stukken van 1 MB via de assistent, dus een chat met veel grote bestanden vergt veel aanroepen. Alleen tekst gaat snel.
Gerelateerde gidsen
- Chats voor het perspectief van een lid op de importmodus.
- MCP en de bijbehorende toolreferentie.
- RPC API.