hl-api-changelog/changelogs-v2/2026-06/20_4101_房务列表补consultantId-站内信接入房务-修改接口-管理后台.md

2.1 KiB

房务列表补 consultantId站内信接入房务·列表卡片开会话— 修改接口 — 管理后台

变更类型: 响应字段新增(房务列表 VO 加 consultantId 端类型:管理后台(房务管家 · 我的接单 / 抢单池 → 聊天) 日期2026-06-20 服务hl-order-service-v3 PRwx/HL#4102 Closes #4101


⚠️ 关键说明(给前端)

站内信(聊天)接入房务收尾。后端聊天接入已就位(open 支持 bizModule=HOUSE、未读红点、会话列表 enrich、配不出走聊天,本次补**房务列表卡片直接开「与定制师会话」**所需的 consultantId

  • 我的接单 GET /v3/admin/order/grab-pool/my-claims/hotel抢单池 GET /v3/admin/order/grab-pool/hotel-requirements 的列表项新增 consultantId(定制师 adminId,字符串雪花
  • 之前列表只返 consultantName,开会话需要的 consultantId 只能进详情才拿得到;现列表卡片即可拿。
  • 前端从列表卡片开会话:
POST /admin/message/chat/open
{ "bizModule": "HOUSE", "bizId": <orderId>, "peerAdminId": <consultantId> }

字段

端点 新增字段 类型 说明
/v3/admin/order/grab-pool/my-claims/hotel(我的接单) consultantId String雪花 定制师 adminId聊天对端 peerAdminId
/v3/admin/order/grab-pool/hotel-requirements(抢单池) consultantId String雪花 同上

取自 order_main.consultant_id(与既有 consultantName 同源同行);列表其余字段不变。


测试

  • 已部署测试服 order-v3 双实例 success;9443 实测两端点 200。
  • consultantId 透传由单测覆盖HouseGrab*Test 47 绿,含 consultantId 断言)+ 与既有 consultantName 同一 JOIN 投影同源。
  • 注:测试环境当前抢单池/我的接单为空,未在真实行上观测到 consultantId 取值;字段为纯增、同源 consultantName 已生产工作。

备注

  • 网关无需改(/v3/admin/** 路由已覆盖)。
  • via 站内信接入房务。