Telegram Bots
What Telegram bots are and why TFilely uses them.
What are Telegram Bots?
Telegram bots are official automated accounts created through Telegram's @BotFather. Each bot receives a unique API token and can interact with Telegram's Bot API to send messages, transfer files, and manage channels.
TFilely uses your personal bot tokens to upload and download files through the Telegram Bot API. Each bot acts as an authorized intermediary between TFilely and Telegram's servers, operating within the permissions and rate limits defined by Telegram's platform.
Why Multiple Bots?
Telegram enforces per-bot rate limits on API calls. These limits restrict how many requests a single bot can make within a given time window. This is a standard part of Telegram's API design, intended to prevent abuse and ensure fair usage across the platform.
To stay compliant with these limits, TFilely distributes file operations across multiple bots. Instead of overloading a single bot and risking throttled or rejected requests, TFilely rotates between your bots so that each one stays well within Telegram's allowed thresholds. This approach respects the rate limits rather than working around them.
We recommend creating at least 6 bots. More bots provide additional capacity for heavy usage such as batch uploads or large file transfers, while keeping each bot's request rate low and compliant.
How Bot Rotation Works
TFilely automatically rotates the active bot at a configurable interval. Only one bot is active at any given time. When the rotation interval expires, TFilely switches to the next bot in your list. This gives each bot a rest period between active use, reducing the chance of hitting rate limits.
If a bot is rate-limited by Telegram, uploads and downloads through that bot may slow down or fail temporarily. TFilely will switch to the next available bot at the next rotation. You can also trigger a manual rotation from Settings to switch immediately.
Best Practices
- Create 6 or more bots to distribute load evenly
- Use a rotation interval of 10-30 minutes for typical usage
- Avoid running large batch operations through a single bot
- If you see frequent rate-limit errors, add more bots or increase the rotation interval
Security Warning
Bot tokens grant full control over the bot. Never share your bot tokens publicly (in GitHub repos, forums, or chat groups). Anyone with your bot token can access the files stored through that bot. Use the Copy All button in Settings to back up your tokens securely.