본문으로 건너뛰기

가져오기와 내보내기 ​

Voxt에는 파일을 만들거나 읽는 "채팅 내보내기" 또는 "채팅 가져오기" 버튼이 없습니다. 데이터는 두 가지 프로그래밍 인터페이스를 통해 이동합니다.

  • 내보내기는 MCP 또는 RPC API를 통해 채팅의 메시지, 첨부 파일, 멤버, 요약을 읽습니다.
  • 가져오기는 다른 서비스의 이전 기록을 채팅에 추가합니다. 소유자가 가져오기 모드를 시작하고, 멤버들이 동의하면, MCP 가져오기 도구 또는 RPC API의 가져오기 서비스를 통해 메시지를 보냅니다. 어느 쪽이든 소유자는 어시스턴트에서 전체 과정을 실행할 수 있습니다.

채팅 내보내기 ​

내보내기에는 API 키 또는 OAuth 로그인이 필요합니다. 어시스턴트나 스크립트는 나로서 동작하므로, 내가 읽을 수 있는 채팅만 읽을 수 있고 그 외에는 읽을 수 없습니다.

  1. MCP에 설명된 대로 API 키를 만들거나 OAuth 흐름으로 어시스턴트를 연결합니다.
  2. 어시스턴트에 내보내기를 요청합니다. 예: "Trip photos 채팅의 모든 메시지를 날짜와 작성자가 포함된 Markdown 파일로 저장해 줘." 어시스턴트가 도구를 고르므로 도구 이름을 알 필요는 없습니다.
  3. 스크립트는 도구를 직접 호출합니다. 도구 레퍼런스에 도구와 인수가 나와 있습니다.

읽을 수 있는 데이터:

데이터도구참고
메시지list_messages, get_id_range오래된 것부터, 호출당 최대 1,024개. 아무것도 반환되지 않을 때까지 마지막 메시지 ID부터 이어서 읽습니다. 삭제된 메시지는 제외됩니다.
고정된 메시지와 반응list_pinned_messages, list_reactions
사진, 동영상, 파일, 링크list_media, list_files, list_links월별로 묶여 있으며 최근 월이 먼저입니다. 모든 첨부 파일에 콘텐츠 URL이 있습니다.
멤버list_members, list_place_members
채팅과 플레이스list_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_place무엇을 내보낼지 찾는 데 사용합니다. 보관한 채팅은 list_archived_chats에서만 나열됩니다.
요약list_conversations, get_conversation음성 세션처럼 채팅에서 요약된 구간.
검색 결과search_messages, search_contacts

큰 채팅을 내보내기 전에 알아 둘 점:

  • 도구는 파일이 아니라 페이지 단위로 반환합니다. 결과는 어시스턴트나 스크립트가 조합합니다.
  • 아직 스트리밍 중인 메시지에는 텍스트가 없습니다. 그 부분은 나중에 다시 읽으세요.
  • 이미 읽은 메시지의 편집과 삭제는 알려 주지 않습니다. 채팅이 아직 활발하다면 해당 범위를 다시 읽으세요.

채팅에 기록 가져오기 ​

가져오기 모드를 사용하면 다른 서비스의 대화를 Voxt 그룹 채팅이나 플레이스로 가져올 수 있습니다. 메시지는 원래 작성자와 원래 날짜로 저장되므로 채팅은 처음부터 Voxt에 있었던 것처럼 보입니다.

먼저 알아 둘 점:

  • 채팅이나 플레이스의 소유자만 가져오기를 시작하고 종료할 수 있습니다.
  • 그룹 채팅과 플레이스에서 사용할 수 있습니다. 플레이스 전체 가져오기는 플레이스의 모든 채팅을 대상으로 합니다. 1:1 채팅으로는 가져올 수 없습니다.
  • 모든 작성자는 채팅의 현재 멤버여야 하고 동의해야 합니다. 동의하지 않았거나, 나갔거나, 멤버가 아닌 사람의 메시지는 거부됩니다.
  • 가져오는 메시지는 과거 날짜여야 하고, 각 메시지는 앞선 메시지보다 늦어야 하며, 채팅에 이미 있는 가장 최근 메시지보다도 늦어야 합니다. 멤버 참여 같은 시스템 메시지도 포함되므로, 그룹 채팅에서는 기록의 날짜가 멤버들이 참여한 이후여야 합니다. 채팅에 아직 남아 있는 메시지만 계산에 들어가므로, 이미 있는 메시지보다 앞에는 기록을 끼워 넣을 수 없지만 맞출 수는 있습니다. 가져오는 동안 소유자가 채팅의 기록을 지우거나 메시지를 하나씩 삭제하면, 지운 메시지만큼 오래된 기록도 가져올 수 있습니다. 가져오는 중에 기록을 지우는 것은 되돌릴 수 없으며 "기록이 삭제되었습니다" 알림도 올리지 않습니다.
  • 가져오기 모드가 켜져 있는 동안에는 소유자를 포함해 아무도 글을 올릴 수 없습니다. 플레이스 전체 가져오기는 플레이스의 모든 채팅에서 글쓰기를 중지합니다.
  • 가져온 메시지는 알림을 보내지 않습니다.

