Telegram shill bot, and the API it cannot use

By Mara Vogel Published 7 August 2026 13 min read

Every result on the first page for telegram shill bot is selling something. Three are code repositories with an install fee attached, the rest are vendor blogs and Medium posts written by the vendors themselves, and across all eight not one number is traced to a Telegram document. The word bot in the product name is the first thing worth checking, because in most of these products it does not describe what is running.

Telegram exposes two interfaces and they behave nothing alike. A bot token addresses the HTTP Bot API. A phone number addresses MTProto, the client protocol every Telegram app is built on. Which one a shilling tool uses decides what it can reach, which errors it collects, and whose account is at stake.

Every Telegram figure below is quoted from Telegram's own documentation with the page it came from named. Where Telegram publishes nothing — and on shilling volume it publishes nothing at all — this guide says so rather than borrowing a number from a vendor page. That is the standard every guide here clears.

What is a Telegram shill bot?

A telegram shill bot is software that posts one promotional message into many Telegram groups on a schedule, most often for a token launch. Shilling means promoting a project to manufacture attention around it. Three unrelated products share the name, and they differ on the only question that matters: which Telegram interface each one talks to, and therefore what happens when it runs.

Only the third row is a bot in Telegram's sense of the word. The first row is a person's account being driven by a script, and the second row is advertising bought from a group owner. Marketing copy uses one term for all three, and a buyer comparing prices across them is comparing three different exposures.

Can a Telegram shill bot post to groups on the Bot API?

No, not into a group the bot was never added to. Telegram's Bot Platform introduction states that bots cannot start conversations and that a user must add them to a group first. No Bot API method makes a bot join a chat on its own initiative, so a bot token has no route into the hundreds of groups a shilling campaign targets. The boundary is structural rather than a policy that tooling can work around.

"Bots can't start conversations with users. A user must either add them to a group or send them a message first."Telegram Bot Platform introduction, core.telegram.org/bots

A second restriction narrows what a bot experiences even after somebody adds it. Telegram states that "Bots added to groups only see relevant messages in the chat", the behaviour it calls Privacy Mode, so a bot in a group is not a general observer of that group either.

Those figures come from the Telegram Bots FAQ, and their original wording matters. The per-chat figure is advice — "In a single chat, avoid sending more than one message per second." The per-group figure is a cap: "In a group, bots are not be able to send more than 20 messages per minute." The bulk figure is explicitly approximate. Reading them as one number produces a queue that breaks on the first busy day, which is the ordinary engineering problem behind what a Telegram bot can and cannot be built to do.

What a shill bot telegram setup actually runs on

A shill bot telegram setup runs on personal accounts through MTProto, not on a bot token. The most-linked open-source example in this search result states it in its own README: "We have not heard of anyone successfully using a bot token; you will most likely have to use your phone." Add-member tooling reaches the same conclusion, and for the same structural reason. Once a number is signed in, the product is a scheduler wrapped around ordinary client API calls that any Telegram app makes.

That repository has been archived and read-only since April 2022, which is worth knowing before it is treated as maintained software. The calls it wraps have not been archived, though, and Telegram documents every error each one returns.

Five of those seven are decided by the group, not by the sender. Slowmode is a per-user cooldown an admin sets on a chat, and it applies whatever the posting schedule says; a group with a 300-second slowmode accepts twelve messages an hour from any account, including every account in a fleet. Pacing on the sending side cannot move a number set on the receiving side.

Getting into the groups is its own documented surface. Telegram's reference for channels.joinChannel, the method that joins a channel or supergroup, publishes a distinct error list.

CHANNELS_TOO_MUCH confirms that a ceiling on group membership exists while naming no number for it, and INVITE_REQUEST_SENT is what an approval-gated group returns — a request queued for a human, not a membership. FROZEN_METHOD_INVALID is the one to read twice: Telegram documents a frozen account state, and documents nothing about what puts an account into it.

How to shill on Telegram, as the tooling describes it

Every guide to how to shill on Telegram describes the same loop: sign several personal accounts in, join as many groups as each account can hold, rotate slightly different versions of one message, and wait between sends. The waiting is the step that sales copy leaves out, and it is the step that decides whether the accounts are still working at the end of the week.

The archived script quoted above is unusually direct about both halves. On repetition: "When you send identical messages, multiple times to multiple channels, Telegram will ban you." On pacing: "A safe wait_interval is typically around 900 seconds." That second figure is the tool author's, not Telegram's, and Telegram publishes nothing to confirm or contradict it — but it is the only interval anywhere in this category attached to a stated reason.

