Glossary

Terms used in the Session / TData export tool. Definitions match actual product behavior. Contact support if anything is unclear.

Auth code

A credential you receive after purchase. Used to log into the export site and deduct export uses.

• Each code has a fixed maximum number of uses (e.g. 10)
• Each successful Session / TData export deducts 1 use
• Possible states and error messages:

Message	Meaning
Auth code not found	The code was not found in the system
Auth code disabled	The code was disabled by an administrator
Auth code expired	The code has passed its validity period
Auth code invalid	Invalid format or content
Auth code uses exhausted	All uses have been consumed
Insufficient remaining uses	The operation needs more uses than remain

Session / StringSession

A string-format login session used by the Telethon library.

• Saved in session.txt inside the ZIP
• A text string loadable in Telethon, Pyrogram, and other StringSession-compatible libraries
• Contains login credentials — sensitive; do not share

TData

The local data directory format used by Telegram Desktop.

• This tool converts StringSession to TData via opentele
• Saved in the tdata/ folder inside the ZIP
• Can be imported into Telegram Desktop
• Also sensitive login information

ZIP package

The download file containing Session, TData, and account info.

• Filename: country code + phone number (digits only), e.g. 8613988881111.zip
• Extracted root folder: same name as the ZIP (without .zip)
• Contains session.txt, account.json, and tdata/

account.json

Account metadata inside the ZIP, in JSON format:

Field	Description
phone	Full phone number (with country code)
generated_at	File generation time
device_model	Simulated device model
system_version	Simulated system version
app_version	Simulated app version
has_2fa	Whether Cloud Password was entered during this export (true if yes, otherwise false)
profile	Telegram profile (username, display name, etc.)

Important

account.json does not contain your two-step verification password (Cloud Password) in plain text, or any recoverable password data.

Export uses / quota

The number of exports bound to an auth code.

• After login, the page shows "X / Y remaining" at the top
• X = remaining uses, Y = total uses on the code
• Each successful export deducts 1 use
• Uses are deducted only after all files are generated successfully; failed code delivery, wrong verification code, 2FA failure, or packaging failure do not deduct uses
• When uses are exhausted, purchase a new auth code

Job ID

Unique identifier for a single export job.

• Assigned when you start an export (phone or QR)
• Used to query status and download files
• Jobs can expire; if expired, start a new export

Job status

Possible states during export:

Status	Meaning
Pending	Job created, waiting for next step
Code sent	Verification code sent to phone
Waiting for QR scan	QR code generated, waiting for phone scan
QR listen timed out	QR listen window expired; refresh and retry
Waiting for 2FA password	Cloud Password required
Building	Generating Session and TData
Completed	Success; ready to download
Failed	Generation error
Expired	Job timed out

Two-step verification / Cloud Password

Telegram account security feature, also called "cloud password".

• When enabled in Telegram settings, new device logins require this password
• This tool prompts for it during login, same as official Telegram
• Password is only sent for verification during login, not saved in exported files
• has_2fa in account.json indicates whether Cloud Password was used in this export, not the password itself

Telethon

Python Telegram client library.

• Supports loading login sessions via StringSession
• Use contents of session.txt in scripts or automation

Pyrogram

Another Python Telegram client library.

• Also supports StringSession format
• Can use the session string from session.txt

Telegram Desktop

Official Telegram desktop client.

• Supports importing TData directories as local login data
• The tdata/ folder from this tool is in that format

Country code

International dialing prefix, e.g. +86 (China), +1 (US).

• Entered separately when filling in your phone number
• ZIP filename digits combine country code and phone number (no + sign)

Verification code

Numeric login code from Telegram, usually 5 or 6 digits.

• Received in official Telegram messages on your phone
• Not necessarily an SMS code (though SMS may be used in some cases; in-app Telegram messages are the primary source)
• Expires after a limited time; request a new one if needed

QR code login

Sign in by scanning the on-page QR code with Telegram on your phone.

• Path: Telegram → Settings → Devices → Link Desktop Device
• Page QR code expires in about 30 seconds and auto-refreshes
• Click Refresh QR code manually if listen times out