Repository files navigation

By Julio Camacho@p92camcj

14 August, 2015

This tutorial helps you to create a new Telegram¹ bot² using only a Chromebook PC³ or a web browser (Google Chrome). We are going to use the tool Codenvy⁴, Google App Engine⁵ and aPython Telegram Bot

I have to thankLeandro Toledo for having helped me in this process.

Thanks toYukuku for doing the tutorial that I followed and which I have used to do this one.

Thanks toSoo Y. Hwang for let me use her code base.

Now, knowing which will be our tools, go on!

1. Message @botfatherhttps://telegram.me/botfather with the following text:/newbotIf you don't know how to message by username, click the search field on your Telegram app and type@botfather. You should be able to initiate a conversation. Be careful not to send it to the wrong contact, because some users has similar usernames tobotfather.

   

2. @botfather replies withAlright, a new bot. How are we going to call it? Please choose a name for your bot.

3. Type whatever name you want for your bot.

4. @botfather replies withGood. Now let's choose a username for your bot. It must end inbot. Like this, for example: TetrisBot or tetris_bot.

5. Type whatever username you want for your bot, minimum 5 characters, and must end withbot. For example:whateversamplebot

6. @botfather replies with:

   Done! Congratulations on your new bot. You will find it at telegram.me/whateversamplebot. You can now add a description, about section and profile picture for your bot, see /help for a list of commands.

   Use this token to access the HTTP API:123456789:AAG90e14-0f8-40183D-18491dDE

   For a description of the Bot API, see this page:https://core.telegram.org/bots/api

7. Note down the 'token' mentioned above.

8. Type/setprivacy to @botfather.

   

9. @botfather replies withChoose a bot to change group messages settings.

10. Type@whateversamplebot (change to the username you set at step 5 above, but start it with@)

11. @botfather replies with

    'Enable' - your bot will only receive messages that either start with the '/' symbol or mention the bot by username.'Disable' - your bot will receive all messages that people send to groups.Current status is: ENABLED

12. TypeDisable to let your bot receive all messages sent to a group. This step is up to you actually.

13. @botfather replies withSuccess! The new status is: DISABLED. /help

14. Go tohttps://console.developers.google.com/project

15. ClickCreate Project

16. Type whatever name you want for the project. For example:tutorial telegram bot p92camcj. Make sure the Project ID is also the same andnote down it, this is YOUR GOOGLE APP ENGINE PROJECT ID. For exampl, my Google App Project ID istutorial-telegram-bot-p92camcj

17. Create an account inCodenvy.com

18. Create a new project. Usingblank option, type the name and description of your project and pressnext.

19. This step is very important. In theSelect Runner environment you have to choosePython/web/python27_gae1914_ext_libs. Then pressCreate.

20. Now you have to import atest bot. I have created one to do this tutorial. You canuse it.

21. So go tomenu/file/Import Project/Import From Location... like it appears in this image:

22. You have to choose inSource Control optionGitHub and then paste this link on URL field like it appears in this image:

23. Edit the first line ofapp.yaml file and typeYOUR GOOGLE APP ENGINE PROJECT ID (step 16).

24. After that, you have to modify bot_gae.py file, in lines 13 and 32.

• Line 13 should be edited to include your token bot (BotFather gave you in step 1)
  bot = telegram.Bot(token='114313687:AAFbt4jveB_hhT-UhMBO1vnjZNruS0Mg1Z4')
• Line 32 should be edited to includeYOUR GOOGLE APP ENGINE PROJECT ID s = bot.setWebhook('https://tutorial-telegram-bot-p92camcj.appspot.com/HOOK')

25. Now everything is ready to work, soRun your project using the menu and submenu option.
26. You must see arunner panel below, you have to wait until the whole proccess have finished, and then open theterminal tab (nearconsole active tab)
27. Finally, you have to deploy it typing next command line on theterminal:google_appengine/appcfg.py update /home/user/application/. It will ask for your Google Account credential (email and pass), so you have to ingress them.
28. If you have had some problems with the previous step and Google sends you an email about your security account, try the next method. Type the next command line on theterminal:google_appengine/appcfg.py update /home/user/application --oauth2 --noauth_local_webserver. It will print a link. Copy the code and return to terminal codenvy. Right-click on the terminal, select Paste from Browser and paste the code. Be happy :)
29. Now, try to navegate tohttps://tutorial-telegram-bot-p92camcj.appspot.com/set_webhook and if all is correct, you must read "webhook setup ok"
30. Now you speak to your bot in telegram, and if it repeats like a parrot everything you write, you will have successfully completed this tutorial.

1: Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed. More info:telegram.org.

2: Bots are simply Telegram accounts operated by software – not people – and they'll often have AI features. They can do anything – teach, play, search, broadcast, remind, connect, integrate with other services, or even pass commands to the Internet of Things.More info in his blog.

3: A Chromebook is a laptop running Chrome OS as its operating system. The devices are designed to be used primarily while connected to the Internet, with most applications and data residing "in the cloud". A Chromebook is an example of a thin client. More info:google.com/chromebook

4: Codenvy provides a container-based development environment whose goal is to remove the need for developers to configure or maintain local or VM-based developer environments for their projects. More info:codenvy.com

5: Google App Engine (often referred to as GAE or simply App Engine) is a platform as a service (PaaS) cloud computing platform for developing and hosting web applications in Google-managed data centers. More info:appengine.google.com