← BACK · 返回原型集
BOT PROTOTYPE 08 / TG BOT v1.0
TELEGRAM BOT CHAT · TG BOT 对话原型

Bot 是用户进入产品的第一扇门 /start → MINI APP → DEPOSIT → DRAW → INVITE

用户从 TG 频道、私信或邀请链接打开 Bot。Bot 主要承担四件事: 登录引导(Open TG Mini App)异步推送(充值 / 开奖 / 提现回执)邀请分享客服跳转。 Bot username 待定,所有按钮的 callback_data 和 deep link start_paramprototype/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.

SCENE · 01
首次进入 / Onboarding
/START → WELCOME → OPEN MINI APP
1U夺宝 · DuobaoBot
bot
今天 14:02
/start 14:02 ✓✓
点下面的按钮进入活动 · 充值认证免手续费 · 邀请好友返佣
Open App · 打开活动
💰 我的余额
📊 开奖记录
👥 邀请好友
❓ 帮助
14:02
🎮 Open App
💰 余额
📊 记录
关键点:欢迎语用 banner,避免长文本。主 CTA Open App 是 TG Mini App 按钮, 点击后直接打开 H5 / TG Mini App 并完成 initData 登录,不再要求用户输入任何东西。
SCENE · 02
充值到账推送 / Deposit Credited
PAY-SVC EVENT → BOT PUSH
1U夺宝 · DuobaoBot
bot
今天 14:18
✅ 充值已到账
+100.00 USDT
链:BSC · 区块:49,128,773
tx:0xab8f...c9d2
🔗 在 BscScan 查看
立即去购票 →
14:18
余额已可购票,立即去活动大厅。 14:18
14:23
📌 你关注的活动有更新
#00428 · iPhone 16 Pro
剩余票数:23 / 1024 · 估算 ~ 5 分钟内开奖
查看活动 →
14:23
🎮 Open App
💰 余额
📊 记录
关键点:充值到账只在chain-service 确认了 N 个区块后推送, 附上链上 tx hash 和区块浏览器跳转。活动即将开奖提醒是订阅触发,不属于强制推送。
SCENE · 03
开奖中奖推送 / Round Drawn
DRAWN EVENT · WINNER NOTIFICATION
1U夺宝 · DuobaoBot
bot
今天 14:28
奖品:iPhone 16 Pro · 256GB · 黑色钛金属
等值~1280 USDT
开奖凭证tx 0x9b2c...4d7e
区块高度:49,128,901
🔗 区块浏览器验证
领取奖品 →
兑换 USDT →
14:28
领取通道 72 小时内有效,请尽快操作。 14:28
🎮 Open App
💰 余额
📊 记录
关键点:中奖通知必须附 tx hash + 区块高度 + 区块浏览器链接,让用户确信开奖结果来自链上而非平台决定。 奖品也提供"兑换 USDT"的二级入口。
SCENE · 04
提现进度 / Withdraw Progress
WITHDRAW BROADCAST → CONFIRMED
1U夺宝 · DuobaoBot
bot
今天 15:02
📤 提现申请已收到
金额:50.00 USDT
链:BSC · 到账地址:0xUSER...9f8a
状态:⏳ 已锁定余额 · 等待签名 15:02
15:03
📡 已广播到链上
tx:0x7e91...3a5b
状态:⏳ 等待区块确认(0 / 15)
🔗 BscScan 查看
15:03
15:05
✅ 提现完成
50.00 USDT 已到账
确认:15 / 15 · 用时 2 分 12 秒
🔗 区块浏览器
📊 提现记录
15:05 ✓✓
🎮 Open App
💰 余额
📊 记录
关键点:提现至少三次推送 —— 申请确认 / 广播到链上 / 区块确认完成。每一步带 tx hash, 用户可以独立验证不依赖平台口径。sign-service 签名失败时降级为人工处理通知。
SCENE · 05
邀请好友 / Invite Link
START_PARAM = REF_CODE
1U夺宝 · DuobaoBot
bot
今天 16:00
邀请好友 16:00 ✓✓
👥 你的专属邀请链接
t.me/DuobaoBot?start=ref_A8K2X9

