Vai al contenuto

Importazione ed esportazione ​

Voxt non ha un pulsante "esporta chat" o "importa chat" che produca o legga un file. I dati si spostano tramite le due interfacce programmatiche:

  • Esportare significa leggere i messaggi, gli allegati, i membri e i riepiloghi di una chat tramite MCP o l'API RPC.
  • Importare significa aggiungere a una chat la cronologia precedente di un altro servizio. Il proprietario avvia la modalità importazione, i membri danno il consenso e i messaggi vengono inviati con gli strumenti di importazione MCP o con il servizio di importazione dell'API RPC. In entrambi i casi il proprietario può eseguire l'intero processo da un assistente.

Esporta una chat ​

Per esportare servono una chiave API o un accesso OAuth. L'assistente o lo script agisce come te, quindi può leggere esattamente le chat che puoi leggere tu, e nient'altro.

  1. Crea una chiave API, oppure collega un assistente con il flusso OAuth, come descritto in MCP.
  2. Chiedi l'esportazione al tuo assistente, per esempio: "Leggi tutti i messaggi della chat Foto del viaggio e salvali in un file Markdown con date e autori." L'assistente sceglie gli strumenti; non devi conoscerne i nomi.
  3. Per uno script, chiama direttamente gli strumenti. Il riferimento degli strumenti li elenca con i loro argomenti.

Cosa si può leggere:

DatiStrumentiNote
Messaggilist_messages, get_id_rangeDal più vecchio, fino a 1.024 messaggi per chiamata. Continua dall'ID dell'ultimo messaggio finché non viene restituito più nulla. I messaggi rimossi sono omessi.
Messaggi fissati e reazionilist_pinned_messages, list_reactions
Foto, video, file e linklist_media, list_files, list_linksRaggruppati per mese, dal mese più recente. Ogni allegato ha un URL del contenuto.
Membrilist_members, list_place_members
Chat e luoghilist_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_placeUsali per trovare cosa esportare. Le chat che hai archiviato sono elencate solo da list_archived_chats.
Riepiloghilist_conversations, get_conversationParti riassunte di una chat, come una sessione vocale.
Risultati di ricercasearch_messages, search_contacts

Cose da sapere prima di esportare una chat grande:

  • Gli strumenti restituiscono pagine, non un file. L'assistente o lo script assembla il risultato.
  • Un messaggio ancora in streaming non ha ancora testo. Rileggi quella parte più tardi.
  • Le modifiche e le rimozioni di messaggi che hai già letto non vengono segnalate. Rileggi l'intervallo se la chat è ancora attiva.

Importa la cronologia in una chat ​

Usa la modalità importazione per portare una conversazione da un altro servizio in una chat di gruppo di Voxt o in un luogo. I messaggi vengono salvati con gli autori e le date originali, così la chat si legge come se fosse sempre stata in Voxt.

Cosa sapere prima:

  • Solo il proprietario della chat o del luogo può avviare e terminare un'importazione.
  • Funziona per le chat di gruppo e per i luoghi. Un'importazione su tutto il luogo riguarda ogni chat del luogo. Non si può importare nelle chat dirette.
  • Ogni autore deve essere un membro attuale della chat e deve dare il consenso. I messaggi di chi non ha dato il consenso, di chi è uscito o di chi non è membro vengono rifiutati.
  • I messaggi importati devono avere una data nel passato, ciascuno successivo al precedente e successivo al messaggio più recente che la chat ha già. Contano anche i messaggi di sistema, come l'ingresso dei membri, quindi in una chat di gruppo la cronologia deve avere date successive all'ingresso dei suoi membri. Contano solo i messaggi ancora presenti nella chat, quindi non si può inserire la cronologia prima di messaggi che ci sono, ma la si può adattare: durante l'importazione il proprietario può cancellare la cronologia della chat, o rimuovere singoli messaggi, e poi si può importare una cronologia anche vecchia quanto i messaggi cancellati. Una cancellazione durante un'importazione non si può annullare e non pubblica nessuna nota "cronologia cancellata".
  • Nessuno può scrivere mentre la modalità importazione è attiva, proprietario compreso. Un'importazione su tutto il luogo impedisce di scrivere in ogni chat del luogo.
  • I messaggi importati non inviano notifiche.

