Importation et exportation
Voxt n'a pas de bouton « exporter la discussion » ou « importer la discussion » qui produit ou lit un fichier. Les données circulent par les deux interfaces programmatiques :
- L'exportation lit les messages, les pièces jointes, les membres et les résumés d'une discussion via MCP ou l'API RPC.
- L'importation ajoute à une discussion un historique antérieur venant d'un autre service. Le propriétaire démarre le mode importation, les membres donnent leur accord, et les messages sont envoyés avec les outils d'importation MCP ou le service d'importation de l'API RPC. Dans les deux cas, le propriétaire peut mener tout le processus depuis un assistant.
Exporter une discussion
L'exportation nécessite une clé API ou une connexion OAuth. L'assistant ou le script agit en votre nom : il peut donc lire exactement les discussions que vous pouvez lire, et rien d'autre.
- Créez une clé API, ou connectez un assistant avec le flux OAuth, comme décrit dans MCP.
- Demandez l'exportation à votre assistant, par exemple : « Lis tous les messages de la discussion Trip photos et enregistre-les dans un fichier Markdown avec les dates et les auteurs. » L'assistant choisit les outils ; vous n'avez pas besoin d'en connaître les noms.
- Pour un script, appelez directement les outils. La référence des outils les liste avec leurs arguments.
Ce qui peut être lu :
| Données | Outils | Remarques |
|---|---|---|
| Messages | list_messages, get_id_range | Du plus ancien au plus récent, jusqu'à 1 024 messages par appel. Continuez à partir de l'ID du dernier message jusqu'à ce que plus rien ne soit renvoyé. Les messages supprimés sont omis. |
| Messages épinglés et réactions | list_pinned_messages, list_reactions | |
| Photos, vidéos, fichiers et liens | list_media, list_files, list_links | Groupés par mois, le mois le plus récent d'abord. Chaque pièce jointe porte une URL de contenu. |
| Membres | list_members, list_place_members | |
| Discussions et lieux | list_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_place | Utilisez-les pour trouver ce qu'il faut exporter. Les discussions que vous avez archivées ne sont listées que par list_archived_chats. |
| Résumés | list_conversations, get_conversation | Périodes résumées d'une discussion, comme une session vocale. |
| Résultats de recherche | search_messages, search_contacts |
À savoir avant d'exporter une grande discussion :
- Les outils renvoient des pages, pas un fichier. L'assistant ou le script assemble le résultat.
- Un message qui est encore en cours de diffusion n'a pas encore de texte. Relisez cette partie plus tard.
- Les modifications et suppressions de messages que vous avez déjà lus ne sont pas signalées. Relisez la plage si la discussion est encore active.
Importer un historique dans une discussion
Utilisez le mode importation pour faire venir une conversation d'un autre service dans une discussion de groupe ou un lieu Voxt. Les messages sont enregistrés sous leurs auteurs d'origine et leurs dates d'origine, de sorte que la discussion se lit comme si elle avait toujours été dans Voxt.
À savoir d'abord :
- Seul le propriétaire de la discussion ou du lieu peut démarrer et terminer une importation.
- Cela fonctionne pour les discussions de groupe et pour les lieux. Une importation à l'échelle d'un lieu couvre toutes les discussions du lieu. On ne peut pas importer dans les discussions directes.
- Chaque auteur doit être un membre actuel de la discussion et doit donner son accord. Les messages d'une personne qui n'a pas donné son accord, qui est partie ou qui n'est pas membre sont rejetés.
- Les messages importés doivent être datés dans le passé, chacun après le précédent, et après le message le plus récent que la discussion contient déjà. Les messages système comptent, comme l'arrivée de membres : dans une discussion de groupe, l'historique doit donc être daté après l'arrivée de ses membres. Seuls les messages encore présents dans la discussion comptent : on ne peut donc pas insérer d'historique avant des messages qui y sont, mais on peut s'y adapter : pendant l'importation, le propriétaire peut effacer l'historique de la discussion, ou supprimer des messages isolés, puis importer un historique aussi ancien que les messages effacés. Un effacement pendant une importation est irréversible et ne publie aucune note « historique effacé ».
- Personne ne peut publier tant que le mode importation est activé, propriétaire compris. Une importation à l'échelle d'un lieu empêche de publier dans toutes les discussions du lieu.
- Les messages importés n'envoient pas de notifications.
Démarrer le mode importation
Dans l'application :
- Ouvrez les paramètres de la discussion (sur un écran étroit, sélectionnez le bouton à trois points de l'en-tête de la discussion, puis Modifier la discussion ; sur un écran large, ouvrez le panneau de droite et sélectionnez le bouton de modification de son en-tête), ou du lieu pour une importation à l'échelle du lieu, et sélectionnez Démarrer l’importation. L'entrée n'est affichée qu'aux propriétaires, et pas dans les fils.
- Confirmez Démarrer le mode importation ?. Voxt effectue quelques vérifications finales pendant une dizaine de secondes (« Passage en mode importation »). Si quelqu'un a publié un message pendant le démarrage, Voxt vous demande de supprimer ce message et de recommencer.
- La zone de message est remplacée par Mode maintenance pour tout le monde.



Un assistant disposant des outils d'importation MCP peut faire de même avec start_import. L'outil ne fait rien si l'appel n'indique pas que vous avez confirmé, car il empêche tous les membres de publier.
Demander aux membres d'autoriser l'importation
La boîte de dialogue de confirmation, l'accord des membres et la fin de l'importation sont présentés dans Importer l'historique d'une discussion. En résumé :
- Chaque membre ouvre la discussion, sélectionne Autoriser l’importation de mes messages et médias pendant cette session et confirme Autoriser l'importation ?. Un accord ne peut pas être révoqué pour cette importation. Le propriétaire donne aussi son accord, pour importer ses propres messages.
- Le propriétaire voit la part des membres qui ont donné leur accord (« Accord donné : 100 % (3 sur 3) ») et ceux qui manquent encore.
- Les messages des membres qui n'ont pas donné leur accord sont rejetés : attendez donc que tous ceux dont vous voulez l'historique aient donné leur accord.
Les membres ne peuvent pas écrire dans la discussion pendant l'importation, le propriétaire ne peut donc pas les relancer à cet endroit. Écrivez-leur plutôt dans vos discussions directes ; elles restent ouvertes. Un assistant peut le faire : get_import liste les membres qui n'ont pas donné leur accord, chacun avec la discussion directe que vous avez avec lui, et l'assistant y publie un rappel puis vérifie de nouveau jusqu'à ce que la part souhaitée ait donné son accord.
Faire de la place pour un historique plus ancien
Si l'historique est plus ancien que des messages déjà présents dans la discussion, par exemple les messages système qui enregistrent l'arrivée de membres, supprimez-les d'abord. Avec les outils MCP, wipe_history supprime les messages de la discussion à partir d'un message choisi (par défaut, tous), uniquement pendant que l'importation est en cours et uniquement pour les propriétaires, et ne rend la main qu'une fois les messages supprimés ; remove_message supprime un seul message. Les deux fonctionnent pendant une importation. Un effacement est irréversible : faites-le confirmer par le propriétaire avant de l'exécuter. N'effacez pas de nouveau après l'importation des messages : cela les supprimerait aussi.
Envoyer les messages
Tant que le mode importation est activé, l'assistant ou le programme du propriétaire envoie l'historique :
- Lisez l'importation en cours (
get_import) ; elle contient l'ID d'importation que chaque appel exige. - Envoyez d'abord les pièces jointes, pour le membre qui les a envoyées ; ce membre doit avoir donné son accord. Chaque envoi se rattache à un seul message.
- Envoyez les messages par lots de 1 à 100, du plus ancien au plus récent. Chaque message a l'auteur, l'heure d'origine, le texte (jusqu'à 64 Ko), jusqu'à 10 pièces jointes et, facultativement, le message auquel il répond. Un lot a son propre ID : renvoyer le même lot renvoie le résultat précédent, de sorte qu'une nouvelle tentative après une erreur réseau ne duplique pas les messages.
- Une réponse ne peut désigner qu'un message déjà présent dans la discussion : envoyez donc d'abord ce message, dans un lot précédent, et utilisez l'ID renvoyé.
- Dans une importation à l'échelle d'un lieu, envoyez chaque message à la discussion précise du lieu à laquelle il appartient. Vérifiez le résultat de chaque message. Un lot peut réussir en partie : un message rejeté revient avec la raison (par exemple « Ce membre n'a pas donné son accord pour l'importation. »), et les autres sont enregistrés.
Les outils MCP pour ces étapes sont décrits dans Import history. Le même service est disponible pour les programmes via l'API RPC, avec les types de données dans Imports data types. Le post_message de MCP n'est pas une importation : il publie en votre nom, avec la date du moment.
Terminer le mode importation
Quand tous les messages sont envoyés, le propriétaire sélectionne Terminer l’importation dans l'application, ou l'assistant appelle end_import. Les membres peuvent de nouveau publier, et l'historique importé se place au-dessus du premier nouveau message. Les membres qui n'ont jamais donné leur accord n'ont simplement aucun message importé.
Après l'importation, parcourez la discussion pour la vérifier : les messages affichent leurs auteurs et dates d'origine, et le premier nouveau message vient ensuite. Comparez quelques messages avec la source, et lisez la liste des messages rejetés si votre assistant en a gardé une. Mieux encore, relisez les messages importés avant de terminer le mode importation, tant que vous pouvez encore envoyer ceux qui manquent.

