🚀 Getting started
Understand the application, folders and runtime first
Feature overview
JQOneMatrix supports multi-account Telegram operations, including account access, collection and filtering, direct and group messaging, inviting and joining, registration and activation, group workflows and advanced tools. This guide groups features by workflow; use the V1, V2 and V3 names shown in the left menu when operating the application.
Recommended first-run sequence
- Import accounts in Account Management and prepare proxies.
- Select a few accounts and run Bulk Login or Account Check to verify both network and account status.
- Review message, thread and network-concurrency options in Global Settings.
- Prepare the groups, users, messages, media or tokens required by the task.
- Run one account, a small dataset and a test target before scaling up.
- Review successful, failed and unprocessed data together with the logs before retrying.
Installation, startup, multiple instances and data folders
- Extract the complete package, keep its structure and make sure the folder is writable.
- Start
JQOneMatrixN.exeand wait for the main interface and left menu to finish loading. - Use a separate
DataNfolder for each instance; never let two processes operate on the same account files. - Back up or migrate the complete matching data folder because accounts, settings, logs, temporary files and reports live in different subfolders.
TelegramN stores regular account data, while TelegramN_New and TelegramN_Temp support new-import or temporary flows. Do not move their files manually while the application is running.
Logs, network and system time
For connection failures, code timeouts, Flood limits or authorization errors, read the account row and task log first. “Network connected” only means a connection was established; it does not mean Telegram authorized the account.
- Verify the computer time and time zone.
- Test proxy type, host, port, credentials and availability separately.
- Run a login check on one account and distinguish Network Status from Account Status.
- When reporting an error, keep the account, time, feature entry and complete error text.
🔐 Accounts and access
Import accounts, configure proxies and authorize new devices
Account Management
Account Management supports import, grouping, Bulk Login, Account Check, proxy switching, offline actions and export. Network Status and Account Status must be interpreted separately.
Import and check workflow
- Select Import Accounts and choose the Session or account-file format.
- Provide the correct two-step verification password when required; use force-password behavior only when an override is intentional.
- Select a few accounts, choose a low thread count and run Bulk Login.
- Wait for an explicit account state, then use Account Check for restriction, registration-time or other checks as needed.
- Group or batch verified accounts and export a backup before using them in other tasks.

Proxy settings and batch proxy switching
- Maintain proxies in the proxy dataset and verify type, host, port, username and password.
- Test connectivity before selecting target accounts in Account Management.
- Use Batch Change Proxy or Distribute Proxies to assign them.
- Run Bulk Login or Account Check on one account after switching and verify both connectivity and authorization.
- Scale only after validation; do not place too many accounts on one poor-quality proxy.
Advanced Import and Passkey
Passkey authorizes a new-device login. It does not contain all old-device information and does not require purchasing an additional token.
- Open (P)Advanced Import and import a working original Session.
- Run a login check and confirm the Session is authorized and can read account information.
- Export and securely save the Passkey file.
- For the new device, choose the matching type or file named like
Passkey-*-New. - Wait for authorization, then run another login check in Account Management.

