Пређите на садржај

Увоз и извоз ​

Voxt нема дугме „извези чет“ или „увези чет“ које ствара или чита фајл. Подаци се преносе преко два програмска интерфејса:

  • Извоз чита поруке, прилоге, чланове и сажетке чета преко MCP-а или RPC API-ја.
  • Увоз додаје раније поруке из другог сервиса у чет. Власник покреће режим увоза, чланови пристају, а поруке се шаљу преко MCP алата за увоз или сервиса за увоз RPC API-ја. У оба случаја власник може да води цео поступак из асистента.

Извоз чета ​

За извоз је потребан API кључ или OAuth пријава. Асистент или скрипта делује у ваше име, па може да чита тачно оне четове које и ви можете да читате, и ништа више.

  1. Креирајте API кључ или повежите асистента преко OAuth тока, као што је описано у MCP-у.
  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. Отворите поставке чета (на уском екрану изаберите дугме с три тачке у заглављу чета, па Уреди чет; на широком екрану отворите десни панел и изаберите дугме за измену у његовом заглављу), или места за увоз за цело место, и изаберите Покрени увоз. Ставка се приказује само власницима, и не у нитима.
  2. Потврдите Покренути режим увоза?. Voxt обавља неколико завршних провера око десет секунди („Улазак у начин увоза“). Ако је неко објавио поруку док се режим покретао, 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. Поруке чланова који нису пристали се одбијају, зато сачекајте док не пристану сви чију историју желите.

Чланови не могу да пишу у чету током увоза, па власник тамо не може да их подсети. Пошаљите им поруку у вашим директним четовима; они остају отворени. Асистент то може да уради: get_import наводи чланове који нису пристали, сваког са директним четом који имате с њим, а асистент тамо објављује подсетник и поново проверава док не пристане удео који желите.

Направите места за старију историју ​

Ако је историја старија од порука које су већ у чету, на пример системских порука које бележе придруживање чланова, прво их уклоните. Са MCP алатима, wipe_history уклања поруке чета од изабране поруке надаље (подразумевано све), само док увоз траје и само за власнике, и враћа одговор тек кад су поруке обрисане; remove_message уклања једну поруку. Оба раде током увоза. Брисање не може да се опозове, зато га потврдите са власником пре него што се изврши. Немојте поново брисати након што су поруке увезене: уклонило би и њих.

Слање порука ​

Док је режим увоза укључен, власников асистент или програм шаље историју:

  1. Прочитајте текући увоз (get_import); он садржи ID увоза који је потребан сваком позиву.
  2. Прво отпремите прилоге, за члана који их је послао; тај члан мора да је пристао. Сваки прилог се везује за једну поруку.
  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 извоза ​

Цео увоз може да обави асистент који је повезан са Voxt-ом преко MCP-а и може да чита фасциклу извоза на вашем рачунару, као што је Claude Code или други асистент са приступом фајловима. Не треба вам сопствени програм. Асистент само за ћаскање који не може да чита ваше фајлове то не може да уради.

Пре почетка:

  1. У програму Telegram Desktop извезите чет: отворите чет, изаберите Export chat history, изаберите Machine-readable JSON и укључите фотографије и фајлове ако их желите. Фасцикла извоза садржи result.json и фасцикле као што су photos и files.
  2. Направите Voxt групни чет и додајте људе који су писали у Telegram чету. Сваки од њих треба да има Voxt рачун и мора бити члан. Telegram имена која немају Voxt члана не могу да се увезу.
  3. Одлучите како се асистент пријављује: API кључем или вашим Voxt рачуном преко OAuth-а (испод).
  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 извоз ако вам је потребан потпун запис.
  • Сваки фајл путује у деловима од 1 MB преко асистента, па чет са много великих фајлова захтева много позива. Сâм текст је брз.