The gap between those rows is a factor of 180, and the lower row is the one written by somebody with no product to sell. Ninety-six messages a day is also a ceiling rather than a forecast, since it assumes every target group accepts every post — and the error table above lists seven documented reasons a group returns nothing at all.

What Telegram shill groups are, and who moderates them

Telegram shill groups are chats whose stated purpose is cross-promotion: members post their own project and are expected to engage with everyone else's. Some are open, some sell placement, and every one of them sits under an admin who can restrict, mute or remove any account at will. A group's moderation settings, not a sending schedule, decide whether a promotional message survives its first minute.

Telegram also ships moderation the admin does not have to build. Its API documentation describes a native antispam system enabled through channels.toggleAntiSpam, available once a supergroup passes a member threshold that Telegram states only as a configuration parameter name.

"Once enabled, Telegram's native antispam system will start monitoring the supergroup, automatically deleting spam messages using the official Telegram Antispam bot."Telegram API, native antispam system

The Bot API exposes the same switch as a read-only field on a chat: has_aggressive_anti_spam_enabled, documented as "True, if aggressive anti-spam checks are enabled in the supergroup. The field is only available to chat administrators." The interface a shilling product cites as its foundation is the interface that reports whether the automatic deletion is already on.

Telegram's position on promotional messages in groups is one sentence, and it is specific about groups rather than general about spam: "Moderators are more lenient when it comes to messages in groups, but anyone who sends spam or unsolicited advertisments will be limited." Leniency and permission are different things, and the sentence grants the first only.

This guide publishes no list of shill groups. Lists of that kind are the standard lead magnet in this category, and circulating one would be recommending the practice while describing its consequences three sections later.

Telegram crypto shill groups and the rules above Telegram's

Telegram crypto shill groups concentrate legal exposure, because paid promotion of a crypto asset is regulated speech in the United States regardless of which app carries it. Section 17(b) of the Securities Act of 1933 requires anyone paid to promote a security to disclose the source and the amount of that compensation. A platform's terms are the floor here, and never the ceiling.

The best-documented enforcement of that rule involved no Telegram group at all, which is exactly why it is useful: the medium was never the point. The SEC's order of 3 October 2022 found that the promoter failed to disclose a $250,000 payment for a single social post about a crypto asset security.

Settled at $1.26 million — roughly $260,000 in disgorgement plus prejudgment interest, and a $1,000,000 penalty — alongside an agreement not to promote crypto asset securities for three years.SEC press release 2022-183, 3 October 2022

In March 2023 the SEC charged eight further celebrities over undisclosed compensation for touting two other crypto assets, so the 2022 order was a pattern rather than an outlier. The Federal Trade Commission runs a parallel regime with a wider reach: its Endorsement Guides at 16 CFR Part 255 require a material connection between an endorser and a marketer to be disclosed clearly and conspicuously, and that duty attaches to any endorsement, not only to securities.

Read against a shill group, both rules describe the same missing element. A paid poster in a chat room is an endorser with a material connection, and the format of these groups — a wall of enthusiasm from accounts that read as ordinary members — is the absence of disclosure rather than an oversight in it. Contact data at Sendhaus is handled under the privacy policy, which also sets out the position on client-supplied lists and paid placement.

This is general information and not legal advice. Whether a particular token is a security is fact-specific, obligations differ by jurisdiction and by whether the audience is retail or professional, and a campaign touching several countries needs review by a qualified adviser in each.

What Telegram never published about a telegram shiller bot

Every telegram shiller bot figure in circulation comes from somewhere other than Telegram. Telegram publishes no posting rate for a personal account, no group-joining cap, no ban threshold and no appeal criteria. It documents the errors that fire when a limit is reached and stops there, which makes the numbers on vendor pages unverifiable rather than merely unsourced.

Across the eight pages ranking for telegram shill bot in August 2026, not one cited a Telegram document for a numeric claim, and three of the eight were code repositories with a paid installation attached.Sendhaus review of the telegram shill bot search results, August 2026

An unsourced number is not automatically a false one. It is untestable, which is the worse property for a buyer: the figure arrives without the account histories, the sample size or the failure rate that would let anyone check it, and the same operation is described at 5 seconds on one page and 900 on another.

Which account carries the consequence

The personal account carries it. Shilling software runs on phone numbers, so Telegram's limitation mechanism lands on a number rather than on a bot token, and the mechanism is described plainly: reports go to moderators, and if the moderators decide the messages deserved it, the account becomes limited temporarily. Telegram's Terms of Service put the underlying prohibition in six words — "Use our service to send spam or scam users."

What a limited account can still do is narrow and precisely worded. Telegram states that "Limited accounts can send messages to people who have their number saved as a contact", and that "You can also always reply to anyone who messages you first." Inbound conversation survives. Contact with strangers, which is the entire function of a shilling fleet, does not.

