Skip to main content

Testing Mini Apps

Using bots in the test environment

To log in to the test environment, use either of the following:

  • iOS: tap 10 times on the Settings icon > Accounts > Login to another account > Test.
  • Telegram Desktop: open ☰ Settings > Shift + Alt + Right click ‘Add Account’ and select ‘Test Server’.
  • macOS: click the Settings icon 10 times to open the Debug Menu, ⌘ + click ‘Add Account’ and log in via phone number.

The test environment is completely separate from the main environment, so you will need to create a new user account and a new bot with @BotFather.

After receiving your bot token, you can send requests to the Bot API in this format:<token>/test/METHOD_NAME

Note: When working with the test environment, you may use HTTP links without TLS to test your Mini App.

Debug Mode for Mini Apps

Use these tools to find app-specific issues in your Mini App:


  • Enable USB-Debugging on your device.
  • In Telegram Settings, scroll all the way down, press and hold on the version number two times.
  • Choose Enable WebView Debug in the Debug Settings.
  • Connect your phone to your computer and open chrome://inspect/#devices in Chrome – you will see your Mini App there when you launch it on your phone.

Telegram Desktop on Windows and Linux

  • Download and launch the Beta Version of Telegram Desktop on Windows or Linux (not supported on Telegram Desktop for macOS yet).
  • Go to Settings > Advanced > Experimental settings > Enable webview inspection.
  • Right click in the WebView and choose Inspect.

Telegram macOS

  • Download and launch the Beta Version of Telegram macOS.
  • Quickly click 5 times on the Settings icon to open the debug menu and enable “Debug Mini Apps”.

Right click in the mini app and choose Inspect Element.

Testing with Eruda

Eruda is a tool that provides a web-based console for debugging and inspecting web pages on mobile devices and desktop browsers. Here's a step-by-step guide on how to use Eruda in a Telegram Mini Apps project.


Step 1: Include Eruda Library

First, you need to include the Eruda library in your HTML file. You can include it from a CDN:

<!-- Include Eruda from CDN (Recommended) -->
<script src=""></script>

Or you can get it on npm.

npm install eruda --save

Step 2: Initialise Eruda

Next, you need to initialize Eruda. You typically do this when the web page loads. In case you run Eruda from CDN.

<script src=""></script>
// Initialize Eruda

If you prefer modern tooling and packages add this script to your project:

import eruda from 'eruda'


Step 3: Launch Eruda

Deploy your Mini App, launch it and just press Eruda icon to start debugging!

concept imageconcept image