用户从 TG 频道、私信或邀请链接打开 Bot。Bot 主要承担四件事:
登录引导(Open TG Mini App)、
异步推送(充值 / 开奖 / 提现回执)、
邀请分享、客服跳转。
Bot username 待定,所有按钮的 callback_data 和 deep link start_param 在 prototype/product-spec-V1.0.md 定义。
Bot is the entry door. Four responsibilities: onboarding, async push, invite, support handoff. No business logic inside Bot — it routes to the TG Mini App.
Open App 是 TG Mini App 按钮,
点击后直接打开 H5 / TG Mini App 并完成 initData 登录,不再要求用户输入任何东西。
chain-service 确认了 N 个区块后推送,
附上链上 tx hash 和区块浏览器跳转。活动即将开奖提醒是订阅触发,不属于强制推送。
tx hash + 区块高度 + 区块浏览器链接,让用户确信开奖结果来自链上而非平台决定。
奖品也提供"兑换 USDT"的二级入口。
sign-service 签名失败时降级为人工处理通知。
start_param —— 新用户点击后,
Bot 接收时拿到 ref_code,绑定上下级。
所有返佣计算和层级在 user-service 内做,Bot 只展示结果。
v1.0 不做站内工单 / CRM / 知识库,
所有支持沟通走 TG 私聊和公告频道,Bot 只做跳转。这是已锁口径,不要再讨论是否加。
所有命令都在 BotFather → /setcommands 注册,让 TG 客户端能展示 hint。
其他高频操作走 Inline / Reply Keyboard,不让用户记命令。
| Command | 用途 / Purpose | 范围 / Scope |
|---|---|---|
| /start | 首次进入 / 重新唤醒。支持 start_param(refCode、活动直达) | DM · Inline |
| /balance | 查看余额 + 最近 3 笔流水(快捷查询) | DM |
| /rounds | 最近开奖列表(5 条 + 跳转 TG Mini App 查看全部) | DM |
| /invite | 展示我的邀请链接 + 返佣数据 | DM |
| /help | 帮助中心入口 + 客服跳转 | DM |
| /language | 切换语言(zh-CN / en-US) | DM |
| /stop | 取消所有非交易类推送(开奖、活动提醒)。资金类推送强制开启。 | DM |
Bot 推送的所有文案必须按模板填,不允许散文化输出。占位符用 {var},金额、时间、地址、tx 都走统一格式化器。
v = 数值,e = 邮件 / 地址,a = 状态 / 链。