TelegramOS Documentation
Operator docs for TelegramOS: connect accounts, pair proxies, run the unified inbox, automation and hosted bots, plus the API, billing, and per-account limits.
TelegramOS 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 (wiped of all chats between tenants) or uploaded by you from an existing Telegram Desktop session.
The shape of a workspace
| Component | Role |
|---|---|
| Accounts | Rented from the pool (wiped between tenants) 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 | Digital listings, plus peer-to-peer resale of accounts, channels, groups and bots through the store bot. |
| Billing | Wallet + subscription. Crypto or Telegram Stars. |
| 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 ($1 per bundle).
- Wallet: prepaid USD balance, scoped to your current workspace. Topped up with crypto or Telegram Stars.
- Pool: inventory of unallocated rental accounts. A returned account is wiped of every chat and can be rented again; accounts whose session died are quarantined.
- Resale listing: an owned account another operator sells through the store bot. Not a pool account; paid directly to the seller.