İçeriğe geç

İçe ve dışa aktarma ​

Voxt'ta dosya üreten ya da okuyan bir "sohbeti dışa aktar" veya "sohbeti içe aktar" düğmesi yoktur. Veriler iki programatik arayüzden geçer:

  • Dışa aktarma, bir sohbetin mesajlarını, eklerini, üyelerini ve özetlerini MCP veya RPC API üzerinden okur.
  • İçe aktarma, başka bir hizmetteki eski geçmişi bir sohbete ekler. Sahip içe aktarma modunu başlatır, üyeler onay verir ve mesajlar MCP içe aktarma araçlarıyla ya da RPC API'nin içe aktarma hizmetiyle gönderilir. Her iki durumda da sahip, tüm süreci bir asistandan yürütebilir.

Bir sohbeti dışa aktarın ​

Dışa aktarma için bir API anahtarı ya da OAuth ile giriş gerekir. Asistan veya betik sizin adınıza hareket eder; bu yüzden tam olarak sizin okuyabildiğiniz sohbetleri okuyabilir, başkasını değil.

  1. Bir API anahtarı oluşturun ya da MCP sayfasında anlatıldığı gibi bir asistanı OAuth akışıyla bağlayın.
  2. Asistanınızdan dışa aktarmayı isteyin; örneğin: "Trip photos sohbetinin tüm mesajlarını oku ve tarihler ve yazarlarla bir Markdown dosyası olarak kaydet." Araçları asistan seçer; adlarını bilmeniz gerekmez.
  3. Bir betik için araçları doğrudan çağırın. Araç başvurusu bunları bağımsız değişkenleriyle listeler.

Okunabilenler:

VeriAraçlarNotlar
Mesajlarlist_messages, get_id_rangeEn eskiden başlayarak, çağrı başına en çok 1.024 mesaj. Hiçbir şey dönmeyene kadar son mesaj kimliğinden devam edin. Kaldırılmış mesajlar atlanır.
Sabitlenmiş mesajlar ve tepkilerlist_pinned_messages, list_reactions
Fotoğraflar, videolar, dosyalar ve bağlantılarlist_media, list_files, list_linksAya göre gruplanır, en yeni ay başta. Her ekin bir içerik URL'si vardır.
Üyelerlist_members, list_place_members
Sohbetler ve mekânlarlist_group_chats, list_peer_chats, list_places, list_place_chats, list_archived_chats, get_chat, get_placeNeyi dışa aktaracağınızı bulmak için kullanın. Arşivlediğiniz sohbetleri yalnızca list_archived_chats listeler.
Özetlerlist_conversations, get_conversationBir sohbetin özetlenmiş bölümleri, örneğin bir sesli oturum.
Arama sonuçlarısearch_messages, search_contacts

Büyük bir sohbeti dışa aktarmadan önce bilmeniz gerekenler:

  • Araçlar bir dosya değil, sayfalar döndürür. Sonucu asistan veya betik birleştirir.
  • Hâlâ akış hâlinde olan bir mesajın henüz metni yoktur. O bölümü daha sonra yeniden okuyun.
  • Zaten okuduğunuz mesajların düzenlenmesi ve kaldırılması bildirilmez. Sohbet hâlâ etkinse aralığı yeniden okuyun.

Geçmişi bir sohbete içe aktarın ​

Başka bir hizmetteki bir konuşmayı Voxt grup sohbetine ya da mekâna getirmek için içe aktarma modunu kullanın. Mesajlar asıl yazarlarının adı ve asıl tarihleriyle saklanır; sohbet sanki baştan beri Voxt'taymış gibi görünür.

Önce bilmeniz gerekenler:

  • İçe aktarmayı yalnızca sohbetin veya mekânın sahibi başlatıp bitirebilir.
  • Grup sohbetleri ve mekânlar için çalışır. Mekân genelindeki bir içe aktarma, mekândaki her sohbeti kapsar. Birebir sohbetlere içe aktarılamaz.
  • Her yazar sohbetin mevcut bir üyesi olmalı ve onay vermelidir. Onay vermemiş, ayrılmış ya da üye olmayan birinin mesajları reddedilir.
  • İçe aktarılan mesajlar geçmiş bir tarihli olmalı, her biri bir öncekinden sonra gelmeli ve sohbetteki en yeni mesajdan sonra olmalıdır. Üyelerin katılması gibi sistem mesajları da sayılır; bu yüzden bir grup sohbetinde geçmiş, üyeler katıldıktan sonraki tarihlerle olmalıdır. Yalnızca sohbette hâlâ bulunan mesajlar sayılır; bu yüzden geçmiş, orada olan mesajların önüne eklenemez, ama sığdırılabilir: içe aktarma sırasında sahip sohbetin geçmişini silebilir ya da tek tek mesajları kaldırabilir, ardından silinen mesajlar kadar eski bir geçmiş içe aktarılabilir. İçe aktarma sırasındaki bir silme geri alınamaz ve "geçmiş silindi" notu göndermez.
  • İçe aktarma modu açıkken, sahip dahil kimse mesaj gönderemez. Mekân genelindeki bir içe aktarma, mekândaki her sohbette mesaj göndermeyi durdurur.
  • İçe aktarılan mesajlar bildirim göndermez.

