获取员工会话信息接口
更新时间：2025-12-17
查询员工历史会话记录，支持多种筛选条件。采用 Bearer Token 认证方式。
1. 认证方式
使用 Bearer Token 认证，符合OAuth 2.0标准，支持以下两种请求头格式：
| 认证方式 | 请求头格式 | 优先级 | 说明 |
|---|---|---|---|
| Bearer Token | Authorization: Bearer <api_key> | 推荐 | 符合OAuth标准 |
| X-API-Key | X-API-Key: <api_key> | 备选 | 备用格式 |
2. 接口信息
请求信息:
- 方法:
POST - 路径:
/employee-console/v1/employees/report/getSessionInfo - Content-Type:
application/json
3. 请求参数
请求体 (EmployeeFetchSessionInfoReq):
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| employeeId | String | ✅ | 员工唯一标识ID |
| startTime | String | ✅ | 查询开始日期，格式: yyyy-MM-dd |
| endTime | String | ✅ | 查询结束日期，格式: yyyy-MM-dd |
| sessionId | String | ❌ | 具体会话ID，用于查询单个会话 |
| fillType | Integer[] | ❌ | 填充类型筛选: [1]=已填充电话号码, [2]=未填充电话号码 |
| needSessionMessages | Boolean | ❌ | 是否返回完整会话内容，默认false |
| pageNo | Integer | ❌ | 页码，从1开始，默认1 |
| pageSize | Integer | ❌ | 每页条数，默认10，最大100 |
4. 请求示例
基础查询:
Plain Text
1curl -X POST 'https://ky.cloud.baidu.com/employee-console/v1/employees/report/getSessionInfo' \
2 -H 'Authorization: Bearer key_ao0WJjtPBy3QViZ-NaPF9Vagrm2p9xP1ReVlrJh__QgaSce_N49AIMlqeOg7NzmV' \
3 -H 'Content-Type: application/json' \
4 -d '{
5 "employeeId": "Hnh4hDWKh1uAoFDgQIUZ",
6 "startTime": "2025-10-22",
7 "endTime": "2025-11-20"
8 }'完整参数查询:
Plain Text
1curl -X POST 'https://ky.cloud.baidu.com/employee-console/v1/employees/report/getSessionInfo' \
2 -H 'Authorization: Bearer key_ao0WJjtPBy3QViZ-NaPF9Vagrm2p9xP1ReVlrJh__QgaSce_N49AIMlqeOg7NzmV' \
3 -H 'Content-Type: application/json' \
4 -d '{
5 "employeeId": "Hnh4hDWKh1uAoFDgQIUZ",
6 "startTime": "2025-10-22",
7 "endTime": "2025-11-20",
8 "sessionId":"8efd19ee-d610-407e-8b6b-3c6d0d31970d",
9 "fillType": [1],
10 "needSessionMessages": true,
11 "pageNo": 1,
12 "pageSize": 10
13 }'5. 响应参数
响应体结构:
Plain Text
1{
2 "code": 200,
3 "msg": "success",
4 "data": {
5 "pageNo": 1,
6 "pageSize": 10,
7 "total": 100,
8 "records": [
9 {
10 "sessionId": "session_123456789",
11 "slotFillData": "{\"phone\":\"13800138000\",\"name\":\"张三\"}",
12 "phone": "13800138000",
13 "channel": "PC",
14 "sessionMessages": "用户: 你好\nAI: 您好！我是智能客服...",
15 "talkStartTime": "2024-01-15T09:30:00",
16 "talkEndTime": "2024-01-15T09:45:30"
17 }
18 ]
19 }
20}响应字段说明:
| 字段路径 | 类型 | 说明 |
|---|---|---|
| code | Integer | 响应状态码，200表示成功 |
| msg | String | 响应消息 |
| data.pageNo | Integer | 当前页码 |
| data.pageSize | Integer | 每页条数 |
| data.total | Long | 总记录数 |
| data.records | Array | 会话信息列表 |
| records[].sessionId | String | 会话唯一标识 |
| records[].slotFillData | String | 用户提交的留资表单（Json） |
| records[].phone | String | 提取的电话号码 |
| records[].channel | String | 会话渠道: PC/MOBILE |
| records[].sessionMessages | String | 完整会话内容(需设置needSessionMessages=true) |
| records[].talkStartTime | String | 会话开始时间 |
| records[].talkEndTime | String | 会话结束时间 |