Do not mix the identifiers. miniapp_id is a signed business id generated by MPChat; shortName is a per-bot link name; entryUrl is the page users open. They play different roles.

Overview

An MPChat MiniApp is a web app opened inside MPChat. The current phase focuses on opening the MiniApp, exposing signed init data, and letting your backend verify user identity. It does not implement the full WebApp JavaScript API.

Core identifiers

Name	Source	Purpose
miniapp_id	Generated by MPChat when you create the MiniApp (looks like `ma_...`).	Business id; appears in the signed `initData`. Verify it on the backend.
shortName	The short link name you set at creation.	Combines with the bot username to form a direct link. Unique under one bot.
entryUrl	The H5 entry URL you set at creation.	The page users open; used as `web_app.url` in sendMessage.
botUsername	The bot username.	First path segment of a direct link.

Direct link rules

https://mp.net/{botUsername}/{shortName}

Do not include @ in the path.
shortName is unique under the same bot; different bots may reuse the same name.
Passing only botUsername resolves the bot but selects no default MiniApp — include shortName.

How creation and opening connect

Create the MiniApp (for example via BotFather /newapp); record miniapp_id, shortName, entryUrl.
Open via a sendMessage web_app button or a direct link.
When opened, MPChat generates a signed launch context; the backend confirms which MiniApp the request belongs to using the signed miniapp_id.

shortName is not a miniapp id

Developers often call shortName a “miniappid”. That is wrong.
miniapp_id (looks like ma_…) is the platform-issued business id inside signed initData.
shortName is the human slug you choose at creation; it pairs with botUsername in the direct link.
Passing only botUsername never selects a default MiniApp — always include shortName.

Direct link and startapp

https://mp.net/{botUsername}/{shortName}
https://mp.net/{botUsername}/{shortName}?startapp=report_0528

MPChat includes the launch value as start_param in the signed initData query string.
For direct-link page routing, the frontend can read window.MpChat.WebApp.initDataUnsafe.startParam. Use the verified start_param on the server for decisions that affect permissions or business state.
Use the https://mp.net/{botUsername}/{shortName}?startapp=… form for parameterized direct links and message buttons. Keep the registered entryUrl as the page URL.
In BotFather, shortName is case-sensitive and unique per bot. Use 3–30 ASCII letters, digits, or underscores (^[a-zA-Z0-9_]{3,30}$).

miniapp_id is not a frontend-defined page id and is not the same as shortName. Always trust the signed value in raw initData, never an unsigned one from the frontend.

MiniApp overview: identifiers, URLs, and direct links