Web Adapters

Adapters connect the engine to your HTTP framework. They register POST, map requests to WebRequest, and map engine responses back to framework types.

Choose an adapterChoose an adapterChoose an adapter

Adapter	Framework	Guide
FastAPIAdapter	FastAPI	FastAPI
AiohttpAdapter	aiohttp.web.Application	aiohttp
Custom WebAdapter	Any async framework	Custom adapter

Match the framework your application already uses. If there is no preference, FastAPI is the shortest path.

Adapter boundaryAdapter boundaryAdapter boundary

The adapter handles HTTP types only. It does not resolve bots, verify security, or call the dispatcher — that stays in the engine.

Adapter does	Adapter does not
Register POST on route.path	Parse Telegram updates for business logic
Expose client_ip, headers, path/query params	Call setWebhook
Build JSON and payload responses	Choose which bot handles the update

Full layer breakdown: Dispatch modes.

Custom frameworkCustom frameworkCustom framework

Shipped adapters are working references, not templates to copy verbatim. See Custom integrations.