直播下单操作流程
系统概览
Facebook / Instagram Messenger 机器人抓单，观众在直播下方评论「快捷码+数量」→ webhook 打到 NS16 → 系统自动：
- 幂等锁（Redis SETNX 30 秒）防止 bot 重推导致重复下单
- 查会员（按 Page ID + PSID）；不存在自动建
- 按「//-//」切分多商品
- 查商品（按 fb_order_code + 博主限定）
- 实时库存检查：一条 SQL 拿最新 stock + 购物车占用，防止售完还能加购
- 写入购物车，同时记录 KOL 归属（归到对应 blogger_pages 以便 KOL 结算）
直播前准备
- 确认所有直播商品已上架，并设好直播快捷码（product.fb_order_code，全平台唯一）
- 确认库存充足
- 如多 KOL 模式，确认 KOL 账号已绑定对应 blogger_page
- 打开「购物篮管理」备用
直播中：评论格式
| 评论内容 | 效果 |
|---|---|
sb001+2 | 买 2 件快捷码 sb001 的商品 |
sb001+2//-//sb002+1 | 同一条评论下 2 件 sb001 + 1 件 sb002（多商品） |
💡 bot 编码：bot 在传输时把
+ → /~/、# → /__/，NS16 webhook 自动还原。可能的返回状态
| 状态 | 含义 | bot 给用户的回复 |
|---|---|---|
| Cart | 加购成功 | 已加入购物车，附商品图 |
| ITEM-NOT-FOUND | 快捷码找不到 | 商品不存在（可配置文案） |
| FULLY-RESERVED | 库存不足 | 已售完 |
| MAX-PURCHASED | 超过每人限购 | 已达限购上限 |
| ACCOUNT-BANNED | 会员被封 | （空） |
多 KOL 归账（公司型博主）
平台管理员开启博主的 多 KOL 模式 后：
- 每个 FB/IG Page 绑定一个 KOL（KOL 关联 Page 列表）
- 直播评论进来时，系统通过 Page ID 查到 blogger_page → 写入 购物车的 KOL 归属 → 下单时拷贝到 订单的 KOL 归属
- 月末 KOL 分红结算按 source_page_id 聚合到各 KOL
- KOL 用
/kol/login自登录看自己的业绩 + 结算单
直播后处理
- 检查所有订单是否已付款
- 未付款订单发送付款提醒或取消
- 按发货方式开始发货
- 月末生成博主结算（所有订单）+ KOL 分红结算（按 source_page_id）
手动补救：购物篮管理
如果评论格式错乱或 bot 抓不到，管理员 / 博主可以在「购物篮管理」里手动代加：选会员 → 输入「快捷码+数量」 → 系统自动归属到博主默认 Page（如果只有一个 Page）。