本文へスキップ

インポートとエクスポート ​

Voxt には、ファイルを作成したり読み込んだりする「チャットのエクスポート」や「チャットのインポート」のボタンはありません。データの移動は、次の2つのプログラム用インターフェースを通じて行います。

  • エクスポート: MCP または RPC API を通じて、チャットのメッセージ、添付ファイル、メンバー、要約を読み取ります。
  • インポート: 他のサービスの過去の履歴をチャットに追加します。オーナーがインポートモードを開始し、メンバーが同意し、メッセージは MCP のインポートツール、または RPC API のインポートサービスで送信されます。どちらの場合も、オーナーはアシスタントからプロセス全体を実行できます。

チャットをエクスポートする ​

エクスポートには API キーまたは OAuth サインインが必要です。アシスタントやスクリプトはあなたとして動作するため、読み取れるのはあなたが読めるチャットだけです。

  1. API キーを作成するか、MCPの説明に従って OAuth フローでアシスタントを接続します。
  2. アシスタントにエクスポートを依頼します。例: 「チャット Trip photos のすべてのメッセージを読み取り、日付と投稿者付きの Markdown ファイルとして保存して」。使うツールはアシスタントが選ぶので、ツール名を知っている必要はありません。
  3. スクリプトの場合は、ツールを直接呼び出します。ツールリファレンスに、引数付きでツールの一覧があります。

読み取れるデータ:

データツール備考
メッセージlist_messages, get_id_range古い順に、1回の呼び出しで最大 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. チャットの設定を開きます(幅の狭い画面では、チャットのヘッダーの 3 つの点のボタンを選び、チャットを編集を選びます。幅の広い画面では、右パネルを開き、そのヘッダーの編集ボタンを選びます。プレイス全体のインポートの場合はプレイスの設定)。インポートを開始を選びます。この項目はオーナーにだけ表示され、スレッドには表示されません。
  2. **インポートモードを開始しますか?**を確認します。Voxt は約10秒間、最終チェックを行います(「インポートモードに切り替えています」)。その間に誰かがメッセージを投稿した場合は、そのメッセージを削除してもう一度開始するよう求められます。
  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. 同意していないメンバーのメッセージは拒否されるので、履歴が必要な全員が同意するまで待ってください。

インポート中はメンバーがチャットに書き込めないため、オーナーはそこでリマインドできません。代わりに、開いたままのダイレクトチャットでメッセージを送ってください。アシスタントにも任せられます。get_import が同意していないメンバーと、それぞれとのダイレクトチャットを返すので、アシスタントがそこにリマインダーを投稿し、希望する割合が同意するまで再確認します。

古い履歴のために場所を空ける ​

履歴が、チャットにすでにあるメッセージ(たとえば、メンバーの参加を記録するシステムメッセージ)より古い場合は、先にそれらを削除します。MCP ツールでは、wipe_history が、選んだメッセージ以降(既定ではすべて)のチャットのメッセージを削除します。これは、インポートの実行中で、かつオーナーにだけ使え、削除が終わってから結果を返します。remove_message は1件のメッセージを削除します。どちらもインポート中に使えます。消去は元に戻せないので、実行する前にオーナーに確認してください。メッセージをインポートした後に、もう一度消去しないでください。インポートしたメッセージも削除されます。

メッセージを送信する ​

インポートモードの間、オーナーのアシスタントまたはプログラムが履歴を送信します。

  1. 現在のインポートを読み取ります(get_import)。すべての呼び出しに必要なインポート ID が含まれています。
  2. 先に添付ファイルをアップロードします。送信したメンバーのものとしてアップロードし、そのメンバーが同意している必要があります。各アップロードは1件のメッセージに添付されます。
  3. メッセージを1〜100件のバッチで、古い順に送信します。各メッセージには、投稿者、元の時刻、テキスト(最大 64 KB)、最大10件の添付ファイル、必要に応じて返信先のメッセージを指定します。バッチには独自の ID があり、同じバッチを再送すると前回の結果が返るため、ネットワークエラー後の再試行でメッセージが重複することはありません。
  4. 返信の宛先にできるのは、すでにチャットにあるメッセージだけです。先に前のバッチでそのメッセージを送信し、返された ID を使ってください。
  5. プレイス全体のインポートでは、各メッセージを、それが属するプレイス内の特定のチャットに送信します。すべてのメッセージの結果を確認してください。バッチは一部だけ成功することがあります。拒否されたメッセージは理由付き(たとえば「このメンバーはインポートに同意していません。」)で返され、それ以外は保存されます。

これらの手順の 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 でチャットをエクスポートします。チャットを開き、チャット履歴をエクスポートを選び、機械可読な JSONを選んで、必要なら写真とファイルも含めます。エクスポートフォルダーには result.json と、photos、files などのフォルダーが入っています。
  2. Voxt のグループチャットを作成し、Telegram のチャットで発言した人を追加します。全員に Voxt アカウントが必要で、メンバーになっている必要があります。Voxt のメンバーがいない Telegram の名前はインポートできません。
  3. アシスタントのサインイン方法を決めます。API キー、または OAuth による Voxt アカウント(下記)です。
  4. アシスタントに Voxt を MCP サーバーとして追加します(下記)。

Voxt を MCP サーバーとして追加する ​

サーバーのアドレスは https://voxt.ai/mcp です。サインインの方法は2つあり、どちらの場合もアシスタントはあなたとして動作します。

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 のエクスポートを保管しておいてください。
  • 各ファイルは 1 MB ずつ、アシスタントを通じて送られるため、大きなファイルが多いチャットでは多くの呼び出しが必要です。テキストだけなら短時間で終わります。