源码简介
TGActivator是一套基于Node.js开发的Telegram短信激活机器人源码,主要用于搭建基于Telegram的虚拟号码和短信验证码接收服务。
该项目通过5sim API连接虚拟号码服务,用户可以直接在Telegram机器人中搜索国家和服务,选择需要的虚拟号码并创建订单。当对应号码收到短信验证码后,系统可以将验证码返回给用户,从而完成整个短信激活业务流程。
除了基础的虚拟号码购买和短信接收功能之外,该源码还集成了用户钱包、订单记录、收藏、优惠码、推广返佣、多语言、多货币、自动退款等功能,并提供基于Telegram的管理后台。
项目采用Node.js开发,使用grammY作为Telegram Bot框架,SQLite负责本地数据存储。所有核心API和敏感配置均通过环境变量进行设置,开发者可以使用自己的Telegram Bot Token、5sim API Key以及支付服务凭据进行部署。
需要注意的是,该项目提供的是源码程序,不包含实际的Telegram Bot Token、5sim API Key、用户数据、订单数据、node_modules目录或数据库文件。部署者需要自行准备相关API和服务器环境。
主要功能
Telegram短信激活机器人
系统以Telegram机器人作为主要用户入口。
用户无需访问传统网页后台,可以直接通过Telegram与机器人进行交互,完成虚拟号码搜索、下单、短信接收以及订单管理。
机器人可以用于构建:
- SMS短信激活平台
- Telegram虚拟号码服务
- 临时号码接码服务
- 在线短信验证码服务
- 多国家虚拟号码商城
5sim API集成
项目已经集成5sim API,可以通过API获取相关国家和服务的虚拟号码信息。
用户可以在Telegram机器人中搜索需要的服务和国家,然后根据可用资源选择号码并创建订单。
5sim API负责实际的虚拟号码和短信业务,而Telegram Bot主要负责用户交互、订单流程以及平台业务逻辑。
国家与服务搜索
系统支持按照国家和服务进行搜索。
用户可以快速查找目标国家的虚拟号码资源,并选择对应的服务进行短信激活。
这种分类搜索方式能够简化大量国家和服务存在时的操作流程。
虚拟号码下单
用户选择服务和国家后,可以直接通过Telegram机器人创建虚拟号码订单。
订单创建后,系统负责跟踪订单状态,并等待对应短信验证码。
SMS验证码接收
当购买的虚拟号码收到短信后,系统可以获取相应的短信验证码,并通过Telegram机器人向用户展示。
这样用户无需离开Telegram即可完成整个短信激活流程。
自动退款
项目提供未成功接收短信订单的自动退款逻辑。如果订单没有按照预期获得短信验证码,系统可以根据业务规则进行退款处理,减少用户需要人工联系客服处理退款的情况。
具体退款条件和实际执行结果会受到5sim API状态以及平台业务配置影响。
用户钱包系统
系统内置用户Wallet钱包功能。用户可以在Telegram中查看账户余额,并使用钱包余额购买虚拟号码服务。
管理员可以通过后台对用户余额进行增加或扣减操作。
订单历史
用户可以查看自己的历史订单。订单记录可以帮助用户了解过去购买过的国家、服务、号码以及订单状态。
收藏功能
项目提供Favorites收藏功能。用户可以收藏经常使用的服务或相关项目,从而减少重复搜索和操作。
多语言支持
源码支持多语言界面,可以根据平台实际运营需求扩展语言。对于面向不同国家和地区用户运营的短信激活平台,多语言功能可以降低用户使用门槛。
多货币显示
系统支持Multi-Currency多货币显示。平台可以根据实际业务需要配置不同货币的展示方式,从而适用于面向多个国家和地区运营的场景。
CryptoBot支付
项目支持CryptoBot支付方式。如果平台需要提供加密货币支付,可以根据CryptoBot相关配置完成支付流程接入。
Telegram Stars支付
系统还支持Telegram Stars支付方式,可以结合Telegram自身的数字支付体系,为机器人用户提供另一种支付选择。
CryptoBot和Telegram Stars属于可选支付功能,实际部署时需要根据平台自身业务和账户条件进行配置。
优惠码系统
管理员可以创建和管理Promo Code优惠码。
优惠码可以用于营销活动,例如:
- 新用户优惠
- 活动优惠
- 指定用户优惠
- 服务促销
- 拉新活动
具体优惠规则可以根据源码提供的配置和业务逻辑进行调整。
推广返佣系统
系统提供Referral System推广系统。
用户可以通过邀请其他用户注册和使用平台获得相应的推广奖励。
管理员可以设置Referral Rate推广比例,用于构建适合自身业务的邀请返佣机制。
这种模式比较适合需要进行Telegram社区推广和用户裂变的服务平台。
强制订阅频道
项目支持Force Subscription功能。
平台可以要求用户先加入指定Telegram频道或群组,再继续使用机器人服务。
该功能适合用于:
- 官方频道推广
- 社区用户增长
- 公告信息触达
- 活动推广
管理员可以根据实际运营需求启用或关闭该功能。
Telegram管理后台
TGActivator的一个重要特点是管理后台同样基于Telegram实现。
管理员不需要额外访问独立Web后台,可以直接通过Telegram进入管理功能。
管理员可以通过:
/admin
进入管理面板。
用户管理
管理员可以搜索和查看平台用户,并对用户账户进行管理。
支持的操作包括:
- 搜索用户
- 查看用户信息
- 查看账户余额
- 增加用户余额
- 扣除用户余额
- 禁止用户
- 解除用户封禁
广播消息
管理员可以向机器人用户发送Broadcast广播消息。
该功能可以用于发布:
- 平台公告
- 活动通知
- 服务更新
- 促销信息
- 维护通知
服务费用设置
管理员可以配置Service Fee服务费用。
平台运营者可以根据自己的业务模式设置相应的服务费或价格调整规则。
推广比例设置
后台支持调整Referral Rate推广返佣比例。
管理员可以根据获客成本和平台利润空间灵活调整推广政策。
优惠码管理
管理员可以创建、调整和管理优惠码活动。
Bot配置
Telegram后台可以用于调整部分机器人运行配置,方便运营人员直接通过Telegram进行日常管理。
基础统计
项目提供基础统计功能,可以帮助管理员了解平台运行情况以及用户相关数据。
技术架构
Node.js
项目基于Node.js开发,适合部署在VPS、云服务器以及其他支持Node.js运行环境的平台。
Node.js的异步处理能力也比较适合Telegram Bot、API请求以及订单状态处理等应用场景。
grammY Telegram Bot框架
源码采用grammY作为Telegram Bot开发框架。
grammY用于处理Telegram消息、按钮交互、命令、用户操作以及机器人业务流程。
5sim API
5sim API主要负责虚拟号码及短信激活相关服务。
Telegram机器人负责前端交互和业务流程,而5sim负责实际号码资源和短信服务。
SQLite数据库
项目使用SQLite作为本地数据存储方案。
数据库主要用于保存平台运行过程中需要管理的用户、订单、余额、优惠码以及其他业务数据。
对于中小规模部署,SQLite可以降低数据库部署复杂度。
如果未来业务规模扩大,也可以根据源码结构和实际需求进一步进行数据库架构调整。
环境变量配置
源码采用.env环境配置方式保存重要参数。
主要配置内容包括:
- Telegram Bot Token
- 管理员Telegram ID
- 5sim API Key
- 支付接口配置
- 其他运行环境参数
这种配置方式可以避免直接将敏感信息硬编码到源代码中。
系统要求
软件环境
部署该Telegram短信激活机器人需要:
- Node.js 18或更高版本
- npm
- SQLite支持
- VPS或云服务器
- SSH访问权限
- 基础Node.js部署知识
Telegram配置
需要准备自己的Telegram Bot Token。
可以通过Telegram官方机器人管理工具创建属于自己的Bot,并将Token配置到.env文件。
同时需要准备管理员Telegram ID,以便进入机器人管理后台。
5sim API
平台需要自己的5sim API Key。
源码本身不提供5sim账户或API密钥,部署者需要自行申请并配置。
支付配置
如果需要启用CryptoBot支付,需要准备对应的CryptoBot API Token。
如果使用Telegram Stars支付,则需要根据Telegram相关要求完成对应配置。
这些支付功能均属于可选配置,不影响源码的基础结构。
安装部署
上传源码
首先将源码压缩包上传到VPS或云服务器,然后解压到项目目录。
配置环境文件
将:
.env.example
重命名为:
.env
然后填写自己的运行参数。
主要包括:
Telegram Bot Token
Admin Telegram ID
5sim API Key
支付相关配置
安装依赖
进入源码目录后执行:
npm install
等待Node.js项目依赖安装完成。
启动机器人
安装依赖后,可以执行:
npm start
启动Telegram Bot。
测试机器人
启动完成后,在Telegram中打开自己的机器人并发送:
/start
如果配置正确,机器人即可开始响应用户请求。
进入管理后台
拥有管理员权限的账户可以向机器人发送:
/admin
进入Telegram管理面板。
普通用户无法使用管理员功能。
源码包含内容
该项目属于源码型产品,主要包含:
- Node.js Telegram Bot源码
- grammY机器人框架
- 5sim API集成
- SQLite数据库结构
- 多语言功能
- 多货币显示
- CryptoBot支付接口
- Telegram Stars支付功能
- 用户钱包系统
- 推广返佣系统
- 优惠码系统
- 收藏功能
- 订单历史
- 自动退款逻辑
- 强制订阅功能
- Telegram管理后台
- 环境变量配置
- README文档
- 安装部署指南
- 管理员使用指南
- 更新日志
不包含的内容
购买源码后,需要注意项目本身不包含实际运行所需的第三方账户资源。
不包含:
- Telegram Bot Token
- 5sim API Key
- CryptoBot API Token
- 用户数据
- 实际订单数据
- node_modules依赖目录
- 已配置的SQLite数据库文件
- 第三方平台账户
因此,部署者需要自行准备Telegram机器人、5sim账号以及服务器环境。
部署注意事项
该项目虽然提供了完整的基础功能,但实际运行时仍然依赖5sim API以及Telegram平台。
部署前建议确认:
- Telegram Bot Token是否有效
- 5sim API Key是否可正常使用
- 服务器Node.js版本是否符合要求
- SQLite文件是否具有正确的读写权限
.env环境变量是否配置完整- 管理员Telegram ID是否正确
- 支付接口是否完成配置
- Telegram机器人是否能够正常访问
- 后台进程是否能够长期运行
生产环境建议使用进程管理工具或服务器服务管理机制保持Node.js机器人持续运行,并定期备份SQLite数据库。
关于5sim API
5sim API 是 5SIM 平台提供的程序化接口,核心用途是让开发者通过代码自动获取临时虚拟手机号码来接收短信验证码,从而绕过各类网站或 App 的短信验证环节,且无需使用个人真实号码。
具体功能与典型用途
-
自动化账号注册与验证:你可以在代码中集成该 API,自动为特定服务(如 Telegram、Google、各大社交或电商平台)购买一个指定国家的虚拟号码,然后程序化地轮询获取该号码收到的短信验证码,并自动填入注册流程,实现全自动的批量账号注册或测试。
-
可用操作:API 提供了完整的账号与订单管理功能。你可以通过它查看账户余额、购买号码(支持指定国家、运营商和服务)、检查是否收到短信、以及完成、取消订单或举报无效号码。
-
覆盖范围:5SIM 官方宣称其虚拟号码覆盖超过 180 个国家。API 支持针对不同的目标服务(如 Telegram、各类 App 及网站)购买对应可用的号码。
使用门槛与资源
使用该 API 通常需要先在 5sim.net 注册账号并生成专属的 API Key。由于 5SIM 提供了标准的 HTTP 接口,社区里存在不少由第三方开发者用 Python、TypeScript、Go 等语言编写的开源客户端库(如 fivesim、PanjSim),可以直接调用以简化开发流程。
申请 5sim API 不需要特殊的资质或审核,注册账号即可获取。
📝 申请门槛
-
仅需注册:根据官方 FAQ 和教程,你只需在 5sim 官网注册一个普通账号,然后在个人中心点击“获取 API 密钥”即可生成。
-
无需证明:平台没有要求提供企业营业执照、开发者身份证明或说明具体用途。
⚠️ 需要注意的硬性限制
虽然没有资质门槛,但存在 地域限制:5SIM 的服务不面向美国或俄罗斯的居民。如果你试图从这两个国家注册或访问,可能会被终止账号。
💡 使用前提
虽然申请免费,但要想通过 API 实际购买号码或接收短信,你的账户必须有余额。API 调用会直接从你的 5SIM 账户余额中扣费。
本站资源仅供下载者学习技术,版权归资源原作者所有,请在下载后24小时之内自觉删除。
本站资源仅供下载者学习IT编程开发技术,请遵守国家法律法规,严禁用于非法用途。
若作商业用途,请购买正版,由于未及时购买正版发生的侵权行为,与本站无关。
如您是版权方,本站源码有侵犯到您的权益,请邮件联系331752841@qq.com 删除,我们将及时处理!
常见问题FAQ
- 链接地址失效怎么办?
- 下单后客服会及时检查链接地址是否有效,并即时更新网盘并通过注册邮箱发送通知和链接,如未即时处理请联系站长。
- 提示下载完但解压或打开不了?
- 有演示地址吗?包搭建吗?