Avvia la modalità importazione ​

Nell'app:

  1. Apri le impostazioni della chat (su uno schermo stretto, seleziona il pulsante a tre puntini nell'intestazione della chat, poi Modifica chat; su uno schermo largo, apri il pannello di destra e seleziona il pulsante di modifica nella sua intestazione), o del luogo per un'importazione su tutto il luogo, e seleziona Avvia importazione. La voce è mostrata solo ai proprietari, e non nei thread.
  2. Conferma Avviare la modalità importazione?. Voxt esegue alcuni controlli finali per circa dieci secondi ("Attivazione della modalità importazione"). Se qualcuno ha scritto un messaggio mentre partiva, Voxt ti chiede di rimuovere quel messaggio e di ricominciare.
  3. Per tutti, la casella dei messaggi viene sostituita da Modalità manutenzione.
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.

Un assistente con gli strumenti di importazione MCP può fare lo stesso con start_import. Lo strumento non fa nulla se la chiamata non indica che hai confermato, perché impedisce di scrivere a tutti i membri.

Chiedi ai membri di consentire l'importazione ​

La finestra di conferma, il consenso dei membri e la conclusione dell'importazione sono mostrati in Importa la cronologia di una chat. In breve:

  1. Ogni membro apre la chat, seleziona Consenti l’importazione dei miei messaggi e contenuti multimediali durante questa sessione e conferma Consentire l'importazione?. Un consenso non può essere revocato per quell'importazione. Anche il proprietario dà il consenso, per importare i propri messaggi.
  2. Il proprietario vede la quota di membri che hanno acconsentito ("Consenso dato: 100% (3 su 3)") e chi manca ancora.
  3. I messaggi dei membri che non hanno acconsentito vengono rifiutati, quindi aspetta che abbiano acconsentito tutti quelli di cui vuoi la cronologia.

I membri non possono scrivere nella chat durante l'importazione, quindi il proprietario non può ricordarglielo lì. Scrivi loro nelle vostre chat dirette, che restano aperte. Un assistente può farlo: get_import elenca i membri che non hanno acconsentito, ciascuno con la chat diretta che hai con lui, e l'assistente scrive lì un promemoria e ricontrolla finché la quota che vuoi non ha acconsentito.

Fai spazio alla cronologia più vecchia ​

Se la cronologia è più vecchia di messaggi già presenti nella chat, per esempio i messaggi di sistema che registrano l'ingresso dei membri, rimuovili prima. Con gli strumenti MCP, wipe_history rimuove i messaggi della chat a partire da un messaggio scelto (per impostazione predefinita tutti), solo mentre l'importazione è in corso e solo per i proprietari, e termina quando sono stati eliminati; remove_message rimuove un singolo messaggio. Entrambi funzionano durante un'importazione. La cancellazione non si può annullare, quindi confermala con il proprietario prima che venga eseguita. Non cancellare di nuovo dopo aver importato i messaggi: rimuoverebbe anche quelli.

Invia i messaggi ​

Mentre la modalità importazione è attiva, l'assistente o il programma del proprietario invia la cronologia:

  1. Leggi l'importazione corrente (get_import); contiene l'ID dell'importazione che serve a ogni chiamata.
  2. Carica prima gli allegati, a nome del membro che li ha inviati; quel membro deve aver acconsentito. Ogni caricamento si collega a un solo messaggio.
  3. Invia i messaggi in lotti da 1 a 100, dal più vecchio. Ogni messaggio ha l'autore, l'ora originale, il testo (fino a 64 KB), fino a 10 allegati e, facoltativamente, il messaggio a cui risponde. Un lotto ha un proprio ID: inviare di nuovo lo stesso lotto restituisce il risultato precedente, quindi un nuovo tentativo dopo un errore di rete non duplica i messaggi.
  4. Una risposta può puntare solo a un messaggio già presente nella chat, quindi invia prima il messaggio, in un lotto precedente, e usa l'ID restituito.
  5. In un'importazione su tutto il luogo, invia ogni messaggio alla chat specifica del luogo a cui appartiene. Controlla il risultato di ogni messaggio. Un lotto può riuscire in parte: un messaggio rifiutato torna con il motivo (per esempio "This member has not consented to import."), e gli altri vengono salvati.

Gli strumenti MCP per questi passaggi sono descritti in Importa la cronologia. Lo stesso servizio è disponibile ai programmi tramite l'API RPC, con i tipi di dati in Tipi di dati di importazione. post_message di MCP non è un'importazione: scrive a tuo nome, con la data di adesso.

Termina la modalità importazione ​

Quando tutti i messaggi sono inviati, il proprietario seleziona Termina importazione nell'app, oppure l'assistente chiama end_import. I membri possono di nuovo scrivere, e la cronologia importata sta sopra il primo messaggio nuovo. I membri che non hanno mai acconsentito semplicemente non hanno messaggi importati.

Dopo l'importazione, scorri la chat per controllarla: i messaggi mostrano i loro autori e le loro date originali, e il primo messaggio nuovo li segue. Confronta alcuni messaggi con l'originale e leggi l'elenco dei messaggi rifiutati se il tuo assistente ne ha tenuto uno. Meglio ancora, rileggi i messaggi importati prima di terminare la modalità importazione, quando puoi ancora inviare quelli mancanti.

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

Esempio: importa un'esportazione di Telegram ​

L'intera importazione può essere eseguita da un assistente collegato a Voxt tramite MCP e in grado di leggere la cartella di esportazione sul tuo computer, come Claude Code o un altro assistente con accesso ai file. Non serve un programma tuo. Un assistente solo chat che non può leggere i tuoi file non può farlo.

Prima di iniziare:

  1. In Telegram Desktop, esporta la chat: apri la chat, scegli Esporta cronologia chat, scegli JSON leggibile da macchina e includi foto e file se li vuoi. La cartella di esportazione contiene result.json e cartelle come photos e files.
  2. Crea la chat di gruppo di Voxt e aggiungi le persone che hanno scritto nella chat di Telegram. Ognuna ha bisogno di un account Voxt e deve essere membro. I nomi di Telegram senza un membro Voxt non possono essere importati.
  3. Decidi come accede l'assistente: con una chiave API, oppure con il tuo account Voxt tramite OAuth (sotto).
  4. Aggiungi Voxt al tuo assistente come server MCP (sotto).

Aggiungi Voxt come server MCP ​

L'indirizzo del server è https://voxt.ai/mcp. Ci sono due modi per accedere. In entrambi, l'assistente agisce come te.

Con una chiave API. Crea una chiave in Voxt (Impostazioni → API e app → Crea chiave API) e passala in un'intestazione Authorization: Bearer. In Claude Code, esegui:

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

Imposta prima VOXT_API_KEY nel tuo terminale, così la chiave non compare in un prompt o in un file.

Con OAuth. Lascia fuori l'intestazione e la chiave:

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

Poi avvia Claude Code, esegui /mcp, seleziona voxt e scegli di autenticarti. Si apre una finestra del browser con la pagina di consenso di Voxt; approva l'accesso e l'assistente è collegato, senza chiavi da creare o conservare.

Altri assistenti hanno una pagina di impostazioni per i server MCP remoti o i connettori dove inserisci lo stesso indirizzo, e l'intestazione oppure l'accesso. MCP descrive entrambi i modi. Chiedi all'assistente di elencare le tue chat di Voxt per verificare che il collegamento funzioni.

Dai l'istruzione ​

Dai all'assistente un'istruzione come questa. Sostituisci la cartella e il nome della chat.

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.

Note sull'esempio:

  • Telegram salva l'ora di un messaggio senza fuso orario. Confronta i primi messaggi importati con la chat originale prima di inviare il resto.
  • I messaggi rifiutati non bloccano il lotto. Correggi la causa (un membro mancante, un mittente che non ha consentito l'importazione, un'ora fuori ordine) e inviali di nuovo in un nuovo lotto.
  • I messaggi che non si possono associare vengono lasciati fuori, quindi conserva l'esportazione di Telegram se ti serve la registrazione completa.
  • Ogni file viaggia a pezzi da 1 MB tramite l'assistente, quindi una chat con molti file grandi richiede molte chiamate. Il solo testo è rapido.