가져오기 모드 시작 ​

앱에서:

  1. 채팅의 설정(좁은 화면에서는 채팅 헤더의 점 세 개 버튼을 선택한 다음 채팅 편집, 넓은 화면에서는 오른쪽 패널을 열고 헤더의 편집 버튼 선택; 플레이스 전체 가져오기는 플레이스의 설정)을 열고 가져오기 시작을 선택합니다. 이 항목은 소유자에게만 표시되며, 스레드에서는 표시되지 않습니다.
  2. **가져오기 모드를 시작하시겠습니까?**를 확인합니다. Voxt가 약 10초 동안 몇 가지 최종 점검을 실행합니다("가져오기 모드로 전환 중"). 시작하는 동안 누군가 메시지를 올렸다면, Voxt가 그 메시지를 삭제하고 다시 시작하라고 안내합니다.
  3. 모든 사람에게 메시지 입력란이 유지보수 모드로 바뀝니다.
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.

MCP 가져오기 도구가 있는 어시스턴트는 start_import로 같은 작업을 할 수 있습니다. 이 도구는 모든 멤버의 글쓰기를 중지시키므로, 호출에서 사용자가 확인했다고 밝히지 않으면 아무 동작도 하지 않습니다.

멤버에게 가져오기 허용 요청 ​

확인 대화상자, 멤버의 동의, 가져오기 종료는 채팅 기록 가져오기에 나와 있습니다. 요약하면 다음과 같습니다.

  1. 각 멤버는 채팅을 열고 이번 세션에서 내 메시지와 미디어 가져오기 허용을 선택한 다음 **가져오기를 허용하시겠습니까?**를 확인합니다. 해당 가져오기에 대한 동의는 철회할 수 없습니다. 소유자도 자신의 메시지를 가져오려면 동의해야 합니다.
  2. 소유자에게는 동의한 멤버의 비율("동의: 100% (3명 중 3명)")과 아직 동의하지 않은 사람이 표시됩니다.
  3. 동의하지 않은 멤버의 메시지는 거부되므로, 기록을 가져오려는 모든 사람이 동의할 때까지 기다리세요.

가져오기 중에는 멤버가 채팅에 글을 쓸 수 없으므로 소유자는 그곳에서 알릴 수 없습니다. 대신 열려 있는 1:1 채팅으로 메시지를 보내세요. 어시스턴트도 이 일을 할 수 있습니다. get_import는 동의하지 않은 멤버와 각 멤버와의 1:1 채팅을 나열하고, 어시스턴트는 그곳에 알림 메시지를 올린 다음 원하는 비율이 동의할 때까지 다시 확인합니다.

더 오래된 기록을 넣을 자리 만들기 ​

기록이 채팅에 이미 있는 메시지보다 오래된 경우, 예를 들어 멤버 참여를 기록하는 시스템 메시지보다 오래된 경우에는 그 메시지를 먼저 삭제하세요. MCP 도구에서 wipe_history는 선택한 메시지부터(기본값은 전체) 채팅의 메시지를 삭제하며, 가져오기가 진행되는 동안에만, 그리고 소유자만 사용할 수 있으며, 메시지가 삭제된 뒤에 반환됩니다. remove_message는 메시지 하나를 삭제합니다. 둘 다 가져오는 중에 사용할 수 있습니다. 기록 삭제는 되돌릴 수 없으므로 실행하기 전에 소유자에게 확인하세요. 메시지를 가져온 뒤에는 다시 삭제하지 마세요. 가져온 메시지도 함께 삭제됩니다.

메시지 보내기 ​

가져오기 모드가 켜져 있는 동안 소유자의 어시스턴트나 프로그램이 기록을 보냅니다.

  1. 현재 가져오기를 읽습니다(get_import). 여기에 모든 호출에 필요한 가져오기 ID가 들어 있습니다.
  2. 첨부 파일을 먼저 업로드합니다. 파일을 보낸 멤버를 기준으로 업로드하며, 그 멤버가 동의했어야 합니다. 각 업로드는 하나의 메시지에 첨부됩니다.
  3. 메시지를 1~100개 단위의 배치로 오래된 것부터 보냅니다. 각 메시지에는 작성자, 원래 시각, 텍스트(최대 64KB), 최대 10개의 첨부 파일, 그리고 필요하면 답장 대상 메시지가 있습니다. 배치에는 고유한 ID가 있습니다. 같은 배치를 다시 보내면 이전 결과가 반환되므로, 네트워크 오류 후 재시도해도 메시지가 중복되지 않습니다.
  4. 답장은 채팅에 이미 있는 메시지만 가리킬 수 있습니다. 따라서 그 메시지를 앞선 배치에서 먼저 보내고 반환된 ID를 사용하세요.
  5. 플레이스 전체 가져오기에서는 각 메시지를 해당하는 플레이스의 특정 채팅으로 보냅니다. 모든 메시지의 결과를 확인하세요. 배치가 일부만 성공할 수도 있습니다. 거부된 메시지는 이유와 함께 반환되고(예: "This member has not consented to import."), 나머지는 저장됩니다.

