tgme — User Guide

Complete operator handbook — every feature, what it does, how to use it.

This is the in-app reference. Click any section in the table of contents to jump there. Use the search box to find anything quickly. Click Download PDFto save the whole guide for offline reading — your browser’s print dialog will open with “Save as PDF” pre-selected.

1Getting Started

tgme is a Telegram growth console. It runs two engines side by side: Telegram User Accounts (real accounts logged in via MTProto, for scraping and account broadcasts) and Bots (Bot-API bots, for subscriber broadcasts, auto-reply, menus and more).

Open the login page and enter the username + password your administrator gave you. If you enabled 2FA, also enter the 6-digit code.

Land on the Dashboard

The dashboard shows your wallet balance, plan, and a summary of accounts and bots.

Check your plan

Open Billing & Plan from the sidebar to see what your subscription includes and how much quota is left.

Two engines, one console

User Accounts and Bots are completely separate Telegram systems. Anything under Accounts / Scrape / Account Broadcasts uses real accounts; anything under Bots uses Bot-API bots. They never share data.

2Telegram User Accounts

Real Telegram accounts logged in to tgme. Use them to scrape group members and to run account-side broadcasts. Each account is a real SIM-registered Telegram account you link as a device.

Add a single account

Accounts → Add account

Top-right of the Accounts page.

Enter a label

Free text, only you see it — e.g. Sales-1.

Optionally set a proxy + notes

Proxy format: http://user:pass@host:port. Skip it to use the server's direct IP.

Link the device

Click Link, then on the SIM phone: Telegram → Settings → Devices → Link Desktop Device, and scan the QR.

Account activates

Within seconds the state turns active and a 7-day warm-up starts.

Batch login

To link many accounts at once, click Batch login, paste phone numbers (one per line, up to 100), and each phone enters its 8-character pairing code. The system staggers pairings 30–60s apart to avoid rate-limiting the server IP.

Warm-up period

A freshly linked account cannot broadcast for 7 days. It is otherwise fully usable (scraping, chats). This protects new accounts from instant bans.

3Anti-Ban & Appeals

Tools that keep your accounts healthy and help recover them after a restriction.

Anti-Ban Profile

Under Accounts → Anti-Ban Profile you set conservative behaviour limits (sending speed, daily caps, rest windows). Apply a profile so the broadcast worker automatically paces every account.

@SpamBot health check

From the Accounts list you can probe an account against Telegram's @SpamBot. tgme reads the reply and flags the account as clean or limited so you know which numbers are safe to send with.

Appeals

Open the appeal dialog

On a restricted account, click Appeal.

Pick a template + enter your email

Templates auto-fill the account's phone. Telegram replies to the email you give.

Submit & mark

The Telegram appeal form opens pre-filled; solve the captcha, submit, then click Mark as submitted.

7-day appeal cooldown

After submitting an appeal for an account, tgme blocks further submissions for it for 7 days. Telegram penalises repeat submitters — spacing appeals out improves your odds.

4Scrape Groups & One-Click Pull

Collect members from public Telegram groups, then add them into your own group or channel.

Scrape a group

Bots/Accounts → Scrape Group

Paste a public group link or @username.

Pick a scraping account

An active user account that has joined (or can join) the source group.

Run the scrape

Members are collected into a list you can review and export.

One-Click Pull

One-click Pull takes a scraped member list and invites those users into your own group/channel, paced safely across your accounts to avoid flood limits.

Pull conservatively

Adding strangers to groups is the single fastest way to get an account limited. Use small daily batches and let warmed-up accounts do the pulling.

5Account Broadcasts

Send a message from your real Telegram accounts to many recipients (contacts, scraped lists, group members). This is separate from Bot Broadcasts (§12).

Broadcasts → New broadcast

Name it and write the message body. You can use the variables in §20.

Pick sending accounts

Only active, past-warmup, non-restricted accounts can be selected.

