Telegram Bot API - Async 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.