- Notifications
You must be signed in to change notification settings - Fork5.7k
Our Wiki (where you currently are) contains anIntroduction to the API explaining how the pure Bot API can be accessed viapython-telegram-bot
.Moreover, theTutorial: Your first Bot gives an Introduction on how chatbots can be easily programmed with the help of thetelegram.ext
module.
- Thepackage documentation is the technical reference for
python-telegram-bot
.It contains descriptions of all available classes, modules, methods and arguments as well as thechangelog. - Thewiki is home to number of more elaborate introductions of the different features of
python-telegram-bot
and other useful resources that go beyond the technical documentation.Seebelow for more details on what this wiki contains. - Ourexamples section contains several examples that showcase the different features of both the Bot API and
python-telegram-bot
.Even if it is not your approach for learning, please take a look atechobot.py
.It is the de facto base for most of the bots out there.The code for these examples is released to the public domain, so you can start by grabbing the code and building on top of it. - Theofficial Telegram Bot API documentation is of course always worth a read.
If the resources mentioned above don't answer your questions or simply overwhelm you, there are several ways of getting help.
- We have a vibrant community of developers helping each other in ourTelegram group.Join us! Asking a question here is often the quickest way to get a pointer in the right direction.
- Ask questions by openinga discussion.
- You can even ask for help on Stack Overflow using thepython-telegram-bot tag.
In the sidebar to the right, you can find all important pages of this wiki. They are roughly organized by the following logic:
- Must read: Introductory articles and frequently referenced pages.
- Concepts & Important Elements: Introductions & explanations of how the components of
telegram.ext
work and interact with each other. - Notable Features: Elaborate explanation to more advanced features of
telegram.ext
. - Code Resources: Some other resources that are not exclusively PTB-specific.
- Examples Explained: An effort to make theexamples even more accessible.You are very welcome to extend this section!
- Networking: Articles about advanced networking questions.
- Other resources: More interesting & helpful stuff that can't be found in any of the above sections.
- Transition Guides: Major versions usually come with breaking changes, i.e. changes that lead to code failing after upgrading. Those guides help to ease the transition.
- Administration: Interesting mostly for the maintainers. They, too, need a place to take notes 🙂
If you stumble upon a part of the wiki that is unclear or missing important points, please go ahead and drop us a message in ourTelegram Group, or just edit the part yourself (anyone can contribute). We'd like our wiki to be as complete as possible 🙂
Wiki ofpython-telegram-bot
© Copyright 2015-2025 – Licensed byCreative Commons
- Architecture Overview
- Builder Pattern for
Application
- Types of Handlers
- Working with Files and Media
- Exceptions, Warnings and Logging
- Concurrency in PTB
- Advanced Filters
- Storing data
- Making your bot persistent
- Adding Defaults
- Job Queue
- Arbitrary
callback_data
- Avoiding flood limits
- Webhooks
- Bot API Forward Compatiblity
- Frequently requested design patterns
- Code snippets
- Performance Optimizations
- Telegram Passport
- Bots built with PTB
- Automated Bot Tests