Choose a pacing mode

Shared, Per-account, or Rotation — controls how the load spreads across accounts.

Add recipients & send

From a contact group, a manual paste, or existing chats. The list refreshes every few seconds with live progress.

Pacing defaults

For warmed accounts: 15–45s between messages, batches of 10, 5–10 min rest. For newer accounts go slower: 30–60s, batches of 5, 15–30 min rest.

6Proxy Pool

A shared pool of proxies you can assign to accounts. Spreading accounts across different IPs reduces the chance Telegram links and bans them together.

Proxy Pool → add a proxy

Format: http://user:pass@host:port. Give it a label.

Assign to accounts

Each account can use one proxy; an unassigned proxy is free to reuse.

One IP, a few accounts

Don't pile dozens of accounts on a single proxy. A handful per IP is much safer.

7Bots — Browsing & Organising

The Bots engine manages Bot-API bots (created via @BotFather). The Bots page drills down in three levels so a large fleet stays organised.

Level 1 — Countries

The Bots page shows country cards. Click a country to enter it.

Level 2 — Company groups

Inside a country you see company group cards (your own custom labels). Bots with no group are listed directly at the bottom.

Level 3 — The bots

Click a company-group card to see the bots inside it.

Add a bot

Get a token

In Telegram, message @BotFather, send /newbot, and copy the token it gives you.

Bots → Add Bot

Paste the token. tgme validates it and pulls the bot's identity.

Set country + group

On any bot card use the Country and Group pickers to file it under the right place in the 3-level browser.

8Managing a Bot

Click a bot to open its detail page. It is organised into tabs.

Tab	What it's for
Overview	Identity, status, quick health test.
Messages	Two-way chat — see conversations and reply (§10).
Subscribers	Everyone who started the bot, with status (§11).
Webhook	Switch delivery mode polling ⇄ webhook (§9).
Settings	Profile, commands, country/group, follow-up and more.

Test first

After adding a bot, click Test on the Overview tab. It confirms the token is valid and refreshes the bot's name and username.

9Delivery Mode: Polling vs Webhook

This setting controls only how a bot receives messages — it never affects sending or broadcast limits.

	Polling	Webhook
How	tgme keeps asking Telegram for updates	Telegram pushes updates to tgme
Per-bot cost	One always-on loop	Zero idle cost
Best for	A modest number of bots	Many bots (dozens / hundreds)

Switch one bot

Open the bot → Webhook tab → Switch to webhook. The receiver URL and its secret are generated automatically — nothing to paste. Press Remove webhook to go back to polling.

Switch all bots at once

On the Bots page (country view) there is a Delivery mode bar showing how many bots are on each mode, with All → Webhook and All → Polling buttons.

Test one before bulk-switching

Switch a single bot to webhook, message it to confirm it still replies, then use All → Webhook for the rest. Webhook runs the exact same handlers as polling (auto-reply, menus, subscriber tracking) — nothing is lost.

10Bot Messages — Two-Way Chat

The Messages tab is a live chat console. The left side lists every conversation; the right side shows the thread and a reply box.

Pick a chat

Choose a conversation from the left list.

Type a reply

Use the box at the bottom. Enter sends, Shift+Enter makes a new line.

Attach media (optional)

Click the 📎 button, pick Photo / Video / File, and paste a media URL. Your text becomes the caption.

Auto-refresh

The thread refreshes every 10 seconds, so new incoming messages appear on their own.

11Subscribers

Everyone who has started your bot. The Subscribers tab shows live counts: Subscribed, Unsubscribed, and active in the last 7 / 3 days.

Subscribed / Unsubscribed — tracked in real time. When a user blocks the bot they flip to unsubscribed instantly; if they restart the bot they flip back.
Broadcasts and follow-ups only ever send to subscribed users — unsubscribed people are skipped automatically.
Use the export button to download the subscriber list as CSV.

Keep the bot online

