Skip to main content

A Python wrapper around the Telegram Bot API

Project description

Python Telegram Bot

A Python wrapper around the Telegram Bot API.

By Leandro Toledo

Travis CI Status

Introduction

This library provides a pure Python interface for the Telegram Bot API. It works with Python versions from 2.6+. Python 3 support is under development. It also works with Google App Engine (billing has to be enabled for fully Socket API support).

Status

Telegram Bot API Method

Supported?

getMe

Yes

sendMessage

Yes

forwardMessage

Yes

sendPhoto

Yes

sendAudio

Yes

sendDocument

Yes

sendSticker

Yes

sendVideo

Yes

sendLocation

Yes

sendChatAction

Yes

getUpdates

Yes

getUserProfilePhotos

Yes

setWebhook

Yes

Installing

You can install python-telegram-bot using:

$ pip install python-telegram-bot

Getting the code

The code is hosted at https://github.com/leandrotoledo/python-telegram-bot

Check out the latest development version anonymously with:

$ git clone https://github.com/leandrotoledo/python-telegram-bot
$ cd python-telegram-bot

Run tests:

$ make test

To see other options available, run:

$ make help

Documentation

View the last release API documentation at: https://core.telegram.org/bots/api

API

The API is exposed via the telegram.Bot class.

To generate an Access Token you have to talk to BotFather and follow a few simple steps (described here).

For full details see the Bots: An introduction for developers.

To create an instance of the telegram.Bot:

>>> import telegram
>>> bot = telegram.Bot(token='token')

To see if your credentials are successful:

>>> print bot.getMe()
{"first_name": "Toledo's Palace Bot", "username": "ToledosPalaceBot"}

NOTE: much more than the small sample given here will print

Bots can’t initiate conversations with users. A user must either add them to a group or send them a message first. People can use telegram.me/<bot_username> links or username search to find your bot.

To fetch text messages sent to your Bot:

>>> updates = bot.getUpdates()
>>> print [u.message.text for u in updates]

To fetch images sent to your Bot:

>>> updates = bot.getUpdates()
>>> print [u.message.photo for u in updates if u.message.photo]

To reply messages you’ll always need the chat_id:

>>> chat_id = bot.getUpdates()[-1].message.chat_id

To post a text message:

>>> bot.sendMessage(chat_id=chat_id, text="I'm sorry Dave I'm afraid I can't do that.")

To post an Emoji (special thanks to Tim Whitlock):

>>> bot.sendMessage(chat_id=chat_id, text=telegram.Emoji.PILE_OF_POO)

To post an image file via URL:

>>> bot.sendPhoto(chat_id=chat_id, photo='https://telegram.org/img/t_logo.png')

To post an audio file:

>>> bot.sendAudio(chat_id=chat_id, audio=open('tests/telegram.ogg', 'rb'))

To tell the user that something is happening on bot’s side:

>>> bot.sendChatAction(chat_id=chat_id, action=telegram.ChatAction.TYPING)

To create Custom Keyboards:

>>> custom_keyboard = [[ telegram.Emoji.THUMBS_UP_SIGN, telegram.Emoji.THUMBS_DOWN_SIGN ]]
>>> reply_markup = telegram.ReplyKeyboardMarkup(custom_keyboard)
>>> bot.sendMessage(chat_id=chat_id, text="Stay here, I'll be back.", reply_markup=reply_markup)

To hide Custom Keyboards:

>>> reply_markup = telegram.ReplyKeyboardHide()
>>> bot.sendMessage(chat_id=chat_id, text="I'm back.", reply_markup=reply_markup)

There are many more API methods, to read the full API documentation:

$ pydoc telegram.Bot

$ pydoc telegram.Bot

Contact

Feel free to join to our Telegram group.

TODO

Patches and bug reports are welcome, just please keep the style consistent with the original source.

Add more example scripts.

Add commands handler.

Project details


Release history Release notifications | RSS feed

This version

1.7

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-telegram-bot-1.7.tar.gz (22.4 kB view details)

Uploaded Source

File details

Details for the file python-telegram-bot-1.7.tar.gz.

File metadata

File hashes

Hashes for python-telegram-bot-1.7.tar.gz
Algorithm Hash digest
SHA256 ffd5810a761570febb3ad0282766312c81c7c0e537e25ce143edb13a3ec57ef3
MD5 06664e4d5dc44f1a1c7478642ba60c7f
BLAKE2b-256 995d48d850d4c5f2b0e6b9ff7617f92765f77eaada462727466556383f9d84d9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page