用途:本技能面向 Telegram Mini App 架构,用于在 Telegram 内构建接近原生体验的 Web 应用,覆盖游戏、DeFi、工具与社交类 Mini App。
主要能力:提供 Telegram Web App API 使用、Mini App 架构设计、TON Connect 集成、应用内支付、基于 Telegram 的用户认证、Mini App UX 模式、病毒式传播机制以及 TON 区块链集成等能力。
必要用法:基础结构需引入脚本 https://telegram.org/js/telegram-web-app.js,并通过 window.Telegram.WebApp 调用 tg.ready()、tg.expand(),用户数据取自 tg.initDataUnsafe.user。React 场景可封装 useTelegram 钩子。机器人可通过 inline_keyboard 的 web_app 字段打开 Mini App。TON Connect 需安装 npm install @tonconnect/ui-react,使用 TonConnectUIProvider 与 TonConnectButton,并配置 tonconnect-manifest.json。发送交易时金额以 nanoton 表示(amount * 1e9)。Telegram Stars 支付使用 currency 'XTR'。
适用场景:适合开发 Telegram 内嵌 Web3 或游戏类应用、需要加密支付与推荐分享裂变的场景。
限制:资料未提供完整的部署、价格或具体平台细节;文中提及需避免忽略 Telegram 主题、避免桌面优先设计、避免缺少加载状态。安全要点包括校验 initData、处理 TON Connect 移动端问题与性能问题。