ghost-dog / telebot

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

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool


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 am saying, click the Download ZIP button on the lower-right of this page, 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. Try sending more messages and you should see replies from the bot. Mission completed!

To customize the bot, edit the starting from the CUSTOMIZE FROM HERE line. It is simple if-else statements. The starter kit calls to generate replies.


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

License:Apache License 2.0


Language:Python 100.0%