Exemple : importer un export Telegram
Toute l'importation peut être faite par un assistant connecté à Voxt via MCP et capable de lire le dossier d'export sur votre ordinateur, comme Claude Code ou un autre assistant avec accès aux fichiers. Vous n'avez besoin d'aucun programme personnel. Un assistant limité au chat, qui ne peut pas lire vos fichiers, ne peut pas le faire.
Avant de commencer :
- Dans Telegram Desktop, exportez la discussion : ouvrez la discussion, choisissez Export chat history, sélectionnez Machine-readable JSON et incluez les photos et les fichiers si vous le souhaitez. Le dossier d'export contient
result.jsonet des dossiers commephotosetfiles. - Créez la discussion de groupe Voxt et ajoutez les personnes qui ont écrit dans la discussion Telegram. Chacune a besoin d'un compte Voxt et doit être membre. Les noms Telegram sans membre Voxt correspondant ne peuvent pas être importés.
- Décidez comment l'assistant se connecte : avec une clé API, ou avec votre compte Voxt via OAuth (ci-dessous).
- Ajoutez Voxt à votre assistant comme serveur MCP (ci-dessous).
Ajouter Voxt comme serveur MCP
L'adresse du serveur est https://voxt.ai/mcp. Il y a deux façons de se connecter. Dans les deux cas, l'assistant agit en votre nom.
Avec une clé API. Créez une clé dans Voxt (Paramètres → API et applications → Créer une clé API) et transmettez-la dans un en-tête Authorization: Bearer. Dans Claude Code, exécutez :
claude mcp add --transport http voxt https://voxt.ai/mcp --header "Authorization: Bearer $VOXT_API_KEY"Définissez d'abord VOXT_API_KEY dans votre terminal, pour que la clé n'apparaisse pas dans une invite ni dans un fichier.
Avec OAuth. Omettez l'en-tête et la clé :
claude mcp add --transport http voxt https://voxt.ai/mcpLancez ensuite Claude Code, exécutez /mcp, sélectionnez voxt et choisissez de vous authentifier. Une fenêtre de navigateur s'ouvre avec la page de consentement de Voxt ; approuvez l'accès et l'assistant est connecté, sans clé à créer ni à conserver.
D'autres assistants ont une page de paramètres pour les serveurs MCP distants ou les connecteurs, où vous saisissez la même adresse, ainsi que l'en-tête ou la connexion. MCP décrit les deux façons. Demandez à l'assistant de lister vos discussions Voxt pour vérifier que la connexion fonctionne.
Donner la consigne
Donnez à l'assistant une consigne comme celle-ci. Remplacez le dossier et le nom de la discussion.
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.Remarques sur l'exemple :
- Telegram enregistre l'heure d'un message sans fuseau horaire. Comparez les premiers messages importés avec la discussion d'origine avant d'envoyer le reste.
- Les messages rejetés n'arrêtent pas le lot. Corrigez la cause (un membre manquant, un expéditeur qui n'a pas autorisé l'importation, une heure hors séquence) et renvoyez-les dans un nouveau lot.
- Les messages qui ne peuvent pas être associés sont omis : conservez donc l'export Telegram si vous avez besoin de l'archive complète.
- Chaque fichier transite par morceaux de 1 Mo via l'assistant : une discussion avec beaucoup de gros fichiers demande donc beaucoup d'appels. Le texte seul est rapide.
Guides associés
- Discussions pour la vue du membre sur le mode importation.
- MCP et sa référence des outils.
- API RPC.