🧩 Content and data
Datasets, randomized text and message formats
Datasets and random syntax
When the dataset under the second icon on the left contains values, {random} returns one random line; the default dataset contains emoji. If the dataset is empty, it returns one random English letter, number, symbol or space.
{random}{random}Run the placeholder twice{random_2}Return exactly 2 values{random_3_6}Return 3–6 values{random_p}Letters and numbers, default length 10–32{random_p_2}Fixed length 2{random_p_1_10}Random length 1–10Workflow
- Open the dataset, add one candidate per line and save it.
- Insert the required placeholder into a text field that supports it.
- Send several tests to verify dataset, fixed-length and ranged output.
- If the dataset is empty, remember that
{random}becomes one random character rather than an emoji line.
Supported message formats
- Regular messages: text, image, voice and video are supported; at least one must contain data. Choose Markdown or Html for formatted text.
- A single URL: select Default. If Convert Single Link to Media is disabled in Global Settings, the URL is sent directly and strangers usually see no preview; when enabled, it is sent as a media message.
- Sticker:
https://t.me/addstickers/stickershortname1sends a random sticker from that pack; add/2to select the second sticker. - PostBot: use
@postbot content; for your own compatible bot use~@mypostbot content. - Share a contact: use
~+15105226666 Display Name. The number may exist or not; only the display differs.
PostBot, Topics and content tools
Topic information, phone numbers or usernames, random media and deduplication are all task-preparation data.
- Confirm whether the selected feature expects a link, phone number, username or collected-data format.
- Deduplicate merged batches and keep an untouched source backup.
- Prepare random-media folders using only media types supported by the task.
- Provide the matching Topic information for topic sending; do not mix a group link with a Topic identifier.
- Test one record before importing the complete list.
🔎 Collection and filtering
Prepare usable data before outreach tasks
User, group and content collection
Current menu entries include Collect Users, Collect Users V2, Collect Groups/Channels and Collect Links/Messages. Each version has different sources and filters.
Collect Users V2 example
- Select logged-in accounts and confirm they can access the source group or channel.
- Enter group data; for channel sources, enable Include Related Group when needed.
- Set Count, groups per operation and Online Time. Use 0 only where the interface explicitly says it means unlimited.
- Enable Join Groups, Deep Collection, Collect from Cache, and username, display-name, bio or message-keyword filters only as required.
- Select Start, watch account logs and the success count, then scale after a successful test.
- Inspect and deduplicate the result before using it for inviting, direct messaging or filtering.

Filter PhoneNumber and Filter Phone/User V2
- Prepare one deduplicated phone number or username per line in the format required by the selected entry.
- Select logged-in accounts and configure threads, intervals and batch size.
- Test a small input and confirm the meaning of successful, failed and unprocessed areas.
- Run the complete task; after stopping, retain unprocessed data instead of classifying it as invalid.
- Record the filtering time with exported results and sample-check again before a later task when necessary.
💬 Messaging and interaction
Select the task version that matches the workflow
Bulk Private Message and Auto Group Message
The application provides Bulk Private Message/V2 and Auto Group Message/V2/V3. Their target input, scheduling and optional conditions differ, so do not reuse another version's configuration blindly.
- Select verified accounts and import user or group data in the format required by the current version.
- Enter text or choose images, voice or video; at least one content type must be valid.
- Select Default, Markdown or Html. Use Default for special message syntax.
- Configure threads, per-account quantity, send intervals and stop conditions.
- Send to your own test target and verify formatting, media, link previews and randomized content.
- After running, retain successful, failed and unprocessed data and use logs to distinguish invalid targets, permission errors, Flood limits and network errors.
Auto Group Chat, Auto Private Chat, replies and marketing
Related entries include Auto Group Chat, Auto Private Chat/V2, Auto Group Reply/Forward, Auto Reply/Like/Forward and Automated Marketing.
- Define the listening scope: group, private chat, keyword or message type.
- Configure the action: reply, like, forward or send prepared content.
- Set accounts, roles, quantity, time, interval and stop conditions.
- Check that no other task is using the same account or processing the same message.
- Create one test message and confirm the rule triggers once with the correct action.
- Monitor logs while running and stop the task before changing its rules.
👥 Invites, joining and groups
Create groups, invite members and synchronize content
Bulk Create channels and groups
- Open Bulk Create and select logged-in accounts that can create the required targets.
- Prepare names, descriptions, channel/group type and public/private options shown on the page.
- Set per-account quantity and operation interval, then create one test target.
- Verify its link, permissions, visibility and administrator capabilities.
- Save or export the result before using it in Bulk Inviting, Auto Group Message or Sync Groups.
Bulk Inviting / V2 / V3
The versions retain different workflows. Bulk Inviting V2 supports multiple accounts, multiple threads and changing the group title after joining.
- Select logged-in accounts and import the target groups and users to invite.
- Configure threads, per-account/per-group limits, intervals, stop conditions and whether to leave groups.
- For title changes, enable Change Group Title When Joining, provide title candidates or random output, and enable unique titles when needed.
- If Change Title After Interval Count is enabled, the title changes only after the invite interval is met; the first account does not need to rename immediately.
- Enable Do Not Invite with Title-Changing Account when that account should only handle title changes.
- Test with a few accounts and one group, then run the full task and inspect successful, failed and unprocessed data.