Real-time unsubscribe tracking needs the bot running (polling or webhook). While it is offline, blocks are caught on the next broadcast instead.

12Bot Broadcasts

Send one message to a bot's subscribers. Open Bot Broadcasts from the sidebar.

Pick the delivery mode

Single bot (default) or Auto-split (multi-bot).

Choose the target

All subscribers, active in the last N days, new subscribers, or a manual selection.

Compose

Send a fresh message (text or media), or forward / copy an existing post.

Send

The result panel shows sent / failed / skipped and, for multi-bot, a per-bot breakdown.

Auto-split across bots

In Auto-split mode you tick several bots. Their subscribers are merged and de-duplicated (a person reachable through several bots is messaged once), then each bot sends its share in parallel — faster, and if one bot is rate-limited the others keep going.

A bot can only message people who started it

Auto-split helps when each bot has its own audience, or when the same people deliberately started several of your bots. A brand-new bot cannot reach people who only ever started a different bot.

Flood limits are handled for you

Broadcasts honour Telegram's 429 flood limits automatically: on a limit tgme waits the required time and retries, slowing down and speeding back up on its own. For large sends, keep the rate moderate and spread big lists over time.

13Auto-Reply & Anti-Link

Configured under Auto-Reply (in the Bots section) and per-chat in a bot's settings.

Keyword auto-reply

Define keyword → response rules. When a user's message matches a keyword, the bot replies automatically — useful for FAQs, price lists and links.

Group welcome

When a new member joins a group the bot is in, it can post a welcome message automatically.

Anti-link

In groups, the bot can delete messages that contain links or @mentions. A whitelist lets trusted users or domains through.

Bot needs admin rights

To delete messages or welcome members, the bot must be an administrator in that group with the matching permissions.

14Menu Templates

A menu template is a multi-page interactive menu shown when a user sends /start (or opens a menu). Each page has text plus inline buttons that jump to other pages or open links.

Menu Templates → new template

Give it a name.

Build pages

Add a home page and any sub-pages. On each page write the body text and add buttons.

Assign it to a bot

In the bot's Settings, set the menu template — it then drives the bot's /start.

15Scheduled Posts

Queue a bot post to go out at a future time, or on a repeating schedule, to a chosen chat or channel.

Scheduled Posts → new

Pick the bot and the target chat/channel.

Write the post

Text or media, with optional buttons.

Set the time

A one-off time, or a recurring schedule. The scheduler sends it automatically.

16Auto Follow-Up

An automatic drip sequence: after someone subscribes, the bot sends a series of follow-up messages spaced over time — a welcome, then nudges, offers, reminders.

Open Auto Follow-Up

Enable it for the bot.

Add steps

Each step has content (text, media, a template or a menu) and a delay after the previous step.

Save

New subscribers are enrolled automatically and progress through the steps.

Unsubscribers are skipped

If a subscriber blocks the bot, the follow-up worker skips them — no wasted sends.

17Lucky Draw

Run a giveaway through a bot. Users join by tapping a button or sharing the draw; tgme picks winners.

Lucky Draw → new draw

Set the prize, the number of winners, and how a user enters.

Promote it

The draw posts a Join button; users can also share it inline into other chats.

Draw winners

Close entries and let tgme pick winners at random.

18Referral Program

Give each subscriber a personal invite link. When people they refer join, the referrer earns a reward — cash or points — with optional multi-level payout.

Bots → Referral Program

Turn it on for the bot and set the reward type (cash or points) and amounts.

Multi-level (optional)

Configure how many levels deep referral rewards pay out.

Withdrawals

Review and process referrer withdrawal requests from the same page.

19Bulk Add to Channels

Add many of your bots into your channels in one operation — handy when you run a large bot fleet and want them all posting to the same set of channels.

Bots → Bulk Add to Channels

Pick the bots and the target channels.

Run

tgme adds each bot to each channel and reports the result.

You must own/admin the channels

