aiogram/docs/index.md

Overview

Documentation for version {!_package_version.md!} [WIP] ¹

aiogram modern and fully asynchronous framework for Telegram Bot API written in Python 3.7 with asyncio and aiohttp. It helps you to make your bots faster and simpler.

Features

• Asynchronous (asyncio docs, PEP-492)
• Supports Telegram Bot API v{!_api_version.md!}
• Updates router (Blueprints)
• Finite State Machine
• Middlewares
• Replies into Webhook

!!! note Before start using aiogram is highly recommend to know how to work with asyncio.

Also if you has questions you can go to our community chats in Telegram:

- [English language](https://t.me/aiogram)
- [Russian language](https://t.me/aiogram_ru)

Example

Simple usage

from aiogram import Bot, Dispatcher, types
from aiogram.dispatcher.handler import MessageHandler

TOKEN = "42:TOKEN"
dp = Dispatcher()


@dp.message(commands=["start"])
class MyHandler(MessageHandler):
    """
    This handler receive messages with `/start` command
    """

    async def handle(self):
        await self.event.answer(f"<b>Hello, {self.from_user.full_name}!</b>")


@dp.message(content_types=[types.ContentType.ANY])
async def echo_handler(message: types.Message, bot: Bot):
    """
    Handler will forward received message back to the sender
    """
    await bot.forward_message(
        from_chat_id=message.chat.id, chat_id=message.chat.id, message_id=message.message_id
    )


def main():
    bot = Bot(TOKEN, parse_mode="HTML")
    dp.run_polling(bot)


if __name__ == "__main__":
    main()

Task list for 3.0

Partial list of plans for this big release is listed here.

---

1. work in progress ↩︎