Papercraft Book
formerly Telegram Bot Handbook
Welcome to the Papercraft Book! This is your guide to developing user-friendly, feature-rich, and stable bots for Telegram. The book is independent of any specific programming language or library— contributions with examples for different libraries are welcome.
We cover all major features of the Telegram bot platform, starting from common features like /commands and progressing to specialized ones, such as managing join requests and forum topics. You'll also find corner cases and development tips throughout.
Another focus is user experience. You'll learn how to make bots easy to use and which Telegram features work best in different scenarios.
This aims to be the most comprehensive and practical guide on developing bots for Telegram.
What’s inside?
The book has four chapters, each divided into multiple pages:
- Development. Things to note before you start coding: API and libraries, bot configuration, some basic notions and tips.
- Messages. Features of messages: sending/editing/deleting, commands, markup, buttons.
- Chats. Managing user data & developing bots for different kinds of chats. Rules of PM, groups, and channels. Forums and supergroups.
- Interaction. Non-dialog Telegram features: join requests, deep links, payments, mini apps, etc.
Feel free to use navigation on the left or just hit the “Next page” button below.
Who made this?
Some pictures and videos are taken from the Telegram site. Most screenshots are made in Telegram web apps.
The sources are open on GitHub—corrections and improvements are welcome!