奖励规则
· 好友首次充值 → 你获得 2 USDT
· 好友每笔活动手续费 → 你获得 20% 返佣
· 6 级代理网络层层分佣
📤 分享给好友
📋 复制链接
查看返佣明细 →
16:00
📊 你的邀请数据
邀请人数:12 · 活跃:8
本月返佣:+18.42 USDT
累计返佣:+156.20 USDT 16:00
🎮 Open App
💰 余额
📊 记录
关键点:邀请链接走 Telegram start_param —— 新用户点击后, Bot 接收时拿到 ref_code,绑定上下级。 所有返佣计算和层级在 user-service 内做,Bot 只展示结果。
SCENE · 06
客服跳转 / Support Handoff
NO IN-APP TICKETS · TG-FIRST
1U夺宝 · DuobaoBot
bot
今天 17:14
/help 17:14 ✓✓
❓ 帮助中心

常见问题:
· 怎么充值?
· 没收到中奖款?
· 提现卡住怎么办?
· 充错链 / 错地址了
📖 帮助文档
💬 联系客服
📢 公告频道
🐦 社区
17:14
联系客服 17:14 ✓✓
💬 客服 · 7×24 中英双语

点下面的按钮直接进入私聊。请描述:
· 问题类型(充值 / 提现 / 中奖)
· 涉及的 tx hash
· 你的用户 ID
@DuobaoSupport · 私聊客服
📢 @DuobaoAnnounce · 公告频道
17:14
🎮 Open App
💰 余额
📊 记录
关键点v1.0 不做站内工单 / CRM / 知识库, 所有支持沟通走 TG 私聊和公告频道,Bot 只做跳转。这是已锁口径,不要再讨论是否加。

Bot 命令清单 BOT COMMANDS

所有命令都在 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

消息模板(占位符语法)MESSAGE TEMPLATES

Bot 推送的所有文案必须按模板填,不允许散文化输出。占位符用 {var},金额、时间、地址、tx 都走统一格式化器。 v = 数值,e = 邮件 / 地址,a = 状态 / 链。

▸ TPL.WELCOME · 欢迎
欢迎来到 1U夺宝 🎉 1 USDT 起买一张号码,活动卖完就开奖。 结果由链上随机数决定,区块浏览器可查。 [Open App] [我的余额] [开奖记录] [邀请好友] [帮助]
触发:/start,无 start_param。中英双语跟用户 TG 语言走。
▸ TPL.DEPOSIT_CREDITED
✅ 充值已到账 +{amount} {currency} 链:{chain} · 区块:{blockNumber} tx:{txHash} [🔗 在 {explorer} 查看] [立即去购票 →]
触发:wallet-service 充值入账后。链 N 个确认后才推。
▸ TPL.ROUND_DRAWN_WIN
🎉 恭喜中奖 第 #{roundId} 期已开奖,中奖号 {winnerNumber} 奖品:{prizeName} · 等值 ~{prizeUSDT} USDT 开奖凭证:tx {drawTxHash} 区块高度:{drawBlock} [🔗 区块浏览器验证] [领取奖品 →] [兑换 USDT →]
触发:game-service round.drawn 事件,且 winnerUserId == currentUser。
▸ TPL.WITHDRAW_BROADCAST
📡 已广播到链上 金额:{amount} USDT · 到账地址:{toAddress} tx:{txHash} 状态:⏳ 等待区块确认(0 / {requiredConfs}) [🔗 {explorer} 查看]
触发:chain-service 广播成功后。每隔 N 个区块更新进度(编辑同一条消息)。
▸ TPL.WITHDRAW_DONE
✅ 提现完成 {amount} USDT 已到账 确认:{confs} / {requiredConfs} · 用时 {duration} [🔗 区块浏览器] [📊 提现记录]
触发:withdraw-confirmed 事件。失败走 TPL.WITHDRAW_FAILED 单独模板。
▸ TPL.INVITE_LINK
👥 你的专属邀请链接 t.me/{botUsername}?start=ref_{refCode} 奖励规则: · 好友首次充值 → 你获得 {firstDepositBonus} USDT · 好友活动手续费 → 你获得 {commissionPct}% [📤 分享] [📋 复制] [查看返佣明细 →]
触发:/invite 或 Inline 按钮。refCode 唯一对应当前用户。