跳至主要內容

使用 BotFather 建立和管理 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. 按 BotFather 的提示上傳符合要求的圖標。

  4. URL——必須是 HTTPS。

  5. shortName 區分大小寫,同一 Bot 下不可重複。使用 3–30 個英文字母、數字或下劃線。

建立後的直鏈

得到 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* 回寫聊天。

驗證應用入口

建立後在私訊測試直鏈和訊息按鈕。群內分享請用打開 MiniApp 指南中的單按鈕請求示例。

相關

權威來源

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

是否回答了您的問題?