Papercraft Book
formerly Telegram Bot Handbook
Welcome to the Papercraft Book! This is a practical 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.
The book starts with the path to a working bot: register it, choose a library, receive updates, and run the program on a server. After that, it explores the Telegram features that shape real bots: dialogs, commands, buttons, groups, channels, forums, and product features such as login or payments.
I focus on good user experience. You'll learn when a command is enough, and when more complex surfaces provide a better flow.
This aims to be the most comprehensive and practical guide on developing bots for Telegram.
Build the first working program
At minimum, you need four things:
- A bot registered in BotFather.
- A token for controlling the bot.
- A library for your programming language.
- A program that receives updates and sends responses.
While you can run the bot program on your computer during development, you'll want to deploy it to a hosting service when the code is ready for production.
The following section covers these steps in order.
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!


