python-telegram-bot-api

Telegram Bot API - Python SDK (using aiohttp)

Simple and fast client to call rest-api endpoints api.telegram.org using aiohttp package.

View at: https://pypi.org/project/python-telegram-bot-api/

How to install

pip3 install python-telegram-bot-api

Usage

Main example:

import asyncio
from api_tgbot import TgBot, TgException


TGBOT_TOKEN = "12345:YOUR_TOKEN"
APP_HOSTNAME = "https://YOUR_HOSTNAME.ngrok.io"
CHAT_ID = 123456789  # your chat id

client_tgbot = TgBot(token=TGBOT_TOKEN)


async def main_async():
    try:
        response = await client_tgbot.setWebhook("{hostname}/tgbot/wh".format(hostname=APP_HOSTNAME))
        assert type(response) == bool
        assert response == True
    except TgException as e:
        print(e)

    try:
        sent_msg = await client_tgbot.sendMessage(CHAT_ID, "Hello from Telegram Bot!")
        assert sent_msg.chat.id == CHAT_ID
        print(sent_msg.text)
    except TgException as e:
        print(e)


if __name__ == "__main__":
    asyncio.run_until_complete(main_async())

Simple JSON-Example if you are not interested in pydantic models and want to use dict in answers:

import asyncio
from api_tgbot import TgBotJson


TGBOT_TOKEN = "12345:YOUR_TOKEN"
APP_HOSTNAME = "https://YOUR_HOSTNAME.ngrok.io"
CHAT_ID = 123456789  # your chat id

client_tgbot = TgBotJson(token=TGBOT_TOKEN)


async def main_async():
    response = await client_tgbot.setWebhook("{hostname}/tgbot/wh".format(hostname=APP_HOSTNAME))
    print(response.status)  # 200
    print(response.payload) # {'ok': True, 'result': True, 'description': 'Webhook was set'}

    response = await client_tgbot.sendMessage(CHAT_ID, "Hello from Telegram Bot!")
    print(response.status)  # 200
    print(response.payload) # {'ok': True, 'result': {'message_id': 786, 'from': {'id': ... } ... }


if __name__ == "__main__":
    asyncio.run_until_complete(main_async())

Docs

• How to publish pypi package Medium article in Russian

Dependencies

This package depends on devtud / pygramtic >= 0.2.0 package.

Disclaimer

This project and its author is neither associated, nor affiliated with Telegram in anyway. See License section for more details.

License

This project is released under the GNU LESSER GENERAL PUBLIC LICENSE License.