Skip to content

步骤 1:申请 Telegram Bot Token 与创建 Mini App

本章节指导如何通过 Telegram 官方管理机器人 @BotFather 注册专属机器人、开通 Telegram Stars 虚拟支付权限,并配置 Mini App 小程序的直接启动链接。


阶段一:创建 Bot 并获取 Token 凭据

  1. 打开 Telegram 客户端,搜索官方管理机器人 @BotFather(带有蓝色官方认证勾号)并开启对话。 搜索 BotFather

  2. 在对话框中点击 Create a New Bot(或直接发送指令 /newbot),然后点击 Open创建新 Bot

  3. 设定显示名称:输入 Bot 的对外昵称(例如:FastTMA Game Demo)。

  4. 设定唯一用户名:输入唯一的英文用户名,末尾必须以 bot 结尾(例如:FastTMAGame_test_bot)。

  5. 保存安全凭据:BotFather 将返回一段 HTTP API Token(格式形如 7123456789:AAFn_xXxXxXxXxXxXxXxXxXxXxXx)。将此 Token 复制并保存在本地备忘录中。 获取 Bot Token

安全红线

请妥善保管 Bot Token,切勿上传到公开代码仓库,更不要硬编码进 Unity 客户端脚本或前端页面中。


阶段二:开启 Telegram Stars 虚拟支付通道

  1. @BotFather 对话框中发送指令 /mybots,选择刚才创建的 Bot。
  2. 依次点击 Bot Settings $\rightarrow$ Payments
  3. 选择 Telegram Stars 并确认开启(用于后续拉起原生 Stars 收银台与商品结算)。

阶段三:创建 Mini App (WebApp) 启动入口

  1. 进入当前机器人的管理界面,依次点击 Settings $\rightarrow$ Mini AppsMini Apps 配置入口

  2. 找到 Direct Links 区域,点击 Create Direct Link 进入链接配置页。 创建直接链接

  3. 填写小程序基础信息:

    • Title:小程序大标题(例如:FastTMA Demo)。
    • Description:游戏一句话描述。
    • Web App URL:WebGL 部署的 HTTPS 域名地址(若暂未上传服务器,可先填入临时地址如 https://example.com,后续随时可在 /myapps 菜单中修改)。
  4. 获取启动链接:配置完成后,BotFather 将返回最终的小程序启动链接(形如 t.me/FastTMAGame_test_bot/game)。在移动端点击此链接即可直接呼起小游戏。