源码介绍
TGStore是一款基于Telegram平台开发的虚拟商品销售商城机器人源码,主要面向销售数字商品的个人卖家、工作室、代理商以及数字产品企业。
通过Telegram Bot,TGStore可以将商品展示、用户充值、订单支付、数字商品自动发货、优惠券、推广返佣、库存管理等流程整合到一个机器人中,实现较为完整的自动化销售体系。
TGStore适合销售流媒体账号、游戏激活码、软件授权码、许可证密钥、数字账号以及其他可通过下载地址、文本或代码形式交付的数字商品。
TGStore采用Python开发,基于现代化的aiogram异步框架,并使用SQLite数据库保存商城数据。管理员和客户都可以直接在Telegram聊天界面完成大部分操作,无需单独搭建复杂的后台管理系统。
在实际部署时,需要重点保护BOT_TOKEN、支付相关配置以及数据库文件,同时建议正式运营前完善订单异常处理、支付验证、数据库备份和库存安全机制,以提高商城长期运行的稳定性。
主要优势
从数字商品商城运营角度来看,TGStore最大的特点是将商品销售、钱包、库存、营销推广和自动发货集中到了Telegram机器人中。
相比传统人工销售模式,它可以减少人工处理订单和发送商品的工作量。
其主要优势包括:
- Telegram内完成商品购买
- 数字商品自动发货
- 内置用户钱包
- 支持每日奖励
- 支持免费商品领取
- 多级邀请返佣
- 支持优惠券和促销码
- 商品评分与评价
- 批量库存添加
- CSV批量导入
- 自动发布商品和补货信息
- 库存不足自动提醒
- 用户管理功能
- SQLite数据库备份与恢复
- Python异步架构
- 支持云服务器部署
主要功能
数字商品自动发货
TGStore支持虚拟商品自动交付。用户完成购买后,机器人可以直接在Telegram聊天窗口发送对应的商品内容,从而减少人工处理订单的工作量。
适用于:
- 游戏激活码
- 软件License授权码
- 流媒体账号
- 数字账号
- 序列号
- 兑换码
- 下载地址
- 其他文本型数字商品
对于库存充足的商品,可以实现从下单到发货的自动化处理。
内置用户钱包
机器人内置数字钱包功能,用户可以在Telegram中查看自己的余额以及相关账户信息。
钱包功能包括:
- 查看当前余额
- 每日领取奖励
- 账户充值
- 查看交易情况
- 使用账户余额购买商品
- 管理充值相关操作
这种设计可以减少用户反复进行支付操作的流程,同时方便商城建立自己的余额体系。
免费商品领取
TGStore支持价格为0的免费商品。为了避免免费商品被频繁领取,系统提供12小时领取冷却机制,并且冷却时间可以精确到秒进行判断。
因此,管理员可以利用免费商品进行:
- 新用户引流
- 营销活动
- 产品试用
- 用户留存
- 社区福利
多级邀请返利
TGStore提供邀请与推荐机制。用户邀请其他用户进入商城后,当被邀请用户进行充值时,邀请关系可以产生相应的余额佣金。
多级推荐体系能够帮助数字产品商城建立裂变式推广渠道,让老用户参与商城推广。管理员可以根据自己的运营模式设置相应的推荐奖励规则。
优惠券和促销码
商城支持自定义Promo Code和Coupon Code。
优惠方式包括:
- 百分比折扣
- 固定金额折扣
- 最大使用次数
- 到期时间限制
例如,可以针对新用户、节日活动或者指定商品创建不同优惠码,从而提高商城的转化率。
商品评价和评分
用户成功购买商品后,可以对商品进行1~5星评分,并留下文字评价。
商品评价系统可以帮助商城积累用户反馈,同时让其他用户在购买商品时获得更多参考信息。
商品分类管理
TGStore支持对数字商品进行分类管理。
商品可以按照不同业务类型进行组织,并通过带有Emoji的Telegram自定义键盘展示。
当商品数量较多时,还可以使用分页菜单,减少Telegram聊天界面的信息拥挤问题。
管理员功能
批量补充库存
管理员可以直接通过Telegram聊天窗口批量添加库存。多个库存项目可以通过换行符或者“|”符号进行分隔,从而快速完成大量商品库存的补充。
这种方式尤其适合需要频繁更新账号、激活码和序列号库存的数字商品商城。
CSV批量导入商品
除了直接在机器人中添加库存,Nova X还支持通过CSV文件批量导入商品。
管理员可以准备标准CSV文件,然后一次性添加多个商品以及对应的库存数量。
对于拥有大量数字商品的商城来说,可以明显减少逐条录入商品信息的工作量。
自动发布商城商品
TGStore可以与Telegram频道结合使用,实现自动化商品推广。当创建新商品时,机器人可以自动向指定频道发布商品信息。当商城补充库存时,也可以自动发布补货通知。
此外,机器人支持定期发布商城库存摘要,默认周期为12小时,可以展示当前商品的库存和价格情况。这样可以将Telegram频道同时作为商品展示和营销推广渠道。
库存不足自动提醒
为了避免热门商品库存耗尽,TGStore提供自动库存预警功能。当某个商品库存降低到3个或更少时,系统可以向管理员以及指定用户或频道发送提醒。当商品完全售罄后,还可以继续发送缺货通知。
对于需要持续销售数字账号、License或激活码的商城,这项功能可以帮助管理员及时补充库存。
用户查询与管理
管理员可以通过机器人查看用户相关信息,并执行必要的运营管理操作。
支持的功能包括:
- 查看用户余额
- 查看交易统计
- 手动增加用户余额
- 封禁用户
- 解除用户封禁
- 查询用户相关数据
因此,管理员无需频繁登录独立后台,就可以直接通过Telegram进行商城运营。
数据库备份与恢复
TGStore支持SQLite数据库备份与恢复。管理员可以通过Telegram请求完整的.db数据库备份文件,也可以使用数据库文件执行恢复操作。
商城的用户、商品、库存、交易等数据均依赖数据库保存,因此定期备份对于保障商城正常运营非常重要。
技术架构
TGStore主要采用Python技术栈开发,核心组件包括:
| 技术组件 | 作用 |
|---|---|
| Python | 项目主要开发语言 |
| aiogram | Telegram机器人异步开发框架 |
| aiosqlite | 异步SQLite数据库操作 |
| SQLite | 保存商城业务数据 |
| python-dotenv | 管理环境变量和配置 |
| Telegram Bot API | 实现机器人交互和消息处理 |
项目采用异步架构,可以更好地处理Telegram机器人中的消息、订单、库存等操作。
SQLite则适合中小型数字商品商城使用,不需要额外部署MySQL等独立数据库服务,可以降低部署和维护成本。
运行环境要求
TGStore对服务器环境要求相对较低。
软件环境
- Python3.8或更高版本
- Windows、Linux等操作系统
- SQLite数据库
- aiogram
- aiosqlite
- python-dotenv
项目也可以部署到云服务器或支持Python应用部署的平台。
原项目推荐使用Railway进行托管部署,对于不希望自行维护服务器环境的用户,可以考虑使用类似的云平台进行部署。
配置方法
下载项目后,首先将ZIP压缩包解压到本地电脑或服务器。
然后找到:
.env.example
将其复制或重命名为:
.env
接下来根据实际情况填写Telegram机器人和商城配置。
环境变量配置示例
BOT_TOKEN=your_telegram_bot_token
ADMIN_IDS=your_telegram_id_1,your_telegram_id_2
BINANCE_PAY_ID=your_binance_pay_id
CHANNEL_ID=-100xxxxxxxxxx
SUPPORT_USERNAME=your_username
BOT_USERNAME=your_bot_username_without_at
CHANNEL_USERNAME=your_channel_name
其中主要参数作用如下:
| 配置项 | 作用 |
|---|---|
| BOT_TOKEN | Telegram机器人Token |
| ADMIN_IDS | 管理员Telegram用户ID,可设置多个 |
| BINANCE_PAY_ID | Binance Pay相关配置 |
| CHANNEL_ID | 商品公告和库存通知频道ID |
| SUPPORT_USERNAME | 客服Telegram用户名 |
| BOT_USERNAME | 机器人用户名,不需要填写@ |
| CHANNEL_USERNAME | Telegram频道用户名 |
BOT_TOKEN需要通过Telegram的BotFather创建机器人后获取。
管理员ID则需要填写实际负责管理商城的Telegram账户ID。
部署方法
完成环境变量配置后,需要安装项目所依赖的Python库。
通常可以通过项目提供的依赖文件安装,例如:
pip install -r requirements.txt
如果项目没有提供完整的依赖文件,则需要根据项目实际代码安装对应的Python依赖,例如:
pip install aiogram aiosqlite python-dotenv
安装完成后即可按照项目入口文件启动Telegram机器人。
Railway部署
对于希望快速上线的用户,可以将项目代码上传到GitHub,然后通过Railway连接GitHub仓库进行部署。
需要注意的是,不要将包含真实Token、支付信息或其他敏感配置的.env文件直接上传到GitHub。
推荐的部署流程为:
- 将项目上传到GitHub。
- 将
.env加入.gitignore。 - 在Railway创建项目。
- 连接对应的GitHub仓库。
- 在Railway的环境变量中填写
.env中的配置。 - 安装项目依赖。
- 启动Python机器人程序。
- 检查Telegram机器人是否正常响应。
- 测试商品、库存、订单和自动发货流程。
这种部署方式可以避免在代码仓库中暴露Telegram Bot Token等敏感信息。
本站资源仅供下载者学习技术,版权归资源原作者所有,请在下载后24小时之内自觉删除。
本站资源仅供下载者学习IT编程开发技术,请遵守国家法律法规,严禁用于非法用途。
若作商业用途,请购买正版,由于未及时购买正版发生的侵权行为,与本站无关。
如您是版权方,本站源码有侵犯到您的权益,请邮件联系331752841@qq.com 删除,我们将及时处理!
常见问题FAQ
- 链接地址失效怎么办?
- 下单后客服会及时检查链接地址是否有效,并即时更新网盘并通过注册邮箱发送通知和链接,如未即时处理请联系站长。
- 提示下载完但解压或打开不了?
- 有演示地址吗?包搭建吗?



