012-kaopeilian/docs/规划/全链路联调/言迹智能工牌/获取客户来访列表 2.md

获取客户来访列表

接口信息

• 路径：GET /api/beauty/v1/visit/by-customer
• 说明：根据客户ID获取来访记录列表

请求参数

Query参数

参数	必选	类型	默认值	描述
estateId	✓	integer(int64)	-	项目ID
thirdCustomerId	✓	string	-	三方顾客ID
visitTimeStart	-	string(date-time)	-	来访时间开始（yyyy-MM-dd HH:mm:ss）
visitTimeEnd	-	string(date-time)	-	来访时间结束（yyyy-MM-dd HH:mm:ss）

请求示例

GET /api/beauty/v1/visit/by-customer?estateId=516799468310364162&thirdCustomerId=customer_001&visitTimeStart=2025-01-01%2000:00:00&visitTimeEnd=2025-01-31%2023:59:59

响应结果

Body结构

参数	必选	类型	默认值	描述
-	-	object[]	-	来访记录数组
└─ id	-	integer(int64)	-	接访单ID
└─ thirdVisitId	-	string	-	三方接访单ID
└─ visitTime	-	string(date-time)	-	来访时间
└─ customerId	-	integer(int64)	-	顾客ID（系统内部）
└─ visitCount	-	integer(int32)	-	第几次接访
└─ visitSpecial	-	integer(int32)	-	是否打上特殊标签
└─ specialReason	-	string	-	特殊标签原因
└─ userId	-	integer(int64)	-	主销ID（员工ID）
└─ createTime	-	string(date-time)	-	创建时间
└─ updateTime	-	string(date-time)	-	更新时间

响应示例

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "id": 1001,
      "thirdVisitId": "visit_001",
      "visitTime": "2025-01-15 10:30:00",
      "customerId": 2001,
      "visitCount": 1,
      "visitSpecial": 0,
      "specialReason": "",
      "userId": 3001,
      "createTime": "2025-01-15 10:30:00",
      "updateTime": "2025-01-15 10:35:00"
    },
    {
      "id": 1002,
      "thirdVisitId": "visit_002",
      "visitTime": "2025-01-20 14:00:00",
      "customerId": 2001,
      "visitCount": 2,
      "visitSpecial": 0,
      "specialReason": "",
      "userId": 3001,
      "createTime": "2025-01-20 14:00:00",
      "updateTime": "2025-01-20 14:30:00"
    }
  ]
}

字段说明

visitCount

表示该客户第几次来访，用于区分新客户和回访客户。

visitSpecial

• 0：正常来访
• 1：特殊标签（如投诉、纠纷等）

业务逻辑

1. 返回按visitTime倒序排列的来访记录
2. 可通过时间范围筛选特定时期的来访
3. visitCount自动累计，反映客户来访频次

使用场景

1. 查询客户历史来访记录
2. 分析客户回访频率
3. 获取员工服务的客户列表，进而获取对话记录
4. 统计销售人员接待量

扩展用法

获取员工最近N条对话记录

1. 通过员工手机号获取userId
2. 反向查询：获取该userId服务的所有来访记录（需要额外接口支持）
3. 对每条来访记录调用"获取来访录音信息"
4. 对每个录音调用"获取录音ASR分析结果"
5. 组合返回完整对话记录

注意事项

1. 大量历史数据建议分页查询
2. 时间范围建议不超过1年
3. thirdCustomerId需要提前在系统中同步