Import und Export
Voxt hat keine Schaltfläche „Chat exportieren“ oder „Chat importieren“, die eine Datei erzeugt oder liest. Daten bewegen sich über die beiden programmatischen Schnittstellen:
- Export liest die Nachrichten, Anhänge, Mitglieder und Zusammenfassungen eines Chats über MCP oder die RPC-API.
- Import fügt einem Chat frühere Verläufe aus einem anderen Dienst hinzu. Der Inhaber startet den Import-Modus, die Mitglieder stimmen zu, und die Nachrichten werden über die MCP-Importwerkzeuge oder den Import-Dienst der RPC-API gesendet. In beiden Fällen kann der Inhaber den ganzen Vorgang von einem Assistenten aus durchführen.
Einen Chat exportieren
Für den Export brauchen Sie einen API-Schlüssel oder eine OAuth-Anmeldung. Der Assistent oder das Skript handelt als Sie, kann also genau die Chats lesen, die Sie lesen können, und nichts anderes.
- Erstellen Sie einen API-Schlüssel oder verbinden Sie einen Assistenten mit dem OAuth-Ablauf, wie unter MCP beschrieben.
- Bitten Sie Ihren Assistenten um den Export, zum Beispiel: „Lies alle Nachrichten des Chats Trip photos und speichere sie als Markdown-Datei mit Datum und Autoren.“ Der Assistent wählt die Werkzeuge; Sie müssen ihre Namen nicht kennen.
- Rufen Sie für ein Skript die Werkzeuge direkt auf. Die Werkzeugreferenz listet sie mit ihren Argumenten auf.
Was gelesen werden kann:
| Daten | Werkzeuge | Hinweise |
|---|---|---|
| Nachrichten | list_messages, get_id_range | Älteste zuerst, bis zu 1.024 Nachrichten pro Aufruf. Machen Sie ab der ID der letzten Nachricht weiter, bis nichts mehr zurückkommt. Entfernte Nachrichten werden ausgelassen. |
| Angeheftete Nachrichten und Reaktionen | list_pinned_messages, list_reactions | |
| Fotos, Videos, Dateien und Links | list_media, list_files, list_links | Nach Monat gruppiert, der neueste Monat zuerst. Jeder Anhang hat eine Inhalts-URL. |
| Mitglieder | list_members, list_place_members | |
| Chats und Places | list_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_place | Damit finden Sie, was exportiert werden soll. Chats, die Sie archiviert haben, listet nur list_archived_chats auf. |
| Zusammenfassungen | list_conversations, get_conversation | Zusammengefasste Abschnitte eines Chats, etwa eine Sprachsitzung. |
| Suchergebnisse | search_messages, search_contacts |
Was Sie vor dem Export eines großen Chats wissen sollten:
- Die Werkzeuge liefern Seiten, keine Datei. Der Assistent oder das Skript setzt das Ergebnis zusammen.
- Eine Nachricht, die noch gestreamt wird, hat noch keinen Text. Lesen Sie diesen Teil später erneut.
- Bearbeitungen und Entfernungen von Nachrichten, die Sie bereits gelesen haben, werden nicht gemeldet. Lesen Sie den Bereich erneut, wenn der Chat noch aktiv ist.
Verlauf in einen Chat importieren
Verwenden Sie den Import-Modus, um eine Unterhaltung aus einem anderen Dienst in einen Voxt-Gruppenchat oder einen Place zu bringen. Nachrichten werden unter ihren ursprünglichen Autoren und mit ihren ursprünglichen Daten gespeichert, sodass der Chat sich liest, als wäre er immer in Voxt gewesen.
Was Sie zuerst wissen sollten:
- Nur der Inhaber des Chats oder Places kann einen Import starten und beenden.
- Er funktioniert für Gruppenchats und für Places. Ein Import für den ganzen Place umfasst jeden Chat im Place. In Direktchats kann nicht importiert werden.
- Jeder Autor muss ein aktuelles Mitglied des Chats sein und zustimmen. Nachrichten von jemandem, der nicht zugestimmt hat, der gegangen ist oder der kein Mitglied ist, werden abgelehnt.
- Importierte Nachrichten müssen in der Vergangenheit datiert sein, jede später als die davor und später als die neueste Nachricht, die der Chat bereits hat. Systemnachrichten zählen mit, etwa wenn Mitglieder beitreten; in einem Gruppenchat muss der Verlauf also nach dem Beitritt seiner Mitglieder datiert sein. Es zählen nur Nachrichten, die noch im Chat sind: Verlauf kann nicht vor dort vorhandene Nachrichten eingefügt werden, aber man kann Platz schaffen. Während des Imports kann der Inhaber den Verlauf des Chats löschen oder einzelne Nachrichten entfernen, und danach kann Verlauf importiert werden, der so alt ist wie die gelöschten Nachrichten. Ein Löschen während eines Imports kann nicht rückgängig gemacht werden und erzeugt keinen Hinweis „Verlauf gelöscht“.
- Solange der Import-Modus an ist, kann niemand schreiben, auch der Inhaber nicht. Ein Import für den ganzen Place stoppt das Schreiben in jedem Chat des Places.
- Importierte Nachrichten senden keine Benachrichtigungen.
Import-Modus starten
In der App:
- Öffnen Sie die Einstellungen des Chats (wählen Sie auf einem schmalen Bildschirm die Drei-Punkte-Schaltfläche in der Chat-Kopfzeile und dann Chat bearbeiten; öffnen Sie auf einem breiten Bildschirm das rechte Panel und wählen Sie die Bearbeiten-Schaltfläche in dessen Kopfzeile), bzw. des Places für einen Import im ganzen Place, und wählen Sie Import starten. Der Eintrag wird nur Inhabern angezeigt, und nicht in Threads.
- Bestätigen Sie Import-Modus starten?. Voxt führt etwa zehn Sekunden lang einige abschließende Prüfungen durch („Import-Modus wird aktiviert“). Wenn jemand beim Start eine Nachricht gesendet hat, bittet Voxt Sie, diese Nachricht zu entfernen und erneut zu starten.
- Das Nachrichtenfeld wird für alle durch Wartungsmodus ersetzt.



