Telegram OS Documentation
Complete operator documentation for Telegram OS
Telegram OS is an operator platform for running many Telegram accounts from one workspace. Each account is paired with a dedicated proxy, has its own warm-up schedule, and can be wired into the unified inbox, the automation runner, and the hosted bot system.
Accounts are either rented from the platform pool (one tenant per account, ever) or uploaded by you from an existing Telegram Desktop session.
The shape of a workspace
| Component | Role |
|---|---|
| Accounts | Rented from the pool (one-tenant lifetime) or uploaded as your own. Each pinned to its own proxy. |
| Proxies | Rental proxies from the platform, or your own. Strict pairing rules apply. |
| Inbox | Unified DM, group, channel, and bot conversations across every account. |
| Automation | Campaigns, flows, and auto-replies with anti-ban pacing. |
| Bots | Hosted Telegram bots. Broadcasts and webhook handlers. |
| Analytics | Optional message analysis. Per-user toggle in Privacy. |
| Marketplace | Buy and sell templates, promotions, bots, and curated accounts. |
| Billing | Wallet + subscription. Card or crypto. |
| Teams | Invite teammates with roles and audit trail. |
| Privacy | Per-user analytics opt-out. Per-rental login-code redaction. |
Key terms
- Workspace: your personal account. Holds your accounts, proxies, bots, wallet, and subscription.
- Operator: a person using the platform.
- Rented account: allocated from the platform pool. Comes paired with a rental proxy. Login-code messages from Telegram (peer ID 777000) are hidden.
- Owned account: uploaded by you from a Telegram Desktop session. Nothing is hidden.
- Bundle: 1 account + 1 dedicated proxy. The unit of pricing ($4 per bundle).
- Wallet: prepaid USD balance, scoped to your current workspace. Topped up with card or crypto.
- Pool: inventory of pristine, never-allocated accounts. Once rented, the row is retired permanently.
- Special account: curated marketplace listing for a previously-used account.