นำเข้าและส่งออก
Voxt ไม่มีปุ่ม "ส่งออกแชท" หรือ "นำเข้าแชท" ที่สร้างหรืออ่านไฟล์ ข้อมูลเคลื่อนย้ายผ่านอินเทอร์เฟซเชิงโปรแกรมสองแบบ:
- ส่งออก อ่านข้อความ ไฟล์แนบ สมาชิก และสรุปของแชทผ่าน MCP หรือ RPC API
- นำเข้า เพิ่มประวัติเก่าจากบริการอื่นลงในแชท เจ้าของเริ่มโหมดนำเข้า สมาชิกยินยอม และข้อความถูกส่งผ่านเครื่องมือนำเข้าของ MCP หรือบริการนำเข้าของ RPC API ในทั้งสองกรณี เจ้าของดำเนินกระบวนการทั้งหมดจากผู้ช่วยได้
ส่งออกแชท
การส่งออกต้องใช้คีย์ API หรือการลงชื่อเข้าใช้ด้วย OAuth ผู้ช่วยหรือสคริปต์ทำงานในนามของคุณ จึงอ่านได้เฉพาะแชทที่คุณอ่านได้ และไม่เกินนั้น
- สร้างคีย์ API หรือเชื่อมต่อผู้ช่วยด้วยขั้นตอน OAuth ตามที่อธิบายใน MCP
- ขอให้ผู้ช่วยส่งออก เช่น "อ่านข้อความทั้งหมดของแชท Trip photos และบันทึกเป็นไฟล์ Markdown พร้อมวันที่และผู้เขียน" ผู้ช่วยเลือกเครื่องมือเอง คุณไม่จำเป็นต้องรู้ชื่อเครื่องมือ
- สำหรับสคริปต์ ให้เรียกเครื่องมือโดยตรง เอกสารอ้างอิงเครื่องมือแสดงรายการเครื่องมือพร้อมอาร์กิวเมนต์
สิ่งที่อ่านได้:
| ข้อมูล | เครื่องมือ | หมายเหตุ |
|---|---|---|
| ข้อความ | 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 มาตลอด
สิ่งที่ควรรู้ก่อน:
- เฉพาะเจ้าของแชทหรือเพลสเท่านั้นที่เริ่มและสิ้นสุดการนำเข้าได้
- ใช้ได้กับแชทกลุ่มและเพลส การนำเข้าทั้งเพลสครอบคลุมทุกแชทในเพลส นำเข้าลงในแชทส่วนตัวไม่ได้
- ผู้เขียนทุกคนต้องเป็นสมาชิกปัจจุบันของแชทและต้องยินยอม ข้อความของผู้ที่ไม่ได้ยินยอม ออกไปแล้ว หรือไม่ได้เป็นสมาชิกจะถูกปฏิเสธ
- ข้อความที่นำเข้าต้องมีวันที่ในอดีต แต่ละข้อความต้องหลังข้อความก่อนหน้า และหลังข้อความใหม่ที่สุดที่แชทมีอยู่แล้ว ข้อความระบบก็นับด้วย เช่น การเข้าร่วมของสมาชิก ดังนั้นในแชทกลุ่ม ประวัติต้องมีวันที่หลังจากที่สมาชิกเข้าร่วม นับเฉพาะข้อความที่ยังอยู่ในแชท จึงแทรกประวัติก่อนข้อความที่มีอยู่ไม่ได้ แต่ปรับให้พอดีได้ ระหว่างการนำเข้า เจ้าของล้างประวัติของแชท หรือลบข้อความทีละข้อความได้ แล้วจึงนำเข้าประวัติที่เก่าเท่ากับข้อความที่ล้างได้ การล้างระหว่างการนำเข้ายกเลิกไม่ได้และไม่โพสต์บันทึก "ล้างประวัติแล้ว"
- ไม่มีใครโพสต์ได้ขณะที่โหมดนำเข้าเปิดอยู่ รวมถึงเจ้าของ การนำเข้าทั้งเพลสหยุดการโพสต์ในทุกแชทของเพลส
- ข้อความที่นำเข้าไม่ส่งการแจ้งเตือน
เริ่มโหมดนำเข้า
ในแอป:
- เปิดการตั้งค่าของแชท (บนหน้าจอแคบ เลือกปุ่มสามจุดในส่วนหัวแชท แล้วเลือก แก้ไขแชท บนหน้าจอกว้าง เปิดแผงด้านขวาแล้วเลือกปุ่มแก้ไขในส่วนหัวของแผง) หรือของเพลสสำหรับการนำเข้าทั้งเพลส แล้วเลือก เริ่มนำเข้า รายการนี้แสดงเฉพาะเจ้าของ และไม่แสดงในเธรด
- ยืนยัน เริ่มโหมดนำเข้าไหม? Voxt ตรวจสอบครั้งสุดท้ายประมาณสิบวินาที ("กำลังเข้าสู่โหมดนำเข้า") หากมีผู้โพสต์ข้อความระหว่างที่เริ่ม Voxt จะขอให้คุณลบข้อความนั้นแล้วเริ่มใหม่
- ช่องข้อความจะถูกแทนที่ด้วย โหมดบำรุงรักษา สำหรับทุกคน



