In the previous post, we already discuss how to create a Telegram bot with the help of the mighty BotFather. But unfortunately, our bot still does nothing. It will not respond to our commands nor answer to our questions — even the easiest one. It feels like we have a fully functional car, but we can’t drive it anywhere because the key is nowhere around.
Now, we’re going to make our bot talks and able to send us random quotes by writing some code. Basically, we can choose any programming language we love — or even the one we hate the most — to develop the system behind the bot, but I prefer to use Python. It’s easy and simple yet powerful.
My favourite package when it comes to Telegram bot is
python-telegram-bot, it’s one of the best we can find out there. We can easily install it using this command:
$ pip install python-telegram-bot
This Python package support both web hook and long polling methods. But personally, I‘d choose the second one most of the time since I don’t have to setup many things like a public IP address or domain and an SSL certificate. When we choose long polling method, all we need is a computer with working internet connection. That’s it!
Now, we’re going to write a simple Python script that will make our bot alive.
from telegram.ext import Updater, CommandHandler from engine import get_random_quote # Your bot token (from BotFather) token = "YOUR TOKEN HERE" def start(bot, update): bot.sendMessage(chat_id=update.message.chat_id, text=("Hi %s. Send me /quote command to get a random quote from " "me!" % update.message.from_user.name)) def quote(bot, update): bot.sendMessage(chat_id=update.message.chat_id, text=get_random_quote()) def main(): updater = Updater(token); dp = updater.dispatcher # Define all the commands that the bot will receive dp.add_handler(CommandHandler("start", start)) dp.add_handler(CommandHandler("quote", quote)) # Start the bot updater.start_polling() print("================================") print("========= Bot Running ==========") print("================================") updater.idle() if __name__ == "__main__": main()
Our next step is writing a function that will generate the random quote. This function will be called by our Telegram bot script. For this project, I do not create the quotes by myself (of course, who will?), I simply take it from TextFiles.com instead. Here is the file snippet:
... %% problems are seldom as bad as they seem at first sight. venessa williams %% there is virtually nothing that has come from molecular biology that can be of any value to human living in the conventional sense of what is good, and quite tremendous possibilities of evil... sir frank macfarlane %% god has infinite time to give us; but how did he give it? in one immense treat of lazy milleniums? no, he cut it up into a neat succession of new mornings. ralph waldo emerson %% ...
%% is the separator symbol between quotes, which means that the text above the separator symbol is different and not related with the text below the separator symbol. So we’ll create a function that will read the text between two
from random import randint quote_file = "quotes.txt" def get_random_quote(): start_line = None end_line = None # Open the quote file with open(quote_file) as file: line = file.readlines() # Let's begin with some random line number # When '%%' is found, save the line number and break the loop for i in range(len(line)-1): random_line = (randint(0, len(line)-1)) if "%%" in line[random_line]: start_line = random_line break # Find the closest next '%%' line number for i in range(start_line+1, len(line)): if "%%" in line[i]: end_line = i break # We don't need the '%%' to be printed start_line += 1 # Join all the text between these two '%%' quote = "".join(line[start_line:end_line]) return quote
Pretty simple and easy to understand, huh?
Our bot in action
We already have 2 scripts to make our bot talks, but we haven’t tried to run it yet. I wonder how does it look when the scripts are running? To use the script, simply run this command from your terminal:
$ python telegram-bot.py
Here’s the look when the bot is running.
Our bot is alive! Yay!
Finally, we have a minimum yet fully working Telegram bot by ourselves. If you’re interested to make your own, I already put all the files in my Github so you can easily clone and run it by yourself. You can also modify the scripts to fit your need.
I’ll see you soon in the next article with more interesting project. Don’t forget to tell a story about your Telegram bot project, I’m looking forward to it!