Adding a bot to a channel requires admin rights in that channel.

20Templates & Variables

Reusable message templates with a CTA button. Variables make every send slightly different.

Variable	Becomes
{name}	The recipient's name
{phone}	The recipient's phone / number
{times}	A rotating value — different per message
{randomnumbers}	Random digits — different per message

Beat identical-message detection

{times} and {randomnumbers} make each message unique, which helps high-volume sends slip past Telegram's identical-message spam filter.

21Billing & Plans

Open Billing & Plan to see your subscription, limits and wallet. Plans cap how many accounts, bots and subscribers you can run, and which features are unlocked.

Plan — your current tier, what it includes, and when it renews/expires.
Usage — accounts, bots and subscribers used vs your limit.
Wallet — your balance in MYR. Top it up to pay for the plan and usage.
Add-ons — optional boosts (e.g. extra subscriber capacity).

Over quota

If you exceed a limit, the affected feature (e.g. broadcasting) pauses until you upgrade or free up room.

22Top-Up & Payments

Your wallet is in MYR. Top it up from the Top Up page; the operator chooses which payment methods are available.

Method	How it works
USDT (TRC20)	Pick the amount; it is converted to USDT. Pay on the checkout page; your wallet is credited automatically once the transfer confirms on-chain.
Card / Online banking	Redirects to the gateway; the wallet is credited after the gateway confirms payment.
Transfer by bank	Opens a chat link to customer service. Transfer to the bank account, and the team credits your wallet manually.

Crypto top-ups

A USDT top-up is credited only after the blockchain confirms the transfer. This usually takes a few minutes — check the Orders page for status.

23Orders

The Orders page lists every wallet top-up you have made, each with a clear status.

Status	Meaning
Successful	Payment confirmed and credited to your wallet.
Pending	Order created, waiting for payment / confirmation.
Failed	The order expired or was not paid in time.

Summary cards show total credited and the count of each status; filter tabs narrow the list. Each order shows the amount, method, time and (for USDT) the crypto amount.

24My Account & Security

My Account is where you manage your own login.

Change password — do this on first sign-in if you were given a default password.
Two-factor (2FA) — enable an authenticator code for an extra layer; you then enter a 6-digit code at every login.
Sub-accounts — a MAIN customer can create SUB accounts that share the workspace. SUB accounts can top up into their own pool or the MAIN balance.

Turn on 2FA

If your account can broadcast and spend wallet funds, 2FA is strongly recommended.

25Admin Console (Operators)

Visible only to operator-tier accounts (admin / superadmin). Customers do not see this section.

Page	What it's for
Customers	Create customers, view usage, change their plan.
Orders	Every customer's top-up orders, with successful / pending / failed counts.
Referrals	Operator-side referral overview.
Revenue	Income, costs and margins.
Settings → Payment gateways	Turn Stripe, ToyyibPay, ePUSDT (USDT) and bank transfer on/off and enter their credentials.
Plans	Define subscription tiers and add-ons.

Visibility scope

A non-root operator only sees the customers they created or referred. The root SuperAdmin sees everyone.

26Troubleshooting & FAQ

Symptom	What to do
Bot won't receive messages	Check its delivery mode. If on webhook, confirm the bot is enabled; try switching to polling and back.
Broadcast stopped at a few thousand	Telegram flood-limited the bot. tgme backs off automatically; lower the rate, spread the send over time, or use multi-bot auto-split.
A bot can't message some users	Those users never started that bot, or they blocked it. A bot can only message people who started it.
Account got restricted	Use the @SpamBot check and the Appeals flow. Slow down sending and respect warm-up.
USDT top-up not credited	Crypto credits only after on-chain confirmation — wait a few minutes and check the Orders page.

Still stuck? Contact your administrator — and use the search box at the top of this guide to jump straight to the relevant section.

End of guide. Questions? Reach out to your administrator or check the API Docs for programmatic integration.