Skip to main content

FAQ

Startup and licensing​

Double-clicking does nothing; the app won't open​

In a virtual machine, VPS, or remote desktop environment, or with a debugger attached, the app refuses to start. Use a physical machine.

The app quit by itself while I was using it​

It quits automatically after 3 consecutive failures to reach the license server (about 3 minutes). Check your network, then reopen the app once it is back.

The main window is blocked by Activation (激活验证)​

Not activated, or the license key has expired. See License key activation. Expiry doesn't affect your accounts or data.

It says "This license key is already in use on another device" (该卡密已在其他设备上使用)​

One key binds to one machine and can't be unbound. A new computer needs a new key.

Accounts​

An account shows Offline (掉线)​

Usually not a fault: an account that a task has finished with disconnects automatically after 1 minute idle and reconnects automatically the next time it is needed. To keep it online, click Go online (上线) in the actions column.

Import sessions (导入协议号) says "missing fingerprint" (缺指纹)​

Only the Telethon format is supported, and each .session must come with a .json of the same name. tdata and Pyrogram are not supported.

An imported session account is Not logged in (未登录)​

Import data only, don't log in now (仅导入数据，不立即登录) is checked by default during import. Bulk DM brings accounts online automatically when it needs them; for other features, click Go online first.

What is the difference between Frozen (冻结) and Banned (封禁)​

Frozen: you can still log in and read messages but can't send anything, and the account is deleted if you don't appeal before the deadline. Check status (检测状态) has an appeal entry. Banned: the account is gone.

I changed the proxy or fingerprint but it didn't take effect​

Accounts that are already online must log in again for it to take effect.

No login code arrives when adding an account​

The login code is sent to the account's other logged-in devices (the 777000 chat) or by SMS. Login code (验证码) in the account library can't help here; it requires the account to be logged in already.

Picking groups​

I can't find a group when creating a task or a performance​

There is no "sync groups" step; groups are fetched live after you pick an account. Common reasons a group is missing:

  • The account isn't logged in
  • It is a broadcast channel; Scheduled Broadcast lists only groups and supergroups
  • You created a performance without Filter groups by account (按账号筛群), so you only see groups stored earlier

You can also paste a group link or @username to add it directly.

Bulk DM​

Why can only usernames be imported​

Delivery is by username only for now; people without a username can't be reached. When harvesting, the Message history (消息记录) method plus Resolve @-mentioned usernames (补全被 at 的用户名) picks up some more.

How do I resend to the ones that failed​

Failed is a final state; they don't roll into the next round. Export (导出) the list → filter for the failed ones → Clear (清空) → import again. Be careful with those noted "timed out waiting for send receipt" (超时未收到发送回执): the message may already have gone out.

What is a contacts-only block (双向拦截)​

The recipient only accepts DMs from contacts, so strangers can't get through. It is not a problem with your account.

A round stopped before it finished​

Check the stop reason in the Send log (发送记录). Common ones: number of accounts × Messages per account (单账号发送数量) < size of the list; all accounts got rate-limited; the forward source or postbot code became invalid (this stops the whole round).

An account shows Restricted (已受限)​

It hit FLOOD_WAIT or PEER_FLOOD; it recovers automatically when the time is up, nothing to do. If it keeps getting restricted, see Anti-ban.

Member Harvest​

A group with tens of thousands of members yields only about 200​

With the Member list (成员名单) method, a non-admin account can only page through about 200 members; this is a Telegram limit. Switch to the Message history method.

The log says "member list hidden, skipped" (隐藏了成员名单，已跳过)​

The group owner hid the member list. Again, switch to Message history.

Agent Filter rejects the submission​

The source contains people who have only an @username and no user id (those @-mentioned in Message history mode). Either harvest again with Resolve @-mentioned usernames turned on, or set AI judgment (AI 判定) to Don't use (不使用).

An AI judgment task fails immediately​

No API key is configured for the AI Copy API.

Scheduled Broadcast​

I checked five content types; why is only one message sent each time​

By design. The five types are alternatives to each other: each time, for each group, one form is drawn and then one item from it. See Broadcast content.

A scheduled task didn't send on time and stays Pending (待发)​

The app wasn't open at the scheduled time. Missed runs are not made up; click Send now (立即发送) or change the time.

Some groups were skipped​

They didn't reach Minimum messages in between (最小间隔消息数), or only reaction was checked and the latest message in the group already has your reaction.

Can it send to channels​

No. Only groups and supergroups are supported.

Rich text won't send​

Rich messages require the sending account to have Premium.

Script performances​

Validate and continue (校验并下一步) won't pass​

A required role slot (marked *) has no account assigned, or the assigned account isn't in that group.

A branch beat didn't jump automatically​

Branches don't decide automatically; they only leave a decision point on the Director Console timeline, and you click Jump to #N (跳至 #N) manually.

I edited the script but the running performance didn't change​

A performance stores a script snapshot when it is created. To change the current one, use Edit line (改词) in the Director Console.

Support Desk​

Do I still receive messages after leaving the Support Desk page​

Yes. Connected accounts keep listening, and the red dot in the sidebar lights up.

An account has unread messages but the red dot is off​

For groups and channels, only unread mentions are counted, not all unread messages. A grey dot means all the unread messages come from muted chats.

Auto-reply didn't trigger​

It only replies to the other person's first message in a private chat: if they have said anything in the previous 30 messages, it doesn't count as first. Groups, channels, and bots get no reply. For ones missed earlier, use Backfill missed replies.

Storage and other​

Disk usage keeps growing​

Telegram's local database only grows. Go to Settings · Storage and cache: first Clear cache (清理缓存), which has no side effects; if that isn't enough, Wipe message database (清空消息库), which keeps you logged in but disconnects briefly.

Where are the logs​

<data directory>/logs/, or click Open folder (打开目录) on the Logs (日志) page in Settings. When troubleshooting, set the level to debug, reproduce the issue once, then set it back.