Managed hosting · First project free · Open source core

Telegram analytics for SaaS,
indie projects, and side hustles.

The best lightweight SaaS analytics tool that lives where you already do — in Telegram. Track signups, purchases, and errors from any stack. Get real-time alerts when important events happen, then ask the bot for instant reports whenever you need the bigger picture.

30 sec to hosted tracking
Alerts for key events
Reports generated in chat
🤖

@MyTelegramAnalyticsBot

tgram-analytics

Message
1
free hosted project
30 sec
to your first API key
3
official SDKs
24/7
Telegram event alerts
0
dashboard tabs to check

The value is simple: the data finds you.

You do not open another dashboard. Important events, charts, and digests arrive where you already work.

📊
Track what matters
See signups, purchases, errors, or any custom event. Query with simple /report commands.
"how many upgrades this month?" · /report error 24h
🔔
Know first, fast
Get pinged when a sale happens, a deploy fails, or a spike hits. No more discovering issues hours later.
"alert me every purchase" · "alert every 500 errors"
📅
Stay in the loop
Weekly digests keep your finger on the pulse without drowning in dashboards you forget to open.
"weekly summary every Monday 9am"
🔌
One key, everywhere
Same project key across your website, mobile app, and backend. All events flow into one Telegram thread.
Web → Flutter → Python → one /report

From your stack to you.

Events flow in. Telegram notifications flow out.

📱
App
Mobile events
🌐
Web
Pageviews, clicks
🖥️
Server
API, jobs, errors
tgram-analytics
Managed or self-hosted
😎
You
Get alerts & reports via bot

Start hosted. Self-host when you want.

Managed hosting is the fastest path. The open source server is there when you want full control.

recommended
Managed hosting
Open the bot, get a key, and start tracking. No server, no deploy, no maintenance.
💬
Open the bot
Start @MyTelegramAnalyticsBot in Telegram and create your first hosted project from chat.
/add myapp.com
🔑
Get your key
The bot returns a project key immediately. Your first project is free.
proj_a1b2c3d4
Track events
Drop in the SDK and send pageviews, signups, purchases, or errors.
track("signup")
open source
Self-hosted
Run the FastAPI server on your VPS, Railway, or Fly.io and keep the data on your own infrastructure.
🚀
Deploy the server
Clone the repo, set your Telegram bot token, and start the server with Docker.
docker compose up -d
🔑
Add a project
Use the same bot command to create projects and generate API keys.
/add myapp.com
📊
Ask for reports
The bot handles reports, alerts, and scheduled digests exactly like the hosted version.
/report signup 7d

Initialize once. Track anywhere.

Use one project key across your web app, mobile app, and backend. Every event lands in the same Telegram reports.

JS / TS tgram-analytics
Add the script, initialize with your key, then track events with one line.
npm install tgram-analytics
Dart / Flutter tgram_analytics
Initialize in main(), then track app events from screens, services, or purchase flows.
flutter pub add tgram_analytics
Python tgram-analytics
Track backend events like subscription changes, jobs, imports, and errors.
pip install tgram-analytics
index.html
<!-- hosted by default, self-host when needed -->
<script src="dist/tga.min.js"></script>
<script>
  TGA.init("proj_xxx");
  TGA.track("signup", sessionId, {
    plan: "pro"
  });
</script>
// In main():
void main() {
  TGA.init('proj_xxx');
  runApp(MyApp());
}

TGA.track('purchase', userId,
  properties: {'amount': 49.99});
from tgram_analytics import TGA

tga = TGA(
  "proj_xxx"
)

tga.track(
  "subscription_created",
  session_id=user.id,
  properties={"plan": "pro"}
)
MCP

AI agent integration

MCP lets AI agents set up projects, track events, and query data — all through conversation. No manual SDK wiring, no dashboard diving.

Ask your agent to wire up analytics or run reports via MCP. The agent handles setup, tracking, and queries for you.

You Wire tgram-analytics on myshop.com Agent → MCP tgram.setup({ project: "myshop.com" }) tgram.track({ event_name: "purchase", amount: 49 }) tgram.query({ report: "signups this week" }) Telegram Project ready — 342 signups this week

Not another dashboard you forget to open.

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 open source path for teams that want full control.

Managed hosting recommended
First project free
Open the bot, get a key, and start tracking.
No server setup required.
Open hosted bot
Best when you want speed
First project is free
No deploy, VPS, backups, or updates
Same Telegram reports, alerts, and digests
Add more projects when you need them
Self-hosted open source
Free
Run the server on your own infra.
Your data stays on machines you control.
View on GitHub
Best when you want control
Unlimited projects and events
All SDKs and bot features
Full data ownership
MIT license: fork it, extend it
You run uptime, backups, and updates

Frequently asked questions about tgram-analytics

Quick answers about the best Telegram analytics platform for SaaS, indie devs, and side projects.

What is tgram-analytics?

tgram-analytics is an open-source Telegram analytics platform for SaaS, indie projects, and side hustles. It tracks events, signups, purchases, and errors from any stack and delivers real-time alerts, weekly digests, and instant reports through a Telegram bot — so you don't need another dashboard.

Is tgram-analytics the best SaaS analytics tool for indie developers?

For solo founders and small teams that already live in Telegram, yes. tgram-analytics is the only SaaS analytics tool that pushes alerts and reports directly into your chat instead of waiting in a dashboard, supports JavaScript, Python, and Flutter from a single project key, and offers a free first project plus a fully MIT-licensed self-hosted option.

How is tgram-analytics different from Google Analytics, Mixpanel, or PostHog?

Unlike Google Analytics, Mixpanel, and PostHog, tgram-analytics is Telegram-first: alerts and reports are pushed to you instead of living in a dashboard. It is fully open source under the MIT license, can be self-hosted on your own infra, requires no cookies, and ships a single project key that works across web, mobile, and backend SDKs.

Is tgram-analytics free?

Yes. The first managed project is free, and the self-hosted server is fully MIT-licensed and free to deploy on your own infrastructure with a single docker compose up -d.

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 a single project covers your full SaaS stack.

Can I self-host tgram-analytics?

Yes. The server is open source under the MIT license at github.com/tgram-analytics/server. Set your Telegram bot token, run docker compose up -d, and you have the same product as the managed cloud — same SDKs, same bot commands, your hardware.

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.

The analytics for this page are handled by tgram-analytics.

Tweaks

Accent
Grid lines
Phone demo