Product analytics
that messages you on Telegram
Like Google Analytics for your site or app — without opening a dashboard. Install the SDK; the bot pings you when someone signs up or buys, and answers with charts when you ask. Free / source-available / self-hosted.
@MyTelegramAnalyticsBot
tgram-analytics
The numbers come to you.
No tab to remember, no login habit to build. Events, charts, and 7-day recaps land in a chat you already read.
From your stack to you.
Your code sends events. The bot sends you messages back.
Start hosted. Self-host when you want.
Managed hosting is the fastest path. The source-available server is there when you want full control.
SDKs for your whole stack.
Official SDKs for JavaScript, Flutter, and Python today, with more on the way. One project key works across all of them, plus plain HTTP for anything not yet covered.
<!-- hosted by default, self-host when needed --> <script src="dist/tga.min.js"></script> <script> TGA.init("proj_xxx", { serverUrl: "https://api.tgram-analytics.com" }); TGA.track("signup", { plan: "pro" }); </script>
// In main(): void main() { TGA.init('proj_xxx', 'https://api.tgram-analytics.com'); runApp(MyApp()); } TGA.track('purchase', userId, properties: {'amount': 49.99});
from tgram_analytics import TGA tga = TGA( "proj_xxx", "https://api.tgram-analytics.com" ) tga.track( "subscription_created", session_id=user.id, properties={"plan": "pro"} )
Point your AI agent at your own data.
Connect the MCP server once with a one-time Telegram login. From there your agent can set tracking up in a project, answer questions about your events, or run on a schedule against Search Console — all in plain language.
Add tracking by asking
Ask about your numbers
Schedule it against Search Console
https://mcp.tgram-analytics.com/mcp and sign in with Telegram — OAuth, no keys to paste.
Setup guide →
How it stacks up against Google Analytics.
Google Analytics is powerful. tgram-analytics is for builders who want fast answers, lower setup friction, and Telegram-native alerts.
| tgram-analytics | Google Analytics / Amplitude | |
|---|---|---|
| Fastest hosted setup | ✓ Open bot, get key, track | More setup property, stream, tags |
| Daily workflow | ✓ Reports arrive in Telegram | ✗ You check a dashboard |
| Cost | First project free or self-host free | Free tier limits and paid upgrades vary |
| Proactive alerts | ✓ Built-in | Possible usually more configuration |
| Self-hosting option | ✓ Same product, your infra | ✗ Cloud platform only |
| Multi-stack (JS + Flutter + Python) | ✓ Same project, same report | Varies |
| Visitor & pageview tracking | ✓ Auto-tracked via JS SDK | ✓ Core GA feature |
| Custom events | ✓ signup, purchase, error — any event | ✓ Events + conversions |
| Funnels & paths | Basic Custom queries via bot | ✓ Advanced funnels, path exploration |
| User properties & segmentation | ✓ Track any properties per event | ✓ Audience + user explorer |
| Real-time data | ✓ Instant Telegram alerts | ✓ Real-time reports |
| Retention & cohorts | ✗ Not yet available | ✓ Cohort analysis, retention |
| Attribution & UTM | Manual Track UTM as properties | ✓ Full attribution modeling |
| Best fit | Indie projects, small teams, Telegram-first builders | Large teams, deep analytics, attribution-heavy orgs |
Managed first. Self-hosted when you need it.
Start without infrastructure. Keep the self-hosted path for teams that want full control.
Frequently asked questions about tgram-analytics
Quick answers about product analytics for your website or app, with alerts and reports in Telegram.
What is tgram-analytics?
tgram-analytics is product analytics for your website or app. Install the SDK and track pageviews, signups, purchases, and errors. A Telegram bot sends you alerts as they happen and replies with charts when you ask — so you never need to open a dashboard.
Is this analytics for Telegram channels or groups?
No. You track your website or app; Telegram is only how you receive alerts and reports.
How is tgram-analytics different from Google Analytics?
It is like Google Analytics for your site or app, but the numbers come to you. The bot pings you in Telegram when someone signs up or buys, and answers with a chart when you ask for a report. It is lightweight, needs no cookies, and you can self-host it.
How does tgram-analytics compare to Plausible or Umami?
Plausible and Umami give you a clean, privacy-friendly dashboard. tgram-analytics is privacy-friendly too, and puts your site and app events — signups, purchases, errors — in Telegram the moment they happen, with SDKs for JavaScript, Python, and Flutter. Like them, you can run it on your own server.
Is tgram-analytics free? Can I self-host it?
Yes to both. Your first managed project is free. The server is source-available under FSL-1.1-ALv2 at github.com/tgram-analytics/server — free for your own use, and it converts to Apache-2.0 two years after each release. Set your Telegram bot token, run docker compose up -d, and you get the same SDKs and bot commands on your own hardware.
Which SDKs are supported?
Official SDKs ship for JavaScript and TypeScript (npm install tgram-analytics), Python (pip install tgram-analytics), and Flutter / Dart (flutter pub add tgram_analytics). All SDKs share the same project key and event API, so one project covers your website, app, and backend.
Does tgram-analytics use cookies or third-party trackers?
No. The browser SDK uses sessionStorage (tab-scoped, no cookies) and posts events directly to your project's ingestion endpoint. There are no third-party trackers, no ad networks, and no cross-site tracking — it's privacy-first by design. The hosted service runs in the EU, doesn't store raw IPs or User-Agents, and uses a one-way daily-rotating visitor hash. See the privacy policy for the full breakdown.