飞投红包管理
| 平台 站点 | 红包名称 ID | 红包类型 | 红包模式 | 红包描述 | 红包图片 | 是否可分享 | 红包状态 | 创建人 | 创建时间 | 操作 | |
|---|---|---|---|---|---|---|---|---|---|---|---|
| TXB TXBD | 专属红包 15 | TG专属红包 | 偏向平均 | 红包的奉公守法个 | 图 | 不可以 | 启用 | System | 2026-05-31 13:22:58 | 详情停用发送红包 |
PRD 说明
红包类型差异
- TG充值红包：会员充值达标后可领取。
- TG流水红包：会员有效投注达标后可领取。
- TG免费红包：无充值/流水门槛，平台会员可免费领取。
- TG推广红包：按邀请推广达标后可领取。
- TG专属红包：平台指定会员可免费领取。
红包模式差异
- 偏向平均：每个红包金额接近平均值，单个会员领取金额差异较小。
- 波动较大：每个红包金额随机波动更大，单个会员领取金额差异较明显。
新增、编辑、详情弹窗均使用「红包模式」下拉单选，不再配置单个红包最小额与最大额。
发送人账号
允许发送人账号只能填入一个站点会员账号，作为本次红包发送的钱包资金来源。发送红包时，系统需校验该会员账号是否存在、启用且属于当前站点。
钱包余额校验
- 校验时机：发送红包弹窗填写红包总金额并点击确定时校验。
- 校验对象：允许发送人账号对应的站点会员钱包余额。
- 通过条件：会员钱包余额需大于等于红包总金额。
- 失败处理：余额不足时不允许发送红包，并提示先充值或调整红包金额。
推广红包代理归属
- 发送弹窗：TG推广红包发送时需填入「指定代理会员账号」。
- 分享领取：红包分享出去后，未注册用户领取时系统自动注册会员。
- 归属规则：自动注册的会员归属到发送弹窗填写的指定代理会员名下。
- 校验规则：指定代理会员账号需存在、启用，且属于当前站点。
TG机器人配置与设定红包完整流程
参照 WG 操作手册「TG机器人配置」：机器人与小程序配置先在后台完成，TG红包页面只读取已启用配置；红包内容沿用原后台配置，发送时仅决定立即发送或指定时间发送。
1. 开通 Bot运营在 Telegram 与 @BotFather 对话，输入 /newbot，建立机器人并取得机器人名称与 token。
2. 绑定机器人进入 TG机器人配置，维护币种、机器人账号、机器人链接、TOKEN、Web大厅域名、TG小程序链接。
3. 设定红包进入 TG红包管理新增/修改红包，选择站点、红包类型、红包模式、图片、状态与允许发送人。
4. 发送红包列表点击发送红包，填写群 ID、总金额、数量、有效期、打码与达标条件；送出前需连续两次确认。
5. TG领取系统用对应站点机器人发送 TG 消息，会员点击领取后进入 H5/小程序，完成门槛校验与入账。
对应截图
- TG机器人配置：字段包含币种、机器人账号、机器人链接、TOKEN、Web大厅域名、TG小程序链接、强制绑定渠道/代理与启用状态。
- 设定红包：维持现有后台字段，红包模式使用下拉单选，选项为偏向平均、波动较大；允许发送人只能填入一个站点会员账号。
- 推广红包：发送弹窗需填入指定代理会员账号，领取红包自动注册的会员归属到该代理名下。
- 发送红包：列表点击发送红包后先填写发送参数，提交后进入两次确认，再调用发送接口。
- TG交互：5 种红包在 TG 展示不同领取文案，会员点击按钮后依类型校验充值、流水、推广或指定会员资格。
TG 机器人
WG 机器人创建与绑定
- 使用 Telegram 与 @BotFather 对话。
- 输入 /newbot 创建机器人，并输入机器人名称。
- 将 BotFather 返回的机器人名称与 token 填入后台「TG机器人配置」。
- 前端仅显示 token 状态，不展示完整 token。
机器人配置字段
- 币种：决定红包金额币种与前端展示单位。
- 机器人账号 / 机器人链接：用于发送红包与跳转校验。
- Web大厅域名 / TG小程序链接：用于生成领取页链接。
- 强制绑定渠道ID / 代理ID：领取前绑定限制。
前端读取与站点隔离
- 进入页面读取 TG 红包配置列表，字段维持后台原配置。
- 点击「发送红包」时读取当前站点、红包类型、金额区间、允许发送人、红包状态。
- 机器人、群组、币种、Web 域名、小程序链接按 siteId 隔离。
- 不得使用 A 站机器人发送 B 站红包，不得跨站生成领取链接。
发送流程与接口
- 前端校验：允许发送人、红包启用状态、金额区间、可用机器人。
- 点击发送红包后先填写发送参数，再进行两次确认，第二次确认后调用发送接口。
- 后端创建批次并通过 Telegram Bot API 发送消息。
- 领取成功后回写领取记录、账变记录、批次剩余数量。
TG红包前端串接流程
1
开通机器人运营依 WG 手册至 Telegram 找 @BotFather，输入 /newbot 建立机器人并取得机器人名称与 token。2
后台绑定在 TG机器人配置填入币种、机器人账号、机器人链接、TOKEN、Web大厅域名、TG小程序链接、绑定渠道/代理。3
读取站点配置TG红包前端依 siteId 拉取机器人、小程序、币种、启用状态，仅展示 token 已配置/未配置。4
配置红包后台维持原 TG红包配置，选择红包模式、允许发送人、指定时间发送与启停状态。5
发送确认点击发送红包后填写群 ID、金额、数量、有效期、打码与达标条件，并弹出两次是否立即发送确认。6
TG展示后端创建发送批次，使用对应站点机器人推送红包消息与领取按钮，按钮链接携带 siteId、batchNo、redPacketId。7
领取入账会员从 TG 进入小程序/H5，完成绑定与红包类型门槛校验，成功后回写领取记录、账变与批次剩余量。前端接口与状态处理
| 节点 | 前端动作 | 关键参数 | 状态处理 |
|---|---|---|---|
| 机器人配置 | GET /tg/robot/config | siteId, currency | 未配置或停用时禁用发送红包，提示先完成 TG机器人配置。 |
| 红包发送 | POST /tg/redPacket/send | siteId, redPacketId, sendType, sendAt | 立即发送走双确认；指定时间发送需展示排程时间与可取消状态。 |
| TG领取页 | GET /tg/redPacket/landing | siteId, batchNo, redPacketId | 校验站点与批次一致，不一致时显示红包不存在或已失效。 |
| 领取提交 | POST /tg/redPacket/claim | siteId, batchNo, memberId | 依据 5 种红包类型校验门槛，返回成功金额、已领取、未达标、已领完或已过期。 |
指定时间发送
- 新增发送方式：立即发送、指定时间发送。
- 指定时间不可早于当前时间，送出后列表显示「待发送」。
- 到达指定时间由后端任务触发 TG 机器人发送，前端只负责建立与展示排程。
- 排程执行前允许取消；已发送、发送中、已结束不可取消。
站点隔离与异常
- 红包、机器人、Web大厅域名、TG小程序链接均以 siteId 为主键隔离。
- 发送接口需二次验证允许发送人是否为当前站点会员，并校验会员钱包余额是否足够支付红包总金额。
- TG消息发送失败需记录失败原因，并保留批次重试入口。
- 领取页遇到机器人停用、批次过期、红包停用时，统一展示失效状态。
TG交互
TG内红包示意
TG 发红包样式对齐频道讯息：主图使用后台配置的 1000*1000 红包图片，按钮固定为「点击抢红包」与「一键注册」。
▣
52.COM
按钮交互定义
- 点击抢红包：开启 TG 小程序，带入红包批次与 TG 用户资料。
- 未连结：进入与「一键注册」相同流程，在 TG 小程序内登录或自动注册。
- 已连结：继续判断红包类型条件是否达标。
- 达标：进入抢红包弹窗，点击「开」后入账并可前往领取记录。
- 未达标：以 Telegram 弹窗提示原因，例如「还差 1000 投注，才可抢红包」。
- 一键注册：先出现 Telegram「打开应用」确认，再进入 TG 小程序登录/注册。
TG红包领取流程判断
TG 红包讯息展示后台 1000*1000 图片与两个按钮。
→
点击抢红包Telegram 弹出打开小程序确认。
→
打开 TG 小程序带入 siteId、batchNo、redPacketId、tgUserId。
→
判断是否连结会员已连结继续判断红包条件。
一键注册进入同一小程序登录/注册页。
→
登录/注册成功绑定 TG 号与平台账号。
→
达标进入抢红包弹窗，点击「开」领取。
→
未达标Telegram 弹窗提示原因，不派发红包。
5种红包情境流程图
TG充值红包
点击领取
↓
判断充值达标
↓
达标：领取入账
未达：提示充值差额
TG流水红包
点击领取
↓
判断有效投注
↓
达标：领取入账
未达：提示流水差额
TG免费红包
点击领取
↓
判断批次/次数
↓
符合：领取入账
不符：提示已领/结束
TG推广红包
点击领取
↓
判断推广条件
↓
达标：领取入账
未达：提示目标差额
TG专属红包
点击领取
↓
判断会员名单
↓
命中：领取入账
未命中：无领取资格
TG 红包弹窗
TG 抢红包 · 达标
TG 充值红包领取
本次红包金额
CNY 18.88
领取成功，金额已入账
×
TG充值红包
TG 展示
充值达标红包开抢！充值达到 {cm} 即可领取，红包金额 {am}，数量 {nm}。
点击抢红包一键注册
领取流程：点击抢红包 → 校验绑定会员 → 校验充值达标 → 达标领取成功；未达标展示充值差额并引导充值。
TG流水红包
TG 展示
流水达标红包发放中！有效投注达到 {cm} 可领取，先到先得。
点击抢红包一键注册
领取流程：点击抢红包 → 校验绑定会员 → 校验有效投注 → 达标入账；未达标展示当前流水与目标差额。
TG免费红包
TG 展示
平台会员免费红包！无需充值/流水门槛，绑定会员即可领取。
点击抢红包一键注册
领取流程：点击抢红包 → 校验绑定会员 → 校验批次状态、是否重复领取、剩余数量 → 领取成功。
TG推广红包
TG 展示
推广达标红包开放领取！邀请/推广达标后可领取专属奖励。
点击抢红包一键注册
领取流程：点击抢红包 → 校验绑定会员 → 校验邀请人数/有效下级/推广条件 → 达标领取；未达标展示目标差额。
TG专属红包
TG 展示
专属会员红包已送达！仅指定会员可领取，数量有限。
点击抢红包一键注册
领取流程：点击抢红包 → 校验绑定会员 → 校验是否在指定会员名单 → 命中名单则领取；否则展示不可领取。
共同交互规则
- 所有红包均需校验：绑定状态、批次状态、领取次数、过期时间、剩余数量。
- 所有 TG 消息至少包含：红包标题、红包描述、领取按钮。
- 领取成功页展示领取金额、到账状态、返回 TG 或返回大厅入口。
- 重复领取时展示已领取结果，不重复派发。
