telegram_crash_reporter #

A lightweight Flutter plugin that sends crash reports, errors, and custom logs directly to your Telegram chat or channel via a bot. Perfect for real-time debugging and monitoring without relying on third-party crash analytics.

💡 Looking for multi-platform support? Check out crash_reporter — the advanced version that can send crash reports to Telegram, Slack, Discord, and custom webhooks simultaneously. Perfect for teams that need flexible routing across multiple channels.

🚀 Features #

• Instant crash reporting to Telegram
• Send custom logs and error messages
• Works with runZonedGuarded for uncaught exceptions
• Supports async error handling
• Lightweight — minimal dependencies
• No external analytics SDKs — full control & privacy

🧩 Installation #

Add the package to your pubspec.yaml:

dependencies:
  telegram_crash_reporter: ^1.0.0

Then run:

flutter pub get

⚙️ Setup #

1. Create a Telegram Bot #

• Open Telegram and search for @BotFather
• Send /newbot and follow the instructions
• Copy the Bot Token (e.g., 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ)

2. Get Your Chat ID #

The easiest way is to use @InstantChatIDBot:

• Open Telegram and start a chat with @InstantChatIDBot
• It will instantly show your Chat ID
• Copy that ID and use it in your initialization code

Alternative (manual method):

For personal chat:

• Message your bot, then visit:
  https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
• Look for "chat":{"id":...} → copy the number

For channels:

• Add your bot as an admin
• Use @channelusername or the negative ID from the API response (e.g., -1001234567890)

3. Initialize in main.dart #

import 'dart:ui';
import 'package:flutter/material.dart';
import 'package:telegram_crash_reporter/telegram_crash_reporter.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // Initialize early
  await TelegramCrashReporter.initialize(
    botToken: 'YOUR_BOT_TOKEN',
    chatId: 123456, // YOUR_CHAT_ID
    showDebugPrint: true // FALSE
  );

  // Catch Flutter UI framework errors
  FlutterError.onError = (details) {
    TelegramCrashReporter.reportCrash(
      error: details.exception,
      stackTrace: details.stack ?? StackTrace.current,
      context: 'Flutter UI Error: ${details.library}',
      fatal: true,
      extraData: {
        'library': details.library,
        'stackFiltered': details.stackFilter,
      },
    );
  };

  // Catch unhandled Dart runtime errors
  PlatformDispatcher.instance.onError = (error, stack) {
    TelegramCrashReporter.reportCrash(
      error: error,
      stackTrace: stack,
      context: 'Dart Runtime Error',
      fatal: true,
    );
    return true; // Keep app running
  };

  // Optional: Catch errors in the widget tree
  ErrorWidget.builder = (errorDetails) {
    TelegramCrashReporter.reportCrash(
      error: errorDetails.exception,
      stackTrace: errorDetails.stack!,
      context: 'Error Widget',
      fatal: false,
    );
    return ErrorWidget(errorDetails.exception);
  };

  runApp(const MyApp());
}

🧠 Usage Examples #

Report a Caught Exception #

try {
  throw Exception("Something went wrong!");
} catch (e, s) {
  TelegramCrashReporter.report(e, s);
}

Send a Custom Log Message #

TelegramCrashReporter.sendMessage("User logged in successfully!");

Advanced: Custom Formatting #

TelegramCrashReporter.report(
  error,
  stackTrace,
  extraInfo: {
    'user_id': '12345',
    'screen': 'HomePage',
    'version': '1.2.0',
  },
);

📝 API #

🛠 Configuration (Optional) #

await TelegramCrashReporter.initialize(
  botToken: '123...',
  chatId: '-1001234567890', // Channel example
  showDebugPrint: true,      // Print to console (debug only)
);

🔒 Privacy & Security #

• No data leaves your app except what you send
• Bot token is stored securely in memory
• No analytics, tracking, or third-party servers