ผู้ช่วยที่มีเครื่องมือนำเข้าของ MCP ทำสิ่งเดียวกันได้ด้วย start_import เครื่องมือนี้จะไม่ทำอะไรเลยหากการเรียกไม่ระบุว่าคุณยืนยันแล้ว เพราะมันหยุดการโพสต์ของสมาชิกทุกคน
ขอให้สมาชิกอนุญาตการนำเข้า
กล่องโต้ตอบยืนยัน การยินยอมของสมาชิก และการสิ้นสุดการนำเข้าแสดงอยู่ในนำเข้าประวัติของแชท โดยสรุป:
- สมาชิกแต่ละคนเปิดแชท เลือก อนุญาตให้นำเข้าข้อความและสื่อของฉันในเซสชันนี้ และยืนยัน อนุญาตการนำเข้าไหม? การยินยอมเพิกถอนไม่ได้สำหรับการนำเข้าครั้งนั้น เจ้าของก็ยินยอมด้วยเพื่อนำเข้าข้อความของตนเอง
- เจ้าของเห็นสัดส่วนของสมาชิกที่ยินยอม ("ยินยอมแล้ว: 100% (3 จาก 3)") และผู้ที่ยังขาดอยู่
- ข้อความของสมาชิกที่ยังไม่ยินยอมจะถูกปฏิเสธ ดังนั้นให้รอจนทุกคนที่คุณต้องการประวัติของเขายินยอมแล้ว
สมาชิกเขียนในแชทระหว่างการนำเข้าไม่ได้ เจ้าของจึงเตือนพวกเขาที่นั่นไม่ได้ ให้ส่งข้อความหาพวกเขาในแชทส่วนตัวของคุณแทน ซึ่งยังเปิดอยู่ ผู้ช่วยทำเรื่องนี้ได้: get_import แสดงรายชื่อสมาชิกที่ยังไม่ยินยอม พร้อมแชทส่วนตัวที่คุณมีกับแต่ละคน และผู้ช่วยโพสต์การเตือนที่นั่นและตรวจสอบซ้ำจนกว่าสัดส่วนที่คุณต้องการจะยินยอม
เว้นที่สำหรับประวัติที่เก่ากว่า
หากประวัติเก่ากว่าข้อความที่อยู่ในแชทแล้ว เช่น ข้อความระบบที่บันทึกการเข้าร่วมของสมาชิก ให้ลบข้อความเหล่านั้นก่อน ด้วยเครื่องมือ MCP wipe_history ลบข้อความของแชทตั้งแต่ข้อความที่เลือกเป็นต้นไป (ค่าเริ่มต้นคือทั้งหมด) เฉพาะขณะที่การนำเข้าทำงานอยู่ และเฉพาะสำหรับเจ้าของ และส่งกลับเมื่อข้อความถูกลบแล้ว remove_message ลบข้อความเดียว ทั้งสองใช้ได้ระหว่างการนำเข้า การล้างยกเลิกไม่ได้ จึงควรยืนยันกับเจ้าของก่อนดำเนินการ อย่าล้างอีกครั้งหลังจากนำเข้าข้อความแล้ว เพราะจะลบข้อความที่นำเข้าด้วย
ส่งข้อความ
ขณะที่โหมดนำเข้าเปิดอยู่ ผู้ช่วยหรือโปรแกรมของเจ้าของจะส่งประวัติ:
- อ่านการนำเข้าปัจจุบัน (
get_import) ซึ่งมี ID การนำเข้าที่ทุกการเรียกต้องใช้ - อัปโหลดไฟล์แนบก่อน สำหรับสมาชิกที่ส่งไฟล์เหล่านั้น สมาชิกคนนั้นต้องยินยอมแล้ว การอัปโหลดแต่ละครั้งแนบกับหนึ่งข้อความ
- ส่งข้อความเป็นชุดละ 1 ถึง 100 ข้อความ เก่าสุดก่อน แต่ละข้อความมีผู้เขียน เวลาเดิม ข้อความตัวอักษร (สูงสุด 64 KB) ไฟล์แนบได้สูงสุด 10 ไฟล์ และข้อความที่ตอบกลับ (ถ้ามี) แต่ละชุดมี ID ของตนเอง: การส่งชุดเดิมซ้ำจะส่งผลลัพธ์ก่อนหน้ากลับมา การลองใหม่หลังเกิดข้อผิดพลาดของเครือข่ายจึงไม่ทำให้ข้อความซ้ำ
- การตอบกลับชี้ไปที่ข้อความที่อยู่ในแชทแล้วเท่านั้น ดังนั้นให้ส่งข้อความนั้นก่อนในชุดที่ผ่านมา และใช้ ID ที่ส่งกลับมา
- ในการนำเข้าทั้งเพลส ให้ส่งแต่ละข้อความไปยังแชทเฉพาะของเพลสที่ข้อความนั้นอยู่ ตรวจสอบผลลัพธ์ของทุกข้อความ ชุดหนึ่งอาจสำเร็จบางส่วน: ข้อความที่ถูกปฏิเสธจะส่งกลับพร้อมเหตุผล (เช่น "สมาชิกคนนี้ไม่ได้ยินยอมให้นำเข้า") และข้อความอื่นถูกเก็บไว้
เครื่องมือ MCP สำหรับขั้นตอนเหล่านี้อธิบายในนำเข้าประวัติ บริการเดียวกันนี้มีให้โปรแกรมใช้ผ่าน RPC API พร้อมชนิดข้อมูลในชนิดข้อมูลการนำเข้า post_message ของ MCP ไม่ใช่การนำเข้า: มันโพสต์ในนามของคุณ ลงวันที่ปัจจุบัน
สิ้นสุดโหมดนำเข้า
เมื่อส่งข้อความทั้งหมดแล้ว เจ้าของเลือก สิ้นสุดการนำเข้า ในแอป หรือผู้ช่วยเรียก end_import สมาชิกโพสต์ได้อีกครั้ง และประวัติที่นำเข้าอยู่เหนือข้อความใหม่ข้อความแรก สมาชิกที่ไม่เคยยินยอมก็เพียงไม่มีข้อความที่นำเข้า
หลังการนำเข้า ให้เลื่อนดูแชทเพื่อตรวจสอบ: ข้อความแสดงผู้เขียนเดิมและวันที่เดิม และข้อความใหม่ข้อความแรกตามหลังข้อความเหล่านั้น เปรียบเทียบข้อความบางส่วนกับต้นฉบับ และอ่านรายการข้อความที่ถูกปฏิเสธหากผู้ช่วยของคุณเก็บไว้ ดีกว่านั้นคืออ่านข้อความที่นำเข้ากลับมาก่อนสิ้นสุดโหมดนำเข้า ขณะที่คุณยังส่งข้อความที่ขาดอยู่ได้

