Documentation

Get your project key, drop in the SDK, and start tracking. Your data arrives in Telegram.

Quick Start

SDK Setup

One project key works across all platforms. Events from your web app, mobile app, and backend all flow into the same Telegram reports.

JavaScript / TypeScript

npm install or drop in a script tag. Works in React, Vue, vanilla JS, and server-side rendering.

// npm install tgram-analytics
import { TGA } from 'tgram-analytics';

// Initialize once
TGA.init('proj_xxx');

// Track events
TGA.track('signup', userId, { plan: 'pro' });
TGA.track('purchase', userId, { amount: 49 });

Flutter / Dart

Add to pubspec.yaml. The SDK buffers events before init, so you can track anywhere.

// flutter pub add tgram_analytics
import 'package:tgram_analytics/tgram_analytics.dart';

// In main():
void main() {
  TGA.init('proj_xxx');
  runApp(MyApp());
}

// Track from anywhere
TGA.track('purchase', userId, properties: {'amount': 49.99});

Python

Sync and async support. Great for Django, FastAPI, or background jobs.

# pip install tgram-analytics
from tgram_analytics import TGA

# Initialize
tga = TGA("proj_xxx")

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

Bot Commands

Everything happens in Telegram. No dashboard to open, no login to remember.