Ir al contenido

Importar y exportar ​

Voxt no tiene un botón "exportar chat" ni "importar chat" que genere o lea un archivo. Los datos se mueven por las dos interfaces programáticas:

  • Exportar lee los mensajes, los archivos adjuntos, los miembros y los resúmenes de un chat mediante MCP o la API RPC.
  • Importar añade a un chat el historial anterior de otro servicio. El propietario inicia el modo de importación, los miembros dan su permiso y los mensajes se envían con las herramientas de importación de MCP o con el servicio de importación de la API RPC. En ambos casos el propietario puede llevar todo el proceso desde un asistente.

Exportar un chat ​

Exportar necesita una clave API o un inicio de sesión con OAuth. El asistente o el script actúa como tú, así que puede leer exactamente los chats que tú puedes leer, y ninguno más.

  1. Crea una clave API, o conecta un asistente con el flujo OAuth, como se describe en MCP.
  2. Pide la exportación a tu asistente, por ejemplo: "Lee todos los mensajes del chat Fotos del viaje y guárdalos en un archivo Markdown con fechas y autores." El asistente elige las herramientas; no necesitas saber sus nombres.
  3. Para un script, llama a las herramientas directamente. La referencia de herramientas las enumera con sus argumentos.

Qué se puede leer:

DatosHerramientasNotas
Mensajeslist_messages, get_id_rangeDel más antiguo al más reciente, hasta 1.024 mensajes por llamada. Continúa desde el ID del último mensaje hasta que no se devuelva nada. Los mensajes eliminados se omiten.
Mensajes fijados y reaccioneslist_pinned_messages, list_reactions
Fotos, vídeos, archivos y enlaceslist_media, list_files, list_linksAgrupados por mes, el mes más reciente primero. Cada archivo adjunto lleva una URL de contenido.
Miembroslist_members, list_place_members
Chats y lugareslist_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_placeÚsalas para encontrar qué exportar. Los chats que archivaste solo los enumera list_archived_chats.
Resúmeneslist_conversations, get_conversationTramos resumidos de un chat, como una sesión de voz.
Resultados de búsquedasearch_messages, search_contacts

Cosas que debes saber antes de exportar un chat grande:

  • Las herramientas devuelven páginas, no un archivo. El asistente o el script monta el resultado.
  • Un mensaje que aún se está transmitiendo todavía no tiene texto. Vuelve a leer esa parte más tarde.
  • Las ediciones y eliminaciones de mensajes que ya leíste no se notifican. Vuelve a leer el intervalo si el chat sigue activo.

Importar historial a un chat ​

Usa el modo de importación para traer una conversación de otro servicio a un chat de grupo o a un lugar de Voxt. Los mensajes se guardan con sus autores y fechas originales, de modo que el chat se lee como si siempre hubiera estado en Voxt.

Qué debes saber primero:

  • Solo el propietario del chat o del lugar puede iniciar y terminar una importación.
  • Funciona con chats de grupo y con lugares. Una importación de todo el lugar abarca todos los chats del lugar. No se puede importar a chats directos.
  • Cada autor debe ser miembro actual del chat y debe dar su permiso. Los mensajes de alguien que no ha dado su permiso, que se ha ido o que no es miembro se rechazan.
  • Los mensajes importados deben tener una fecha pasada, cada uno posterior al anterior y posterior al mensaje más reciente que ya tenga el chat. Los mensajes del sistema cuentan, como la incorporación de miembros, así que en un chat de grupo el historial debe tener fecha posterior a la incorporación de sus miembros. Solo cuentan los mensajes que siguen en el chat, así que no se puede insertar historial antes de los mensajes que hay, pero se puede hacer sitio: durante la importación el propietario puede borrar el historial del chat, o quitar mensajes sueltos, y entonces se puede importar historial tan antiguo como los mensajes borrados. Un borrado durante una importación no se puede deshacer y no publica ninguna nota de "historial borrado".
  • Nadie puede publicar mientras el modo de importación está activado, incluido el propietario. Una importación de todo el lugar impide publicar en todos los chats del lugar.
  • Los mensajes importados no envían notificaciones.