Ein Assistent mit den MCP-Importwerkzeugen kann dasselbe mit start_import tun. Das Werkzeug tut nichts, wenn der Aufruf nicht angibt, dass Sie bestätigt haben, weil es das Schreiben für jedes Mitglied stoppt.
Die Mitglieder um Erlaubnis für den Import bitten
Der Bestätigungsdialog, die Zustimmung der Mitglieder und das Beenden des Imports werden unter Verlauf eines Chats importieren gezeigt. Kurz gesagt:
- Jedes Mitglied öffnet den Chat, wählt Import meiner Nachrichten und Medien während dieser Sitzung erlauben und bestätigt Import erlauben?. Eine Zustimmung kann für diesen Import nicht widerrufen werden. Auch der Inhaber stimmt zu, um seine eigenen Nachrichten zu importieren.
- Der Inhaber sieht den Anteil der Mitglieder, die zugestimmt haben („Zugestimmt: 100 % (3 von 3)“), und wer noch fehlt.
- Nachrichten von Mitgliedern, die nicht zugestimmt haben, werden abgelehnt. Warten Sie also, bis alle zugestimmt haben, deren Verlauf Sie möchten.
Mitglieder können während des Imports nicht im Chat schreiben, der Inhaber kann sie dort also nicht erinnern. Schreiben Sie ihnen stattdessen in Ihren Direktchats; diese bleiben offen. Ein Assistent kann das übernehmen: get_import listet die Mitglieder auf, die nicht zugestimmt haben, jeweils mit dem Direktchat, den Sie mit ihnen haben, und der Assistent schreibt dort eine Erinnerung und prüft erneut, bis der gewünschte Anteil zugestimmt hat.
Platz für älteren Verlauf schaffen
Wenn der Verlauf älter ist als Nachrichten, die bereits im Chat sind, zum Beispiel die Systemnachrichten, die den Beitritt von Mitgliedern festhalten, entfernen Sie diese zuerst. Mit den MCP-Werkzeugen entfernt wipe_history die Nachrichten des Chats ab einer gewählten Nachricht (standardmäßig alle), nur während der Import läuft und nur für Inhaber, und kehrt zurück, sobald sie gelöscht sind; remove_message entfernt eine einzelne Nachricht. Beide funktionieren während eines Imports. Das Löschen kann nicht rückgängig gemacht werden, bestätigen Sie es also mit dem Inhaber, bevor es ausgeführt wird. Löschen Sie nicht erneut, nachdem die Nachrichten importiert sind: Das würde sie ebenfalls entfernen.
Die Nachrichten senden
Solange der Import-Modus an ist, sendet der Assistent oder das Programm des Inhabers den Verlauf:
- Lesen Sie den aktuellen Import (
get_import); er enthält die Import-ID, die jeder Aufruf braucht. - Laden Sie Anhänge zuerst hoch, für das Mitglied, das sie gesendet hat; dieses Mitglied muss zugestimmt haben. Jeder Upload wird an eine Nachricht angehängt.
- Senden Sie Nachrichten in Stapeln von 1 bis 100, älteste zuerst. Jede Nachricht hat den Autor, die ursprüngliche Zeit, den Text (bis zu 64 KB), bis zu 10 Anhänge und optional die Nachricht, auf die sie antwortet. Ein Stapel hat eine eigene ID: Wenn Sie denselben Stapel erneut senden, wird das frühere Ergebnis zurückgegeben, sodass ein erneuter Versuch nach einem Netzwerkfehler keine Nachrichten dupliziert.
- Eine Antwort kann nur auf eine Nachricht zeigen, die bereits im Chat ist. Senden Sie die Nachricht also zuerst, in einem früheren Stapel, und verwenden Sie die zurückgegebene ID.
- Senden Sie bei einem Import für den ganzen Place jede Nachricht an den bestimmten Chat des Places, zu dem sie gehört. Prüfen Sie das Ergebnis jeder Nachricht. Ein Stapel kann teilweise gelingen: Eine abgelehnte Nachricht kommt mit dem Grund zurück (zum Beispiel „Dieses Mitglied hat dem Import nicht zugestimmt.“), und die anderen werden gespeichert.
Die MCP-Werkzeuge für diese Schritte sind unter Verlauf importieren beschrieben. Derselbe Dienst steht Programmen über die RPC-API zur Verfügung, mit den Datentypen unter Datentypen des Imports. post_message von MCP ist kein Import: Es schreibt als Sie, mit dem aktuellen Datum.
Import-Modus beenden
Wenn alle Nachrichten gesendet sind, wählt der Inhaber in der App Import beenden, oder der Assistent ruft end_import auf. Mitglieder können wieder schreiben, und der importierte Verlauf steht über der ersten neuen Nachricht. Mitglieder, die nie zugestimmt haben, haben einfach keine importierten Nachrichten.
Blättern Sie nach dem Import durch den Chat, um ihn zu prüfen: Die Nachrichten zeigen ihre ursprünglichen Autoren und Daten, und die erste neue Nachricht folgt ihnen. Vergleichen Sie einige Nachrichten mit der Quelle und lesen Sie die Liste der abgelehnten Nachrichten, falls Ihr Assistent eine geführt hat. Noch besser: Lesen Sie die importierten Nachrichten zurück, bevor Sie den Import-Modus beenden, solange Sie die fehlenden noch senden können.

