Step by step
- 01
Prepare a folder on your computer
Make one parent folder (for example accounts) with a subfolder for each account inside: the subfolder name becomes the account name (the "Name" column). Each subfolder must hold one of two things: a tdata folder from Telegram Desktop or a *.session file. Next to it you may add optional files: the supplier's json (phone, 2FA password) and Password2FA.txt with the 2FA password. The tree in words: accounts → acc1 → tdata folder; accounts → acc2 → acc2.session and acc2.json; accounts → acc3 → tdata folder and Password2FA.txt. These also work — the system sorts them out itself: extra wrapper folders on top (accounts → batch_1 → acc1 → tdata: the account is still acc1); the account folder itself selected, with tdata right inside (the account name = that folder's name); "bare" tdata — the account folder holds the contents of tdata (key_datas, folders like D877F783D5D3EF8C) without the tdata folder itself; loose sessions — several *.session files in one folder: every file becomes a separate account named after the file (acc2.session → acc2), and acc2.json and acc2.txt with the 2FA password lying next to it are attached to it. Not accepted: a ZIP, RAR or 7z archive — unpack it first, you pick a folder; folders with no tdata and no .session (screenshots, txt with phone numbers, empty folders) — they are skipped with the reason "folder X has no tdata and no .session (inside: …)", the other accounts are uploaded; tdata from Telegram Desktop 6.x — version 5.x is required. Service files .DS_Store, Thumbs.db, desktop.ini and the __MACOSX folder do no harm. Two subfolders with the same name in one upload: the second one gets the suffix _2.
- 02
Upload the folder
In the "Accounts" section, click "Upload folder" at the top right — the "Upload a folder with accounts" card appears. Optionally fill in "2FA password (if any)" and turn on "Name by folder". Click "Select the folder with accounts" and pick the parent folder. The progress line "Uploading: <name>" and an N / M counter appear, then "Done!" with the blocks "Imported: N" and "Errors: N". A toast "Upload finished — N accounts imported" pops up and the accounts show up in the "Account list" table.
- 03
Wait for the background check
Right after the upload an account gets the "Active" status and a background check starts (if "Check accounts after import" is on in "Settings" → "Automation"). After 1–3 minutes click "Refresh" (the arrows icon at the top right): real data appears in the "Phone", "TG name" and "Username" columns, and the result in "Status". If the phone is still empty, click "Pull data from TG". Proxies are assigned automatically from the active proxies in the "Proxies" section; if you added proxies later, click "Distribute proxies (round-robin)".
- 04
Alternative: "Import session:proxy (.txt)"
If your accounts are string sessions, prepare a TXT where every line is: session_string:ip:port:login:password (socks5 proxy; ip:port alone also works). Click "Import session:proxy (.txt)" and pick the file. You get "Import started: N lines. Accounts will appear as they are checked". The proxy from the line is created in the "Proxies" section (no duplicates) and bound to the account. Maximum 5000 lines per file.
- 05
Learn the statuses
Below the search box there are counter cards: "Total", "Active", "Banned", "Frozen", "Restricted", "Invalid", "Connection error", "Appeal filed", "Retired". Clicking a card filters the table ("Total" clears the filter). The "Status" column shows the reason in grey text ("Restricted until 20.09.2026", "Session revoked by Telegram…", "Dead proxy (#12) — reassign the proxy"). A flame icon next to the status means "Warmed-up account".
- 06
Re-check the problem accounts
If there are invalid ones, a "Re-check invalid (N)" button appears. If there are "Error" ones, a "Re-check errors (N)" button: the proxy is checked first, then the account; a dead proxy becomes inactive in the "Proxies" section. For a single account, use the "Check" icon in the "Actions" column. For several, tick the checkboxes and click "Check selected" (no more than 10 at a time).
- 07
Check restrictions with "SpamBot check"
Tick the accounts (Shift+click for a range; "Select all" in the table header). The "Selected: N" panel appears. Click "SpamBot check". Each account in turn (with a 15-second pause) sends /start to @SpamBot: a "no limits" reply → "Active"; a future date → "Restricted until dd.mm.yyyy"; a reply about a complaint with no date → "Frozen". The date of the last SpamBot check is in the "Check" column next to the robot icon.
- 08
File an appeal (in the "Conversations" section)
The system does not write the appeal for you. Go to "Conversations", pick the frozen account, click "Open @SpamBot", and answer the bot as it instructs (usually "This is a mistake" plus the text of your request). Then click "Appeal filed" in the header of the @SpamBot chat. In "Accounts" such accounts show up under the "Appeal filed" card — the status stays "Frozen" or "Restricted" until Telegram lifts the restriction.
- 09
Return them to work or pull them out of rotation
Once SpamBot replies that there are no limits, tick the accounts and click "Restore to active" in the "Selected: N" panel, then confirm "Restore N accounts to active? This clears the restriction and the appeal flag". If an account is used up, click the "Retired (remove from rotation)" icon in "Actions": the status becomes "Retired", campaigns skip it, the stats are kept; to bring it back, use "Restore to active" in the same row. The "Delete" bin icon removes the account for good.
- 10
Tidy up: names, groups, notes
Clicking the name in the "Name" column opens "Rename account" → "New name" → "Save". The "Selected: N" panel → "Assign group": pick an "Existing group" or type a "New group name" → "Create" → "Assign group". Groups are used by warm-up, campaigns, stories and the AI commenter. The same panel has "Assign proxy" → pick a proxy → "Assign" ("No proxy" removes the proxy). The "Warmed up" / "Not warmed up" buttons add and remove the flame icon. The "Notes" column takes any comment. The "Stats" icon in "Actions" shows the account's sends, errors and campaigns.
Fields and settings
- Select the folder with accounts
- The parent folder, with one subfolder per account inside (subfolder name = account name) holding a tdata folder or a .session file; optional json and Password2FA.txt next to it. Wrapper folders on top, the account folder itself being selected, tdata contents without a tdata folder and several .session files in one folder are recognised automatically. After you pick the folder you see how many accounts were found and which folders were skipped and why. A subfolder named like an already uploaded account is skipped silently; identical names within one upload get the suffixes _2, _3. If two-step verification (2FA) is enabled on the account, sign-in is impossible without the password — enter it in the “2FA password” field when uploading or put Password2FA.txt in the folder.
- 2FA password (if any)
- The Telegram cloud password for the accounts in the folder. The field is sent to the server but is not used by the background check after import. If 2FA accounts end up "Invalid", message support @TGBLASTBOT.
- Name by folder
- If the parent folder is named, say, tg1050, the accounts get the names tg1050, tg1051, tg1052… in order. Works only if the parent folder name ends with a number.
- Import session:proxy (.txt)
- A TXT where every line is session_string:ip:port:login:password. Repeated session_string values and phones that already exist are skipped. Limit 5000 lines.
- Status
- Active — ready to send. Banned — Telegram deleted the account. Frozen — an open-ended restriction that needs an appeal. Restricted — a temporary restriction with an end date. Invalid — the session/tdata cannot be read. Error — the connection failed (usually the proxy). Retired — you pulled the account out of rotation by hand.
- Appeal filed (filter card)
- Not a status but a flag saying you wrote an appeal to @SpamBot. Set by the "Appeal filed" button in "Conversations", cleared by the "Restore to active" button.
- Proxy
- The ip:port of the account's proxy. Assigned automatically on upload — the active proxy with the fewest accounts. To change it: select → "Assign proxy"; to hand one to everyone without a proxy — "Distribute proxies (round-robin)".
- Check
- The date of the last connection check; below it, with the robot icon, the date of the last check through @SpamBot.
Tips
- Before you start a campaign, run "SpamBot check" on every account you need: the regular check only shows "alive/not alive", and only SpamBot sees sending restrictions.
- Add proxies in the "Proxies" section first, then upload accounts — the proxies will be bound automatically.
- The "Geo" column is derived from the phone code — handy for filtering accounts from a given country.
- Instead of deleting used-up accounts, use "Retired (remove from rotation)" — the stats stay in "Stats" and in campaign reports.
- Table headers are clickable for sorting; the "Search by phone, name, username..." box searches every field.
- If "Re-check errors" returns the reason "Dead proxy", change the proxy, not the account: select those accounts and assign a different one with "Assign proxy".
- Not sure about the structure? Just pick the folder: before the upload you see how many accounts were found and what was skipped with the reason, and the upload card has a collapsed "How to prepare the folder?" help with an example tree.
Gotchas and common mistakes
- "SpamBot check" only checks the status — it does not file an appeal, even though the notification calls it "Appeal filed for N accounts". An appeal is written by hand in "Conversations".
- The "Accounts" page has no "Appeal filed" button — the flag is set only in "Conversations", in the chat with @SpamBot.
- "Restore to active" sets "Active" without any check. Confirm with "SpamBot check" first.
- "Check selected" handles at most 10 accounts at a time. For bulk checks use "Re-check invalid" / "Re-check errors".
- tdata from Telegram Desktop 6.x is not supported — the reason reads "New-format TData (Telegram Desktop 6.x)". Re-export it from version 5.x.
- If "Check accounts after import" is off in "Settings", uploaded accounts stay "Active" with no real check, and the phone and username stay empty.
- The account limit of your plan applies: the "Errors" block will show "Account limit for your plan: N. Upgrade your plan." — delete the extra accounts or renew your plan in the "Subscription" section.
- The folder upload runs through the browser one account at a time — do not close the tab until "Done!" appears.
- "Delete" removes the account for good, together with its stats.
- The hint in the empty table, "Import accounts from Google Drive", is out of date: only "Upload folder" and "Import session:proxy (.txt)" are available.
- "Distribute proxies (round-robin)" touches only accounts without a proxy and needs at least one active proxy ("No active proxies to distribute").
- "Select the folder with accounts" accepts only a folder: unpack a ZIP, RAR or 7z archive first. A folder with neither tdata nor .session (screenshots, phone lists) is skipped with the reason "folder X has no tdata and no .session (inside: …)" — the other accounts are still uploaded.
No tdata or .session — add the account by QR code.