Iniciar el modo de importación ​

En la app:

  1. Abre los ajustes del chat (en una pantalla estrecha, selecciona el botón de tres puntos del encabezado del chat y luego Editar chat; en una pantalla ancha, abre el panel derecho y selecciona el botón de editar de su encabezado), o del lugar si es una importación de todo el lugar, y selecciona Iniciar importación. La entrada solo se muestra a los propietarios, y no en los hilos.
  2. Confirma ¿Iniciar el modo de importación?. Voxt hace unas comprobaciones finales durante unos diez segundos ("Entrando en modo de importación"). Si alguien publicó un mensaje mientras se iniciaba, Voxt te pide que quites ese mensaje y empieces de nuevo.
  3. El cuadro de mensaje se sustituye por Modo de mantenimiento para todos.
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 asistente con las herramientas de importación de MCP puede hacer lo mismo con start_import. La herramienta no hace nada a menos que la llamada indique que lo has confirmado, porque impide publicar a todos los miembros.

Pedir a los miembros que permitan la importación ​

El cuadro de confirmación, el permiso de los miembros y el final de la importación se muestran en Importar el historial de un chat. En resumen:

  1. Cada miembro abre el chat, selecciona Permitir que se importen mis mensajes y archivos durante esta sesión y confirma ¿Permitir la importación?. Un permiso no se puede revocar durante esa importación. El propietario también da su permiso, para importar sus propios mensajes.
  2. El propietario ve la proporción de miembros que dieron su permiso ("Han dado permiso: 100% (3 de 3)") y quién falta todavía.
  3. Los mensajes de los miembros que no han dado su permiso se rechazan, así que espera hasta que hayan aceptado todos aquellos cuyo historial quieras importar.

Los miembros no pueden escribir en el chat durante la importación, así que el propietario no puede recordárselo ahí. Escríbeles en tus chats directos; esos siguen abiertos. Un asistente puede hacerlo: get_import enumera los miembros que no han dado su permiso, cada uno con el chat directo que tienes con él, y el asistente publica un recordatorio ahí y vuelve a comprobar hasta que haya aceptado la proporción que quieres.

Hacer sitio para el historial más antiguo ​

Si el historial es más antiguo que mensajes que ya están en el chat, por ejemplo los mensajes del sistema que registran la incorporación de miembros, quítalos primero. Con las herramientas de MCP, wipe_history quita los mensajes del chat a partir de un mensaje elegido (por defecto, todos), solo mientras dura la importación y solo para los propietarios, y termina cuando ya se han eliminado; remove_message quita un mensaje suelto. Ambas funcionan durante una importación. Borrar no se puede deshacer, así que confírmalo con el propietario antes de ejecutarlo. No borres de nuevo después de importar los mensajes: también los quitaría.

Enviar los mensajes ​

Mientras el modo de importación está activado, el asistente o el programa del propietario envía el historial:

  1. Lee la importación actual (get_import); contiene el ID de importación que necesita cada llamada.
  2. Sube primero los archivos adjuntos, a nombre del miembro que los envió; ese miembro debe haber dado su permiso. Cada subida se adjunta a un mensaje.
  3. Envía los mensajes en lotes de 1 a 100, del más antiguo al más reciente. Cada mensaje tiene el autor, la hora original, el texto (hasta 64 KB), hasta 10 archivos adjuntos y, opcionalmente, el mensaje al que responde. Un lote tiene su propio ID: si se envía de nuevo el mismo lote, se devuelve el resultado anterior, así que un reintento tras un error de red no duplica los mensajes.
  4. Una respuesta solo puede apuntar a un mensaje que ya esté en el chat, así que envía antes ese mensaje, en un lote anterior, y usa el ID que devuelve.
  5. En una importación de todo el lugar, envía cada mensaje al chat concreto del lugar al que pertenece. Comprueba el resultado de cada mensaje. Un lote puede tener éxito solo en parte: un mensaje rechazado vuelve con el motivo (por ejemplo "Este miembro no ha dado su permiso para la importación."), y los demás se guardan.

