TG 红包 · 后台配置原型

优惠 / 红包 / TG 红包

tilly002

首页飞投红包管理飞投红包记录下级红包管理

飞投红包管理

平台站点	红包名称 ID	红包类型	红包描述	红包图片	是否可分享	红包状态	创建人	创建时间	操作
TXB TXBD	充值红包 11	TG充值红包	充值达标红包	图	可以	启用	System	2026-06-15 10:22:18	详情停用发送红包
TXB TXBD	流水红包 12	TG流水红包	流水达标红包	图	可以	启用	System	2026-06-15 10:28:41	详情停用发送红包
TXB TXBD	免费红包 13	TG免费红包	平台会员免费领取	图	可以	启用	System	2026-06-15 10:35:06	详情停用发送红包
TXB TXBD	推广红包 14	TG推广红包	邀请推广达标奖励	图	可以	启用	System	2026-06-15 10:41:24	详情停用发送红包
TXB TXBD	专属红包 15	TG专属红包	指定会员专属奖励	图	不可以	启用	System	2026-06-15 10:52:37	详情停用发送红包

飞投红包记录

平台站点	红包名称 ID	红包类型	币种	红包总金额	红包数量	是否可分享	红包状态	当日充值达标	当日流水达标	创建人	创建时间	操作
TXB TXBD	充值红包 RP20260615001	TG充值红包	CNY	10,000.00	500	可以	待领取	100	-	tilly002	2026-06-15 12:18:36	详情
TXB TXBD	流水红包 RP20260615002	TG流水红包	CNY	6,000.00	300	可以	已领取	-	100	tilly002	2026-06-15 12:28:09	详情
TXB TXBD	免费红包 RP20260615003	TG免费红包	CNY	3,000.00	200	可以	已领取	-	-	tilly002	2026-06-15 12:38:19	详情
TXB TXBD	推广红包 RP20260615004	TG推广红包	CNY	8,800.00	300	可以	已过期	-	-	agent001	2026-06-15 12:42:09	详情
TXB TXBD	专属红包 RP20260615005	TG专属红包	CNY	1,888.00	88	不可以	待领取	-	-	tilly002	2026-06-15 12:52:24	详情

PRD 说明

飞投红包整体流程

业务定义飞投红包由后台配置红包规则，允许发送人以站点会员账号发起红包，资金从该会员个人钱包扣除。 资金流向发送成功后，红包金额进入红包批次冻结/占用；同一平台站点内其他会员点击 TG 红包领取，领取成功后入账至领取会员钱包。 站点限制发送会员、领取会员、机器人配置、红包批次与领取记录必须属于同一平台站点，不允许跨站发送或跨站领取。 余额校验发送前校验发送会员钱包余额需大于等于红包总金额；余额不足时不建立批次、不扣款、不发送 TG 消息。

红包类型差异

TG充值红包：会员充值达标后可领取。
TG流水红包：会员有效投注达标后可领取。
TG免费红包：无充值/流水门槛，平台会员可免费领取。
TG推广红包：按邀请推广达标后可领取。
TG专属红包：平台指定会员可免费领取。

发送红包弹窗字段差异

共通字段：红包名称、红包类型、telegram群ID、红包总金额、假领取数量、红包数量、红包有效期、打码倍数。
TG充值红包：额外填写「当日充值达标」。
TG流水红包：额外填写「当日流水达标」。
TG免费红包：无充值/流水门槛，仅展示「领取门槛：无充值/流水门槛」。
TG推广红包：额外填写「指定代理会员账号」与「邀请达标人数」。
TG专属红包：额外填写「指定会员账号」。

发送人账号

允许发送人账号只能填入一个站点会员账号，作为本次红包发送的钱包资金来源。发送红包时，系统需校验该会员账号是否存在、启用且属于当前站点。

钱包余额校验