Beispiel: Einen Telegram-Export importieren
Der ganze Import kann von einem Assistenten durchgeführt werden, der über MCP mit Voxt verbunden ist und den Exportordner auf Ihrem Computer lesen kann, etwa Claude Code oder ein anderer Assistent mit Dateizugriff. Er braucht kein eigenes Programm. Ein reiner Chat-Assistent, der Ihre Dateien nicht lesen kann, kann das nicht.
Bevor Sie beginnen:
- Exportieren Sie in Telegram Desktop den Chat: Öffnen Sie den Chat, wählen Sie Chatverlauf exportieren, wählen Sie Maschinenlesbares JSON und schließen Sie Fotos und Dateien ein, wenn Sie sie möchten. Der Exportordner enthält
result.jsonund Ordner wiephotosundfiles. - Erstellen Sie den Voxt-Gruppenchat und fügen Sie die Personen hinzu, die im Telegram-Chat geschrieben haben. Jede braucht ein Voxt-Konto und muss Mitglied sein. Telegram-Namen ohne Voxt-Mitglied können nicht importiert werden.
- Entscheiden Sie, wie sich der Assistent anmeldet: mit einem API-Schlüssel oder mit Ihrem Voxt-Konto über OAuth (unten).
- Fügen Sie Voxt Ihrem Assistenten als MCP-Server hinzu (unten).
Voxt als MCP-Server hinzufügen
Die Serveradresse ist https://voxt.ai/mcp. Es gibt zwei Arten der Anmeldung. In beiden handelt der Assistent als Sie.
Mit einem API-Schlüssel. Erstellen Sie in Voxt einen Schlüssel (Einstellungen → API & Apps → API-Schlüssel erstellen) und übergeben Sie ihn in einem Authorization: Bearer-Header. Führen Sie in Claude Code Folgendes aus:
claude mcp add --transport http voxt https://voxt.ai/mcp --header "Authorization: Bearer $VOXT_API_KEY"Setzen Sie VOXT_API_KEY zuerst in Ihrem Terminal, damit der Schlüssel nicht in einem Prompt oder in einer Datei auftaucht.
Mit OAuth. Lassen Sie den Header und den Schlüssel weg:
claude mcp add --transport http voxt https://voxt.ai/mcpStarten Sie dann Claude Code, führen Sie /mcp aus, wählen Sie voxt und wählen Sie die Authentifizierung. Ein Browserfenster mit der Voxt-Zustimmungsseite öffnet sich; genehmigen Sie den Zugriff, und der Assistent ist verbunden, ohne dass Sie einen Schlüssel erstellen oder aufbewahren müssen.
Andere Assistenten haben eine Einstellungsseite für entfernte MCP-Server oder Konnektoren, auf der Sie dieselbe Adresse und entweder den Header oder die Anmeldung eingeben. MCP beschreibt beide Wege. Bitten Sie den Assistenten, Ihre Voxt-Chats aufzulisten, um zu prüfen, ob die Verbindung funktioniert.
Die Anweisung geben
Geben Sie dem Assistenten eine Anweisung wie diese. Ersetzen Sie den Ordner und den Chatnamen.
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.Hinweise zum Beispiel:
- Telegram speichert die Zeit einer Nachricht ohne Zeitzone. Prüfen Sie die ersten importierten Nachrichten mit dem ursprünglichen Chat, bevor Sie den Rest senden.
- Abgelehnte Nachrichten stoppen den Stapel nicht. Beheben Sie die Ursache (ein fehlendes Mitglied, ein Absender, der den Import nicht erlaubt hat, eine Zeit außerhalb der Reihenfolge) und senden Sie sie in einem neuen Stapel erneut.
- Nachrichten, die nicht zugeordnet werden können, werden ausgelassen. Behalten Sie also den Telegram-Export, wenn Sie die vollständige Aufzeichnung brauchen.
- Jede Datei wird in 1-MB-Stücken über den Assistenten übertragen, ein Chat mit vielen großen Dateien braucht also viele Aufrufe. Nur Text geht schnell.
Weiterführende Anleitungen
- Chats für die Sicht der Mitglieder auf den Import-Modus.
- MCP und seine Werkzeugreferenz.
- RPC-API.