36d49ea9cd
* Render-fixes for BP * docs: fix simple typo, submition -> submission (#2260) There is a small typo in tests/test_bot.py. Should read `submission` rather than `submition`. * Type on rawapibot.py docstring * typo * Typo: Filters.document(s) * Typo fix * Doc fix for messageentity (#2311) * Add New Shortcuts to Chat (#2291) * Add shortcuts * Add a note * Add run_async Parameter to ConversationHandler (#2292) * Add run_async parameter * Update docstring * Update test to explicitly specify parameter * Fix test job queue * Add version added tag to docs * Update docstring Co-authored-by: Poolitzer <25934244+Poolitzer@users.noreply.github.com> * Doc nitpicking Co-authored-by: Poolitzer <25934244+Poolitzer@users.noreply.github.com> Co-authored-by: Hinrich Mahler <hinrich.mahler@freenet.de> * Fix rendering in messageentity Co-authored-by: Bibo-Joshi <hinrich.mahler@freenet.de> Co-authored-by: zeshuaro <joshuaystang@gmail.com> Co-authored-by: Poolitzer <25934244+Poolitzer@users.noreply.github.com> * fix: type hints for TelegramError changed :class:`telegram.TelegramError` to :class:`telegram.error.TelegramError` * fix: the error can be more then just a Telegram error * Doc fix for inlinekeyboardbutton.py added missing colon which broke rendering * fix: remove context argument and doc remark look at us already being in post 12 * use rtd badge * filters doc fixes * fix some rendering * Doc & Rendering fixes for helpers.py Co-authored-by: Tim Gates <tim.gates@iress.com> Co-authored-by: Harshil <37377066+harshil21@users.noreply.github.com> Co-authored-by: zeshuaro <joshuaystang@gmail.com> Co-authored-by: Poolitzer <25934244+Poolitzer@users.noreply.github.com> Co-authored-by: Harshil <ilovebhagwan@gmail.com> |
||
|---|---|---|
| .. | ||
| conversationbot.png | ||
| conversationbot.py | ||
| conversationbot2.png | ||
| conversationbot2.py | ||
| deeplinking.py | ||
| echobot.py | ||
| errorhandlerbot.py | ||
| inlinebot.py | ||
| inlinekeyboard.py | ||
| inlinekeyboard2.py | ||
| LICENSE.txt | ||
| nestedconversationbot.png | ||
| nestedconversationbot.py | ||
| passportbot.html | ||
| passportbot.py | ||
| paymentbot.py | ||
| persistentconversationbot.py | ||
| pollbot.py | ||
| rawapibot.py | ||
| README.md | ||
| timerbot.py | ||
Examples
In this folder are small examples to show what a bot written with python-telegram-bot looks like. Some bots focus on one specific aspect of the Telegram Bot API while others focus on one of the mechanics of this library. Except for the rawapibot.py example, they all use the high-level framework this library provides with the telegram.ext submodule.
All examples are licensed under the CC0 License and are therefore fully dedicated to the public domain. You can use them as the base for your own bots without worrying about copyrights.
echobot.py
This is probably the base for most of the bots made with python-telegram-bot. It simply replies to each text message with a message that contains the same text.
timerbot.py
This bot uses the JobQueue class to send timed messages. The user sets a timer by using /set command with a specific time, for example /set 30. The bot then sets up a job to send a message to that user after 30 seconds. The user can also cancel the timer by sending /unset. To learn more about the JobQueue, read this wiki article.
conversationbot.py
A common task for a bot is to ask information from the user. In v5.0 of this library, we introduced the ConversationHandler for that exact purpose. This example uses it to retrieve user-information in a conversation-like style. To get a better understanding, take a look at the state diagram.
conversationbot2.py
A more complex example of a bot that uses the ConversationHandler. It is also more confusing. Good thing there is a fancy state diagram for this one, too!
nestedconversationbot.py
A even more complex example of a bot that uses the nested ConversationHandlers. While it's certainly not that complex that you couldn't built it without nested ConversationHanldlers, it gives a good impression on how to work with them. Of course, there is a fancy state diagram for this example, too!
persistentconversationbot.py
A basic example of a bot store conversation state and user_data over multiple restarts.
inlinekeyboard.py
This example sheds some light on inline keyboards, callback queries and message editing.
inlinekeyboard2.py
A more complex example about inline keyboards, callback queries and message editing. This example showcases how an interactive menu could be build using inline keyboards.
deeplinking.py
A basic example on how to use deeplinking with inline keyboards.
inlinebot.py
A basic example of an inline bot. Don't forget to enable inline mode with @BotFather.
pollbot.py
This example sheds some light on polls, poll answers and the corresponding handlers.
passportbot.py
A basic example of a bot that can accept passports. Use in combination with passportbot.html. Don't forget to enable and configure payments with @BotFather. Check out this guide on Telegram passports in PTB.
paymentbot.py
A basic example of a bot that can accept payments. Don't forget to enable and configure payments with @BotFather.
errorhandlerbot.py
A basic example on how to set up a custom error handler.
Pure API
The rawapibot.py example uses only the pure, "bare-metal" API wrapper.