跳至主要內容

用 /newapp 與 /myapps 建立和管理 MiniApp

介紹用 BotFather 的 /newapp 與 /myapps 建立和管理 MiniApp:HTTPS URL、shortName、直鏈 https://mp.net/{botUsername}/{shortName},以及可選 ?startapp= 深鏈與下架注意點。

一句話結論

每個 MiniApp 綁定一個正常狀態的 Bot。用 BotFather /newapp 建立,用 /myapps 管理。直鏈形狀:https://mp.net/{botUsername}/{shortName},可加 ?startapp=


總覽

登記在 BotFather 完成。訊息裡打開仍遵循內嵌 / 菜單 web_app 規則,見 core.mp.net/bots

前提

  • 必須先有一個正常狀態的 Bot。

  • 每個 MiniApp 只綁定一個 Bot。

/newapp 步驟

  1. 選擇 Bot。

  2. 名稱(全英文)。

  3. 描述(全英文)。

  4. 連結圖 640×360。

  5. URL——必須是 HTTPS

  6. shortName——同一 Bot 下不重複。

建立後的直鏈

得到 https://mp.net/{botUsername}/{shortName}。可用 ?startapp=report_0528 深鏈到具體頁(進入籤名 initData.start_param / 前端 startParam)。不要把 startapp 寫進 MiniApp 的 entryUrl 本身;放在直鏈或按鈕 web_app.url 上。

https://mp.net/MyBot/shop
https://mp.net/MyBot/shop?startapp=report_0528

/myapps 管理

  • 可改 Title / 描述 / 連結圖 / URL。

  • 刪除需二次確認(嚴肅程度同刪 Bot)。

  • 完成後返回列表。

下架 / 刪除後

已發出的直鏈與按鈕會走用戶側「MiniApp 下架」表現(無法繼續操作,通常只剩關閉)。請停止再發這些 URL,或改成新應用。

客戶端回流仍關閉

web_app_data / sendData / answerWebAppQuery 仍不可用。用戶在 MiniApp 內完成後,優先用訊息 callback 或服務端 editMessage* 回寫聊天。

相關

權威來源

直鏈與歸屬規則以 core.mp.net/bots 為準。

是否回答了您的問題?