Almost two years ago let developers create bots quite painlessly. You can read an introduction about it . In this article we will create a simple bot in , it’ll be hosted in Azure using Bottle framework. The bot will not do anything fancy, consider it as a template for your python based bots. Telegram on Telegram website python Here are the things which we’ll cover: Registering your bot in Telegram app Creating a Bottle App in Azure Configuring Bottle server to run as HTTPS (which is required by Telegram) Creating an API endpoint for communication with Telegram After that, I will also introduce you to inline bots. Registering bot in Telegram app You can do it without leaving the Telegram app. Your contact person is, well, a bot named @BotFather. Start a conversation with him: He’s a really cool guy and I’m sure you’ll not have any problems with creating a new bot. Just write , then choose a name and username for it (the latter should end with ). /newbot bot If everything goes smoothly, you’ll receive your bot’s token, which we’ll use in the next step. Creating a Bottle App in Azure is a lightweight server framework for python. It’s available in Azure as a Web Application. In order to create it, open Azure Portal, look for „bottle” in new app search window. Bottle Click on it, then choose a name for your app and resource group. After about a minute, your app should be ready. You should be able to see it on http://APPNAME.azurewebsites.net Open it in azure, and search for “Deployment options”. By default azure bottle app is deployed from . Let’s create a local git repository just for your project. In , click and confirm. Then, click button, select and confirm. This action may take about a minute to reflect in the UI, after that you should see an address to your git repo in screen: this git repository Deployment options Disconnect Setup Local git repository Overview Copy that link, then switch to cmd/terminal, go to directory of your choice and clone your repo (I hope you have git installed!): git clone (repolink) You will be asked for user password, you can set it up in : Deployment Credentials Let’s take a look at the files: this file contains initialization of your bottle server app.py — it specifies logic which should be executed for API routes (and returns data) routes.py — all python dependencies have to be listed here requirements.txt — — if this file exists, azure will not proceed with full python deployment each time you commit (you should remove it for commits which add new dependencies) .skipPythonDeployment Other files and folders are less significant for this tutorial, you can figure out their importance by yourself (or ask in comments, I’ll be happy to help). Configuring Bottle server to run as HTTPS Telegram doesn’t support HTTP requests for bot API, so we need to make sure our method is reachable using HTTPS. Bottle doesn’t offer HTTPS server out of the box. To archive this, we need to create a ServerAdapter. You can use one of the implementations floating on the Internet, like . this Copy the code of server class and paste it into your file (right under the imports is fine): app.py class (bottle.ServerAdapter):def run(self, handler):from wsgiref.simple_server import make_server, WSGIRequestHandlerimport sslif self.quiet:class QuietHandler(WSGIRequestHandler):def log_request(*args, **kw): passself.options['handler_class'] = QuietHandlersrv = make_server(self.host, self.port, handler, **self.options)srv.socket = ssl.wrap_socket (srv.socket,certfile=' , server_side=True)srv.serve_forever() SSLWSGIRefServer server.pem' is a path to your server certificate. It’s easy to create it using by running the command below, you can provide empty input for all certificate fields except for , for it you have to use your domain address (APPNAME.azurewebsites.net): certfile=’server.pem’ OpenSSL Common Name openssl req -new -x509 -keyout server.pem -out server.pem -days 365 -nodes Place generated server.pem file in the root folder of your app. Now, let’s switch to using new class. Change your startup code to look like this and remember to use your app’s name: if __name__ == '__main__':app = bottle.Bottle()srv = SSLWSGIRefServer(host=" .azurewebsites.net", port=80)bottle.run(server=srv) APPNAME python-telegram-bot To communicate with Telegram API, we’ll use a wrapper called . python-telegram-bot This package is not available in your azure environment. In order to add it, you need to do two things: add line to requirements.txt python-telegram-bot==5.3.0 remove file .skipPythonDeployment Azure will make sure all package requirements are met during deployment (which happens after each commit). Communication between Telegram and our server can be done in 2 different ways:1. Our server can check for updates from Telegram in a loop using getUpdates method2. We can hook telegram to our server’s API method, so everytime there is some user message waiting, Telegram will send us an HTTPS POST request with details. In this tutorial we’ll use thesecond approach. Creating an API in Bottle Let’s open routes.py file. You can see many routes specified here, all of them useless for our use case, you can safely remove them. We will add two methods: will respond to telegram’s requests. Our bot will take the incoming message, assume it’s in format , split it into 2 ints and answer with the sum of these numbers. /botHook a+b will be responsible for hooking telegram to our API. You could move this logic to app.py file, so it’d be done with each deployment/server restart, but I prefer to have quick access to it this way. We’ll pass the address of the method. It will return a boolean value, which will indicate if the hooking was successful. /setWebhook /bootHook Here’s the full code for routes.py which you can use. Make sure to use your app name and bot token: from bottle import route, view, run, requestimport telegram TOKEN = 'TOKEN'APPNAME = 'APPNAME' ('/setWebhook')def setWebhook():bot = telegram.Bot(TOKEN)botWebhookResult = bot.setWebhook(webhook_url=' return str(botWebhookResult) @route https://{}.azurewebsites.net/botHook'.format(APPNAME)) ('/botHook', method='POST')def botHook():bot = telegram.Bot(TOKEN)update = telegram.update.Update.de_json(request.json, bot)bot.sendMessage(chat_id=update.message.chat_id, text=getSum(update.message.text, update.message.from_user.username))return 'OK' @route def getSum(query, userName):try:splittedBySum = query.split('+')if len(splittedBySum) != 2:raise ValueError('Too complicated stuff')return str(int(splittedBySum[0]) + int(splittedBySum[1]))except:return "I'm sorry, {}. I'm afraid I can't do that".format(userName) Done! Now upload all our changes: git add .git commit -m 'Simple bot'git push origin master After the deployment is done, call webook method in your browser: https://APPNAME.azurewebsites.net/setWebhook If it resulted with , then everything should be ready to have your first conversation with your awesome bot, give it a try! True Inline bots We created a bot which answers with one result. Sometimes we’d like our bot to provide user couple of options. In Telegram it’s possible with inline bots. To see that multiple results you need to add your bot to some group conversation and start typing @botname query. To archive it, we need to activate this feature by talking to @BotFather. After switching it on with , it’s also required to provide text which will be shown to user after writing @YourBot in chat /setinline We also need to change /bootHook method (it has to support both normal messages and inline queries) and provide a small helper function: ('/botHook', method='POST')def botHook():bot = telegram.Bot(TOKEN)update = telegram.update.Update.de_json(request.json, bot) @route if update.message is not None: bot.sendMessage(chat\_id=update.message.chat\_id, text=getSum(update.message.text, update.message.from\_user.username)) elif update.inline\_query is not None: results = list() results.append(getArticleFromText("Just what do you think you're doing, {}?".format(update.inline\_query.from\_user.username))) results.append(getArticleFromText(getSum(update.inline\_query.query, update.inline\_query.from\_user.username))) bot.answerInlineQuery(update.inline\_query.id, results) return 'OK' def getArticleFromText(text):return telegram.InlineQueryResultArticle(id=text.upper(),title=text,input_message_content=telegram.InputTextMessageContent(text)) Here’s how it looks like in action: Conclusion It’s relatively easy to get your python code working as a Telegram bot. There are dozens of potential use cases for bots, so this knowledge may become handy one day for you. Also, check out other stuff which can be done with Telegram bots API, like different types of inline responses or games. If you have any questions, feel free to ask them. If you find this article helpful, also let me know! :)
