The Telegram glossary — every term that matters in 2026

A reference list of every term you’ll encounter while building, growing, or monetizing on Telegram. Bookmark it. Search it. Each entry links to the canonical source.

Organized by surface, not alphabetically — you’ll find the entry you need by scanning the section, not by typing.

The platform

Telegram — the messenger. Owned by Telegram FZ-LLC. Free to use, partly funded by the Ads Platform and Premium subscriptions.

Telegram Premium — paid subscription tier (~$5/mo). Unlocks larger uploads, custom emoji reactions, voice-to-text, business features, and a few prestige badges. Required to enable Telegram Business and to issue Boosts.

TON (The Open Network) — Layer-1 blockchain originally seeded by Telegram, now governed by the TON Foundation. Native token: Toncoin. The official wallet ships embedded in Telegram.

Toncoin — TON’s native cryptocurrency. Used for: in-app payments, NFT gifts, withdrawing Stars, and gas on the TON network.

Identities

User — a real human account. Has id (int), username (optional, @handle), first_name, language_code, and an optional Premium badge.

Bot — an automated account. Same id/username shape but with is_bot: true. Created via @BotFather. Has an HTTP API token granting full control.

Channel — one-to-many broadcast surface. Subscribers can read but not post. Owner + admins post. Public channels have a @handle; private channels share via invite link.

Group — many-to-many chat. Up to 200,000 members. “Supergroups” are groups with extended features (forum mode, slow mode, admin tools).

Forum (topics) — a supergroup with topic-tabs. Each topic is its own thread. Used by communities for organized discussion.

Channel vs Group: channels broadcast, groups discuss. A channel + group pair is the standard “media + community” architecture.

Authentication & sessions

Phone number — primary identifier. Required for account creation; can be hidden from non-contacts via privacy settings.

Username — optional public handle (@yourname). Globally unique. Tradeable as TON-based collectibles via Fragment.

Two-Factor Auth (2FA) — optional cloud password. Required to recover an account if SIM is lost.

initData — signed payload Telegram passes into Mini Apps. Contains user identity, theme, start_param. Must be HMAC-verified server-side. core.telegram.org spec ↗

Login Widget — the OAuth-style “Log in with Telegram” button for external websites. core.telegram.org spec ↗

Bot API

Bot API — HTTPS interface for bots. Base URL api.telegram.org/bot<TOKEN>. core.telegram.org reference ↗

Update — a single event delivered to a bot (new message, callback, payment, etc.). Polled via getUpdates or pushed via webhook.

Webhook — HTTPS endpoint Telegram POSTs updates to. Set with setWebhook. Recommended over polling for production.

Long polling — alternative to webhook; getUpdates blocks until events arrive. Simpler dev setup; not recommended for scale.

Inline keyboard — buttons attached to a message. Each button has a callback or URL. Common UI primitive.

Reply keyboard — replaces the user’s keyboard with predefined option buttons. Less common in 2026.

Callback query — what fires when a user taps an inline button with callback_data. Must be answerCallbackQuery’d within ~10s.

Inline mode — @yourbot query works in any chat. Bot returns inline results. Enable via @BotFather.

Bot commands — /start, /help, custom. Listed in the bot’s command menu (set via setMyCommands).

BotFather — @BotFather, the official bot for creating and managing bots. core.telegram.org guide ↗

Mini Apps

Mini App (formerly Web App) — HTML5 application that runs inside Telegram with native chrome. core.telegram.org spec ↗

WebApp bridge — window.Telegram.WebApp JS object exposing identity, theme, native UI, payments, and storage to your code.

MainButton — a native button at the bottom of the Mini App, controlled via JS. The standard primary action.

BackButton — native back button at the top-left, only visible when your code shows it.

Cloud Storage — WebApp.CloudStorage — key-value store synced to the user’s Telegram cloud. ~10KB total. Cross-device, no DB needed for small state.

Bot Web App vs Mini App — used interchangeably in 2026. “Mini App” is current branding.

start_param — query parameter passed when a Mini App is opened via t.me/bot/app?startapp=value. Read in initData.start_param. Used for referrals, deep links, attribution.

App Center — Telegram’s curated directory of Mini Apps (invite-only as of Q1 2026).

Payments

Stars (XTR) — Telegram’s in-app currency for digital goods. Bought by users in-app. Mandatory for selling digital products through bots/Mini Apps. core.telegram.org spec ↗

Provider token — credential for a fiat payment provider (Stripe, Smart Glocal, etc.) configured via @BotFather.

Invoice — a payment request created by sendInvoice or createInvoiceLink. Contains currency, prices, payload (your idempotency key).