ตัวอย่าง: นำเข้าข้อมูลส่งออกจาก Telegram
ผู้ช่วยที่เชื่อมต่อกับ Voxt ผ่าน MCP และอ่านโฟลเดอร์ส่งออกบนคอมพิวเตอร์ของคุณได้ เช่น Claude Code หรือผู้ช่วยอื่นที่เข้าถึงไฟล์ได้ ทำการนำเข้าทั้งหมดได้ ไม่ต้องมีโปรแกรมของคุณเอง ผู้ช่วยแบบแชทอย่างเดียวที่อ่านไฟล์ของคุณไม่ได้ทำไม่ได้
ก่อนเริ่ม:
- ใน Telegram Desktop ให้ส่งออกแชท: เปิดแชท เลือก ส่งออกประวัติแชท เลือก JSON ที่เครื่องอ่านได้ และรวมรูปภาพและไฟล์หากต้องการ โฟลเดอร์ที่ส่งออกมี
result.jsonและโฟลเดอร์ เช่นphotosและfiles - สร้างแชทกลุ่มใน Voxt และเพิ่มบุคคลที่เขียนในแชท Telegram แต่ละคนต้องมีบัญชี Voxt และต้องเป็นสมาชิก ชื่อใน Telegram ที่ไม่มีสมาชิก Voxt จะนำเข้าไม่ได้
- ตัดสินใจว่าผู้ช่วยจะลงชื่อเข้าใช้อย่างไร: ด้วยคีย์ API หรือด้วยบัญชี Voxt ของคุณผ่าน OAuth (ด้านล่าง)
- เพิ่ม Voxt ให้ผู้ช่วยของคุณเป็นเซิร์ฟเวอร์ MCP (ด้านล่าง)
เพิ่ม Voxt เป็นเซิร์ฟเวอร์ MCP
ที่อยู่ของเซิร์ฟเวอร์คือ https://voxt.ai/mcp มีสองวิธีในการลงชื่อเข้าใช้ ในทั้งสองวิธี ผู้ช่วยทำงานในนามของคุณ
ด้วยคีย์ API สร้างคีย์ใน Voxt (การตั้งค่า → API และแอป → สร้างคีย์ API) และส่งในส่วนหัว Authorization: Bearer ใน Claude Code ให้รัน:
claude mcp add --transport http voxt https://voxt.ai/mcp --header "Authorization: Bearer $VOXT_API_KEY"ตั้ง VOXT_API_KEY ในเทอร์มินัลของคุณก่อน เพื่อไม่ให้คีย์ปรากฏในพรอมต์หรือในไฟล์
ด้วย OAuth ไม่ต้องใส่ส่วนหัวและคีย์:
claude mcp add --transport http voxt https://voxt.ai/mcpจากนั้นเริ่ม Claude Code รัน /mcp เลือก voxt และเลือกการยืนยันตัวตน หน้าต่างเบราว์เซอร์จะเปิดพร้อมหน้ายินยอมของ Voxt อนุมัติการเข้าถึงแล้วผู้ช่วยจะเชื่อมต่อ โดยไม่ต้องสร้างหรือเก็บคีย์
ผู้ช่วยอื่นมีหน้าการตั้งค่าสำหรับเซิร์ฟเวอร์ MCP ระยะไกลหรือตัวเชื่อมต่อ ซึ่งคุณป้อนที่อยู่เดียวกัน และส่วนหัวหรือการลงชื่อเข้าใช้อย่างใดอย่างหนึ่ง MCP อธิบายทั้งสองวิธี ขอให้ผู้ช่วยแสดงรายการแชท Voxt ของคุณเพื่อตรวจสอบว่าการเชื่อมต่อใช้งานได้
ให้คำสั่ง
ให้คำสั่งแก่ผู้ช่วยตามนี้ แทนที่โฟลเดอร์และชื่อแชท
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 ผ่านผู้ช่วย ดังนั้นแชทที่มีไฟล์ขนาดใหญ่จำนวนมากต้องเรียกหลายครั้ง ข้อความตัวอักษรอย่างเดียวเร็ว
คู่มือที่เกี่ยวข้อง
- แชท สำหรับมุมมองของสมาชิกต่อโหมดนำเข้า
- MCP และเอกสารอ้างอิงเครื่องมือ
- RPC API