Batch Join Groups, checks, bots and synchronization
Batch Join Groups/Check, Batch Join Groups V2/Bot and Batch Join Groups V3 add accounts or bots to targets; they are different from Bulk Inviting.
- Prepare one deduplicated group link or collected-format record per line.
- Select accounts; in Bot mode, confirm the Bot is configured and has the permissions required by the target operation.
- Set per-account join count, threads and intervals, then choose options such as group distribution, random groups or join only when needed.
- Check links or join one test with one account before the full task.
- Inspect successful, failed and unprocessed data; resume from unprocessed data after a stop.
- For Sync Groups, verify source and destination again to avoid reversing the direction.
⭐ Registration and advanced tools
Registration, Premium and extension management
Bulk Register, Batch Activation/Online and one-week Premium
- Open Bulk Register, select the registration platform or method, and prepare numbers, verification/authorization resources, proxies and matching tokens.
- Verify the API/device type, country code, two-step verification, email and other options shown on the page.
- For one-week Premium registration, purchase the matching Premium token and choose that type in the registration module; do not use a standard registration token.
- Use low threads and intervals to test one number through verification, email, payment or Premium steps.
- Confirm the new account reaches the regular account directory and can log in before starting the batch.
- Use Batch Activation/Online as needed after registration; keep new accounts at low frequency before adding concurrent tasks.
Premium, tokens, bots and business tools
Depending on the licensed scope, current entries also include (P)Premium Management, (P)Group & Bot Management, (P)Report Links, Claim Username, Change Phone, Business, Email Management, Payment Management and Token Management.
- Import and check the required resources in Email, Payment or Token Management.
- Open the business feature and select logged-in accounts and target data.
- Verify credential type, account permissions, target links and irreversible-action warnings.
- Run one account and confirm both the result and resource-consumption state.
- After a batch, retain successful, failed and unprocessed data and check whether used credentials were marked correctly.

🛠️ Settings and troubleshooting
Diagnose first, then decide whether to retry or reset
Global settings, proxies and task parameters
Global Settings affects multiple features. Record the old value before a change and validate with one account, a small dataset and one target.
- System Network Concurrency: limits concurrent network connections that do not use a proxy; use the value displayed by the current application as the baseline.
- Proxy Network Concurrency: limits concurrent connections associated with a proxy and is separate from each task's thread count.
- Convert Single Link to Media: controls whether a Default-format single URL is sent directly or as a media message.
- Threads and intervals: adjust task threads, per-account quantity and action intervals gradually for account, network and target limits.
- Datasets: verify actual
{random}and{random_p}output after changing content.
Stuck login, frozen accounts and Batch Offline
“Network connected” does not mean “account logged in.” A frozen account may return FROZEN_METHOD_INVALID during Telegram authorization, or it may stall on verification, two-step authentication, Session data or proxy handling.
- Stop Bulk Login and wait for the task to finish; do not dispatch new work to the account.
- Read Network Status, Account Status and the complete account log, and record the Telegram response.
- Confirm that no other feature or application instance is using the same account.
- In Account Management, select only the affected account and choose Batch Offline. In the current version this also force-cleans a residual client when its login count is already 0.
- After going offline, switch or test the proxy and run Bulk Login or Account Check for that account only.
- If Telegram still reports frozen, banned, revoked Session, verification or two-step errors, resolve that condition; repeated offline actions cannot remove an account restriction.