Step by step
- 01
Prepare a folder on your computer
Make one parent folder with a subfolder for each account inside. Each subfolder must hold a tdata folder (from Telegram Desktop) or a *.session file. Example: accounts/acc1/tdata/..., accounts/acc2/acc2.session. The subfolder name becomes the account name (the "Name" column). A subfolder with no tdata and no .session is skipped with the error "No .session or tdata".
- 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 holding a tdata folder or a .session file. The subfolder name is the account name; a subfolder whose name is already uploaded is skipped silently.
- 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 @saymynamepython.
- 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".
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 subfolder 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").
All account tools — what the dashboard includes.