twx.botapi 1.0.1

Unofficial Telegram Bot API Library and Client

twx.botapi: Unofficial Telegram Bot API Library and Client

contributions:

Please join https://github.com/datamachine/twx.botapi

issues:

Please use https://github.com/datamachine/twx.botapi/issues

Python version supported:

2.7, 3.0, 3.1, 3.2, 3.3, 3.4, 3.5b

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.

Support

You can join our support chat at: https://telegram.me/joinchat/05c5c2f60112fa104d1c0c563b2fd34a

or our dev chat at: https://telegram.me/joinchat/05c5c2f6018bd6653eb6bbdccb7106a8

Install

For stable:

pip install twx.botapi

For dev:

pip install -i https://testpypi.python.org/pypi twx.botapi

Documentation

Documentation can be found at http://pythonhosted.org/twx.botapi/

Quick Start

from twx.botapi import TelegramBot, ReplyKeyboardMarkup

"""
Setup the bot
"""

bot = TelegramBot('<API TOKEN>')
bot.update_bot_info().wait()
print(bot.username)

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

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

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

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

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