Skip to main content

​
How Dashgram Works with Mini Apps

Dashgram is an analytics platform for Telegram Mini Apps. It can be integrated into any web-based Mini App, with SDKs available to simplify integration for popular frameworks. Dashgram automatically captures user interactions, tracks events, and sends analytics data to the platform.

​
Key Features

Automatic Event Tracking

Automatically tracks user interactions like clicks, form submissions, page views, and more based on your configured tracking level.

Telegram WebApp Context

Native integration with Telegram WebApp API, automatically capturing user data and Telegram-specific events.

Performance Monitoring

Tracks Web Vitals (LCP, FID, CLS) and performance metrics to help you optimize your Mini App.

Custom Events

Track custom business events like purchases, sign-ups, feature usage, and any other user actions.

​
Getting Started

Dashgram can be integrated into Telegram Mini Apps using the REST API directly, or with convenience SDKs for faster integration:

JavaScript SDK

SDK for vanilla JavaScript, TypeScript, or any framework. Works with any web application.

React SDK

SDK with React integration including hooks, providers, and React-specific features.

​
Track Levels

Dashgram offers three tracking levels to balance between data collection and performance:
Minimal tracking. Only captures basic app lifecycle events:
  • app_open - When the Mini App is opened
  • app_close - When the Mini App is closed
Use when: You only need basic usage metrics.
Comprehensive tracking. Level 1 + 2 + performance metrics + all Telegram events:
  • Scroll depth tracking
  • Element visibility
  • Web Vitals (LCP, FID, CLS)
  • Network status
  • All Telegram WebApp events
  • Performance monitoring
Use when: You need detailed performance monitoring and all Telegram events.

​
Next Steps

  1. Get your project ID: Sign up at app.dashgram.io and create a project
  2. Integrate Dashgram: Use the REST API directly, or choose an SDK like JavaScript or React for faster integration
  3. Start tracking: Follow the integration guide for your chosen approach
  4. View analytics: Check your dashboard to see real-time data
All Dashgram Mini App SDKs require your Mini App to be running inside Telegram. They automatically detect the Telegram WebApp environment and only track events when running in Telegram.