Building a Virtual Personal Assistant with Telegram app and Telepot

Have you ever wondered what comforts a truly programmable app can give to a consumer. Many of us admire Internet of things( IOT) . So today I am going to talk about creating Personal Assistants (PA) for Telegram app, an application similar to whatsApp but fully programmable using it’s Bot API. We can pass messages to multiple devices in a click of eye. Telegram is the app which hackers likes because of it’s customization. Messaging apps should not only provide communication between humans but also should lay channels between humans and programmable machines. There are obvious advantages for programmers who use Telegram App.

  1. Get Github and Sentry messages directly to your app
  2. Get favorite tweets from Twitter
  3. Get updates from multiple information sources like weather or scores
  4. Control home appliances by sending pre-defined commands

Applications are endless. In this IOT generation you need a platform to program and Telegram API provides you that.

This tutorial will use two main ingredients.

  1. Telegram app
  2. Telepot python library


Our goal is to build a PA for us using Bot API provided by Telegram app. We need to install the app

Telegram app on Google playstore

You can also have a Telegram client for your system. Mine is Ubuntu14.04. You can download all clients here.

Telegram desktop clients

I presume that you installed the telegram app. Now we need to create a bot for us. Telegram provides us a program called Bot Father using which we can create custom bots. Launch BotFather by visiting this link.

After adding BotFather to your chat list enter into it, you will see few options like this


Screenshot from 2015-12-06 21:31:56

now type /newbot and hit Enter. It will ask you for a name, give that. Next it will generate an API key, which we are going to use to build our Bot. Store this API key. It also gives a link to your bot. Visit that link to add it as one of your friends. Share it to others if you want to.

Telepot, a python client for Telegram

Telepot is a python client which is the REST wrapper for Telegram API. Using it we can take commands from user and compute something and give back results to the user. Now I am going to build a small bot program which does following things when below commands are given.

  1. /timeline -> Should fetch the latest tweets on my timeline
  2. /tweet=message  -> Should tweet my message on Twitter
  3. /chat  -> Should launch a virtual chat with machine
  4. /stopchat -> You are bored and stop chatting

These tasks might be simpler one. But you should be aware that if you know how to unleash the power of message passing between devices you can define your own custom tasks which can have greater value of application. Code for this application is at

Let us build the PA

First we need to install the sufficient libraries for constructing the Virtual Assistant. I name my PA as mika.

$ virtualenv  telegram-bot
$ source telegram-bot/bin/activate
$ pip install telepot tweepy nltk

We are installing telepot for sending and receiving messages from Telegram. NLTK for using it’s virtual chat engines. Tweepy is used for accessing twitter account through consumer keys. For now I am creating a simple bot command which returns “Hello, how are you?” when we say hello to it.

import telepot, time

def handle(msg):
    chat_id = msg['chat']['id']
    command = msg['text']
    print 'Got command: %s' % command

    if command == '/hello':
        bot.sendMessage(chat_id, "Hello, how are you?")

# Create a bot object with API key
bot = telepot.Bot('152871568:AAFRaZ6ibZQ52wEs2sd2XXXXXXXXX')

# Attach a function to notifyOnMessage call back

# Listen to the messages
while 1:

Run $ python

Now enter /hello in the bot channel you created. you will see the following output.

Screenshot from 2015-12-06 21:49:20

So our bot received our message and replied back to us with the greeting. It is actually the Python code running under the hood managing those tasks. Code is very simple. We need to

  • Create  Bot object using API key
  • Create a function for handling commands and returning information
  • Attach the above function to call back handler of Bot. Whenever bot receives a message this function handler executes. We can have any logic in those handlers.

You can see what all inputs you can accept and types of outputs you can send to users from bot here. telepot github link

For now let us Integrate twitter and chat engines of NLTK into our bot. We all know that NLTK comes with few chat engines like Eliza, Iesha,Zen etc. I am here using a chatbot called Iesha. Before I create a file called for managing my tweet and timeline fetch tasks.

import tweepy

#I prepared this class for simplicity. Fill in details and use it.
class Tweet:
    #My Twitter consumer key
    #My consumer secret
    #My access token
    #My access token secret

    def __init__(self):
        self.auth = tweepy.OAuthHandler(self.consumer_key,self.consumer_secret)
        self.auth.set_access_token(self.access_token, self.access_token_secret)
        self.handle = tweepy.API(self.auth)

        def hitme(self,str):
            print 'tweet posted succesfully'

Now let me finish the show with adding both chatting and Tweeting.

import telepot, time
from import iesha_chatbot
from tweep import Tweet

# create tweet client
tweet_client = Tweet()
is_chatting = False

def handle(msg):
    global is_chatting
    global tweet_client
    chat_id = msg['chat']['id']
    command = msg['text']
    print 'Got command: %s' % command
    if command == '/timeline' and not is_chatting:
        bot.sendMessage(chat_id, '\n'.join([message.text for message in tweet_client.handle.home_timeline()]))
    elif command.split('=')[0] == '/tweet' and not is_chatting:
            tweet_client.hitme(command.split('=')[1] + ' #mika')
            bot.sendMessage(chat_id, 'Your message tweeted successfully')
            bot.sendMessage(chat_id, 'There is some problem tweeting! Try after some time')
    elif command == '/chat':
        is_chatting = True
        bot.sendMessage(chat_id, 'Hi I am Iesha. Who are You?')
    elif command == '/stopchat':
        is_chatting = False
        bot.sendMessage(chat_id, 'Bye Bye. take care!')
    elif not command.startswith('/') and is_chatting:
        bot.sendMessage(chat_id, iesha_chatbot.respond(command))

# Create a bot object with API key
bot = telepot.Bot('152871568:AAFRaZ6ibZQ52wEs2sd2Tp4Wcs-IXoWfA-Q')

# Attach a function to notifyOnMessage call back

# Listen to the messages
while 1:

So output screens will be like this for /chat and /tweet

Screenshot from 2015-12-06 23:41:21

For /timeline

Screenshot from 2015-12-06 23:42:32

Isn’t it funny. We can add lots of features to this basic personal assistant bot like

  1. Tracking time
  2. Scheduler and alert
  3. Notes taking etc
  4. Opening your garage gate when you push a command to bot

If you observe the code there isn’t much in that. I just used Elisha chat bot from NLTK. Used tweepy methods to fetch timeline and post a tweet. If you want to use code visit my repo.

Thanks for reading this stuff. Hope it will be helpful for you to build your own IOT.

9 thoughts on “Building a Virtual Personal Assistant with Telegram app and Telepot

  1. Hello Naren arya,

    Unbelievable! Great post about telegram bots. Actually that exactly what I have been searching for in a very well explained manner.
    I started searching for telegram bots this morning and this is the best introduction to telegram bots so far!
    Keep up the great work😀

    Rafael Acurcio.

  2. Inspired, and using some of your code, I am reading temperature and light level with two sensors, and switching ON or OFF a LED on a PIC (Picaxe 18m2 from Revolution Education). I also check the status of the LED whether ON or OFF.

    Telegram bot is resident on a Raspberry Pi 2 that sends commands to PIC with recourse to bluetooth.

    Thank you Naren Aryan.

  3. hi
    thanks for your wonderful post.
    what server you used for your bot?
    is it uploaded to google app engine or some thing else?

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s