⚠️ Independent open-source project. Not affiliated with, endorsed by, or connected to Telegram Messenger LLP in any way. "Telegram" is a trademark of Telegram Messenger LLP.
Website analytics delivered to your Telegram chat.
No dashboard to log into. No new tool to learn. No data leaving your server. Your Telegram bot tells you what's happening with your website or app — signups, purchases, errors — whenever you ask, or automatically on a schedule.
flowchart LR
subgraph Sources["📡 Data Sources"]
A["🌐 Website"]
B["📱 App"]
end
subgraph SDKs["📦 Client Libraries"]
JS["tgram-analytics-js"]
PY["tgram-analytics-py"]
SW["..."]
end
S["⚙️ tgram-analytics\nserver"]
T["🤖 Telegram Bot"]
U["😎 You"]
A --> JS
A --> PY
B --> SW
JS -- "track · pageview" --> S
PY -- "track · pageview" --> S
SW -- "track · pageview" --> S
S <-. "queries & reports" .-> T
T <-. "messages" .-> U
style Sources fill:#2b2b2b,stroke:#555,color:#fff
style SDKs fill:#2b2b2b,stroke:#555,color:#fff
style S fill:#0088cc,stroke:#006699,color:#fff
style T fill:#0088cc,stroke:#006699,color:#fff
style U fill:#333,stroke:#555,color:#fff
1. Deploy the server once — on a VPS, Railway, Fly.io, wherever you like. Everything runs on your infrastructure. Your data never leaves.
2. Add your project — open Telegram, type /add myapp.com.
The bot gives you an API key.
3. Drop in the tracker — one <script> tag for websites, one package for Flutter.
4. Ask your bot — /report signup sends you a chart. Right there in Telegram.
- 📊
/report <event>— chart any event across any time range - 🔔 Alerts — "tell me every time someone makes a purchase"
- 📅 Scheduled reports — "every Monday, send me last week's signups"
- 🔑 Multi-project — one bot, many projects
| Repo | What it is |
|---|---|
| server | FastAPI backend + Telegram bot — deploy this |
| tgram-analytics-js | <script> tracker for websites |
| tgram-analytics-flutter | Flutter SDK |
| tgram-analytics | Google Analytics / Amplitude | |
|---|---|---|
| Login required | ❌ It's in Telegram | ✅ |
| Your server, your data | ✅ | ❌ |
| Price | Free (server costs) | Free → paid |
| Proactive alerts | ✅ Built-in | Paid feature |
| GDPR-friendly | ✅ No third parties | Complicated |
| Setup time | ~5 min | 15–30 min |
Self-hosted. Open source. No dashboards. Just Telegram.