校验时机：发送红包弹窗填写红包总金额并点击确定时校验。
校验对象：允许发送人账号对应的站点会员钱包余额。
通过条件：会员钱包余额需大于等于红包总金额。
失败处理：余额不足时不允许发送红包，并提示先充值或调整红包金额。

飞投红包记录

后台路径：quickBet/records/redPacketRecords，用于查看飞投红包发送批次与配置快照。
查询条件：站点、红包名称、红包 ID、创建日期、红包类型、是否可分享。
列表字段：平台站点、红包名称/ID、红包类型、币种、红包总金额、红包数量、是否可分享、红包状态、当日充值达标、当日流水达标、创建人、创建时间、操作。
状态筛选：红包记录状态以下拉筛选，选项为全部、待领取、已领取、已过期；列表以 5 笔记录示意 5 种红包类型，状态只使用待领取、已领取、已过期。
操作规则：列表操作仅保留「详情」，点击后开启领取记录弹窗，展示剩余数量、领取情况、剩余可领时间、打码倍数与当前红包类型条件；待领取、已过期状态无领取时间，已领取状态才展示领取时间。
类型条件：TG充值红包展示充值金额，TG流水红包展示流水金额，TG免费红包展示无门槛，TG推广红包展示指定代理与邀请达标人数，TG专属红包展示指定会员账号。
账变同步：发送红包时需写入发红包扣款账变记录；会员领取红包成功时需写入领红包加款账变记录，领取记录与账变记录需可相互追踪。
记录用途：追踪每次发送的扣款来源、批次状态、领取门槛与后续领取明细，方便财务核对会员钱包扣款与派发结果。

推广红包代理归属

发送弹窗：TG推广红包发送时需填入「指定代理会员账号」，输入内容为代理账号。
分享领取：红包分享出去后，未注册用户点击领取时系统在 TG 内自动注册会员。
归属规则：自动注册的会员成为发送弹窗填写代理账号的下级会员。
校验规则：代理账号需存在、启用，且属于当前站点。

TG机器人配置与设定红包完整流程

参照 WG 操作手册「TG机器人配置」：机器人与 TG 内平台注册入口先在后台完成，TG红包页面只读取已启用配置；红包内容沿用原后台配置，发送时仅决定立即发送或指定时间发送。

1. 开通 Bot运营在 Telegram 与 @BotFather 对话，输入 /newbot，建立机器人并取得机器人名称与 token。

2. 绑定机器人进入 TG机器人配置，维护币种、机器人账号、机器人链接、TOKEN、Web大厅域名、TG 内平台注册入口。

3. 设定红包进入 TG红包管理新增/修改红包，选择站点、红包类型、图片、状态与允许发送人。

4. 发送红包列表点击发送红包，填写群 ID、总金额、数量、有效期、打码与达标条件；送出前需连续两次确认。

5. TG领取系统用对应站点机器人发送 TG 消息，用户在 TG 内点击后先完成平台注册/绑定，再校验门槛与入账。

对应截图

发送红包弹窗截图 — 截图：列表点击「发送红包」后展示基础发送弹窗。当前截图为 TG充值红包，字段包含红包名称、红包类型、telegram群ID、红包总金额、假领取数量、红包数量、红包有效期、打码倍数、当日充值达标。

TG机器人配置：字段包含币种、机器人账号、机器人链接、TOKEN、Web大厅域名、TG 内平台注册入口、强制绑定渠道/代理与启用状态。
设定红包：维持现有后台字段，选择红包类型、图片、状态与允许发送人；允许发送人只能填入一个站点会员账号。
发送红包：列表点击发送红包后展示上方弹窗；红包名称、红包类型为当前红包配置带入，提交后进入两次确认，再调用发送接口。
钱包扣款：弹窗不展示发送会员账号与钱包余额，系统按红包配置的允许发送人账号在后端校验余额并扣款。
推广红包：TG推广红包需额外校验指定代理会员账号；分享出去后注册的会员自动成为该代理账号下级。
TG交互：5 种红包在 TG 展示不同领取文案，会员点击按钮后依类型校验充值、流水、推广或指定会员资格。