pre_checkout_query — update fired before charge. Must answerPreCheckoutQuery within 10s, or payment auto-fails.

successful_payment — Message field set after a charge completes. Idempotency-key your handler on invoice_payload.

refundStarPayment — Bot API method to refund a Stars charge. Programmatic. Manual for fiat (provider dashboard).

Subscription period — invoice field for native recurring billing in Stars. Telegram handles renewals automatically.

TON Wallet — official wallet built into Telegram (formerly Wallet by Telegram, now self-custodial via @wallet bot). Holds Toncoin and TON-native tokens.

Fragment — TON-based marketplace for usernames, anonymous numbers, NFT gifts. fragment.com.

Channels & growth

Boost — a Premium user “vouching” for a channel. Each channel has a Boost level threshold (1, 4, 10, 25, 50…) unlocking custom emoji, more stories, custom backgrounds.

Channel monetization — set of features unlocked when an owner enables it: paid posts, channel subscriptions, ad revenue share, gifts.

Paid post — a single channel post locked behind a Stars unlock. Reader pays once.

Channel subscription — recurring Stars subscription giving access to a private companion channel.

Ad Revenue Share — Telegram pays channel owners a share of revenue from Sponsored Messages displayed inside their channel.

Sponsored Message — an ad shown in channels with 1k+ subscribers, served by the Telegram Ads Platform.

Stories — 24-hour ephemeral posts on channels (since 2024). Unlocked at Boost Level 2.

Folder sharing — share a folder of channels via a single invite link. Used for cross-promotion.

Boost swap — informal mutual-boosting arrangement between channel owners.

Telegram Business

Telegram Business — feature set bundled into Telegram Premium (since 2024). Turns a personal account into a lightweight CRM. core.telegram.org overview ↗

Business profile — opening hours, location, intro message visible to non-contacts.

Quick Reply — saved message accessible via /shortcut. Cross-device sync.

Greeting message — auto-fires once when a new contact writes for the first time.

Away message — auto-fires when offline by schedule.

Business Connection — bot permission to read and reply on behalf of a personal account. core.telegram.org API ↗

Custom intro — message shown in an empty chat with you (replaces the default empty state).

Ads Platform — self-serve platform at ads.telegram.org. Text-only sponsored messages targeting channels, bots, Mini Apps. core.telegram.org overview ↗

CPM — cost per 1,000 impressions. Default Ads Platform pricing model.

CPC — cost per click. Alternative bidding mode (since late 2024).

Sponsored block — the message format with a “Sponsored” label that appears at the bottom of large channels.

Premium-only

Custom emoji — user-uploaded emoji packs. Free to use; sending requires Premium.

Emoji status — animated emoji shown next to your name. Premium feature.

Larger uploads — 4GB per file vs 2GB on free tier.

Voice-to-text — automatic transcription of voice notes. Premium-gated.

Faster downloads — uncapped bandwidth on Premium.

Less-common but useful

Saved Messages — your private “notepad chat.” Now supports tags (since 2024) for organization.

Folder — chat list filter (Work / Personal / Channels). Shareable since 2023.

Spoiler — formatting that hides text/media until tapped.

Reactions — emoji reactions on messages. Up to 11 distinct on Premium, 1 on free.

Live location — share moving location for 15min/1hr/8hr.

Slow mode (groups) — limit how often each member can post.

Gift — sendable Stars gift or NFT gift attached to a message. Public unless made private.

Anonymous number — TON-based collectible phone number issued by Fragment. Used to register a Telegram account without exposing your real number.

Useful @bots

@BotFather — create and manage bots
@PremiumBot — manage Premium subscription
@Wallet — TON wallet (self-custodial)
@DonateStars — official Stars donation flow
@Stickers — create custom sticker packs
@StoreBot — directory of bot apps
@gif — official GIF search bot

Useful @channels (canonical references)

@telegram — official news
@durov — founder’s posts (changes are often previewed here before docs)
@BotNews — Bot API changelog
@TONblockchain — TON ecosystem updates

Further listening

Two long-form conversations with Telegram founder Pavel Durov that frame the why behind the platform — useful background for anyone building on it.

A 3-hour conversation covering Telegram's product philosophy, the Stars economy, Mini Apps strategy, and what's next.

Human Rights Foundation talk — privacy, encryption, and the tradeoffs Telegram makes.

Updated frequency

This glossary is rebuilt every quarter. Last refresh: April 2026. Telegram ships fast; if a term feels wrong or missing, that’s expected — open an issue on GitHub or wait for the next refresh.