Las herramientas de MCP para estos pasos se describen en Importar historial. El mismo servicio está disponible para los programas mediante la API RPC, con los tipos de datos en Tipos de datos de importación. El post_message de MCP no es una importación: publica como tú, con la fecha de ahora.

Terminar el modo de importación ​

Cuando se han enviado todos los mensajes, el propietario selecciona Finalizar importación en la app, o el asistente llama a end_import. Los miembros pueden volver a publicar, y el historial importado queda encima del primer mensaje nuevo. A los miembros que nunca dieron su permiso simplemente no se les importa ningún mensaje.

Después de la importación, recorre el chat para comprobarlo: los mensajes muestran sus autores y fechas originales, y el primer mensaje nuevo va a continuación. Compara algunos mensajes con el origen y lee la lista de mensajes rechazados si tu asistente llevó una. Mejor aún, lee los mensajes importados antes de terminar el modo de importación, mientras todavía puedes enviar los que falten.

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

Ejemplo: importar una exportación de Telegram ​

Toda la importación puede hacerla un asistente que esté conectado a Voxt mediante MCP y pueda leer la carpeta de exportación de tu ordenador, como Claude Code u otro asistente con acceso a archivos. No necesita ningún programa propio. Un asistente solo de chat que no pueda leer tus archivos no puede hacerlo.

Antes de empezar:

  1. En Telegram Desktop, exporta el chat: abre el chat, elige Export chat history, selecciona Machine-readable JSON e incluye fotos y archivos si los quieres. La carpeta de exportación contiene result.json y carpetas como photos y files.
  2. Crea el chat de grupo de Voxt y añade a las personas que escribieron en el chat de Telegram. Cada una necesita una cuenta de Voxt y debe ser miembro. Los nombres de Telegram que no tengan un miembro de Voxt no se pueden importar.
  3. Decide cómo inicia sesión el asistente: con una clave API o con tu cuenta de Voxt mediante OAuth (más abajo).
  4. Añade Voxt a tu asistente como servidor MCP (más abajo).

Añadir Voxt como servidor MCP ​

La dirección del servidor es https://voxt.ai/mcp. Hay dos formas de iniciar sesión. En ambas, el asistente actúa como tú.

Con una clave API. Crea una clave en Voxt (Ajustes → API y apps → Crear clave API) y pásala en una cabecera Authorization: Bearer. En Claude Code, ejecuta:

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

Define antes VOXT_API_KEY en tu terminal, para que la clave no aparezca en un prompt ni en un archivo.

Con OAuth. Omite la cabecera y la clave:

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

Después inicia Claude Code, ejecuta /mcp, selecciona voxt y elige autenticarte. Se abre una ventana del navegador con la página de consentimiento de Voxt; aprueba el acceso y el asistente queda conectado, sin ninguna clave que crear ni guardar.

Otros asistentes tienen una página de ajustes para servidores MCP remotos o conectores donde se escribe la misma dirección, y la cabecera o el inicio de sesión. MCP describe ambas formas. Pide al asistente que enumere tus chats de Voxt para comprobar que la conexión funciona.

Dar la instrucción ​

Dale al asistente una instrucción como esta. Cambia la carpeta y el nombre del 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.

Notas sobre el ejemplo:

  • Telegram guarda la hora de un mensaje sin zona horaria. Comprueba los primeros mensajes importados con el chat original antes de enviar el resto.
  • Los mensajes rechazados no detienen el lote. Corrige la causa (un miembro que falta, un remitente que no ha permitido la importación, una hora fuera de orden) y envíalos de nuevo en un lote nuevo.
  • Los mensajes que no se pueden asignar se omiten, así que conserva la exportación de Telegram si necesitas el registro completo.
  • Cada archivo viaja en trozos de 1 MB a través del asistente, así que un chat con muchos archivos grandes requiere muchas llamadas. Solo el texto es rápido.