이 단계의 MCP 도구는 기록 가져오기에 설명되어 있습니다. 같은 서비스를 프로그램에서 RPC API로 사용할 수 있으며, 데이터 형식은 가져오기 데이터 형식에 있습니다. MCP의 post_message는 가져오기가 아닙니다. 나로서 현재 시각으로 글을 올립니다.

가져오기 모드 종료 ​

모든 메시지를 보냈으면 소유자가 앱에서 가져오기 종료를 선택하거나 어시스턴트가 end_import를 호출합니다. 멤버는 다시 글을 올릴 수 있고, 가져온 기록은 첫 번째 새 메시지 위에 놓입니다. 동의하지 않은 멤버의 메시지는 가져오지 않습니다.

가져온 뒤에는 채팅을 스크롤하며 확인하세요. 메시지에 원래 작성자와 날짜가 표시되고, 첫 번째 새 메시지가 그 뒤에 이어집니다. 몇 개의 메시지를 원본과 비교하고, 어시스턴트가 거부된 메시지 목록을 보관했다면 그 목록도 읽어 보세요. 더 좋은 방법은 가져오기 모드를 종료하기 전에 가져온 메시지를 다시 읽어 보는 것입니다. 그러면 빠진 메시지를 아직 보낼 수 있습니다.

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

예: Telegram 내보내기 가져오기 ​

가져오기 전체를 MCP로 Voxt에 연결되어 있고 내 컴퓨터의 내보내기 폴더를 읽을 수 있는 어시스턴트가 수행할 수 있습니다. Claude Code나 파일 접근이 가능한 다른 어시스턴트가 그런 예입니다. 별도의 프로그램은 필요 없습니다. 파일을 읽을 수 없는 채팅 전용 어시스턴트는 할 수 없습니다.

시작하기 전에:

  1. Telegram Desktop에서 채팅을 내보냅니다. 채팅을 열고 Export chat history를 선택한 다음 Machine-readable JSON을 고르고, 원하면 사진과 파일을 포함합니다. 내보내기 폴더에는 result.json과 photos, files 같은 폴더가 들어 있습니다.
  2. Voxt 그룹 채팅을 만들고 Telegram 채팅에서 글을 쓴 사람들을 추가합니다. 각자 Voxt 계정이 있어야 하고 멤버여야 합니다. Voxt 멤버가 없는 Telegram 이름은 가져올 수 없습니다.
  3. 어시스턴트가 로그인하는 방법을 정합니다. API 키를 사용하거나 OAuth로 내 Voxt 계정을 사용합니다(아래 참고).
  4. 어시스턴트에 Voxt를 MCP 서버로 추가합니다(아래 참고).

Voxt를 MCP 서버로 추가 ​

서버 주소는 https://voxt.ai/mcp입니다. 로그인 방법은 두 가지가 있으며, 어느 쪽이든 어시스턴트는 나로서 동작합니다.

API 키 사용. Voxt에서 키를 만들고(설정 → API 및 앱 → API 키 생성) Authorization: Bearer 헤더로 전달합니다. Claude Code에서는 다음을 실행합니다.

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

키가 프롬프트나 파일에 나타나지 않도록 먼저 터미널에서 VOXT_API_KEY를 설정하세요.

OAuth 사용. 헤더와 키를 빼고 실행합니다.

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

그런 다음 Claude Code를 시작하고 /mcp를 실행해 voxt를 선택한 뒤 인증을 선택합니다. 브라우저 창에 Voxt 동의 페이지가 열립니다. 접근을 승인하면 어시스턴트가 연결되며, 만들거나 저장할 키가 없습니다.

다른 어시스턴트에는 원격 MCP 서버나 커넥터 설정 페이지가 있으며, 같은 주소와 헤더 또는 로그인을 입력합니다. MCP에 두 방법이 모두 설명되어 있습니다. 어시스턴트에 내 Voxt 채팅을 나열해 달라고 요청하면 연결이 작동하는지 확인할 수 있습니다.

지침 주기 ​

어시스턴트에 다음과 같은 지침을 줍니다. 폴더와 채팅 이름은 바꿔 넣으세요.

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.

예제에 대한 참고:

  • Telegram은 메시지 시각을 시간대 없이 저장합니다. 나머지를 보내기 전에 처음 가져온 메시지들을 원래 채팅과 비교해 확인하세요.
  • 거부된 메시지가 있어도 배치는 중단되지 않습니다. 원인(없는 멤버, 가져오기를 허용하지 않은 발신자, 순서가 어긋난 시각)을 해결한 다음 새 배치로 다시 보내세요.
  • 매핑할 수 없는 메시지는 제외되므로, 전체 기록이 필요하면 Telegram 내보내기를 보관하세요.
  • 각 파일은 어시스턴트를 통해 1MB 조각으로 전송되므로, 큰 파일이 많은 채팅은 많은 호출이 필요합니다. 텍스트만이라면 빠릅니다.