Creating a Telegram Bot with Python
Hey! This is a step-by-step guide on creating a Telegram Bot in a couple minutes!
If you are already familiar with Python 3 and its
virtualenv, simply create a
pip freeze > requirements.txt, and skip to section 1.
This guide was updated on March 20th, 2021, tweaking details to support Python 3.9.2 and
0. Requirements and dependencies
Before you start, be sure to have
python3 and its package installer
pip ready to go in whatever platform you are using. If for some reason you don’t have Python 3 on your system, install it via your distro’s package manager or, if on Windows, via the official website.
Depending on your setup, Python 3 might be simply called
python, and the package installer might be
pip3, so be sure to adjust the commands accordingly.
Create a directory for your bot and enter it:
virtualenv via Python’s package manager, to create a virtual environment for your bot and thus keep things neatly organized:
Inside your directory, create a Python 3 virtual environment. Here, I will be calling it simply
Then, to start using the virtual environment, run
source venv/bin/activate if on Linux, or
venv\Scripts\activate if on Windows.
While inside it, install
Save a list of your newly installed packages in a text file called
You are all set!
1. Creating and naming your bot
Your Telegram API access is granted by @BotFather. Talk to him via Telegram and try using
/newbot. You will choose a display name and a @username (that ends with bot).
After naming your creation, you will receive your HTTP API token, and that’s what you will need to control the bot. Store it safely, as it can be used by malicious people to tamper with it.
You may also want to try
/setdescription (Text shown when starting a chat),
/setabouttext (Profile description) and
/setuserpic (Upload image with compression), along with many other commands BotFather has to offer.
2. It’s alive!
Here’s some boilerplate code for you to start building on. Create a
main.py file and paste the content below in it:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 from telegram.ext import Updater, CommandHandler import logging TOKEN = "" def start(update, context): s = "hello, world!" update.message.reply_text(s) def main(): logger = logging.getLogger(__name__) logging.basicConfig( format='%(asctime)s [%(levelname)s] %(message)s', level=logging.INFO ) updater = Updater(TOKEN) dp = updater.dispatcher dp.add_handler(CommandHandler("start", start)) updater.start_polling() logging.info("=== Bot running! ===") updater.idle() logging.info("=== Bot shutting down! ===") if __name__ == "__main__": main()
Make sure to add your API token in the
TOKEN variable on line 4!
To start your bot, enter your virtual environment (if not already in it) and run your file:
If everything went well, you shall see the message
=== Bot running! ===. Congrats! Try talking to him via Telegram. Send
/start and it should answer
hello, world!. To shut it down, press
CTRL+C and wait for it to exit properly.
If you want to exit from the current virtual environment, simply run
3. Making it your own
To add your own commands, three simple steps are needed. As an example, let’s create a /random command, that returns a random number.
Start by sending
/setcommands to @BotFather, selecting your bot and sending him a list of all commands it should respond to, as well as their description. Be sure to send all commands and their descriptions, not only the one you’re adding! As it’s our bot’s first command (apart from /start, which doesn’t need to be listed here), our message should contain only one line:
I also recommend saving the list of commands and descriptions in a text file called something like
BotFather_setcommands.txt, for reference.
Then, in your
main.py file, create a new function for the command, with
context as arguments:
Finally, add the corresponding
CommandHandler right after line 19:
After restarting, the bot should now be responding to /random!
4. Running your bot 24/7
Having to leave your terminal window open and your computer powered on for your bot to be working can’t be the best option, right? Well, if you already know your way through VPS, cloud providers and the like, then just leave it running on your preferred platform. Otherwise, keep on reading.
To leave your chatbot running (almost) all the time, this tutorial will be using Heroku, a cloud platform as a service (PaaS) that has a free tier for small personal projects, which should handle a simple bot just fine. It also has a large list of add-ons for databases, logging, testing, and much more. Alongside it, you will also need
git for a quick and easy deployment method.
Let’s get on it! First, create a free Heroku account:
Then, create a new app and give it whatever name you feel like.
Now that your app is created, you need to tell Heroku how to start it. For that, in your bot folder alongside your other files, create a blank file named
Procfile, with no file extension. It should contain only the line
worker: python main.py. Alternatively, simply run:
Also, let’s have
git ignore our
venv folder, as Heroku will later recreate it for us via the file
requirements.txt created back in section 0. Same idea as before: blank file named
venv/. Or, simply:
Now, let’s upload the bot files to Heroku using the Heroku CLI. This step is also detailed in the Deploy tab, “Deploy using Heroku Git” section.
Log in to your account using
heroku login and following the messages. Then, initialize a
git repository in your bot folder and link it to your Heroku app, replacing
bot-tutorial with your Heroku app name:
Finally, add your files, commit and push:
All that’s left is to turn your bot on. In the Resources tab, click the edit button, flip the switch and confirm:
Your bot should now be working! Try sending it a command via Telegram! To check your console logs, go on More > View logs:
To deploy any additions or changes, commit them via
git and push. Be sure to add a commit message describing what changed:
And you should be all set! Thanks for following along, and I hope you enjoy your new creation!