Skip to content
Go to file


Failed to load latest commit information.
Latest commit message
Commit time
Jun 25, 2015
Jun 25, 2015
Jun 26, 2015
Jun 25, 2015


Telegram Bot starter kit. Very easy to install with Google App Engine.

Reddit post:


  1. Message @botfather with the following text: /newbot If 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 to botfather.

    botfather initial conversation

  2. @botfather replies with Alright, 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 with Good. Now let's choose a username for your bot. It must end in bot. Like this, for example: TetrisBot or tetris_bot.

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

  6. @botfather replies with:

    Done! Congratulations on your new bot. You will find it at 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:

  7. Note down the 'token' mentioned above.

  8. Type /setprivacy to @botfather.

    botfather later conversation

  9. @botfather replies with Choose 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. Type Disable to let your bot receive all messages sent to a group. This step is up to you actually.

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

  14. Go to

  15. Click Create Project

  16. Type the project name, whatever you want. For example: octopus-gorilla-123. Make sure the Project ID is also the same.

    App Engine registration

  17. Clone this repository. If you don't understand what I said, click the green Clone or download button on this page, click Download ZIP, and extract the ZIP file.

  18. Open app.yaml file using a good text editor like Sublime Text. Change the YOUR_APP_ID_HERE to the Project ID you set on step 16, and save the file.


  1. Open file using a good text editor. Change the YOUR_BOT_TOKEN_HERE to the token you get from @botfather at step 6, and save the file.

  1. Download Google App Engine SDK for Python from and install it.

  2. Run the GoogleAppEngineLauncher application.

  3. Click the File menu, choose Add Existing Application... and browse to the folder with the app.yaml and file.

  4. The project ID should appear as a row at the Name column.

    app engine launcher

  5. Click Deploy, enter your Google credentials, and your app should be installed to Google's servers.

  6. Open your browser and go to (replace project-id with the Project ID you set on step 16).

  7. Wait until you see a long text with "ok": true and your bot's name. This could take a minute or so, please reload if it does not succeed.

  8. Now, go to (replace both project-ids with the Project ID you set on step 16).

  9. You should see Webhook was set.

  10. Open your Telegram client and send the message /start to your bot. (type @your-bot-username at the search field to initiate the conversation)

  11. You can, for example, send what time to the bot and the bot will reply you. Try sending /image as well. Mission completed!

To customize the bot, edit the starting from the CUSTOMIZE FROM HERE line. They are simple if-else statements.


Telegram Bot starter kit. Very easy to install with Google App Engine.





No releases published


You can’t perform that action at this time.