Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Unofficial Telegram Bot API Library and Client

Project description


twx.botapi: Unofficial Telegram Bot API Library and Client

- -
contributions Please join
issues Please use
Python version supported 2.7, 3.0, 3.1, 3.2, 3.3, 3.4, 3.5, 3.6

twx.botapi is a python interface for the Telegram bot API. It supports making synchronous and asynchronous calls and converts the response into a usable native python object.

Support for the MTProto API is in the works, but considered pre-alpha right now.


You can join our support chat at:


For stable:

pip install twx.botapi

For dev:

pip install -i twx.botapi


Documentation can be found at

Quick Start

from twx.botapi import TelegramBot, ReplyKeyboardMarkup

Setup the bot

bot = TelegramBot('<API TOKEN>')

Send a message to a user
user_id = int(<someuserid>)

result = bot.send_message(user_id, 'test message body').wait()

Get updates sent to the bot
updates = bot.get_updates().wait()
for update in updates:

Use a custom keyboard
keyboard = [
    ['7', '8', '9'],
    ['4', '5', '6'],
    ['1', '2', '3'],
reply_markup = ReplyKeyboardMarkup.create(keyboard)

bot.send_message(user_id, 'please enter a number', reply_markup=reply_markup).wait()

Download files

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

Files for twx.botapi, version 3.6.2
Filename, size File type Python version Upload date Hashes
Filename, size twx.botapi-3.6.2.tar.gz (33.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page