aiogram-webhook 3.0.1

A python library for integrating webhook support with multiple web frameworks in aiogram. Organizes bot operation via webhooks for both single and multi-bot setups.

aiogram-webhook

aiogram-webhook is a modular Python library for webhook integration in aiogram. It supports single-bot and token-based multi-bot setups, with route building, optional request checks, and adapters for FastAPI and aiohttp.

Install

pip install aiogram-webhook
pip install "aiogram-webhook[fastapi]"
pip install "aiogram-webhook[aiohttp]"

Quick Start

from aiogram import Bot, Dispatcher
from fastapi import FastAPI

from aiogram_webhook import FastAPIAdapter, SingleBotEngine
from aiogram_webhook.route import Route

dispatcher = Dispatcher()
bot = Bot("BOT_TOKEN")

engine = SingleBotEngine(
    dispatcher,
    bot,
    web=FastAPIAdapter(),
    route=Route(base_url="https://example.com", path="/webhook"),
)

app = FastAPI()
engine.register(app)

Call await engine.set_webhook() during your application startup to register the public webhook URL in Telegram. For production, pass security=Security(...) to verify Telegram requests.

Documentation

The full documentation is in docs. It covers installation, FastAPI and aiohttp setup, routing, security, lifecycle behavior, and the public API.

Contributing

See CONTRIBUTING.md for development setup, branch naming, commit conventions, and PR guidelines.