Skip to main content

Add Accounts

An actor (演员) is one Telegram account. Broadcasts, DMs, harvesting, support and performances all run on them. There are two ways to add them, both at the top right of Accounts (账号管理).

If your network cannot reach Telegram, add proxies in Proxies first.

Phone login​

Click Add account (添加账号).

  1. Phone number (手机号): include the country code, for example +8613800000000. You can also pick an outbound proxy (出网代理) at this step. Click Send code (发送验证码)
  2. Login code (验证码): Telegram sends it to another device where the account is already logged in (the chat with the official account 777000) or by SMS. Enter it and click Submit code (提交验证码)
  3. Two-step verification (两步验证): this step only appears if the account has it enabled. Enter the password
  4. Done (完成)

A freshly logged-in account stays online, and there is nothing else to do. Which groups it has joined is fetched live when a feature needs it; there is no "sync groups" action.

Import sessions​

Click Import sessions (导入协议号) and drag in files or a whole folder.

  • Only the Telethon format is accepted: one .session plus a .json with the same name (the device fingerprint). Files without a json are marked Missing fingerprint (缺指纹) in the preview and cannot be imported
  • The phone number is taken from phone in the json, or from the file name if it is absent; twoFA in the json is carried into the Two-step verification column
  • Use proxies (使用代理) allows multiple selections, assigned in rotation by file order; select none and every account connects directly
  • Import data only, do not log in now (仅导入数据，不立即登录) is checked by default: nothing goes online during the import, and the status afterwards is Not logged in (未登录). Bulk DM brings such accounts online automatically when it needs them; for other features, click Go online (上线) in the actions column first
  • Uncheck it and each account is verified against Telegram one by one; banned accounts and accounts with a dead session are reported on the spot and not stored

Reading the two status columns​

Account statusMeaning
Normal (正常)Logged in, nothing abnormal on Telegram's side
Frozen (冻结)Can log in and read messages, but cannot send anything; if not appealed before the deadline, the account is deleted
Banned (封禁)Banned by Telegram
Session revoked (已注销)Telegram revoked this session; log in again
Not logged in (未登录)Never logged in, logged out manually, or a session account imported as data only
Logging in (登录中)In the middle of the login code or two-step verification step

The runtime state is only ever Online (在线) or Offline (掉线). Offline is not a fault: an account that a task has finished with disconnects automatically after 1 minute idle (saves traffic and one fewer standing connection), and reconnects automatically the next time it is needed. Freshly logged-in accounts and accounts you brought online manually are exempt.

Next steps​

caution

Logging in a large number of accounts in a short time on the same machine and the same exit IP is itself a risk signal. See Anti-ban and pacing advice.