TG 机器人

WG 机器人创建与绑定

使用 Telegram 与 @BotFather 对话。
输入 /newbot 创建机器人，并输入机器人名称。
将 BotFather 返回的机器人名称与 token 填入后台「TG机器人配置」。
前端仅显示 token 状态，不展示完整 token。

机器人配置字段

币种：决定红包金额币种与前端展示单位。
机器人账号 / 机器人链接：用于发送红包与跳转校验。
Web大厅域名 / TG 内平台注册入口：用于生成领取与注册入口。
强制绑定渠道ID / 代理ID：领取前绑定限制。

前端读取与站点隔离

进入页面读取 TG 红包配置列表，字段维持后台原配置。
点击「发送红包」时读取当前站点、红包类型、允许发送人、红包状态。
机器人、群组、币种、Web 域名、TG 内平台注册入口按 siteId 隔离。
不得使用 A 站机器人发送 B 站红包，不得跨站生成领取链接。

发送流程与接口

前端校验：允许发送人、红包启用状态、可用机器人。
点击发送红包后先填写发送参数，再进行两次确认，第二次确认后调用发送接口。
后端创建批次并通过 Telegram Bot API 发送消息。
领取成功后回写领取记录、账变记录、批次剩余数量。

TG红包前端串接流程

开通机器人运营依 WG 手册至 Telegram 找 @BotFather，输入 /newbot 建立机器人并取得机器人名称与 token。

后台绑定在 TG机器人配置填入币种、机器人账号、机器人链接、TOKEN、Web大厅域名、TG 内平台注册入口、绑定渠道/代理。

读取站点配置TG红包前端依 siteId 拉取机器人、币种、启用状态与 TG 内注册入口，仅展示 token 已配置/未配置。

配置红包后台维持原 TG红包配置，选择红包类型、允许发送人、指定时间发送与启停状态。

发送确认点击发送红包后填写群 ID、金额、数量、有效期、打码与达标条件，并弹出两次是否立即发送确认。

TG展示后端创建发送批次，使用对应站点机器人推送红包消息与领取按钮，按钮链接携带 siteId、batchNo、redPacketId。

领取入账用户在 TG 内启动平台注册；未注册时自动注册并绑定 TG 号，再校验红包类型门槛，成功后回写领取记录、账变与批次剩余量。

前端接口与状态处理

节点	前端动作	关键参数	状态处理
机器人配置	`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📌 👁 102 12:01 AM

按钮交互定义

点击抢红包：在 TG 内启动平台注册/绑定流程，带入红包批次与 TG 用户资料。
未注册：在 TG 内自动启动平台注册并绑定 TG 号，再继续判断红包领取条件。
已连结：继续判断红包类型条件是否达标。
达标：进入抢红包弹窗，点击「开」后入账并可前往领取记录。
未达标：以 Telegram 弹窗提示原因，例如「还差 1000 投注，才可抢红包」。
一键注册：直接在 TG 内启动平台注册，注册完成后绑定该 TG 号与平台会员。

TG红包领取流程判断

TG 红包讯息展示后台 1000*1000 图片与两个按钮。

→

点击抢红包Telegram 弹出打开应用确认。

→

TG 内启动注册带入 siteId、batchNo、redPacketId、tgUserId。

→

判断是否连结会员已连结继续判断红包条件。

一键注册直接在 TG 内完成平台注册与 TG 号绑定。

→

所有红包均需校验：注册/绑定状态、批次状态、领取次数、过期时间、剩余数量。
所有 TG 消息至少包含：红包标题、红包描述、领取按钮。
领取成功页展示领取金额、到账状态、返回 TG 或返回大厅入口。
重复领取时展示已领取结果，不重复派发。