TeleTemplate文档Telegram
Telegram Bot
Telegram Bot 集成介绍
概述
SuperTele 提供基于 grammY 的完整 Telegram Bot 集成，支持命令处理、内联查询、支付等功能。
配置
环境变量
在 .env.local 文件中配置以下环境变量：
# Telegram Bot Token（从 @BotFather 获取）
TELEGRAM_BOT_TOKEN=your_bot_token
# Webhook 密钥用于安全验证
TELEGRAM_BOT_WEBHOOK_SECRET=your_webhook_secret
# 你的网站 URL（用于设置 webhook）
NEXT_PUBLIC_APP_URL=https://your-domain.com开发模式
开发时使用长轮询模式：
pnpm bot:dev生产模式
生产环境设置 webhook：
pnpm bot:webhookBot 命令
模板包含以下内置命令：
| 命令 | 描述 |
|---|---|
/start | 启动 Bot 并显示欢迎信息 |
/help | 显示帮助信息 |
/buy | 购买积分 |
/balance | 查看积分余额 |
/invite | 获取邀请链接 |
/support | 联系客服 |
Telegram Stars 支付
SuperTele 支持 Telegram Stars 作为支付方式：
用户发起支付
用户点击购买按钮或使用 /buy 命令。
显示账单
Bot 发送包含商品详情的账单。
处理支付
处理 pre_checkout_query 和 successful_payment 事件。
交付商品
为用户添加积分或解锁功能。
文件结构
src/telegram/
├── bot/
│ ├── bot.ts # Bot 实例
│ ├── commands/ # 命令处理器
│ └── i18n.ts # 国际化
├── stars/
│ └── payment-service.ts # Stars 支付服务
├── miniapp/ # MiniApp 工具
└── invite/ # 邀请系统