# telegras

`telegras` is a Telegram ingestion and automation service built on FastAPI.
It supports webhook-driven workflows, configurable handler attachments, and pluggable publication backends.

## What you can do

- Receive Telegram webhook updates.
- Match updates with composable criteria.
- Dispatch actions to built-in or custom handlers.
- Inspect runtime state and execution history via protected introspection APIs.

## Documentation map

- Start with [Getting Started](getting-started.md).
- Learn matcher/handler behavior in [Webhook Attachments](webhook-attachments.md).
- Maintain extraction tooling via [Telegram API Extraction](telegram-api-extraction.md).
- See [API Reference](api/index.md) for package and module docs.
