开发者文档
智齿科技
2025-04-23
目录

在线客服统计V6 API

# 在线客服统计V6 API

# 接口声明

在调用接口时必须在 https 请求的 header 中携带 "token" 参数。

Token 是智齿客服接口开放平台全局唯一的接口调用凭据。 开发者在调用各业务接口时都需使用 Token，开发者需要进行妥善保存。 Token 的存储至少要保留 32 个字符空间。Token 的有效期目前为 24 个小时，需定时刷新，或根据接口返回的 Token 失效提示，进行重新获取。请求 Token 接口，无论 Token 是否存在，都会返回新的 Token，并重置 Token 的过期时间（目前 24 小时）。

Token 使用方式说明：
1、开发者需要统一获取和管理 Token，在调用智齿客服各个业务开放接口时都应该使用同一个的 Token，不应该每个业务都刷新获取新的 Token，否则容易导致 Token 失效，影响接口的正常调用；
2、目前 Token 的有效期通过返回的 expire_in 来传达，目前是 86,400 秒之内的值。开发者需要根据这个有效时间提前去刷新新 Token。
3、开发者需要根据接口返回的 Token 失效提示，进行重新获取 Token。

# 接口调用

# ● 获取访问 Token 编码

接口说明：

获取 API 开放接口 Token，此 Token 仅适用于智齿开放平台 5.0 版本全部 API 接口 。API 接口中的参数 appid 、 app_key 请联系智齿售后人员获取。

请求方式：

GET

请求地址：

 https://www.sobot.com/api/get_token
1

请求参数：

参数 类型 必填 描述
appid String 是 接口凭证 Id
create_time String 是 时间戳
sign String 是 签名

返回参数：

参数 类型 必填 描述
ret_code String 是 返回编码
ret_msg String 是 返回信息
item Object 否 返回对象

item 对象：

参数 类型 必填 描述
token String 是 token 编码
expires_in String 是 凭证有效时间

时间戳转换参考工具：

http://tool.chinaz.com/Tools/unixtime.aspx
1

sign 签名生成示例：

例如：appid = "1"; create_time="1569397773"; app_key="2"

sign = Md5("115693977732") 为 258eec3118705112b2c53dc8043d4d34。

请求示例：

curl https://www.sobot.com/api/get_token?appid=1&create_time=1569397773&sign=258eec3118705112b2c53dc8043d4d34
1

返回示例：

{
  "item": {
    "token": "4ac37cb2e9c740dba4b75a34d5358802",
    "expires_in": "86400"
  },
  "ret_code": "000000",
  "ret_msg": "操作成功"
}
1
2
3
4
5
6
7
8

# 参数和状态码说明

# 参数

请求头参数说明:

参数 类型 必填 描述 备注
token String 是 token
timezoneid String 否 时区 标准的时区ID,不传或非法默认为"Asia/Shanghai"
language String 否 语言标识 en:英文,zh:中文,不传或非法默认为"zh"

其他参数说明:

关于入参时间说明,通常常规接口如无特殊备注,传入的时间大于当前时间为了确保入参的合法性我们则会根据接口指定的pattern,重置入参时间为当前时间, 例如今天是2023-09-11日,那么传入的时间假设是2023-09-12日则会重置时间为2023-09-11日.

如果传入的时间为起始时间和结束时间通常接口无特殊说明,结束时间也不能大于起始时间.

时间格式说明:

pattern Date
yyyy-MM-dd 2023-09-01
yyyy-MM-dd HH:mm 2023-09-01 00:00
yyyy-MM-dd HH:mm:ss 2023-09-01 00:00:00
# 统一状态码描述

返回参数：

错误码 描述
000000 成功
900001 token为空
900002 token认证失败
229000 调用接口过于频繁
222000 接口入参错误
999999 系统内部错误

返回示例：

{
  "ret_code": "000000",
  "ret_msg": "成功",
  "item": {}
}
1
2
3
4
5
{
  "ret_code": "900001",
  "ret_msg": "token为空!"
}
1
2
3
4
{
  "ret_code": "900002",
  "ret_msg": "token已失效或不存在，请重新获取!"
}
1
2
3
4
{
  "ret_code": "229000",
  "ret_msg": "接口调用过于频繁,请[60]秒以后重试,目前允许[60]秒调用接口[20]次,超过次数将被限制!"
}
1
2
3
4
{
  "ret_code": "222000",
  "ret_msg": "[start_date]参数格式错误,正确的格式是[yyyy-MM-dd],当前入参是[2023-07-24 1]"
}
1
2
3
4

{
  "ret_code": "999999",
  "ret_msg": "系统未知异常"
}
1
2
3
4
5

# 接口域名地址说明

# 阿里云域名地址
https://api-c.sobot.com/text
1
# 腾讯云域名地址
https://api-c.soboten.com/text
1
# 完整地址示例

1、用户请求阿里云环境全路径地址

https://api-c.sobot.com/text/chat-static-api/api/customerService/staffWorkStatis
1

2、用户请求腾讯云环境全路径地址

https://api-c.soboten.com/text/chat-static-api/api/customerService/staffWorkStatis
1

# 公共查询条件API

# ● 查询渠道列表信息

请求方式：

POST

请求地址：

/chat-static-api/api/condition/getChannelList
1

请求参数：

参数 类型 必填 描述 备注
query_content String 否 渠道名称关键词

返回参数：

参数 类型 必填 描述
ret_code String 是 返回编码
ret_msg String 是 返回信息
items List 否 返回对象

items 对象：

参数 类型 必填 描述
code String 是 渠道类型
msg String 是 渠道名称

请求示例：