İçe aktarma modunu başlatın ​

Uygulamada:

  1. Sohbetin ayarlarını açın (dar bir ekranda sohbet üst bilgisindeki üç nokta düğmesini, sonra Sohbeti düzenle'yi seçin; geniş bir ekranda sağ paneli açın ve üst bilgisindeki düzenle düğmesini seçin) ya da mekân genelindeki bir içe aktarma için mekânın ayarlarını açın ve İçe aktarmayı başlat'ı seçin. Bu giriş yalnızca sahiplere gösterilir, konularda gösterilmez.
  2. İçe aktarma modu başlatılsın mı? sorusunu onaylayın. Voxt yaklaşık on saniye boyunca birkaç son kontrol yapar ("İçe aktarma moduna geçiliyor"). Başlarken biri mesaj gönderdiyse Voxt, o mesajı kaldırmanızı ve yeniden başlatmanızı ister.
  3. Mesaj kutusu, herkes için Bakım modu ile değişir.
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 içe aktarma araçlarına sahip bir asistan aynısını start_import ile yapabilir. Çağrı onayladığınızı belirtmedikçe araç hiçbir şey yapmaz, çünkü her üye için mesaj göndermeyi durdurur.

Üyelerden içe aktarmaya izin vermelerini isteyin ​

Onay penceresi, üyelerin onayı ve içe aktarmanın bitirilmesi Bir sohbetin geçmişini içe aktarın bölümünde gösterilir. Kısaca:

  1. Her üye sohbeti açar, Bu oturumda mesajlarımın ve medyamın içe aktarılmasına izin ver'i seçer ve İçe aktarmaya izin verilsin mi? sorusunu onaylar. Bir onay, o içe aktarma için geri alınamaz. Kendi mesajlarını içe aktarmak için sahip de onay verir.
  2. Sahip, onay veren üyelerin oranını ("Onaylayan: %100 (3 / 3)") ve henüz onay vermeyenleri görür.
  3. Onay vermemiş üyelerin mesajları reddedilir; bu yüzden geçmişini istediğiniz herkes onay verene kadar bekleyin.

Üyeler içe aktarma sırasında sohbete yazamaz, bu yüzden sahip onlara orada hatırlatma yapamaz. Bunun yerine birebir sohbetlerinizden onlara yazın; onlar açık kalır. Bir asistan bunu yapabilir: get_import, onay vermemiş üyeleri her biriyle olan birebir sohbetinizle birlikte listeler; asistan oraya bir hatırlatma gönderir ve istediğiniz oran onay verene kadar yeniden kontrol eder.

Eski geçmişe yer açın ​

Geçmiş, sohbette zaten bulunan mesajlardan daha eskiyse, örneğin üyelerin katılmasını kaydeden sistem mesajlarından, önce onları kaldırın. MCP araçlarında wipe_history, sohbetin mesajlarını seçilen bir mesajdan itibaren (varsayılan olarak hepsini) kaldırır; yalnızca içe aktarma sürerken ve yalnızca sahipler için çalışır ve mesajlar silindikten sonra döner. remove_message tek bir mesajı kaldırır. İkisi de içe aktarma sırasında çalışır. Silme geri alınamaz, bu yüzden çalıştırmadan önce sahipten onay alın. Mesajlar içe aktarıldıktan sonra yeniden silmeyin: onları da kaldırır.

Mesajları gönderin ​

İçe aktarma modu açıkken, sahibin asistanı veya programı geçmişi gönderir:

  1. Geçerli içe aktarmayı okuyun (get_import); her çağrının gerek duyduğu içe aktarma kimliğini taşır.
  2. Önce ekleri, onları gönderen üye adına yükleyin; o üye onay vermiş olmalıdır. Her yükleme tek bir mesaja eklenir.
  3. Mesajları 1 ile 100 arasındaki gruplar hâlinde, en eskiden başlayarak gönderin. Her mesajın yazarı, asıl zamanı, metni (en çok 64 KB), en çok 10 eki ve isteğe bağlı olarak yanıtladığı mesaj vardır. Bir grubun kendi kimliği vardır: aynı grubu yeniden göndermek önceki sonucu döndürür, bu yüzden ağ hatasından sonra yeniden denemek mesajları çoğaltmaz.
  4. Bir yanıt yalnızca sohbette zaten var olan bir mesajı gösterebilir; bu yüzden önce mesajı daha önceki bir grupta gönderin ve dönen kimliğini kullanın.
  5. Mekân genelindeki bir içe aktarmada her mesajı, ait olduğu mekân sohbetine gönderin. Her mesajın sonucunu kontrol edin. Bir grup kısmen başarılı olabilir: reddedilen mesaj nedeniyle birlikte döner (örneğin "Bu üye içe aktarmaya onay vermedi."), diğerleri saklanır.

Bu adımlar için MCP araçları Geçmişi içe aktarın bölümünde anlatılır. Aynı hizmet programlara RPC API üzerinden sunulur; veri türleri İçe aktarma veri türleri sayfasındadır. MCP'nin post_message aracı bir içe aktarma değildir: sizin adınıza, şimdiki tarihle mesaj gönderir.

İçe aktarma modunu bitirin ​

Tüm mesajlar gönderildiğinde sahip uygulamada İçe aktarmayı bitir'i seçer ya da asistan end_import'u çağırır. Üyeler yeniden mesaj gönderebilir ve içe aktarılan geçmiş ilk yeni mesajın üstünde yer alır. Hiç onay vermemiş üyelerin içe aktarılmış mesajı olmaz.

İçe aktarmadan sonra sohbeti kaydırarak kontrol edin: mesajlar asıl yazarlarını ve tarihlerini gösterir, ilk yeni mesaj onların ardından gelir. Birkaç mesajı kaynakla karşılaştırın ve asistanınız bir liste tuttuysa reddedilen mesajların listesini okuyun. Daha da iyisi, eksik olanları hâlâ gönderebileceğiniz içe aktarma modunu bitirmeden önce içe aktarılan mesajları geri okuyun.

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

Örnek: Telegram dışa aktarımını içe aktarın ​

İçe aktarmanın tamamı, MCP ile Voxt'a bağlı ve bilgisayarınızdaki dışa aktarma klasörünü okuyabilen bir asistan tarafından yapılabilir; örneğin Claude Code ya da dosya erişimi olan başka bir asistan. Kendi programınıza gerek yoktur. Dosyalarınızı okuyamayan, yalnızca sohbet eden bir asistan bunu yapamaz.

Başlamadan önce:

  1. Telegram Desktop'ta sohbeti dışa aktarın: sohbeti açın, Export chat history'yi seçin, Machine-readable JSON'u seçin ve isterseniz fotoğrafları ve dosyaları ekleyin. Dışa aktarma klasöründe result.json ile photos ve files gibi klasörler bulunur.
  2. Voxt grup sohbetini oluşturun ve Telegram sohbetinde yazan kişileri ekleyin. Her birinin bir Voxt hesabı olmalı ve üye olmalıdır. Voxt üyesi olmayan Telegram adları içe aktarılamaz.
  3. Asistanın nasıl oturum açacağına karar verin: bir API anahtarıyla ya da OAuth üzerinden Voxt hesabınızla (aşağıda).
  4. Voxt'u asistanınıza MCP sunucusu olarak ekleyin (aşağıda).

Voxt'u MCP sunucusu olarak ekleyin ​

Sunucu adresi https://voxt.ai/mcp'dir. Oturum açmanın iki yolu vardır. İkisinde de asistan sizin adınıza hareket eder.

Bir API anahtarıyla. Voxt'ta bir anahtar oluşturun (Ayarlar → API ve uygulamalar → API Anahtarı Oluşturun) ve bir Authorization: Bearer başlığıyla iletin. Claude Code'da şunu çalıştırın:

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

Anahtar bir istemde ya da dosyada görünmesin diye önce terminalinizde VOXT_API_KEY'i ayarlayın.

OAuth ile. Başlığı ve anahtarı bırakın:

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

Sonra Claude Code'u başlatın, /mcp'yi çalıştırın, voxt'u seçin ve kimlik doğrulamayı seçin. Voxt onay sayfasıyla bir tarayıcı penceresi açılır; erişimi onaylayın, asistan bağlanır; oluşturulacak ya da saklanacak anahtar yoktur.

Diğer asistanlarda, uzak MCP sunucuları ya da bağlayıcılar için bir ayar sayfası vardır; oraya aynı adresi ve başlığı ya da girişi yazarsınız. MCP iki yolu da anlatır. Bağlantının çalıştığını denetlemek için asistandan Voxt sohbetlerinizi listelemesini isteyin.

Talimatı verin ​

Asistana şuna benzer bir talimat verin. Klasörü ve sohbet adını değiştirin.

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.

Örnekle ilgili notlar:

  • Telegram bir mesajın zamanını saat dilimi olmadan saklar. Gerisini göndermeden önce ilk içe aktarılan mesajları asıl sohbetle karşılaştırın.
  • Reddedilen mesajlar grubu durdurmaz. Nedeni düzeltin (eksik bir üye, içe aktarmaya izin vermemiş bir gönderen, sırası bozuk bir zaman) ve onları yeni bir grup olarak yeniden gönderin.
  • Eşlenemeyen mesajlar dışarıda bırakılır; bu yüzden tam kayda ihtiyacınız varsa Telegram dışa aktarımını saklayın.
  • Her dosya asistan üzerinden 1 MB'lık parçalarla taşınır; bu yüzden çok sayıda büyük dosyası olan bir sohbet çok sayıda çağrı gerektirir. Yalnızca metin hızlıdır.