Three related patterns end on the same kind of account, usually the same one, because the tooling is normally bundled into a single interface and a single signed-in session: what happens to accounts sending unsolicited direct messages, what an invite member bot actually calls, and what a mass report panel is really selling. Buying one product from that bundle concentrates the exposure rather than spreading it.

What replaces a telegram shill bot

Nothing replaces it one-for-one, and the alternative is slower in week one. Attention is bought or earned in public, converted into people who pressed a link, then broadcast to on the Bot API inside the published rates. The reachable audience is smaller at the start and still reachable a year later, which is the opposite trade to the one shilling software offers.

1. Post where you hold the admin rights

   A channel or group you administer is a chat the Bot API can post into without asking anyone's permission, at the documented rate of no more than 20 messages per minute in a group. No slowmode, no CHAT_WRITE_FORBIDDEN, no account restricted by a stranger.

2. Buy placement through official Telegram Ads

   Paid reach into other people's audiences exists as a first-party product, priced and reviewed by Telegram. How a subscriber base gets built without a list to import covers the placement side and what bought members cost a channel afterwards.

3. Convert attention into people who started the bot

   A bot cannot open a conversation, so every reachable contact begins with somebody pressing a link. Deep-link parameters record which placement produced each arrival, which turns spend into a measured number rather than an impression count.

4. Broadcast inside the published rates

   Telegram advises against more than one message per second in a single chat, caps a bot at 20 per minute in a group, and states about 30 messages per second for bulk notifications unless paid broadcasts are enabled, which raises it to 1,000 per second at 0.1 Stars per message. Queue design and delivery-state reporting is ordinary engineering once the audience exists.

5. Disclose paid promotion inside the message

   Where a post is compensated, the disclosure belongs in the post rather than in a profile or a pinned notice. That is what "clear and conspicuous" describes in the FTC's Endorsement Guides, and it costs nothing to satisfy before a campaign starts.

When a telegram shill bot is the wrong tool

Four situations defeat this category regardless of which product is bought, because all four are properties of the platform, the audience or the law rather than of the software. Each is checkable in an afternoon, and each is cheaper to check than to discover after purchase.

The first is a target audience that is not in the groups. Shill groups are populated by other people promoting other projects, so the reachable audience is promoters rather than buyers, and message volume does not convert one into the other. The second is a regulated offer: a token that is a security, a financial product, or anything where an undisclosed paid endorsement is the violation rather than an aggravating detail. The third is a set of target groups with active moderation, where slowmode, admin restriction and Telegram's native antispam settle the outcome before pacing is even consulted. The fourth is a business that needs the same audience next quarter, since a limited account cannot contact anyone who has not saved its number, and the accounts do not come back.

Frequently asked questions

Sources

• Telegram Bot Platform introduction — bots cannot start conversations; a user must add them to a group first; Privacy Mode.
• Telegram Bots FAQ — the per-chat, per-group and bulk broadcast rates, HTTP 429, and paid broadcasts.
• Telegram Bot API reference — has_aggressive_anti_spam_enabled.
• Telegram API, messages.sendMessage — the published error table, including SLOWMODE_WAIT and CHAT_WRITE_FORBIDDEN.
• Telegram API, channels.joinChannel — CHANNELS_TOO_MUCH, INVITE_REQUEST_SENT and FROZEN_METHOD_INVALID.
• Telegram API, native antispam system — channels.toggleAntiSpam and the official Antispam bot.
• Telegram API error reference — error class 420 and FLOOD_WAIT_X; PEER_FLOOD is not listed.
• Telegram API Terms of Service — sections 1.4 and 4.2.
• Telegram Terms of Service — the prohibition on sending spam or scamming users.
• Telegram spam and limitation FAQ — what gets reported, group leniency, and what limited accounts can do.
• TelegramShillBot README — the bot-token admission and the 900-second interval; archived April 2022.
• SEC press release 2022-183 — Section 17(b) anti-touting, the undisclosed payment and the settlement terms.
• 16 CFR Part 255 — the FTC Endorsement Guides and the material-connection disclosure duty.

Related guides

• All three service lines — broadcast, growth and automation, with the declined-work list attached to each.
• Telegram mass DM — every published send limit in its original wording, and the four things Telegram documents nowhere.
• Telegram scraper — where the target lists come from, and the errors that stop the collection.
• Telegram invite member bot — the missing add-member method, and the two errors that end most attempts.
• Telegram mass report bot — why no bot can file a report, and what the panels are really selling.
• Sendhaus — Telegram broadcast, growth and automation built on the platform's published limits.