Switch sectionGetting started

Import history from other services

Which services Syncra imports history from, and how to move a Telegram group step by step.

Syncra imports chat history from Slack, Telegram and Microsoft Teams and tasks from Jira, Asana and Linear. You start an import in the workspace settings, on the Import tab, by picking the service you are moving from. This article walks through the Telegram import step by step.

From Telegram you move a group or a channel. Messages, voice messages, video messages, photos and files keep their authors and dates. If the group is split into topics, each topic becomes its own channel. Personal Telegram chats and exports of a whole account cannot be moved, only groups and channels.

Who can import

Only the owner and the admins of the workspace. Everyone else sees “Only workspace owners and admins can import chats.”

How to export a group from Telegram

  1. Open Telegram Desktop on a computer. The phone app cannot export.
  2. Open the group, click ⋮ in the top right corner and choose Export chat history.
  3. Tick photos, videos, voice messages, video messages and files, and move the size limit to the maximum.
  4. Choose the Machine-readable JSON format and export.

Telegram creates a folder with a name like ChatExport_2026-10-19. Inside it is a file called result.json.

How to load the export into Syncra

  1. Click the workspace icon at the top of the narrow blue column on the left and choose Workspace settings.
  2. Go to the Import tab and pick Telegram. The page Import from Telegram opens.
  3. Drop the folder into the window or press Choose folder.
  4. Syncra opens a screen where you set up the import, described in the next section. Check the settings and press Import.

If the page also offers Sign in to Telegram, you need no export: Syncra reads the chat through your account and signs out afterwards. This option is not available on every server.

What to set before you start

  • Topics and channels. Syncra suggests a channel name for each topic. Names use Latin letters, digits and dashes.
  • Period. Set From and To dates, or choose 3 months, 6 months, 1 year or All history.
  • People. Match Telegram people to workspace members. Anyone left unmatched gets a ghost account, a placeholder that keeps their name on their messages. When you later invite that person by email, the history becomes theirs.
  • New channels. Private channels are visible only to matched members and you. Public ones can be found and joined by anyone in the workspace.

Good to know

  • The file result.json can be up to 100 MB. If it is larger, export a shorter period of the chat.
  • Files above the workspace’s size limits are skipped. The message stays, with a 📎 mark.
  • Voice and video messages from the last 3 months are transcribed, so search finds them and the Syncra assistant can read them.
  • If a reply points at a message deleted in Telegram, Syncra cannot tell which topic it belongs to. Such replies go to General, the group’s common topic.

Progress

Syncra shows Uploading files and then Moving messages. At the end you see Import finished with the counts and a list of ghost accounts. If the connection drops, the file upload continues. If the import stops, press Retry and it carries on from where it stopped. Cancel import stops the move, and messages already moved stay. The All imports link returns to the Imports list, which shows every run.

Updated:

More in “Getting started”

Back to the category

Didn't find an answer?

Message us on Telegram. A person from the Syncra team replies.

Message us on Telegram