curl --location '/chat-static-api/api/condition/getChannelList' \
--header 'token: 3d162dc4362840428f80e1f8c49670ee' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "query_content": ""
}'
1
2
3
4
5
6
7
8

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "操作成功",
    "items": [
        {
            "code": "4",
            "msg": "移动网站"
        },
        {
            "code": "0",
            "msg": "桌面网站"
        },
        {
            "code": "2",
            "msg": "APP"
        },
        {
            "code": "17",
            "msg": "微信客服"
        },
        {
            "code": "3",
            "msg": "微博"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# ● 查询子渠道列表信息（分页）

请求方式：

POST

请求地址：

/chat-static-api/api/condition/getChildChannelList
1

请求参数：

参数 类型 必填 描述 备注
sources String 否 渠道类型 多个以英文逗号分割例"1,2"
query_content String 否 渠道名称关键词
page_no String 否 页码 默认1
page_size String 否 每页数量 默认15,最大允许为100,如果超过100则重置为100

返回参数：

参数 类型 必填 描述
ret_code String 是 返回编码
ret_msg String 是 返回信息
page_no String 是 当前页
page_count String 是 总页数
page_size String 是 页面条数
total_count String 是 数据总条数
items List 否 返回对象

items 对象：

参数 类型 必填 描述
sub_channel_id String 是 子渠道使用id
channel_type String 是 渠道类型
sub_channel_name String 是 子渠道名称
channel_flag String 是 渠道标识
channel_flag_key String 是 渠道标识key(用于机器人接口查询入参)

请求示例：

curl --location '/chat-static-api/api/condition/getChildChannelList' \
--header 'token: 3d162dc4362840428f80e1f8c49670ee' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "page_no": "1",
    "page_size": "5",
    "sources": "",
    "query_content": ""
}'
1
2
3
4
5
6
7
8
9
10
11

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "操作成功",
    "page_no": 1,
    "total_count": 42,
    "page_size": 5,
    "items": [
        {
            "sub_channel_id": "9eef5ee48be74ff2850a7886acbadd7c",
            "channel_type": "4",
            "sub_channel_name": "默认移动网站",
            "channel_flag": "1",
            "channel_flag_key": "4_1"
        },
        {
            "sub_channel_id": "12ef5039433e48558945aaf834c04a82",
            "channel_type": "4",
            "sub_channel_name": "移动网站名称-29",
            "channel_flag": "29",
            "channel_flag_key": "4_29"
        },
        {
            "sub_channel_id": "21f51d0acc0b43b0a3945d70d56bb1bf",
            "channel_type": "4",
            "sub_channel_name": "移动网站名称Randolph Keebler",
            "channel_flag": "32",
            "channel_flag_key": "4_32"
        },
        {
            "sub_channel_id": "d58353048a3c460b9fa391dd581c06d4",
            "channel_type": "4",
            "sub_channel_name": "移动网站名称Conrad Parisian",
            "channel_flag": "35",
            "channel_flag_key": "4_35"
        },
        {
            "sub_channel_id": "ea3917b2579642f0a84968b3589d9a20",
            "channel_type": "4",
            "sub_channel_name": "移动网站名称Bill Bergstrom",
            "channel_flag": "30",
            "channel_flag_key": "4_30"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
# ● 查询服务分类列表

请求方式：

POST

请求地址：

/chat-static-api/api/condition/getClassificationList
1

请求参数：

无

返回参数：

参数 类型 必填 描述
ret_code String 是 返回编码
ret_msg String 是 返回信息
items List 否 返回对象

items 对象：

参数 类型 必填 描述
id String 是 分类ID
classify_name String 是 分类名称
classify_code String 是 分类编码
classify_level String 是 分类级别
classify_level_path String 是 分类路径,最后一位由当前分类id构成,多个之间以英文逗号分隔
classify_parent_id String 是 分类父级id
sort String 是 排序值

请求示例：

curl --location --request POST '/chat-static-api/api/condition/getClassificationList' \
--header 'token: 94b4db111e2f4369942db415bdfec17e' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai'
1
2
3
4

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "items": [
        {
            "id": "1675771435033501698",
            "classify_name": "分类1",
            "classify_code": "1001",
            "classify_level": 1,
            "classify_level_path": "1675771435033501698",
            "classify_parent_id": "1",
            "sort": 1
        },
        {
            "id": "1942058769946447874",
            "classify_name": "分类1_2",
            "classify_level": 2,
            "classify_level_path": "1675771435033501698,1942058769946447874",
            "classify_parent_id": "1675771435033501698",
            "sort": 1
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

说明：

  1. 目前针对接口有限流控制，当ret_code=229000，表示接口被限流，当前每分钟最多允许调用20次。
# ● 查询机器人列表

请求方式：

POST

请求地址：

/chat-static-api/api/condition/getRobotList
1

请求参数：

无

返回参数：

参数 类型 必填 描述
ret_code String 是 返回编码
ret_msg String 是 返回信息
items List 否 返回对象

items 对象：

参数 类型 必填 描述
robot_logo String 是 机器人logo
robot_name String 是 机器人名称
robot_flag String 是 机器人flag

请求示例：

curl --location --request POST '/chat-static-api/api/condition/getRobotList' \
--header 'token: 94b4db111e2f4369942db415bdfec17e' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai'
1
2
3
4

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "items": [
        {
            "robot_logo": "https://img.sobot.com/console/common/face/robot.png",
            "robot_name": "小智机器人",
            "robot_flag": 1
        },
        {
            "robot_logo": "https://img.sobot.com/console/common/face/robot.png",
            "robot_name": "小智机器人-2",
            "robot_flag": 2
        },
        {
            "robot_logo": "https://img.sobot.com/console/common/face/robot.png",
            "robot_name": "小智机器人-3",
            "robot_flag": 3
        },
        {
            "robot_logo": "https://img.sobot.com/console/common/face/robot.png",
            "robot_name": "小智机器人-4",
            "robot_flag": 4
        },
        {
            "robot_logo": "https://img.sobot.com/console/common/face/robot.png",
            "robot_name": "小智机器人-5",
            "robot_flag": 5
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

说明：

  1. 目前针对接口有限流控制，当ret_code=229000，表示接口被限流，当前每分钟最多允许调用20次。
# ● 查询部门列表

请求方式：

POST

请求地址：

/chat-static-api/api/condition/getDepartmentList
1

请求参数：

无

返回参数：

参数 类型 必填 描述
ret_code String 是 返回编码
ret_msg String 是 返回信息
items List 否 返回对象

items 对象：

参数 类型 必填 描述
depart_id String 是 部门ID
depart_name String 是 部门名称
parent_id String 是 父节点ID
company_id String 是 公司ID
child_list List 否 子部门列表

请求示例：

curl --location --request POST '/chat-static-api/api/condition/getDepartmentList' \
--header 'token: 94b4db111e2f4369942db415bdfec17e' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai'
1
2
3
4

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "items": [
        {
            "depart_id": "11b97b04eaea4f89b84fcbb75e41a3d6",
            "depart_name": "总公司",
            "company_id": "913d909e3a194598ba61cf904b5dc12a",
            "parent_id": "0",
            "child_list": [
                {
                    "depart_id": "6e4c8ae50b7046e2b790466dc35e660f",
                    "depart_name": "西南地区",
                    "company_id": "913d909e3a194598ba61cf904b5dc12a",
                    "parent_id": "11b97b04eaea4f89b84fcbb75e41a3d6"
                },
                {
                    "depart_id": "7b46015c6a184511bc6a4d8a8c44bc99",
                    "depart_name": "东北地区",
                    "company_id": "913d909e3a194598ba61cf904b5dc12a",
                    "parent_id": "11b97b04eaea4f89b84fcbb75e41a3d6"
                }
            ]
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

说明：

  1. 目前针对接口有限流控制，当ret_code=229000，表示接口被限流，当前每分钟最多允许调用20次。
# ● 查询技能组列表

请求方式：

POST

请求地址：

/chat-static-api/api/condition/getGroupList
1

请求参数：

参数 类型 必填 描述 备注
depart_ids_param String 否 部门ID 多个以英文逗号分割例"1,2"
query_content String 否 名称关键词
page String 否 页码 默认1
size String 否 每页数量 默认15,最大允许为100,如果超过100则重置为100

返回参数：

参数 类型 必填 描述
ret_code String 是 返回编码
ret_msg String 是 返回信息
items List 否 返回对象

items 对象：

参数 类型 必填 描述
group_id String 是 技能组ID
group_name String 是 技能组名称

请求示例：

curl --location --request POST '/chat-static-api/api/condition/getGroupList' \
--header 'token: 38cb37ae635e46faa5ffd5cf5bc9acc3' \
--header 'timezoneid: Asia/Shanghai' \
--header 'language: zh' \
--header 'Content-Type: application/json' \
--data-raw '{
    "query_content": "测",
    "depart_ids_param": "11b97b04eaea4f89b84fcbb75e41a3d6"
}'
1
2
3
4
5
6
7
8
9

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "page_no": 1,
    "page_size": 15,
    "items": [
        {
            "group_id": "3b4a3eb565f74558a0b746023a85e0ad",
            "group_name": "测试"
        },
        {
            "group_id": "2a5171b2a85d49bda666f1569588d12e",
            "group_name": "会话统计测试"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

说明：

  1. 目前针对接口有限流控制，当ret_code=229000，表示接口被限流，当前每分钟最多允许调用20次。
# ● 查询客服列表

请求方式：

POST

请求地址：

/chat-static-api/api/condition/getServiceList
1

请求参数：

参数 类型 必填 描述 备注
search_way Integer 是 1-部门 2-技能组 默认search_way=1
depart_ids_param String 否 部门ID 多个以英文逗号分割例"1,2"
group_ids_param String 否 技能组ID 多个以英文逗号分割例"1,2"
query_content String 否 名称关键词
page String 否 页码 默认1
size String 否 每页数量 默认15,最大允许为100,如果超过100则重置为100

返回参数：

参数 类型 必填 描述
ret_code String 是 返回编码
ret_msg String 是 返回信息
page_no String 是 当前页
page_count String 是 总页数
page_size String 是 页面条数
total_count String 是 数据总条数
items List 否 返回对象

items 对象：

参数 类型 必填 描述
service_id String 是 客服ID
service_name String 是 客服名称
service_nick String 是 客服昵称

请求示例：

curl --location --request POST '/chat-static-api/api/condition/getServiceList' \
--header 'token: 38cb37ae635e46faa5ffd5cf5bc9acc3' \
--header 'timezoneid: Asia/Shanghai' \
--header 'language: zh' \
--header 'Content-Type: application/json' \
--data-raw '{
    "query_content": "",
    "search_way":"2",
    "group_ids_param":"3b4a3eb565f74558a0b746023a85e0ad,2a5171b2a85d49bda666f1569588d12e",
    "depart_ids_param": "11b97b04eaea4f89b84fcbb75e41a3d6"
}'
1
2
3
4
5
6
7
8
9
10
11

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "page_no": 1,
    "total_count": 3,
    "page_size": 15,
    "items": [
        {
            "service_id": "3c199c5dff5b44f7b45638e83d8710a7",
            "service_name": "张三",
            "service_nick": "zstest"
        },
        {
            "service_id": "70b08e73e1894273934acf97ab3726d5",
            "service_name": "赵琳凤",
            "service_nick": "赵琳凤"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

说明：

  1. 目前针对接口有限流控制，当ret_code=229000，表示接口被限流，当前每分钟最多允许调用20次。

# 会话统计API

# ● 会话数据(分页)

请求方式：

POST

请求地址：

/chat-static-api/api/online/session/getStat
1

请求参数：

参数 类型 必填 描述 备注
start_date String 是 会话开始时间 pattern:yyyy-MM-dd HH:mm:ss
end_date String 是 会话结束时间 pattern:yyyy-MM-dd HH:mm:ss
search_way Integer 是 1-部门 2-技能组 3-咨询渠道 默认search_way=3
summary_way Integer 否 0-合计 1-日报 2-周报 3-月报 默认summary_way=0
source String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flag String 否 渠道channel_flag_key 多个以英文逗号分割例"1,2"
depart_ids_param String 否 部门ID 多个以英文逗号分割例"1,2"
group_ids_param String 否 技能组ID 多个以英文逗号分割例"1,2"
robot_ids_param String 否 机器人robot_flag 多个以英文逗号分割例"1,2"
staff_ids_param String 否 客服ID 多个以英文逗号分割例"1,2"
page String 否 页码 默认1
size String 否 每页数量 默认15,最大允许为100,如果超过100则重置为100

返回参数：

参数 类型 必填 描述
ret_code String 是 返回编码
ret_msg String 是 返回信息
page_no String 是 当前页
page_count String 是 总页数
page_size String 是 页面条数
total_count String 是 数据总条数
items List 否 返回对象

items 对象：

参数 类型 必填 描述
queue Long 否 排队会话数
not_queue Long 否 未排队会话数
queue_not_accept_rate Double 否 未排队接通率
queue_accept Long 否 排队接通会话数
queue_accept_rate Double 否 排队接通率
queue_leave Long 否 排队离开会话数
queue_leave_rate Double 否 排队离开率
avg_queue_accept_duration Double 否 平均排队接通时长
avg_queue_leave_duration Double 否 平均排队离开时长
human_consult Long 否 总会话数
human_self Integer 否 独立接待会话数
human_self_rate Double 否 独立接待率
human_valid Integer 否 有效会话数
human_invalid Integer 否 无效会话数
human_valid_rate Double 否 有效会话率
human_not_recep Long 否 未接待会话数
human_not_recep_rate Double 否 未接待会话率
avg_human_recep_duration Double 否 平均接待时长
avg_staff_first_res_duration Double 否 平均首次响应时长
avg_staff_res_total_duration Double 否 平均响应时长
human_valid_recep Long 否 有效接待会话数
human_valid_recep_rate Double 否 有效接待会话率
human_invalid_recep Long 否 无效接待会话数
human_invalid_recep_rate Double 否 无效接待会话率
human_transfer Long 否 转接会话数
in_blacklist Long 否 拉黑会话数
summary_solved Long 否 已解决会话数
summary_not_solved Long 否 未解决会话数
human_snatch Long 否 抢接会话数
human_initiative Long 否 主动发起会话数
not_mark_is_solved Long 否 未标注是否解决会话数

请求示例：

curl --location --request POST '/chat-static-api/api/online/session/getStat' \
--header 'token: 3a9da6809b0c4daebe4706d17e4bcf89' \
--header 'timezoneid: Asia/Shanghai' \
--header 'language: zh' \
--header 'Content-Type: application/json' \
--data-raw '{
  "start_date": "2025-02-01 00:00:00",
  "end_date": "2025-07-08 23:59:59",
  "channel_flag": "0_12,0_13",
  "robot_ids_param": "1,2,3,4,5",
  "group_ids_param": "284a84325e504b5489179b925ec01e54",
  "search_way": "2"
  "page": 1,
  "size": 15,
}'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "page_no": 1,
    "page_count": 37,
    "total_count": 73,
    "page_size": 2,
    "items": [
        {
            "channel_flag": "6",
            "channel_flag_name": "DeskTop--6",
            "source": "0",
            "source_name": "Desktop Site",
            "session_consult": 0,
            "session_valid": 0,
            "session_invalid": 0,
            "queue": 0,
            "not_queue": 56,
            "queue_accept": 0,
            "queue_leave": 0,
            "queue_not_accept_rate": 1.0,
            "queue_not_accept_rate_str": "100.00%",
            "queue_accept_rate": 0.0,
            "queue_accept_rate_str": "0.00%",
            "queue_leave_rate": 0.0,
            "queue_leave_rate_str": "0.00%",
            "avg_queue_accept_duration": 0.0,
            "avg_queue_accept_duration_str": "00:00:00",
            "avg_queue_leave_duration": 0.0,
            "avg_queue_leave_duration_str": "00:00:00",
            "robot_consult": 0,
            "robot_self": 0,
            "robot_valid": 0,
            "robot_in_valid": 0,
            "robot_to_staff_active": 0,
            "robot_to_staff_trigger_key_word": 0,
            "robot_total_transfer": 0,
            "human_consult": 56,
            "human_self": 42,
            "human_valid": 56,
            "human_invalid": 0,
            "human_not_recep": 14,
            "human_valid_recep": 40,
            "human_invalid_recep": 2,
            "human_transfer": 0,
            "in_blacklist": 0,
            "summary_solved": 20,
            "summary_not_solved": 14,
            "human_snatch": 0,
            "human_initiative": 0,
            "human_self_rate": 0.75,
            "human_self_rate_str": "75.00%",
            "human_valid_rate": 1.0,
            "human_valid_rate_str": "100.00%",
            "human_not_recep_rate": 0.25,
            "human_not_recep_rate_str": "25.00%",
            "avg_human_recep_duration": 628769.25,
            "avg_human_recep_duration_str": "00:10:28",
            "avg_staff_first_res_duration": 853451.6,
            "avg_staff_first_res_duration_str": "00:14:13",
            "avg_staff_res_total_duration": 182964.42328042327,
            "avg_staff_res_total_duration_str": "00:03:02",
            "human_valid_recep_rate": 0.7142857142857143,
            "human_valid_recep_rate_str": "71.43%",
            "human_invalid_recep_rate": 0.03571428571428571,
            "human_invalid_recep_rate_str": "3.57%",
            "not_mark_is_solved": 22,
            "response_warn_count": 20,
            "staff_res_total_count": 189.0,
            "response_warn_rate": 0.10582010582010581
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

说明：

  1. 目前针对接口有限流控制，当ret_code=229000，表示接口被限流，当前每分钟最多允许调用20次。
# ● 会话消息数据(分页)

请求方式：

POST

请求地址：

/chat-static-api/api/online/session/getMsgStat
1

请求参数：

参数 类型 必填 描述 备注
start_date String 是 会话开始时间 pattern:yyyy-MM-dd HH:mm:ss
end_date String 是 会话结束时间 pattern:yyyy-MM-dd HH:mm:ss
search_way Integer 是 1-部门 2-技能组 3-咨询渠道 默认search_way=3
summary_way Integer 否 0-合计 1-日报 2-周报 3-月报 默认summary_way=0
source String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flag String 否 渠道channel_flag_key 多个以英文逗号分割例"1,2"
depart_ids_param String 否 部门ID 多个以英文逗号分割例"1,2"
group_ids_param String 否 技能组ID 多个以英文逗号分割例"1,2"
robot_ids_param String 否 机器人robot_flag 多个以英文逗号分割例"1,2"
staff_ids_param String 否 客服ID 多个以英文逗号分割例"1,2"
page String 是 页码 默认1
size String 是 每页数量 默认15,最大允许为100,如果超过100则重置为100

返回参数：

参数 类型 必填 描述
ret_code String 是 返回编码
ret_msg String 是 返回信息
page_no String 是 当前页
page_count String 是 总页数
page_size String 是 页面条数
total_count String 是 数据总条数
items List 否 返回对象

items 对象：

参数 类型 必填 描述
msg_human Integer 否 总会话消息数
msg_visitor_to_staff Integer 否 客户发送消息数
msg_staff Integer 否 客服发送消息数
offline_message Long 否 客服离线消息数
human_avg_msg Double 否 平均每会话消息数
msg_staff_visitor_rate Double 否 问答比
human_avg_msg_visitor Double 否 平均每会话客户消息数
human_avg_msg_staff Double 否 平均每会话客服消息数
msg_staff_word_count Integer 否 人工客服字数
human_avg_staff_word_count Double 否 平均每会话客服消息字数
staff_res_total_count Double 否 人工会话轮次
response_warn_rate Double 否 人工会话响应报警轮次
response_warn_count Integer 否 人工会话响应报警轮次

请求示例：

curl --location --request POST '/chat-static-api/api/online/session/getMsgStat' \
--header 'token: 3a9da6809b0c4daebe4706d17e4bcf89' \
--header 'timezoneid: Asia/Shanghai' \
--header 'language: zh' \
--header 'Content-Type: application/json' \
--data-raw '{
  "start_date": "2025-06-11 00:00:00",
  "end_date": "2025-07-10 23:59:00",
  "page": 1,
  "size": 15,
  "search_way": 1
}'
1
2
3
4
5
6
7
8
9
10
11
12

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "page_no": 1,
    "page_count": 1,
    "total_count": 1,
    "page_size": 15,
    "items": [
        {
            "depart_id": "11b97b04eaea4f89b84fcbb75e41a3d6",
            "depart_name": "总公司",
            "msg_human": 31,
            "msg_visitor_to_staff": 23,
            "msg_staff": 8,
            "offline_message": 0,
            "msg_staff_word_count": 32,
            "human_avg_msg": 3.44,
            "msg_staff_visitor_rate": 0.34782608695652173,
            "msg_staff_visitor_rate_str": "34.78%",
            "human_avg_msg_visitor": 2.56,
            "human_avg_msg_staff": 0.89,
            "human_avg_staff_word_count": 3.56,
            "response_warn_count": 7,
            "staff_res_total_count": 11.0,
            "response_warn_rate": 0.6363636363636364,
            "response_warn_rate_str": "63.64%"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

说明：

  1. 目前针对接口有限流控制，当ret_code=229000，表示接口被限流，当前每分钟最多允许调用20次。

# 客户统计API

# ● 客户统计-概览数据

请求方式：

POST

请求地址：

/chat-static-api/api/online/custom/getGeneral
1

请求参数：

参数 类型 必填 描述 备注
start_date String 是 会话开始时间 pattern:yyyy-MM-dd HH:mm
end_date String 是 会话结束时间 pattern:yyyy-MM-dd HH:mm
search_way Integer 是 1-部门 2-技能组 3-咨询渠道 默认search_way=2
source String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flag String 否 渠道channel_flag_key 多个以英文逗号分割例"1,2"
depart_ids_param String 否 部门ID 多个以英文逗号分割例"1,2"
group_ids_param String 否 技能组ID 多个以英文逗号分割例"1,2"
robot_ids_param String 否 机器人robot_flag 多个以英文逗号分割例"1,2"
staff_ids_param String 否 客服ID 多个以英文逗号分割例"1,2"

返回参数：

参数 类型 必填 描述
ret_code String 是 返回编码
ret_msg String 是 返回信息
item Object 否 返回对象

item 对象：

参数 类型 必填 描述
valid_visitor_total String 否 总有效客户数
new_visitor_num String 否 新访客数
old_visitor_num String 否 老访客数
old_visitor_proportion String 否 老访客占比
one_time_solution_rate String 否 24小时首解率
valid_visitor_total_cycle String 否 总有效客户数环比
new_visitor_num_cycle String 否 新访客数环比
old_visitor_num_cycle String 否 老访客数环比
old_visitor_proportion_cycle String 否 老访客占比环比
one_time_solution_rate_cycle String 否 24小时首解率环比

请求示例：

curl --location --request POST '/chat-static-api/api/online/custom/getGeneral' \
--header 'token: 3a9da6809b0c4daebe4706d17e4bcf89' \
--header 'timezoneid: Asia/Shanghai' \
--header 'language: zh' \
--header 'Content-Type: application/json' \
--data-raw '{
  "start_date": "2025-06-11 00:00",
  "end_date": "2025-07-10 23:59",
  "search_way": 1
}'
1
2
3
4
5
6
7
8
9
10

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "item": {
        "valid_visitor_total": "21",
        "new_visitor_num": "7",
        "old_visitor_num": "14",
        "old_visitor_proportion": "66.67%",
        "one_time_solution_rate": "22.22%",
        "valid_visitor_total_cycle": "-32.26%",
        "new_visitor_num_cycle": "-69.57%",
        "old_visitor_num_cycle": "55.56%",
        "old_visitor_proportion_cycle": "38.54%",
        "one_time_solution_rate_cycle": "-5.36%"
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

说明：

  1. 目前针对接口有限流控制，当ret_code=229000，表示接口被限流，当前每分钟最多允许调用20次。
# ● 客户统计-机器人接待数据

请求方式：

POST

请求地址：

/chat-static-api/api/online/custom/getRobotReception
1

请求参数：

参数 类型 必填 描述 备注
start_date String 是 会话开始时间 pattern:yyyy-MM-dd HH:mm
end_date String 是 会话结束时间 pattern:yyyy-MM-dd HH:mm
search_way Integer 是 1-部门 2-技能组 3-咨询渠道 默认search_way=2
source String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flag String 否 渠道channel_flag_key 多个以英文逗号分割例"1,2"
depart_ids_param String 否 部门ID 多个以英文逗号分割例"1,2"
group_ids_param String 否 技能组ID 多个以英文逗号分割例"1,2"
robot_ids_param String 否 机器人robot_flag 多个以英文逗号分割例"1,2"
staff_ids_param String 否 客服ID 多个以英文逗号分割例"1,2"

返回参数：

参数 类型 必填 描述
ret_code String 是 返回编码
ret_msg String 是 返回信息
item Object 否 返回对象

item 对象：

参数 类型 必填 描述
robot_reception_num String 否 机器人接待客户数
robot_reception_num_cycle String 否 机器人接待客户数环比
robot_reception_valid_num String 否 机器人有效接待客户数
robot_reception_valid_num_cycle String 否 机器人有效接待客户数环比
robot_self_reception_num String 否 机器人独立接待客户数
robot_self_reception_num_cycle String 否 机器人独立接待客户数环比
robot_self_reception_num_proportion String 否 机器人独立接待客户占比
robot_self_reception_num_proportion_cycle String 否 机器人独立接待客户占比环比
robot_to_staff_active String 否 主动转人工客户数
robot_to_staff_active_cycle String 否 主动转人工客户数环比
robot_to_staff_active_proportion String 否 主动转人工客户占比
robot_to_staff_active_proportion_cycle String 否 主动转人工客户占比环比
trigger_to_manual_num String 否 触发自动转人工客户数
trigger_to_manual_num_cycle String 否 触发自动转人工客户数环比
trigger_to_manual_num_proportion String 否 触发自动转人工客户占比
trigger_to_manual_num_proportion_cycle String 否 触发自动转人工客户占比环比
transfer_to_staff_num String 否 转人工客户数
transfer_to_staff_num_cycle String 否 转人工客户数环比
robot_to_staff_trigger_key_word String 否 关键词触发转人工客户数
robot_to_staff_trigger_key_word_cycle String 否 关键词触发转人工客户数环比
robot_to_staff_trigger_key_word_proportion String 否 关键词触发转人工客户占比
robot_to_staff_trigger_key_word_proportion_cycle String 否 关键词触发转人工客户占比环比

请求示例：

curl --location --request POST '/chat-static-api/api/online/custom/getRobotReception' \
--header 'token: 3a9da6809b0c4daebe4706d17e4bcf89' \
--header 'timezoneid: Asia/Shanghai' \
--header 'language: zh' \
--header 'Content-Type: application/json' \
--data-raw '{
  "start_date": "2025-04-01 00:00",
  "end_date": "2025-07-09 23:59",
  "search_way": 1
}'
1
2
3
4
5
6
7
8
9
10

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "item": {
        "robot_reception_num": "1496",
        "robot_reception_valid_num": "300",
        "robot_self_reception_num": "66",
        "robot_self_reception_num_proportion": "22.00%",
        "transfer_to_staff_num": "1452",
        "robot_to_staff_active": "1441",
        "robot_to_staff_active_proportion": "99.24%",
        "trigger_to_manual_num": "6",
        "trigger_to_manual_num_proportion": "0.41%",
        "robot_to_staff_trigger_key_word": "1",
        "robot_to_staff_trigger_key_word_proportion": "0.07%",
        "robot_reception_num_cycle": "-53.24%",
        "robot_reception_valid_num_cycle": "-64.03%",
        "robot_self_reception_num_cycle": "450.00%",
        "robot_self_reception_num_proportion_cycle": "20.56%",
        "transfer_to_staff_num_cycle": "-54.64%",
        "robot_to_staff_active_cycle": "-54.87%",
        "robot_to_staff_active_proportion_cycle": "-0.51%",
        "trigger_to_manual_num_cycle": "500.00%",
        "trigger_to_manual_num_proportion_cycle": "0.38%",
        "robot_to_staff_trigger_key_word_cycle": "0.00%",
        "robot_to_staff_trigger_key_word_proportion_cycle": "0.07%"
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

说明：

  1. 目前针对接口有限流控制，当ret_code=229000，表示接口被限流，当前每分钟最多允许调用20次。
# ● 客户统计-人工客服接待数据

请求方式：

POST

请求地址：

/chat-static-api/api/online/custom/getStaffReception
1

请求参数：

参数 类型 必填 描述 备注
start_date String 是 会话开始时间 pattern:yyyy-MM-dd HH:mm
end_date String 是 会话结束时间 pattern:yyyy-MM-dd HH:mm
search_way Integer 是 1-部门 2-技能组 3-咨询渠道 默认search_way=2
source String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flag String 否 渠道channel_flag_key 多个以英文逗号分割例"1,2"
depart_ids_param String 否 部门ID 多个以英文逗号分割例"1,2"
group_ids_param String 否 技能组ID 多个以英文逗号分割例"1,2"
robot_ids_param String 否 机器人robot_flag 多个以英文逗号分割例"1,2"
staff_ids_param String 否 客服ID 多个以英文逗号分割例"1,2"

返回参数：

参数 类型 必填 描述
ret_code String 是 返回编码
ret_msg String 是 返回信息
item Object 否 返回对象

item 对象：

参数 类型 必填 描述
staff_reception_num String 否 人工接待客户数
staff_reception_num_cycle String 否 人工接待客户数环比
staff_self_reception_num String 否 人工独立接待客户数
staff_self_reception_num_cycle String 否 人工独立接待客户数环比
staff_self_reception_num_proportion String 否 人工独立接待客户占比
staff_self_reception_num_proportion_cycle String 否 人工独立接待客户占比环比
staff_valid_reception_num String 否 人工有效接待客户数
staff_valid_reception_num_cycle String 否 人工有效接待客户数环比
staff_valid_reception_num_proportion String 否 人工有效接待客户占比
staff_valid_reception_num_proportion_cycle String 否 人工有效接待客户占比环比

请求示例：

curl --location --request POST '/chat-static-api/api/online/custom/getStaffReception' \
--header 'token: 3a9da6809b0c4daebe4706d17e4bcf89' \
--header 'timezoneid: Asia/Shanghai' \
--header 'language: zh' \
--header 'Content-Type: application/json' \
--data-raw '{
  "start_date": "2025-04-01 00:00",
  "end_date": "2025-07-09 23:59",
  "search_way": 1
}'
1
2
3
4
5
6
7
8
9
10

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "item": {
        "staff_reception_num": "704",
        "staff_self_reception_num": "700",
        "staff_self_reception_num_proportion": "99.43%",
        "staff_valid_reception_num": "700",
        "staff_valid_reception_num_proportion": "99.43%",
        "staff_reception_num_cycle": "-69.14%",
        "staff_self_reception_num_cycle": "-69.05%",
        "staff_self_reception_num_proportion_cycle": "-0.31%",
        "staff_valid_reception_num_cycle": "-69.23%",
        "staff_valid_reception_num_proportion_cycle": "-0.31%"
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

说明：

  1. 目前针对接口有限流控制，当ret_code=229000，表示接口被限流，当前每分钟最多允许调用20次。
# ● 客户统计-地域分布

请求方式：

POST

请求地址：

/chat-static-api/api/online/custom/getGeographicalDistribution
1

请求参数：

参数 类型 必填 描述 备注
start_date String 是 会话开始时间 pattern:yyyy-MM-dd HH:mm
end_date String 是 会话结束时间 pattern:yyyy-MM-dd HH:mm
search_way Integer 是 1-部门 2-技能组 3-咨询渠道 默认search_way=2
source String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flag String 否 渠道channel_flag_key 多个以英文逗号分割例"1,2"
depart_ids_param String 否 部门ID 多个以英文逗号分割例"1,2"
group_ids_param String 否 技能组ID 多个以英文逗号分割例"1,2"
robot_ids_param String 否 机器人robot_flag 多个以英文逗号分割例"1,2"
staff_ids_param String 否 客服ID 多个以英文逗号分割例"1,2"

返回参数：

参数 类型 必填 描述
ret_code String 是 返回编码
ret_msg String 是 返回信息
items List 否 返回对象

items 对象：

参数 类型 必填 描述
id String 否 序号
country String 否 国家
province String 否 地区
visitor_total String 否 总访客数
new_visitor_num String 否 新访客数
old_visitor_num String 否 老访客数

请求示例：

curl --location --request POST '/chat-static-api/api/online/custom/getGeographicalDistribution' \
--header 'token: 3a9da6809b0c4daebe4706d17e4bcf89' \
--header 'timezoneid: Asia/Shanghai' \
--header 'language: zh' \
--header 'Content-Type: application/json' \
--data-raw '{
  "start_date": "2025-04-01 00:00",
  "end_date": "2025-07-09 23:59",
  "search_way": 1
}'
1
2
3
4
5
6
7
8
9
10

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "items": [
    {
            "id": "6",
            "country": "中国",
            "province": "北京",
            "visitor_total": "1445",
            "new_visitor_num": "1402",
            "old_visitor_num": "43"
        },
        {
            "id": "1",
            "country": "美国",
            "province": "加利福尼亚",
            "visitor_total": "2",
            "new_visitor_num": "2",
            "old_visitor_num": "0"
        },
        {
            "id": "4",
            "country": "荷兰",
            "province": "",
            "visitor_total": "1",
            "new_visitor_num": "0",
            "old_visitor_num": "1"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

说明：

  1. 目前针对接口有限流控制，当ret_code=229000，表示接口被限流，当前每分钟最多允许调用20次。

# 客服统计API

# ● 查询客服工作量统计(分页)

请求方式：

POST

请求地址：

/chat-static-api/api/customerService/staffWorkStatis
1

请求参数：

参数 类型 必填 描述 备注
search_way Integer 是 1-部门 2-技能组 默认search_way=2
start_date String 是 会话开始时间 pattern:yyyy-MM-dd
end_date String 是 会话结束时间 pattern:yyyy-MM-dd
staff_id_list List 否 客服id ["staffId1","staffId2"]
group_id_list List 否 技能组id ["groupId1","groupId2"]
page_no String 否 页码 默认1
page_size String 否 每页数量 默认15,最大允许为100,如果超过100则重置为100

返回参数：

参数 类型 必填 描述
ret_code String 是 返回编码
ret_msg String 是 返回信息
page_no String 是 当前页
page_count String 是 总页数
page_size String 是 页面条数
total_count String 是 数据总条数
items List 否 返回对象

items 对象：

参数 类型 必填 描述
service_nick String 否 客服昵称
service_email String 否 客服邮箱
group_name String 否 客服技能组
human_consult Integer 否 总会话数
human_self Integer 否 独立接待会话数
human_valid Integer 否 有效会话数
human_invalid Integer 否 无效会话数
human_invalid_recep Integer 否 无效接待会话数
first_response_time_set Integer 否 首次接待首响会话数
transfer_first_res_duration Long 否 转接后首响会话数
valid_recep_rate_str String 否 有效接待会话率
not_recep_rate_str String 否 未接待会话率
max_conv_num String 否 最大同时接待会话数
human_consult_duration_str String 否 人工咨询时长
valid_information Integer 否 有效留资会话数
human_valid_recep Integer 否 有效接待会话数
valid_response_counts Long 否 有效交互会话数
avg_human_confirm_duration_transfer_str String 否 转接时长
total_human_message Integer 否 总会话消息数
msg_staff Integer 否 客服消息数
msg_visitor_tostaff Integer 否 客户消息数
answer_than_str String 否 问答比
msg_staff_wordcount Integer 否 客服字数
human_visitor_consult Long 否 有效咨询会话数
roll_in Integer 否 转入会话数
roll_out Integer 否 转出会话数
human_not_recep Integer 否 未接待会话数
last_staff_consult Long 否 最后接待数
quiet_after_session_count Long 否 24小时首解数
quiet_after_session_rate_str String 否 24小时首解率
human_initiative Integer 否 客服主动发起会话数
avg_session_duration_str String 否 平均人工接待时长
avg_total_session_duration_str String 否 平均总会话时长
avg_first_response_time_str String 否 平均首次响应时长
transfer_first_response_rate_str String 否 转接后首次响应率
response_time_avg_str String 否 平均响应时长
response_duration_max_str String 否 最大响应时长
first_response_rate_str String 否 首次响应率
first_response_in30s_rate_str String 否 30s应答率
first_response_in60s_rate_str String 否 60s应答率
solve_not_mark Integer 否 未标注是否解决会话
snatch_out Integer 否 被抢接会话数
response_counts Integer 否 人工会话轮次
summary_solved Integer 否 已解决会话数
summary_not_solved Integer 否 未解决会话数
snatch_in Integer 否 抢接会话数
response_rate_str String 否 客服最后回复率
staff_connect_rate_str String 否 客服接通率
human_res_warn_count Integer 否 人工会话响应报警轮次
human_res_warn_rate_str String 否 人工会话响应报警率
total_times Integer 否 参评数
comment_rate_str String 否 参评率
initiative Integer 否 客户主动参评数
customer_initiative_rate_str String 否 客户主动参评率
invite_counts Integer 否 邀请数
invite_counts_rate_str String 否 邀请率
invites Integer 否 客服邀请参评数
staff_invite_rate_str String 否 客服邀请参评率
level2_score5_rate_str String 否 满意率 (2 级评价)
level2_score1_rate_str String 否 不满意率 (2 级评价)
avg_comment_score Double 否 平均分 (5 星)
good_rate_str String 否 好评率 (5 星)
middle_rate_str String 否 中评率 (5 星)
bad_rate_str String 否 差评率 (5 星)
score5_rate_str String 否 5 星占比
score4_rate_str String 否 4 星占比
score3_rate_str String 否 3 星占比
score2_rate_str String 否 2 星占比
score1_rate_str String 否 1 星占比
avg_nps_score Double 否 平均分 (10 分)
good_nps_rate_str String 否 好评率 (10 分)
middle_nps_rate_str String 否 中评率 (10 分)
bad_nps_rate_str String 否 差评率 (10 分)
nps_score10_rate_str String 否 10 分占比
nps_score9_rate_str String 否 9 分占比
nps_score8_rate_str String 否 8 分占比
nps_score7_rate_str String 否 7 分占比
nps_score6_rate_str String 否 6 分占比
nps_score5_rate_str String 否 5 分占比
nps_score4_rate_str String 否 4 分占比
nps_score3_rate_str String 否 3 分占比
nps_score2_rate_str String 否 2 分占比
nps_score1_rate_str String 否 1 分占比
level2_score5 Integer 否 满意会话数 (2 级评价)
level2_score1 Integer 否 不满意会话数 (2 级评价)
good Integer 否 好评会话数 (5 星)
middle Integer 否 中评会话数 (5 星)
bad Integer 否 差评会话数 (5 星)
score5 Integer 否 5 星会话数
score4 Integer 否 4 星会话数
score3 Integer 否 3 星会话数
score2 Integer 否 2 星会话数
score1 Integer 否 1 星会话数
nps_good Integer 否 好评会话数 (10 分)
nps_middle Integer 否 中评会话数 (10 分)
nps_bad Integer 否 差评会话数 (10 分)
nps_score10 Integer 否 10 分会话数
nps_score9 Integer 否 9 分会话数
nps_score8 Integer 否 8 分会话数
nps_score7 Integer 否 7 分会话数
nps_score6 Integer 否 6 分会话数
nps_score5 Integer 否 5 分会话数
nps_score4 Integer 否 4 分会话数
nps_score3 Integer 否 3 分会话数
nps_score2 Integer 否 2 分会话数
nps_score1 Integer 否 1 分会话数
remark Integer 否 备注数

请求示例：

curl --location '/chat-static-api/api/customerService/staffWorkStatis' \
--header 'token: c84f8b6f5885434da40d8449eb15c7f1' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "search_way":"1",
    "start_date": "2023-04-01",
    "end_date": "2023-06-30",
    "staff_id_list": ["staff_id1","staff_id2"],
    "group_id_list": ["group_id1","group_id2"],
    "page_no": "1",
    "page_size": "15"
}'
1
2
3
4
5
6
7
8
9
10
11
12
13
14

返回示例：

{
  "ret_code": "000000",
  "ret_msg": "操作成功",
  "page_no": 1,
  "page_count": 1,
  "total_count": 5,
  "page_size": 15,
  "items": [
    {
      "start_date": "2025-03-19",
      "end_date": "2025-04-17",
      "group_id": "5a06cfe6bdac42419c56ec7e15dd64e9",
      "group_name": "测试1",
      "staff_id": "0a8c83731fd04728ac2ed13e9ef180dc",
      "service_email": "staff1@zhichi.com",
      "service_nick": "客服1",
      "human_consult": 7,
      "human_self": 0,
      "human_valid": 4,
      "valid_information": 0,
      "human_invalid": 3,
      "human_valid_recep": 0,
      "human_invalid_recep": 0,
      "first_response_time_set": 0,
      "transfer_first_res_duration": 0,
      "human_visitor_consult": 4,
      "valid_recep_rate_str": "0.00%",
      "roll_in": 1,
      "roll_out": 1,
      "human_not_recep": 4,
      "not_recep_rate_str": "100.00%",
      "last_staff_consult": 6,
      "quiet_after_session_count": 2,
      "quiet_after_session_rate_str": "33.33%",
      "human_initiative": 0,
      "human_consult_duration": 2099106,
      "human_consult_duration_str": "00:34:59",
      "avg_session_duration": 301885.75,
      "avg_session_duration_str": "00:05:01",
      "avg_total_session_duration": 299872.2857,
      "avg_total_session_duration_str": "00:04:59",
      "summary_solved": 0,
      "summary_not_solved": 0,
      "solve_not_mark": 7,
      "lastmsg_staff": 0,
      "snatch_in": 0,
      "snatch_out": 0,
      "staff_connect_rate_str": "0.00%",
      "avg_human_confirm_duration_transfer": 9073,
      "avg_human_confirm_duration_transfer_str": "00:00:09",
      "total_human_message": 9,
      "msg_staff": 0,
      "msg_visitor_tostaff": 9,
      "answer_than_str": "0.00%",
      "msg_staff_wordcount": 0,
      "avg_first_response_time": 353669.5,
      "avg_first_response_time_str": "00:05:53",
      "first_response_rate_str": "0.00%",
      "transfer_first_response_rate_str": "0.00%",
      "response_time_avg": 353669.5,
      "response_time_avg_str": "00:05:53",
      "response_duration_max": 818770,
      "response_duration_max_str": "00:13:38",
      "first_response_in30s_rate_str": "0.00%",
      "first_response_in60s_rate_str": "0.00%",
      "total_times": 1,
      "comment_rate_str": "25.00%",
      "initiative": 0,
      "customer_initiative_rate_str": "0.00%",
      "invite_counts": 0,
      "invite_counts_rate_str": "0.00%",
      "invites": 1,
      "staff_invite_rate_str": "100.00%",
      "avg_comment_score": 0,
      "good_rate_str": "0.00%",
      "middle_rate_str": "0.00%",
      "bad_rate_str": "0.00%",
      "score5_rate_str": "0.00%",
      "score4_rate_str": "0.00%",
      "score3_rate_str": "0.00%",
      "score2_rate_str": "0.00%",
      "score1_rate_str": "0.00%",
      "avg_nps_score": 10,
      "good_nps_rate_str": "100.00%",
      "middle_nps_rate_str": "0.00%",
      "bad_nps_rate_str": "0.00%",
      "nps_score10_rate_str": "100.00%",
      "nps_score9_rate_str": "0.00%",
      "nps_score8_rate_str": "0.00%",
      "nps_score7_rate_str": "0.00%",
      "nps_score6_rate_str": "0.00%",
      "nps_score5_rate_str": "0.00%",
      "nps_score4_rate_str": "0.00%",
      "nps_score3_rate_str": "0.00%",
      "nps_score2_rate_str": "0.00%",
      "nps_score1_rate_str": "0.00%",
      "nps_score0_rate_str": "0.00%",
      "good": 0,
      "middle": 0,
      "bad": 0,
      "score5": 0,
      "score4": 0,
      "score3": 0,
      "score2": 0,
      "score1": 0,
      "nps_good": 1,
      "nps_middle": 0,
      "nps_bad": 0,
      "nps_score10": 1,
      "nps_score9": 0,
      "nps_score8": 0,
      "nps_score7": 0,
      "nps_score6": 0,
      "nps_score5": 0,
      "nps_score4": 0,
      "nps_score3": 0,
      "nps_score2": 0,
      "nps_score1": 0,
      "nps_score0": 0,
      "level2_score1": 0,
      "level2_score5": 0,
      "level2_score1_rate_str": "0.00%",
      "level2_score5_rate_str": "0.00%",
      "remark": 0,
      "valid_response_counts": 0,
      "response_rate_str": "0.00%",
      "max_conv_num": "1",
      "human_res_warn_count": 3,
      "response_counts": 4,
      "human_res_warn_rate_str": "75.00%"
    },
    {
      "start_date": "2025-03-19",
      "end_date": "2025-04-17",
      "group_id": "5a06cfe6bdac42419c56ec7e15dd64e9",
      "group_name": "测试1",
      "staff_id": "903965b75366482dbc95a4322538e2c8",
      "service_email": "staff2@zhichi.com",
      "service_nick": "测试2",
      "human_consult": 9,
      "human_self": 1,
      "human_valid": 6,
      "valid_information": 0,
      "human_invalid": 3,
      "human_valid_recep": 1,
      "human_invalid_recep": 0,
      "first_response_time_set": 0,
      "transfer_first_res_duration": 0,
      "human_visitor_consult": 6,
      "valid_recep_rate_str": "16.67%",
      "roll_in": 0,
      "roll_out": 0,
      "human_not_recep": 5,
      "not_recep_rate_str": "83.33%",
      "last_staff_consult": 9,
      "quiet_after_session_count": 2,
      "quiet_after_session_rate_str": "22.22%",
      "human_initiative": 0,
      "human_consult_duration": 4363974,
      "human_consult_duration_str": "01:12:43",
      "avg_session_duration": 228155.6667,
      "avg_session_duration_str": "00:03:48",
      "avg_total_session_duration": 484886,
      "avg_total_session_duration_str": "00:08:04",
      "summary_solved": 0,
      "summary_not_solved": 0,
      "solve_not_mark": 9,
      "lastmsg_staff": 1,
      "snatch_in": 0,
      "snatch_out": 0,
      "staff_connect_rate_str": "16.67%",
      "avg_human_confirm_duration_transfer": 0,
      "avg_human_confirm_duration_transfer_str": "00:00:00",
      "total_human_message": 14,
      "msg_staff": 7,
      "msg_visitor_tostaff": 7,
      "answer_than_str": "100.00%",
      "msg_staff_wordcount": 50,
      "avg_first_response_time": 392346,
      "avg_first_response_time_str": "00:06:32",
      "first_response_rate_str": "0.00%",
      "transfer_first_response_rate_str": "0.00%",
      "response_time_avg": 392346,
      "response_time_avg_str": "00:06:32",
      "response_duration_max": 572595,
      "response_duration_max_str": "00:09:32",
      "first_response_in30s_rate_str": "0.00%",
      "first_response_in60s_rate_str": "0.00%",
      "total_times": 0,
      "comment_rate_str": "0.00%",
      "initiative": 0,
      "customer_initiative_rate_str": "0.00%",
      "invite_counts": 0,
      "invite_counts_rate_str": "0.00%",
      "invites": 0,
      "staff_invite_rate_str": "0.00%",
      "avg_comment_score": 0,
      "good_rate_str": "0.00%",
      "middle_rate_str": "0.00%",
      "bad_rate_str": "0.00%",
      "score5_rate_str": "0.00%",
      "score4_rate_str": "0.00%",
      "score3_rate_str": "0.00%",
      "score2_rate_str": "0.00%",
      "score1_rate_str": "0.00%",
      "avg_nps_score": 0,
      "good_nps_rate_str": "0.00%",
      "middle_nps_rate_str": "0.00%",
      "bad_nps_rate_str": "0.00%",
      "nps_score10_rate_str": "0.00%",
      "nps_score9_rate_str": "0.00%",
      "nps_score8_rate_str": "0.00%",
      "nps_score7_rate_str": "0.00%",
      "nps_score6_rate_str": "0.00%",
      "nps_score5_rate_str": "0.00%",
      "nps_score4_rate_str": "0.00%",
      "nps_score3_rate_str": "0.00%",
      "nps_score2_rate_str": "0.00%",
      "nps_score1_rate_str": "0.00%",
      "nps_score0_rate_str": "0.00%",
      "good": 0,
      "middle": 0,
      "bad": 0,
      "score5": 0,
      "score4": 0,
      "score3": 0,
      "score2": 0,
      "score1": 0,
      "nps_good": 0,
      "nps_middle": 0,
      "nps_bad": 0,
      "nps_score10": 0,
      "nps_score9": 0,
      "nps_score8": 0,
      "nps_score7": 0,
      "nps_score6": 0,
      "nps_score5": 0,
      "nps_score4": 0,
      "nps_score3": 0,
      "nps_score2": 0,
      "nps_score1": 0,
      "nps_score0": 0,
      "level2_score1": 0,
      "level2_score5": 0,
      "level2_score1_rate_str": "0.00%",
      "level2_score5_rate_str": "0.00%",
      "remark": 0,
      "valid_response_counts": 0,
      "response_rate_str": "16.67%",
      "max_conv_num": "1",
      "human_res_warn_count": 2,
      "response_counts": 6,
      "human_res_warn_rate_str": "33.33%"
    }
  ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256

说明：

  1. 目前针对接口有限流控制，当ret_code=229000，表示接口被限流，当前每分钟最多允许调用20次。
# ● 查询客服工作状态(分页)

请求方式：

POST

请求地址：

/chat-static-api/api/online/staff/getWorkLogList
1

请求参数：

参数 类型 必填 描述 备注
start_date String 是 会话开始时间 pattern:yyyy-MM-dd
end_date String 是 会话结束时间 pattern:yyyy-MM-dd
depart_ids_param String 否 部门ID 多个以英文逗号分割例"1,2"
staff_ids_param String 否 客服ID 多个以英文逗号分割例"1,2"
page String 否 页码 默认1
size String 否 每页数量 默认15,最大允许为100,如果超过100则重置为100

返回参数：

参数 类型 必填 描述
ret_code String 是 返回编码
ret_msg String 是 返回信息
page_no String 是 当前页
page_count String 是 总页数
page_size String 是 页面条数
total_count String 是 数据总条数
items List 否 返回对象

items 对象：

参数 类型 必填 描述
staff_id String 否 客服ID
staff_name String 否 客服姓名
department_id String 否 所属部门ID
department_name String 否 所属部门
start_login_time Long 否 首次登录时间(毫秒级时间戳)
first_login_time Long 否 首次在线时间(毫秒级时间戳)
online_duration Long 否 在线时长(毫秒)
busy_counts Integer 否 忙碌次数
busy_all_duration Long 否 忙碌时长(毫秒)
rest_duration Long 否 小休时长(毫秒)
eat_duration Long 否 用餐时长(毫秒)
active_duration Long 否 活动时长(毫秒)
train_duration Long 否 培训时长(毫秒)
meet_duration Long 否 会议时长(毫秒)
last_leave_time Long 否 最后离线时间(毫秒级时间戳)

请求示例：

curl --location '/chat-static-api/api/online/staff/getWorkLogList' \
--header 'token: c84f8b6f5885434da40d8449eb15c7f1' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "start_date": "2025-04-01",
    "end_date": "2025-06-30",
    "staff_id_list": ["staff_id1","staff_id2"],
    "group_id_list": ["group_id1","group_id2"],
    "page": "1",
    "size": "2"
}'
1
2
3
4
5
6
7
8
9
10
11
12
13

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "page_no": 1,
    "page_count": 5,
    "total_count": 9,
    "page_size": 2,
    "items": [
        {
            "staff_id": "e6d913b5c1e346558b55e4720f7f49b2",
            "staff_name": "[]",
            "department_id": "913d909e3a194598ba61cf904b5dc12a|11b97b04eaea4f89b84fcbb75e41a3d6",
            "department_name": "总公司",
            "group_id": "135cbdc489f9412881ae97781bc0999a,2a5171b2a85d49bda666f1569588d12e,18634c519b134cce9cd3a663297ba9e9,284a84325e504b5489179b925ec01e54",
            "group_name": "超管1,会话统计测试,超管组,lzc",
            "start_login_time": "1747893918830",
            "free_duration": "11529665",
            "app_free_duration": "0",
            "online_duration": "11529665",
            "busy_counts": "1",
            "busy_duration": "2059",
            "app_busy_duration": "0",
            "busy_all_duration": "2059",
            "rest_duration": "0",
            "eat_duration": "0",
            "active_duration": "0",
            "train_duration": "0",
            "meet_duration": "0",
            "last_leave_time": "1747898942095",
            "first_login_time": "1743478293005",
            "result_month": "2025-04",
            "result_week": "14",
            "result_date": "2025-04-01",
            "result_year": "2025",
            "company_id": "913d909e3a194598ba61cf904b5dc12a",
            "start_date": "2025-04-01",
            "end_date": "2025-07-09"
        },
        {
            "staff_id": "642d296772cf45ca99bc2a280bef6c10",
            "staff_name": "昭宸",
            "department_id": "913d909e3a194598ba61cf904b5dc12a|11b97b04eaea4f89b84fcbb75e41a3d6",
            "department_name": "总公司",
            "group_id": "3b4a3eb565f74558a0b746023a85e0ad,284a84325e504b5489179b925ec01e54,135cbdc489f9412881ae97781bc0999a",
            "group_name": "测试,lzc,超管1",
            "start_login_time": "1751953173368",
            "free_duration": "273494425",
            "app_free_duration": "0",
            "online_duration": "273494425",
            "busy_counts": "1",
            "busy_duration": "1637",
            "app_busy_duration": "0",
            "busy_all_duration": "1637",
            "rest_duration": "0",
            "eat_duration": "0",
            "active_duration": "0",
            "train_duration": "0",
            "meet_duration": "0",
            "last_leave_time": "1751953702117",
            "first_login_time": "1743481451524",
            "result_month": "2025-04",
            "result_week": "14",
            "result_date": "2025-04-01",
            "result_year": "2025",
            "company_id": "913d909e3a194598ba61cf904b5dc12a",
            "start_date": "2025-04-01",
            "end_date": "2025-07-09"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

说明：

  1. 目前针对接口有限流控制，当ret_code=229000，表示接口被限流，当前每分钟最多允许调用20次。

# 满意度评价统计API

# ● 会话满意度统计数据查询

请求方式：

POST

请求地址：

/chat-static-api/api/online/satisfaction/getSatisfactionSurvey
1

请求参数：

参数 类型 必填 描述 备注
start_date String 是 会话开始时间 pattern:yyyy-MM-dd
end_date String 是 会话结束时间 pattern:yyyy-MM-dd
search_way Integer 是 1-部门 2-技能组 默认search_way=1
source String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flag String 否 渠道channel_flag_key 多个以英文逗号分割例"1,2"
depart_ids_param String 否 部门ID 多个以英文逗号分割例"1,2"
group_ids_param String 否 技能组ID 多个以英文逗号分割例"1,2"
staff_ids_param String 否 客服ID 多个以英文逗号分割例"1,2"

返回参数：

参数 类型 必填 描述
ret_code String 是 返回编码
ret_msg String 是 返回信息
item Object 否 返回对象

item 对象：

参数 类型 必填 描述
概览数据
human_valid Integer 否 人工有效会话数
human_valid_ratio String 否 人工有效会话数环比
total_times Integer 否 参评数
total_times_ratio String 否 参评数环比
comment_rate_str String 否 参评率
comment_rate_str_ratio String 否 参评率环比
valid_reception_comment_rate_str String 否 有效接待会话参评率
valid_reception_comment_rate_str_ratio String 否 有效接待会话参评率环比
initiative Integer 否 客户主动参评数
initiative_ratio String 否 客户主动参评数环比
customer_initiative_rate_str String 否 客户主动参评率
customer_initiative_rate_str_ratio String 否 客户主动参评率环比
invite_counts_rate_str String 否 客服邀评率
invite_counts_rate_str_ratio String 否 客服邀评率环比
invite_counts Integer 否 客服邀评数
invite_counts_ratio String 否 客服邀评数环比
staff_invite_rate_str String 否 客服邀请参评率
staff_invite_rate_str_ratio String 否 客服邀请参评率环比
invites Integer 否 客服邀请参评数
invites_ratio String 否 客服邀请参评数环比
not_solved Integer 否 评价未解决数
not_solved_ratio Integer 否 评价未解决数环比
not_solved_rate_str String 否 评价未解决率
not_solved_rate_str_ratio String 否 评价未解决率环比
solved Integer 否 评价已解决数
solved_ratio String 否 评价已解决数环比
solved_rate_str String 否 评价已解决率
solved_rate_str_ratio String 否 评价已解决率环比
solved_count Integer 否 评价解决总数
solved_count_ratio Integer 否 评价解决总数环比
2 级评价数据
level2_score5 Integer 否 满意会话数 (2 级评价)
level2_score5_ratio String 否 满意会话数环比 (2 级评价)
level2_score5_rate_str String 否 满意率(2 级评价)
level2_score5_rate_str_ratio String 否 满意率环比(2 级评价)
level2_score1 Integer 否 不满意会话数 (2 级评价)
level2_score1_ratio String 否 不满意会话数环比 (2 级评价)
level2_score1_rate_str String 否 不满意率 (2 级评价)
level2_score1_rate_str_ratio String 否 不满意率环比 (2 级评价)
星级评价数据
avg_comment_score String 否 平均分 (5 星)
avg_comment_score_ratio String 否 平均分环比 (5 星)
good Integer 否 好评会话数
good_ratio String 否 好评会话数环比
good_rate_str String 否 好评率
good_rate_str_ratio String 否 好评率环比
middle Integer 否 中评会话数
middle_ratio String 否 中评会话数环比
middle_rate_str String 否 中评率
middle_rate_str_ratio String 否 中评率环比
bad Integer 否 差评会话数
bad_ratio String 否 差评会话数环比
bad_rate_str String 否 差评率
bad_rate_str_ratio String 否 差评率环比
score5 Integer 否 5 星会话数
score5_ratio String 否 5 星会话数环比
score4 Integer 否 4 星会话数
score4_ratio String 否 4 星会话数环比
score3 Integer 否 3 星会话数
score3_ratio String 否 3 星会话数环比
score2 Integer 否 2 星会话数
score2_ratio String 否 2 星会话数环比
score1 Integer 否 1 星会话数
score1_ratio String 否 1 星会话数环比
score5_rate_str String 否 5 星会话占比
score5_rate_str_ratio String 否 5 星会话占比环比
score4_rate_str String 否 4 星会话占比
score4_rate_str_ratio String 否 4 星会话占比环比
score3_rate_str String 否 3 星会话占比
score3_rate_str_ratio String 否 3 星会话占比环比
score2_rate_str String 否 2 星会话占比
score2_rate_str_ratio String 否 2 星会话占比环比
score1_rate_str String 否 1 星会话占比
score1_rate_str_ratio String 否 1 星会话占比环比
分值评价数据
avg_nps_score String 否 平均分
avg_nps_score_ratio String 否 平均分环比
nps_good Integer 否 好评会话数
nps_good_ratio String 否 好评会话数环比
good_nps_rate_str String 否 好评率
good_nps_rate_str_ratio String 否 好评率环比
nps_middle Integer 否 中评会话数
nps_middle_ratio String 否 中评会话数环比
middle_nps_rate_str String 否 中评率
middle_nps_rate_str_ratio String 否 中评率环比
nps_bad Integer 否 差评会话数
nps_bad_ratio String 否 差评会话数
bad_nps_rate_str String 否 差评率
bad_nps_rate_str_ratio String 否 差评率环比
nps_score10 Integer 否 10 分会话数
nps_score10_ratio String 否 10 分会话数环比
nps_score9 Integer 否 9 分会话数
nps_score9_ratio String 否 9 分会话数环比
nps_score8 Integer 否 8 分会话数
nps_score8_ratio String 否 8 分会话数环比
nps_score7 Integer 否 7 分会话数
nps_score7_ratio String 否 7 分会话数环比
nps_score6 Integer 否 6 分会话数
nps_score6_ratio String 否 6 分会话数环比
nps_score5 Integer 否 5 分会话数
nps_score5_ratio String 否 5 分会话数环比
nps_score4 Integer 否 4 分会话数
nps_score4_ratio String 否 4 分会话数环比
nps_score3 Integer 否 3 分会话数
nps_score3_ratio String 否 3 分会话数环比
nps_score2 Integer 否 2 分会话数
nps_score2_ratio String 否 2 分会话数环比
nps_score1 Integer 否 1 分会话数
nps_score1_ratio String 否 1 分会话数环比
nps_score0 Integer 否 0 分会话数
nps_score0_ratio String 否 0 分会话数环比
nps_score10_rate_str String 否 10 分会话占比
nps_score10_rate_str_ratio String 否 10 分会话占比环比
nps_score9_rate_str String 否 9 分会话占比
nps_score9_rate_str_ratio String 否 9 分会话占比环比
nps_score8_rate_str String 否 8 分会话占比
nps_score8_rate_str_ratio String 否 8 分会话占比环比
nps_score7_rate_str String 否 7 分会话占比
nps_score7_rate_str_ratio String 否 7 分会话占比环比
nps_score6_rate_str String 否 6 分会话占比
nps_score6_rate_str_ratio String 否 6 分会话占比环比
nps_score5_rate_str String 否 5 分会话占比
nps_score5_rate_str_ratio String 否 5 分会话占比环比
nps_score4_rate_str String 否 4 分会话占比
nps_score4_rate_str_ratio String 否 4 分会话占比环比
nps_score3_rate_str String 否 3 分会话占比
nps_score3_rate_str_ratio String 否 3 分会话占比环比
nps_score2_rate_str String 否 2 分会话占比
nps_score2_rate_str_ratio String 否 2 分会话占比环比
nps_score1_rate_str String 否 1 分会话占比
nps_score1_rate_str_ratio String 否 1 分会话占比环比
nps_score0_rate_str String 否 0 分会话占比
nps_score0_rate_str_ratio String 否 0 分会话占比环比

请求示例：

curl --location --request POST '/chat-static-api/api/online/satisfaction/getSatisfactionSurvey' \
--header 'token: 3a9da6809b0c4daebe4706d17e4bcf89' \
--header 'timezoneid: Asia/Shanghai' \
--header 'language: zh' \
--header 'Content-Type: application/json' \
--data-raw '{
  "start_date": "2025-04-01",
  "end_date": "2025-07-09",
  "search_way": 1
}'
1
2
3
4
5
6
7
8
9
10

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "item": {
        "human_valid": 1282,
        "human_valid_ratio": "-46.18%",
        "total_times": 687,
        "total_times_ratio": "-70.60%",
        "score_total_times": 684,
        "nps_total_times": 0,
        "comment_rate_str": "53.59%",
        "comment_rate_str_ratio": "-45.38%",
        "valid_reception_comment_rate_str": "93.72%",
        "valid_reception_comment_rate_str_ratio": "-5.24%",
        "initiative": 375,
        "initiative_ratio": "-70.60%",
        "customer_initiative_rate_str": "54.59%",
        "customer_initiative_rate_str_ratio": "-0.34%",
        "invite_counts_rate_str": "24.49%",
        "invite_counts_rate_str_ratio": "-44.91%",
        "invite_counts": 314,
        "invite_counts_ratio": "-70.35%",
        "staff_invite_rate_str": "45.41%",
        "staff_invite_rate_str_ratio": "0.41%",
        "invites": 312,
        "invites_ratio": "-70.48%",
        "not_solved": 312,
        "not_solved_ratio": "-70.45%",
        "not_solved_rate_str": "45.61%",
        "not_solved_rate_str_ratio": "0.47%",
        "solved": 372,
        "solved_ratio": "-70.71%",
        "solved_rate_str": "54.39%",
        "solved_rate_str_ratio": "-0.39%",
        "solved_count": 684,
        "solved_count_ratio": "-70.59%",
        "avg_comment_score": "3.00",
        "avg_comment_score_ratio": "-0.99%",
        "good": 156,
        "good_ratio": "-66.95%",
        "good_rate_str": "22.81%",
        "good_rate_str_ratio": "12.49%",
        "middle": 253,
        "middle_ratio": "-73.06%",
        "middle_rate_str": "36.99%",
        "middle_rate_str_ratio": "-8.30%",
        "bad": 275,
        "bad_ratio": "-70.01%",
        "bad_rate_str": "40.20%",
        "bad_rate_str_ratio": "2.07%",
        "score5": 156,
        "score5_ratio": "-66.95%",
        "score4": 112,
        "score4_ratio": "-77.42%",
        "score3": 141,
        "score3_ratio": "-68.17%",
        "score2": 125,
        "score2_ratio": "-73.46%",
        "score1": 150,
        "score1_ratio": "-66.37%",
        "score5_rate_str": "22.81%",
        "score5_rate_str_ratio": "12.49%",
        "score4_rate_str": "16.37%",
        "score4_rate_str_ratio": "-23.15%",
        "score3_rate_str": "20.61%",
        "score3_rate_str_ratio": "8.33%",
        "score2_rate_str": "18.27%",
        "score2_rate_str_ratio": "-9.67%",
        "score1_rate_str": "21.93%",
        "score1_rate_str_ratio": "14.47%",
        "avg_nps_score": "0.00",
        "avg_nps_score_ratio": "NA",
        "nps_good": 0,
        "nps_good_ratio": "NA",
        "good_nps_rate_str": "0.00%",
        "good_nps_rate_str_ratio": "NA",
        "nps_middle": 0,
        "nps_middle_ratio": "NA",
        "middle_nps_rate_str": "0.00%",
        "middle_nps_rate_str_ratio": "NA",
        "nps_bad": 0,
        "nps_bad_ratio": "NA",
        "bad_nps_rate_str": "0.00%",
        "bad_nps_rate_str_ratio": "NA",
        "nps_score10": 0,
        "nps_score10_ratio": "NA",
        "nps_score9": 0,
        "nps_score9_ratio": "NA",
        "nps_score8": 0,
        "nps_score8_ratio": "NA",
        "nps_score7": 0,
        "nps_score7_ratio": "NA",
        "nps_score6": 0,
        "nps_score6_ratio": "NA",
        "nps_score5": 0,
        "nps_score5_ratio": "NA",
        "nps_score4": 0,
        "nps_score4_ratio": "NA",
        "nps_score3": 0,
        "nps_score3_ratio": "NA",
        "nps_score2": 0,
        "nps_score2_ratio": "NA",
        "nps_score1": 0,
        "nps_score1_ratio": "NA",
        "nps_score0": 0,
        "nps_score0_ratio": "NA",
        "nps_score10_rate_str": "0.00%",
        "nps_score10_rate_str_ratio": "NA",
        "nps_score9_rate_str": "0.00%",
        "nps_score9_rate_str_ratio": "NA",
        "nps_score8_rate_str": "0.00%",
        "nps_score8_rate_str_ratio": "NA",
        "nps_score7_rate_str": "0.00%",
        "nps_score7_rate_str_ratio": "NA",
        "nps_score6_rate_str": "0.00%",
        "nps_score6_rate_str_ratio": "NA",
        "nps_score5_rate_str": "0.00%",
        "nps_score5_rate_str_ratio": "NA",
        "nps_score4_rate_str": "0.00%",
        "nps_score4_rate_str_ratio": "NA",
        "nps_score3_rate_str": "0.00%",
        "nps_score3_rate_str_ratio": "NA",
        "nps_score2_rate_str": "0.00%",
        "nps_score2_rate_str_ratio": "NA",
        "nps_score1_rate_str": "0.00%",
        "nps_score1_rate_str_ratio": "NA",
        "nps_score0_rate_str": "0.00%",
        "nps_score0_rate_str_ratio": "NA",
        "level2_score1": 0,
        "level2_score1_ratio": "NA",
        "level2_score5": 3,
        "level2_score5_ratio": "-66.67%",
        "level2_score1_rate_str": "0.00%",
        "level2_score1_rate_str_ratio": "NA",
        "level2_score5_rate_str": "100.00%",
        "level2_score5_rate_str_ratio": "0.00%"
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138

说明：

  1. 目前针对接口有限流控制，当ret_code=229000，表示接口被限流，当前每分钟最多允许调用20次。
# ● 客户满意度统数据查询

请求方式：

POST

请求地址：

/chat-static-api/api/online/satisfaction/getCustomerSatisfaction
1

请求参数：

参数 类型 必填 描述 备注
start_date String 是 会话开始时间 pattern:yyyy-MM-dd
end_date String 是 会话结束时间 pattern:yyyy-MM-dd
search_way Integer 是 1-部门 2-技能组 默认search_way=1
source String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flag String 否 渠道channel_flag_key 多个以英文逗号分割例"1,2"
depart_ids_param String 否 部门ID 多个以英文逗号分割例"1,2"
group_ids_param String 否 技能组ID 多个以英文逗号分割例"1,2"
staff_ids_param String 否 客服ID 多个以英文逗号分割例"1,2"

返回参数：

参数 类型 必填 描述
ret_code String 是 返回编码
ret_msg String 是 返回信息
item Object 否 返回对象

item 对象：

参数 类型 必填 描述
概览数据
human_valid Integer 否 人工有效客户数
human_valid_change String 否 人工有效客户数环比
human_in_valid_recep Integer 否 人工有效接待客户数
human_in_valid_recep_change String 否 人工有效接待客户数环比
evaluate String 否 参评客户数
evaluate_change String 否 参评客户数环比
solved String 否 评价已解决客户数
solved_change String 否 评价已解决客户数环比
active_evaluate Integer 否 主动参评客户数
active_evaluate_change String 否 主动参评客户数环比
staff_invite String 否 客服邀请客户数
staff_invite_change String 否 客服邀请客户数环比
invite_evaluate String 否 客服邀请评价客户数
invite_evaluate_change String 否 客服邀请评价客户数环比
2 级评价数据
level2_score5 Integer 否 满意会话数
level2_score5_change String 否 满意会话数环比
level2_score1 String 否 不满意会话数
level2_score1_change String 否 不满意会话数环比
星级评价数据
score5_average String 否 平均分 (5 星)
score5_average_change String 否 平均分环比 (5 星)
score5 String 否 5 星评价数
score5_change String 否 5 星评价数环比
score4 String 否 4 星评价数
score4_change String 否 4 星评价数环比
score3 String 否 3 星评价数
score3_change String 否 3 星评价数环比
score2 String 否 2 星评价数
score2_change String 否 2 星评价数环比
score1 String 否 1 星评价数
score1_change String 否 1 星评价数环比
分值评价数据
nps10_average String 否 平均分（10 分）
nps10_average_change String 否 平均分环比（10 分）
nps10 String 否 10 分评价数量
nps10_change String 否 10 分评价数量环比
nps9 String 否 9 分评价数量
nps9_change String 否 9 分评价数量环比
nps8 String 否 8 分评价数量
nps8_change String 否 8 分评价数量环比
nps7 String 否 7 分评价数量
nps7_change String 否 7 分评价数量环比
nps6 String 否 6 分评价数量
nps6_change String 否 6 分评价数量环比
nps5 String 否 5 分评价数量
nps5_change String 否 5 分评价数量环比
nps4 String 否 4 分评价数量
nps4_change String 否 4 分评价数量环比
nps3 String 否 3 分评价数量
nps3_change String 否 3 分评价数量环比
nps2 String 否 2 分评价数量
nps2_change String 否 2 分评价数量环比
nps1 String 否 1 分评价数量
nps1_change String 否 1 分评价数量环比
nps0 String 否 0 分评价数量
nps0_change String 否 0 分评价数量环比

请求示例：

curl --location --request POST '/chat-static-api/api/online/satisfaction/getCustomerSatisfaction' \
--header 'token: 3a9da6809b0c4daebe4706d17e4bcf89' \
--header 'timezoneid: Asia/Shanghai' \
--header 'language: zh' \
--header 'Content-Type: application/json' \
--data-raw '{
  "start_date": "2025-04-01",
  "end_date": "2025-07-09",
  "search_way": 1
}'
1
2
3
4
5
6
7
8
9
10

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "item": {
        "score5_average": "3.02",
        "score5_average_change": "-0.27%",
        "score5": "253",
        "score5_change": "-66.71%",
        "score4": "208",
        "score4_change": "-73.23%",
        "score3": "228",
        "score3_change": "-68.60%",
        "score2": "208",
        "score2_change": "-73.02%",
        "score1": "244",
        "score1_change": "-66.02%",
        "nps10_average": "0.00",
        "nps10_average_change": "-100.00%",
        "nps10": "0",
        "nps10_change": "-100.00%",
        "nps9": "0",
        "nps9_change": "-100.00%",
        "nps8": "0",
        "nps8_change": "-100.00%",
        "nps7": "0",
        "nps7_change": "-100.00%",
        "nps6": "0",
        "nps6_change": "-100.00%",
        "nps5": "0",
        "nps5_change": "-100.00%",
        "nps4": "0",
        "nps4_change": "-100.00%",
        "nps3": "0",
        "nps3_change": "-100.00%",
        "nps2": "0",
        "nps2_change": "-100.00%",
        "nps1": "0",
        "nps1_change": "-100.00%",
        "nps0": "0",
        "nps0_change": "-100.00%",
        "human_valid": "1672",
        "human_valid_change": "-66.50%",
        "human_in_valid_recep": "1156",
        "human_in_valid_recep_change": "-75.33%",
        "evaluate": "1149",
        "evaluate_change": "-76.74%",
        "solved": "622",
        "solved_change": "-76.77%",
        "active_evaluate": "632",
        "active_evaluate_change": "-76.39%",
        "staff_invite": "517",
        "staff_invite_change": "-76.65%",
        "invite_evaluate": "517",
        "invite_evaluate_change": "-77.17%",
        "level2_score1": "0",
        "level2_score1_change": "-100.00%",
        "level2_score5": "8",
        "level2_score5_change": "100.00%"
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

说明：

  1. 目前针对接口有限流控制，当ret_code=229000，表示接口被限流，当前每分钟最多允许调用20次。

# 服务总结统计API

# ● 服务总结统计数据查询

请求方式：

POST

请求地址：

/chat-static-api/api/online/summary/search
1

请求参数：

参数 类型 必填 描述 备注
start_date String 是 会话开始时间 pattern:yyyy-MM-dd HH:mm:ss
end_date String 是 会话结束时间 pattern:yyyy-MM-dd HH:mm:ss
summary_way Integer 否 0-合计 1-日报 2-周报 3-月报 默认summary_way=0
group_ids_param String 否 技能组ID 多个以英文逗号分割例"1,2"
page Integer 否 页码 默认1
size Integer 否 每页数量 默认15,最大允许为100,如果超过100则重置为100
level_classifys List 否 服务分类 多个以英文逗号分割例"1,2"

level_classifys 对象：

参数 类型 必填 描述 备注
classify_id String 是 分类ID id
level Integer 是 分类级别 classify_level

返回参数：

参数 类型 必填 描述
ret_code String 是 返回编码
ret_msg String 是 返回信息
page_no String 是 当前页
page_count String 是 总页数
page_size String 是 页面条数
total_count String 是 数据总条数
items List 否 返回对象

items 对象：

参数 类型 必填 描述
level Integer 否 分类级别
classify_id String 否 分类ID
classify_show_name String 否 分类名称
details List 否 分类聚合指标详情

details 对象：

参数 类型 必填 描述
show_date String 否 展示时间
real_date String 否 时间
total_conversation_num Integer 否 总会话数
service_invited_num Integer 否 客服邀评数
initiative_comment_num Integer 否 客户主动参评数
comment_type_total_num Integer 否 参评数
star_level_num5 Integer 否 5 星评价数
star_level_num4 Integer 否 4 星评价数
star_level_num3 Integer 否 3 星评价数
star_level_num2 Integer 否 2 星评价数
star_level_num1 Integer 否 1 星评价数
score_num10 Integer 否 10 分评价数
score_num9 Integer 否 9 分评价数
score_num8 Integer 否 8 分评价数
score_num7 Integer 否 7 分评价数
score_num6 Integer 否 6 分评价数
score_num5 Integer 否 5 分评价数
score_num4 Integer 否 4 分评价数
score_num3 Integer 否 3 分评价数
score_num2 Integer 否 2 分评价数
score_num1 Integer 否 1 分评价数
score_num0 Integer 否 0 分评价数

请求示例：

curl --location --request POST '/chat-static-api/api/online/summary/search' \
--header 'token: dce986ca86bf4244ac179d996b85023a' \
--header 'timezoneid: Asia/Shanghai' \
--header 'language: zh' \
--header 'Content-Type: application/json' \
--data-raw '{
    "summary_way": 2,
    "start_date": "2024-11-04 00:00:00",
    "end_date": "2024-11-05 23:59:59",
    "group_ids_param": "",
    "level_classifys": [
        {
            "classify_id": "1675771496144510978",
            "level": 1
        },
        {
            "classify_id": "1853733211749933058",
            "level": 1
        }
    ],
    "page": 1,
    "size": 15
}'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "page_no": 1,
    "page_count": 1,
    "total_count": 2,
    "page_size": 15,
    "items": [
        {
            "details": [
                {
                    "show_date": "45 week 2024-11-04-2024-11-10",
                    "real_date": "2024-45",
                    "total_conversation_num": 2,
                    "service_invited_num": 0,
                    "initiative_comment_num": 0,
                    "comment_type_total_num": 0,
                    "star_level_num1": 0,
                    "star_level_num2": 0,
                    "star_level_num3": 0,
                    "star_level_num4": 0,
                    "star_level_num5": 0,
                    "score_num0": 0,
                    "score_num1": 0,
                    "score_num2": 0,
                    "score_num3": 0,
                    "score_num4": 0,
                    "score_num5": 0,
                    "score_num6": 0,
                    "score_num7": 0,
                    "score_num8": 0,
                    "score_num9": 0,
                    "score_num10": 0
                }
            ],
            "level": "1",
            "classify_id": "1675771496144510978",
            "classify_show_name": "分类2"
        },
        {
            "details": [
                {
                    "show_date": "45 week 2024-11-04-2024-11-10",
                    "real_date": "2024-45",
                    "total_conversation_num": 2,
                    "service_invited_num": 0,
                    "initiative_comment_num": 0,
                    "comment_type_total_num": 0,
                    "star_level_num1": 0,
                    "star_level_num2": 0,
                    "star_level_num3": 0,
                    "star_level_num4": 0,
                    "star_level_num5": 0,
                    "score_num0": 0,
                    "score_num1": 0,
                    "score_num2": 0,
                    "score_num3": 0,
                    "score_num4": 0,
                    "score_num5": 0,
                    "score_num6": 0,
                    "score_num7": 0,
                    "score_num8": 0,
                    "score_num9": 0,
                    "score_num10": 0
                }
            ],
            "level": "1",
            "classify_id": "1853733211749933058",
            "classify_show_name": "分类3"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

说明：

  1. 目前针对接口有限流控制，当ret_code=229000，表示接口被限流，当前每分钟最多允许调用20次。
上次更新: 2025/8/5 11:34:11

← 知识中心 API→

最近更新
01
知识中心 API
07-25
02
运营支持 API
03-03
03
CRM 对接方案
12-05
更多文章>
Theme by Vdoing