开发者文档
智齿科技
2023-09-08
目录

在线机器人统计 API

# 在线机器人统计 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/condition/getChannelList
1

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

https://api-c.soboten.com/text/chat-static-api/api/condition/getChannelList
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/robot/receptionOverview/getReceptionOverviewTrend
1

请求参数：

参数 类型 必填 描述 备注
robot_ids String 否 机器人ID 多个以英文逗号分割例"1,2"
sources String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flags String 否 子渠道类型 多个以英文逗号分割例"0_16,0_1"
start_date String 否 会话开始时间 pattern:yyyy-MM-dd
end_date String 否 会话结束时间 pattern:yyyy-MM-dd

返回参数：

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

items 对象：

参数 类型 必填 描述
result_day String 否 数据天
result_hour String 否 数据小时
robot_consult Integer 否 总会话数
robot_valid Integer 否 有效会话数
robot_in_valid Integer 否 无效会话数
robot_self Integer 否 独立接待数
robot_solved Integer 否 解决数
robot_not_solved Integer 否 未解决数(未解决会话数)
evaluate_robot Integer 否 参评数
satisfied Integer 否 满意数
dissatisfied Integer 否 不满意数
evaluate_robot_invites Integer 否 会话邀评数
robot_transfer_to_staff_total Integer 否 转人工会话总数
robot_valid_to_staff Integer 否 有效会话转人工数
robot_of_visitor_direct_transfer Integer 否 直接转人工数
robot_transfer_succ_total Integer 否 转人工成功总数
robot_valid_transfer_succ Integer 否 有效会话转接成功数
robot_direct_transfer_succ Integer 否 直接转人工且转接成功数
robot_transfer_faild_total Integer 否 转人工失败总数
robot_valid_transfer_falid Integer 否 有效会话转接失败数
robot_direct_transfer_falid Integer 否 直接转人工但转接失败数
robot_valid_consult_rate Double 否 有效会话率
robot_valid_consult_rate_str String 否 字符串表示有效会话率
robot_in_valid_rate Double 否 无效会话率
robot_in_valid_rate_str String 否 字符串表示无效会话率
robot_self_rate Double 否 独立接待率
robot_self_rate_str String 否 字符串表示独立接待率
robot_solved_rate Double 否 解决率
robot_solved_rate_str String 否 字符串表示解决率
robot_not_solved_rate Double 否 未解决率(未解决参评数)
robot_not_solved_rate_str String 否 字符串表示未解决率
robot_evaluate_invites_rate Double 否 参评率
robot_evaluate_invites_rate_str String 否 字符串表示参评率
satisfied_rate Double 否 满意率
satisfied_rate_str String 否 字符串表示满意率
dissatisfied_rate Double 否 不满意率
dissatisfied_rate_str String 否 字符串表示不满意率
robot_transfer_rate Double 否 整体转人工率(转人工会话总数总会话数)
robot_transfer_rate_str String 否 字符串表示整体转人工率
robot_valid_to_staff_rate Double 否 有效会话转人工率
robot_valid_to_staff_rate_str String 否 字符串表示有效会话转人工率
robot_of_visitor_direct_transfer_rate Double 否 直接转人工率
robot_of_visitor_direct_transfer_rate_str String 否 字符串表示直接转人工率
robot_transfer_succ_total_rate Double 否 整体转人工成功率
robot_transfer_succ_total_rate_str String 否 字符串表示整体转人工成功率
robot_valid_transfer_succ_rate Double 否 有效会话转接成功率
robot_valid_transfer_succ_rate_str String 否 字符串表示有效会话转接成功率
robot_direct_transfer_succ_rate Double 否 直接转人工成功率
robot_direct_transfer_succ_rate_str String 否 字符串表示直接转人工成功率
robot_transfer_faild_total_rate Double 否 整体转人工失败率
robot_transfer_faild_total_rate_str String 否 字符串表示整体转人工失败率
robot_valid_transfer_falid_rate Double 否 有效会话转接失败率
robot_valid_transfer_falid_rate_str String 否 字符串表示有效会话转接失败率
robot_direct_transfer_falid_rate Double 否 直接转人工失败率
robot_direct_transfer_falid_rate_str String 否 字符串表示直接转人工失败率

请求示例：

curl --location '/chat-static-api/api/robot/receptionOverview/getReceptionOverviewTrend' \
--header 'token: 1e50ef3b9b974b62bbfc686cfd237904' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "robot_ids": "1",
    "sources": "",
    "channel_flags": "",
    "start_date": "2023-07-24",
    "end_date": "2023-07-25"
}'
1
2
3
4
5
6
7
8
9
10
11
12

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "items": [
        {
            "result_day": "2023-07-24",
            "result_hour": "0.00%",
            "robot_consult": 0,
            "robot_valid": 0,
            "robot_in_valid": 0,
            "robot_self": 0,
            "robot_solved": 0,
            "robot_not_solved": 0,
            "evaluate_robot": 0,
            "satisfied": 0,
            "dissatisfied": 0,
            "evaluate_robot_invites": 0,
            "robot_transfer_to_staff_total": 0,
            "robot_valid_to_staff": 0,
            "robot_of_visitor_direct_transfer": 0,
            "robot_transfer_succ_total": 0,
            "robot_valid_transfer_succ": 0,
            "robot_direct_transfer_succ": 0,
            "robot_transfer_faild_total": 0,
            "robot_valid_transfer_falid": 0,
            "robot_direct_transfer_falid": 0,
            "robot_valid_consult_rate": 0.0,
            "robot_valid_consult_rate_str": "0.00%",
            "robot_in_valid_rate": 0.0,
            "robot_in_valid_rate_str": "0.00%",
            "robot_self_rate": 0.0,
            "robot_self_rate_str": "0.00%",
            "robot_solved_rate": 0.0,
            "robot_solved_rate_str": "0.00%",
            "robot_not_solved_rate": 0.0,
            "robot_not_solved_rate_str": "0.00%",
            "robot_evaluate_invites_rate": 0.0,
            "robot_evaluate_invites_rate_str": "0.00%",
            "satisfied_rate": 0.0,
            "satisfied_rate_str": "0.00%",
            "dissatisfied_rate": 0.0,
            "dissatisfied_rate_str": "0.00%",
            "robot_transfer_rate": 0.0,
            "robot_transfer_rate_str": "0.00%",
            "robot_valid_to_staff_rate": 0.0,
            "robot_valid_to_staff_rate_str": "0.00%",
            "robot_of_visitor_direct_transfer_rate": 0.0,
            "robot_of_visitor_direct_transfer_rate_str": "0.00%",
            "robot_transfer_succ_total_rate": 0.0,
            "robot_transfer_succ_total_rate_str": "0.00%",
            "robot_valid_transfer_succ_rate": 0.0,
            "robot_valid_transfer_succ_rate_str": "0.00%",
            "robot_direct_transfer_succ_rate": 0.0,
            "robot_direct_transfer_succ_rate_str": "0.00%",
            "robot_transfer_faild_total_rate": 0.0,
            "robot_transfer_faild_total_rate_str": "0.00%",
            "robot_valid_transfer_falid_rate": 0.0,
            "robot_valid_transfer_falid_rate_str": "0.00%",
            "robot_direct_transfer_falid_rate": 0.0,
            "robot_direct_transfer_falid_rate_str": "0.00%"
        },
        {
            "result_day": "2023-07-25",
            "robot_consult": 3,
            "robot_valid": 1,
            "robot_in_valid": 2,
            "robot_self": 0,
            "robot_solved": 0,
            "robot_not_solved": 0,
            "evaluate_robot": 0,
            "satisfied": 0,
            "dissatisfied": 0,
            "evaluate_robot_invites": 0,
            "robot_transfer_to_staff_total": 3,
            "robot_valid_to_staff": 1,
            "robot_of_visitor_direct_transfer": 2,
            "robot_transfer_succ_total": 3,
            "robot_valid_transfer_succ": 1,
            "robot_direct_transfer_succ": 2,
            "robot_transfer_faild_total": 0,
            "robot_valid_transfer_falid": 0,
            "robot_direct_transfer_falid": 0,
            "robot_valid_consult_rate": 0.3333333333333333,
            "robot_valid_consult_rate_str": "33.33%",
            "robot_in_valid_rate": 0.6666666666666666,
            "robot_in_valid_rate_str": "66.67%",
            "robot_self_rate": 0.0,
            "robot_self_rate_str": "0.00%",
            "robot_solved_rate": 0.0,
            "robot_solved_rate_str": "0.00%",
            "robot_not_solved_rate": 0.0,
            "robot_not_solved_rate_str": "0.00%",
            "robot_evaluate_invites_rate": 0.0,
            "robot_evaluate_invites_rate_str": "0.00%",
            "satisfied_rate": 0.0,
            "satisfied_rate_str": "0.00%",
            "dissatisfied_rate": 0.0,
            "dissatisfied_rate_str": "0.00%",
            "robot_transfer_rate": 1.0,
            "robot_transfer_rate_str": "100.00%",
            "robot_valid_to_staff_rate": 1.0,
            "robot_valid_to_staff_rate_str": "100.00%",
            "robot_of_visitor_direct_transfer_rate": 0.6666666666666666,
            "robot_of_visitor_direct_transfer_rate_str": "66.67%",
            "robot_transfer_succ_total_rate": 1.0,
            "robot_transfer_succ_total_rate_str": "100.00%",
            "robot_valid_transfer_succ_rate": 1.0,
            "robot_valid_transfer_succ_rate_str": "100.00%",
            "robot_direct_transfer_succ_rate": 1.0,
            "robot_direct_transfer_succ_rate_str": "100.00%",
            "robot_transfer_faild_total_rate": 0.0,
            "robot_transfer_faild_total_rate_str": "0.00%",
            "robot_valid_transfer_falid_rate": 0.0,
            "robot_valid_transfer_falid_rate_str": "0.00%",
            "robot_direct_transfer_falid_rate": 0.0,
            "robot_direct_transfer_falid_rate_str": "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
# ● 会话数据转化

请求方式：

POST

请求地址：

/chat-static-api/api/robot/receptionOverview/getReceptionOverviewStatistics
1

请求参数：

参数 类型 必填 描述 备注
robot_ids String 否 机器人ID 多个以英文逗号分割例"1,2"
sources String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flags String 否 子渠道类型 多个以英文逗号分割例"0_16,0_1"
start_date String 否 会话开始时间 pattern:yyyy-MM-dd
end_date String 否 会话结束时间 pattern:yyyy-MM-dd

返回参数：

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

item 对象：

参数 类型 必填 描述
robot_consult Integer 是 总会话数
robot_consult_pre Integer 是 总会话数(上月比较)
robot_consult_ratio Double 是 总会话数环比
robot_consult_ratio_str String 是 总会话数环比字符串表示
robot_valid Integer 是 有效会话数
robot_valid_pre Integer 是 有效会话数(上月比较)
robot_valid_ratio Double 是 有效会话数环比
robot_valid_ratio_str String 是 有效会话数 环比字符串表示
robot_self Integer 是 独立接待数
robot_self_pre Integer 是 独立接待数(上月比较)
robot_self_ratio Double 是 独立接待数环比
robot_self_ratio_str String 是 独立接待数 环比字符串表示
robot_valid_to_staff Integer 是 有效会话转人工数
robot_valid_to_staff_pre Integer 是 有效会话转人工数(上月比较)
robot_valid_to_staff_ratio Double 是 有效会话转人工数 环比
robot_valid_to_staff_ratio_str String 是 有效会话转人工数 环比字符串表示
robot_in_valid Integer 是 无效会话数
robot_in_valid_pre Integer 是 无效会话数(上月比较)
robot_in_valid_ratio Double 是 无效会话数 环比
robot_in_valid_ratio_str String 是 无效会话数 环比字符串表示
robot_of_visitor_direct_transfer Integer 是 直接转人工数
robot_of_visitor_direct_transfer_pre Integer 是 直接转人工数(上月比较)
robot_of_visitor_direct_transfer_ratio Double 是 直接转人工数 环比
robot_of_visitor_direct_transfer_ratio_str String 是 直接转人工数 环比字符串表示
robot_valid_consult_rate Double 是 有效会话率
robot_valid_consult_rate_str String 是 字符串表示: 有效会话率
robot_self_rate Double 是 独立接待率
robot_self_rate_str String 是 字符串表示: 独立接待率
robot_solved_rate Double 是 解决率
robot_solved_rate_str String 是 字符串表示: 解决率
satisfied_rate Double 是 满意率
satisfied_rate_str String 是 字符串表示: 满意率
robot_valid_to_staff_rate Double 是 有效会话转人工率
robot_valid_to_staff_rate_str String 是 字符串表示: 有效会话转人工率
robot_valid_transfer_succ_rate Double 是 有效会话转接成功率
robot_valid_transfer_succ_rate_str String 是 字符串表示: 有效会话转接成功率
robot_valid_transfer_falid_rate Double 是 有效会话转接失败率
robot_valid_transfer_falid_rate_str String 是 字符串表示: 有效会话转接失败率
robot_in_valid_rate Double 是 无效会话率
robot_in_valid_rate_str String 是 字符串表示: 无效会话率
robot_of_visitor_direct_transfer_rate Double 是 直接转人工率
robot_of_visitor_direct_transfer_rate_str String 是 字符串表示: 直接转人工率
robot_direct_transfer_succ_rate Double 是 直接转人工成功率
robot_direct_transfer_succ_rate_str String 是 字符串表示: 直接转人工成功率
robot_direct_transfer_falid_rate Double 是 直接转人工失败率
robot_direct_transfer_falid_rate_str String 是 字符串表示: 直接转人工失败率

请求示例：

curl --location '/chat-static-api/api/robot/receptionOverview/getReceptionOverviewStatistics' \
--header 'token: 1e50ef3b9b974b62bbfc686cfd237904' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "robot_ids": "1",
    "sources": "",
    "channel_flags": "",
    "start_date": "2023-07-24",
    "end_date": "2023-08-22"
}'
1
2
3
4
5
6
7
8
9
10
11
12

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "item": {
        "robot_consult": 14,
        "robot_consult_pre": 10,
        "robot_consult_ratio": 0.4,
        "robot_consult_ratio_str": "40.00%",
        "robot_valid": 9,
        "robot_valid_pre": 2,
        "robot_valid_ratio": 3.5,
        "robot_valid_ratio_str": "350.00%",
        "robot_self": 6,
        "robot_self_pre": 2,
        "robot_self_ratio": 2.0,
        "robot_self_ratio_str": "200.00%",
        "robot_valid_to_staff": 3,
        "robot_valid_to_staff_pre": 0,
        "robot_valid_to_staff_ratio": 0.0,
        "robot_valid_to_staff_ratio_str": "0.00%",
        "robot_in_valid": 5,
        "robot_in_valid_pre": 8,
        "robot_in_valid_ratio": -0.38,
        "robot_in_valid_ratio_str": "-38.00%",
        "robot_of_visitor_direct_transfer": 5,
        "robot_of_visitor_direct_transfer_pre": 8,
        "robot_of_visitor_direct_transfer_ratio": -0.38,
        "robot_of_visitor_direct_transfer_ratio_str": "-38.00%",
        "robot_valid_consult_rate": 0.6428571428571429,
        "robot_valid_consult_rate_str": "64.29%",
        "robot_self_rate": 0.6666666666666666,
        "robot_self_rate_str": "66.67%",
        "robot_solved_rate": 0.0,
        "robot_solved_rate_str": "0.00%",
        "satisfied_rate": 0.0,
        "satisfied_rate_str": "0.00%",
        "robot_valid_to_staff_rate": 0.3333333333333333,
        "robot_valid_to_staff_rate_str": "33.33%",
        "robot_valid_transfer_succ_rate": 0.6666666666666666,
        "robot_valid_transfer_succ_rate_str": "66.67%",
        "robot_valid_transfer_falid_rate": 0.3333333333333333,
        "robot_valid_transfer_falid_rate_str": "33.33%",
        "robot_in_valid_rate": 0.35714285714285715,
        "robot_in_valid_rate_str": "35.71%",
        "robot_of_visitor_direct_transfer_rate": 0.35714285714285715,
        "robot_of_visitor_direct_transfer_rate_str": "35.71%",
        "robot_direct_transfer_succ_rate": 1.0,
        "robot_direct_transfer_succ_rate_str": "100.00%",
        "robot_direct_transfer_falid_rate": 0.0,
        "robot_direct_transfer_falid_rate_str": "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
# ● 对比图(多日期比较)

请求方式：

POST

请求地址：

/chat-static-api/api/robot/receptionOverview/getReceptionOverviewColumnarMutilDate
1

请求参数：

参数 类型 必填 描述 备注
robot_ids String 否 机器人ID 多个以英文逗号分割例"1,2"
sources String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flags String 否 子渠道类型 多个以英文逗号分割例"0_16,0_1"
start_date String 是 会话开始时间 pattern:yyyy-MM-dd
end_date String 是 会话结束时间 pattern:yyyy-MM-dd
start_date_compare String 是 对比会话开始时间 pattern:yyyy-MM-dd
end_date_compare String 是 对比会话结束时间 pattern:yyyy-MM-dd

返回参数：

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

item 对象：

参数 类型 必填 描述
robot_consult Integer 否 总会话数
robot_valid Integer 否 有效会话数
robot_in_valid Integer 否 无效会话数
robot_self Integer 否 独立接待数
robot_solved Integer 否 解决数
robot_not_solved Integer 否 未解决数(未解决会话数)
evaluate_robot Integer 否 参评数
satisfied Integer 否 满意数
dissatisfied Integer 否 不满意数
evaluate_robot_invites Integer 否 会话邀评数
robot_transfer_to_staff_total Integer 否 转人工会话总数
robot_valid_to_staff Integer 否 有效会话转人工数
robot_of_visitor_direct_transfer Integer 否 直接转人工数
robot_transfer_succ_total Integer 否 转人工成功总数
robot_valid_transfer_succ Integer 否 有效会话转接成功数
robot_direct_transfer_succ Integer 否 直接转人工且转接成功数
robot_transfer_faild_total Integer 否 转人工失败总数
robot_valid_transfer_falid Integer 否 有效会话转接失败数
robot_direct_transfer_falid Integer 否 直接转人工但转接失败数
robot_valid_consult_rate Double 否 有效会话率
robot_valid_consult_rate_str String 否 字符串表示: 有效会话率
robot_in_valid_rate Double 否 无效会话率
robot_in_valid_rate_str String 否 字符串表示: 无效会话率
robot_self_rate Double 否 独立接待率
robot_self_rate_str String 否 字符串表示: 独立接待率
robot_solved_rate Double 否 解决率
robot_solved_rate_str String 否 字符串表示: 解决率
robot_not_solved_rate Double 否 未解决率 (未解决参评数)
robot_not_solved_rate_str String 否 字符串表示: 未解决率 (未解决参评数)
robot_evaluate_invites_rate Double 否 参评率
robot_evaluate_invites_rate_str String 否 字符串表示: 参评率
satisfied_rate Double 否 满意率
satisfied_rate_str String 否 字符串表示: 满意率
dissatisfied_rate Double 否 不满意率
dissatisfied_rate_str String 否 字符串表示: 不满意率
robot_transfer_rate Double 否 整体转人工率 (转人工会话总数总会话数)
robot_transfer_rate_str String 否 字符串表示: 整体转人工率 (转人工会话总数总会话数)
robot_valid_to_staff_rate Double 否 有效会话转人工率
robot_valid_to_staff_rate_str String 否 字符串表示:有效会话转人工率
robot_of_visitor_direct_transfer_rate Double 否 直接转人工率
robot_of_visitor_direct_transfer_rate_str String 否 字符串表示: 直接转人工率
robot_transfer_succ_total_rate Double 否 整体转人工成功率
robot_transfer_succ_total_rate_str String 否 字符串表示: 整体转人工成功率
robot_valid_transfer_succ_rate Double 否 有效会话转接成功率
robot_valid_transfer_succ_rate_str String 否 字符串表示: 有效会话转接成功率
robot_direct_transfer_succ_rate Double 否 直接转人工成功率
robot_direct_transfer_succ_rate_str String 否 字符串表示: 直接转人工成功率
robot_transfer_faild_total_rate Double 否 整体转人工失败率
robot_transfer_faild_total_rate_str String 否 字符串表示: 整体转人工失败率
robot_valid_transfer_falid_rate Double 否 有效会话转接失败率
robot_valid_transfer_falid_rate_str String 否 字符串表示: 有效会话转接失败率
robot_direct_transfer_falid_rate Double 否 直接转人工失败率
robot_direct_transfer_falid_rate_str String 否 字符串表示: 直接转人工失败率

请求示例：

curl --location '/chat-static-api/api/robot/receptionOverview/getReceptionOverviewColumnarMutilDate' \
--header 'token: 1e50ef3b9b974b62bbfc686cfd237904' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "robot_ids": "1",
    "sources": "",
    "channel_flags": "",
    "start_date": "2023-07-25",
    "end_date": "2023-08-23",
    "start_date_compare": "2023-08-01",
    "end_date_compare": "2023-08-24"
}'
1
2
3
4
5
6
7
8
9
10
11
12
13
14

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "操作成功",
    "item": {
        "compare1": {
            "robot_consult": 16,
            "robot_valid": 9,
            "robot_in_valid": 7,
            "robot_self": 6,
            "robot_solved": 0,
            "robot_not_solved": 0,
            "evaluate_robot": 0,
            "satisfied": 0,
            "dissatisfied": 0,
            "evaluate_robot_invites": 0,
            "robot_transfer_to_staff_total": 10,
            "robot_valid_to_staff": 3,
            "robot_of_visitor_direct_transfer": 7,
            "robot_transfer_succ_total": 9,
            "robot_valid_transfer_succ": 2,
            "robot_direct_transfer_succ": 7,
            "robot_transfer_faild_total": 1,
            "robot_valid_transfer_falid": 1,
            "robot_direct_transfer_falid": 0,
            "robot_valid_consult_rate": 0.5625,
            "robot_valid_consult_rate_str": "56.25%",
            "robot_in_valid_rate": 0.4375,
            "robot_in_valid_rate_str": "43.75%",
            "robot_self_rate": 0.6666666666666666,
            "robot_self_rate_str": "66.67%",
            "robot_solved_rate": 0.0,
            "robot_solved_rate_str": "0.00%",
            "robot_not_solved_rate": 0.0,
            "robot_not_solved_rate_str": "0.00%",
            "robot_evaluate_invites_rate": 0.0,
            "robot_evaluate_invites_rate_str": "0.00%",
            "satisfied_rate": 0.0,
            "satisfied_rate_str": "0.00%",
            "dissatisfied_rate": 0.0,
            "dissatisfied_rate_str": "0.00%",
            "robot_transfer_rate": 0.625,
            "robot_transfer_rate_str": "62.50%",
            "robot_valid_to_staff_rate": 0.3333333333333333,
            "robot_valid_to_staff_rate_str": "33.33%",
            "robot_of_visitor_direct_transfer_rate": 0.4375,
            "robot_of_visitor_direct_transfer_rate_str": "43.75%",
            "robot_transfer_succ_total_rate": 0.9,
            "robot_transfer_succ_total_rate_str": "90.00%",
            "robot_valid_transfer_succ_rate": 0.6666666666666666,
            "robot_valid_transfer_succ_rate_str": "66.67%",
            "robot_direct_transfer_succ_rate": 1.0,
            "robot_direct_transfer_succ_rate_str": "100.00%",
            "robot_transfer_faild_total_rate": 0.1,
            "robot_transfer_faild_total_rate_str": "10.00%",
            "robot_valid_transfer_falid_rate": 0.3333333333333333,
            "robot_valid_transfer_falid_rate_str": "33.33%",
            "robot_direct_transfer_falid_rate": 0.0,
            "robot_direct_transfer_falid_rate_str": "0.00%"
        },
        "compare2": {
            "robot_consult": 13,
            "robot_valid": 8,
            "robot_in_valid": 5,
            "robot_self": 6,
            "robot_solved": 0,
            "robot_not_solved": 0,
            "evaluate_robot": 0,
            "satisfied": 0,
            "dissatisfied": 0,
            "evaluate_robot_invites": 0,
            "robot_transfer_to_staff_total": 7,
            "robot_valid_to_staff": 2,
            "robot_of_visitor_direct_transfer": 5,
            "robot_transfer_succ_total": 6,
            "robot_valid_transfer_succ": 1,
            "robot_direct_transfer_succ": 5,
            "robot_transfer_faild_total": 1,
            "robot_valid_transfer_falid": 1,
            "robot_direct_transfer_falid": 0,
            "robot_valid_consult_rate": 0.6153846153846154,
            "robot_valid_consult_rate_str": "61.54%",
            "robot_in_valid_rate": 0.38461538461538464,
            "robot_in_valid_rate_str": "38.46%",
            "robot_self_rate": 0.75,
            "robot_self_rate_str": "75.00%",
            "robot_solved_rate": 0.0,
            "robot_solved_rate_str": "0.00%",
            "robot_not_solved_rate": 0.0,
            "robot_not_solved_rate_str": "0.00%",
            "robot_evaluate_invites_rate": 0.0,
            "robot_evaluate_invites_rate_str": "0.00%",
            "satisfied_rate": 0.0,
            "satisfied_rate_str": "0.00%",
            "dissatisfied_rate": 0.0,
            "dissatisfied_rate_str": "0.00%",
            "robot_transfer_rate": 0.5384615384615384,
            "robot_transfer_rate_str": "53.85%",
            "robot_valid_to_staff_rate": 0.25,
            "robot_valid_to_staff_rate_str": "25.00%",
            "robot_of_visitor_direct_transfer_rate": 0.38461538461538464,
            "robot_of_visitor_direct_transfer_rate_str": "38.46%",
            "robot_transfer_succ_total_rate": 0.8571428571428571,
            "robot_transfer_succ_total_rate_str": "85.71%",
            "robot_valid_transfer_succ_rate": 0.5,
            "robot_valid_transfer_succ_rate_str": "50.00%",
            "robot_direct_transfer_succ_rate": 1.0,
            "robot_direct_transfer_succ_rate_str": "100.00%",
            "robot_transfer_faild_total_rate": 0.14285714285714285,
            "robot_transfer_faild_total_rate_str": "14.29%",
            "robot_valid_transfer_falid_rate": 0.5,
            "robot_valid_transfer_falid_rate_str": "50.00%",
            "robot_direct_transfer_falid_rate": 0.0,
            "robot_direct_transfer_falid_rate_str": "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
# ● 对比图(单日期)

请求方式：

POST

请求地址：

/chat-static-api/api/robot/receptionOverview/getReceptionOverviewColumnarSingle
1

请求参数：

参数 类型 必填 描述 备注
all_robot_ids String 否 全量机器人ID 多个以英文逗号分割例"1,2"
robot_ids String 否 机器人ID 多个以英文逗号分割例"1,2"
sources String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flags String 否 子渠道类型 多个以英文逗号分割例"0_16,0_1"
start_date String 否 会话开始时间 pattern:yyyy-MM-dd
end_date String 否 会话结束时间 pattern:yyyy-MM-dd

返回参数：

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

items 对象：

参数 类型 必填 描述
robot_flag String 否 机器人id
first_receive_robot_id String 否 接待机器人
robot_consult Integer 否 总会话数
robot_valid Integer 否 有效会话数
robot_in_valid Integer 否 无效会话数
robot_self Integer 否 独立接待数
robot_solved Integer 否 解决数
robot_not_solved Integer 否 未解决数(未解决会话数)
evaluate_robot Integer 否 参评数
satisfied Integer 否 满意数
dissatisfied Integer 否 不满意数
evaluate_robot_invites Integer 否 会话邀评数
robot_transfer_to_staff_total Integer 否 转人工会话总数
robot_valid_to_staff Integer 否 有效会话转人工数
robot_of_visitor_direct_transfer Integer 否 直接转人工数
robot_transfer_succ_total Integer 否 转人工成功总数
robot_valid_transfer_succ Integer 否 有效会话转接成功数
robot_direct_transfer_succ Integer 否 直接转人工且转接成功数
robot_transfer_faild_total Integer 否 转人工失败总数
robot_valid_transfer_falid Integer 否 有效会话转接失败数
robot_direct_transfer_falid Integer 否 直接转人工但转接失败数
robot_valid_consult_rate Double 否 有效会话率
robot_valid_consult_rate_str String 否 字符串表示: 有效会话率
robot_in_valid_rate Double 否 无效会话率
robot_in_valid_rate_str String 否 字符串表示: 无效会话率
robot_self_rate Double 否 独立接待率
robot_self_rate_str String 否 字符串表示: 独立接待率
robot_solved_rate Double 否 解决率
robot_solved_rate_str String 否 字符串表示: 解决率
robot_not_solved_rate Double 否 未解决率 (未解决参评数)
robot_not_solved_rate_str String 否 字符串表示: 未解决率 (未解决参评数)
robot_evaluate_invites_rate Double 否 参评率
robot_evaluate_invites_rate_str String 否 字符串表示: 参评率
satisfied_rate Double 否 满意率
satisfied_rate_str String 否 字符串表示: 满意率
dissatisfied_rate Double 否 不满意率
dissatisfied_rate_str String 否 字符串表示: 不满意率
robot_transfer_rate Double 否 整体转人工率 (转人工会话总数总会话数)
robot_transfer_rate_str String 否 字符串表示: 整体转人工率 (转人工会话总数总会话数)
robot_valid_to_staff_rate Double 否 有效会话转人工率
robot_valid_to_staff_rate_str String 否 字符串表示:有效会话转人工率
robot_of_visitor_direct_transfer_rate Double 否 直接转人工率
robot_of_visitor_direct_transfer_rate_str String 否 字符串表示: 直接转人工率
robot_transfer_succ_total_rate Double 否 整体转人工成功率
robot_transfer_succ_total_rate_str String 否 字符串表示: 整体转人工成功率
robot_valid_transfer_succ_rate Double 否 有效会话转接成功率
robot_valid_transfer_succ_rate_str String 否 字符串表示: 有效会话转接成功率
robot_direct_transfer_succ_rate Double 否 直接转人工成功率
robot_direct_transfer_succ_rate_str String 否 字符串表示: 直接转人工成功率
robot_transfer_faild_total_rate Double 否 整体转人工失败率
robot_transfer_faild_total_rate_str String 否 字符串表示: 整体转人工失败率
robot_valid_transfer_falid_rate Double 否 有效会话转接失败率
robot_valid_transfer_falid_rate_str String 否 字符串表示: 有效会话转接失败率
robot_direct_transfer_falid_rate Double 否 直接转人工失败率
robot_direct_transfer_falid_rate_str String 否 字符串表示: 直接转人工失败率

请求示例：

curl --location '/chat-static-api/api/robot/receptionOverview/getReceptionOverviewColumnarSingle' \
--header 'token: 1e50ef3b9b974b62bbfc686cfd237904' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "robot_ids": "1",
    "sources": "",
    "channel_flags": "",
    "start_date": "2023-07-24",
    "end_date": "2023-08-22",
    "all_robot_ids":"1"
}'
1
2
3
4
5
6
7
8
9
10
11
12
13

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "items": [
        {
            "robot_flag": 1,
            "first_receive_robot_id": "1",
            "robot_consult": 14,
            "robot_valid": 9,
            "robot_in_valid": 5,
            "robot_self": 6,
            "robot_solved": 0,
            "robot_not_solved": 0,
            "evaluate_robot": 0,
            "satisfied": 0,
            "dissatisfied": 0,
            "evaluate_robot_invites": 0,
            "robot_transfer_to_staff_total": 8,
            "robot_valid_to_staff": 3,
            "robot_of_visitor_direct_transfer": 5,
            "robot_transfer_succ_total": 7,
            "robot_valid_transfer_succ": 2,
            "robot_direct_transfer_succ": 5,
            "robot_transfer_faild_total": 1,
            "robot_valid_transfer_falid": 1,
            "robot_direct_transfer_falid": 0,
            "robot_valid_consult_rate": 0.6428571428571429,
            "robot_valid_consult_rate_str": "64.29%",
            "robot_in_valid_rate": 0.35714285714285715,
            "robot_in_valid_rate_str": "35.71%",
            "robot_self_rate": 0.6666666666666666,
            "robot_self_rate_str": "66.67%",
            "robot_solved_rate": 0.0,
            "robot_solved_rate_str": "0.00%",
            "robot_not_solved_rate": 0.0,
            "robot_not_solved_rate_str": "0.00%",
            "robot_evaluate_invites_rate": 0.0,
            "robot_evaluate_invites_rate_str": "0.00%",
            "satisfied_rate": 0.0,
            "satisfied_rate_str": "0.00%",
            "dissatisfied_rate": 0.0,
            "dissatisfied_rate_str": "0.00%",
            "robot_transfer_rate": 0.5714285714285714,
            "robot_transfer_rate_str": "57.14%",
            "robot_valid_to_staff_rate": 0.3333333333333333,
            "robot_valid_to_staff_rate_str": "33.33%",
            "robot_of_visitor_direct_transfer_rate": 0.35714285714285715,
            "robot_of_visitor_direct_transfer_rate_str": "35.71%",
            "robot_transfer_succ_total_rate": 0.875,
            "robot_transfer_succ_total_rate_str": "87.50%",
            "robot_valid_transfer_succ_rate": 0.6666666666666666,
            "robot_valid_transfer_succ_rate_str": "66.67%",
            "robot_direct_transfer_succ_rate": 1.0,
            "robot_direct_transfer_succ_rate_str": "100.00%",
            "robot_transfer_faild_total_rate": 0.125,
            "robot_transfer_faild_total_rate_str": "12.50%",
            "robot_valid_transfer_falid_rate": 0.3333333333333333,
            "robot_valid_transfer_falid_rate_str": "33.33%",
            "robot_direct_transfer_falid_rate": 0.0,
            "robot_direct_transfer_falid_rate_str": "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

# 满意度评价统计接口调用

# ● 数据概览

请求方式：

POST

请求地址：

/chat-static-api/api/robot/robotSatisfaction/robotSatisfaction
1

请求参数：

参数 类型 必填 描述 备注
robot_ids String 否 机器人ID 多个以英文逗号分割例"1,2"
sources String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flags String 否 子渠道类型 多个以英文逗号分割例"0_16,0_1"
start_date String 否 会话开始时间 pattern:yyyy-MM-dd
end_date String 否 会话结束时间 pattern:yyyy-MM-dd

返回参数：

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

item 对象：

参数 类型 必填 描述
robot_valid Long 否 有效会话数
robot_valid_str String 否 有效会话数环比
robot_self Long 否 独立接待数
robot_in_valid Long 否 无效会话数
evaluate_robot Long 否 参评数
evaluate_robot_str String 否 参评数
robot_solved Long 否 解决数
robot_solved_str String 否 字符串表示: 解决数
solved_rate double 否 解决率
solved_lv String 否 解决率字符
solved_lv_str String 否 字符串表示:解决率
evaluate_robot_invites Long 否 会话邀评数
satisfied Long 否 满意数
robot_not_solved Long 否 未解决数
robot_not_solved_str String 否 字符串表示: 未解决数
solved_not_rate double 否 未解决率
solved_not_lv String 否 未解决率字符表示
solved_not_lv_str String 否 字符串表示:未解决率
dissatisfied Long 否 不满意数
evaluation_participate double 否 参评率(double型小数)
evaluation_participatelv String 否 参评率(百分比格式)
evaluation_participatelv_str String 否 字符串表示: 参评率(百分比格式)

请求示例：

curl --location '/chat-static-api/api/robot/robotSatisfaction/robotSatisfaction' \
--header 'token: d56f13525ad14f279f71feec370dd2d2' \
--header 'Content-Type: application/json' \
--data '{
    "start_date": "2023-06-01",
    "end_date": "2023-08-31",
    "sources": "0,4",
    "channel_flags": "0_14,0_10,4_22",
    "robot_ids": "1,2,3"
}'
1
2
3
4
5
6
7
8
9
10

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "操作成功",
    "item": {
        "robot_valid": 0,
        "robot_valid_str": "NA",
        "robot_self": 0,
        "robot_in_valid": 0,
        "evaluate_robot": 422314,
        "evaluate_robot_str": "0.00%",
        "robot_solved": 2215,
        "robot_solved_str": "0.00%",
        "solved_rate": 0.005244912553218695,
        "solved_lv": "0.52%",
        "solved_lv_str": "0.00%",
        "evaluate_robot_invites": 0,
        "satisfied": 0,
        "robot_not_solved": 420102,
        "robot_not_solved_str": "0.00%",
        "solved_not_rate": 0.994762191165815,
        "solved_not_lv": "99.48%",
        "solved_not_lv_str": "0.00%",
        "dissatisfied": 0,
        "evaluation_participate": 0.0,
        "evaluation_participatelv": "0.00%",
        "evaluation_participatelv_str": "NA"
    }
}
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
# ● 趋势图、对比图

请求方式：

POST

请求地址：

 /chat-static-api/api/robot/robotSatisfaction/robotSatisfactionLineChart
1

请求参数：

参数 类型 必填 描述 备注
robot_ids String 否 机器人ID 多个以英文逗号分割例"1,2"
sources String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flags String 否 子渠道类型 多个以英文逗号分割例"0_16,0_1"
start_date String 否 会话开始时间 pattern:yyyy-MM-dd
end_date String 否 会话结束时间 pattern:yyyy-MM-dd
timeInterval String 否 对比时段 1-昨天，2-上周，3-上月，多个以逗号隔开，全选1,2,3，不选-0

返回参数：

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

items 对象：

参数 类型 必填 描述
coordinate Long 否 日期
itemName String 否 指标名称：有效会话数（robotValid）、参评数（evaluateRobot）、解决数（robotSolved）、未解决数（robotNotSolved）、参评率（evaluateRate）、已解决率（solvedRate）
status Long 否 独立接待数
value Long 否 1表示多天  0 表示一天

请求示例：

curl --location '/chat-static-api/api/robot/robotSatisfaction/robotSatisfactionLineChart' \
--header 'token: d56f13525ad14f279f71feec370dd2d2' \
--header 'Content-Type: application/json' \
--data '{
    "start_date": "2023-08-30",
    "end_date": "2023-08-31",
    "sources": "0,4",
    "channel_flags": "",
    "robot_ids": "1,2,3",
    "timeInterval":""
}'
1
2
3
4
5
6
7
8
9
10
11

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "操作成功",
    "items": [
        [
            {
                "coordinate": "2023-08-30",
                "itemName": "robotValid",
                "status": "1",
                "value": "0"
            },
            {
                "coordinate": "2023-08-31",
                "itemName": "robotValid",
                "status": "1",
                "value": "0"
            }
        ],
        [
            {
                "coordinate": "2023-08-30",
                "itemName": "evaluateRobot",
                "status": "1",
                "value": "0"
            },
            {
                "coordinate": "2023-08-31",
                "itemName": "evaluateRobot",
                "status": "1",
                "value": "0"
            }
        ],
        [
            {
                "coordinate": "2023-08-30",
                "itemName": "robotSolved",
                "status": "1",
                "value": "0"
            },
            {
                "coordinate": "2023-08-31",
                "itemName": "robotSolved",
                "status": "1",
                "value": "0"
            }
        ],
        [
            {
                "coordinate": "2023-08-30",
                "itemName": "robotNotSolved",
                "status": "1",
                "value": "0"
            },
            {
                "coordinate": "2023-08-31",
                "itemName": "robotNotSolved",
                "status": "1",
                "value": "0"
            }
        ],
        [
            {
                "coordinate": "2023-08-30",
                "itemName": "evaluateRate",
                "status": "1",
                "value": "0"
            },
            {
                "coordinate": "2023-08-31",
                "itemName": "evaluateRate",
                "status": "1",
                "value": "0"
            }
        ],
        [
            {
                "coordinate": "2023-08-30",
                "itemName": "solvedRate",
                "status": "1",
                "value": "0"
            },
            {
                "coordinate": "2023-08-31",
                "itemName": "solvedRate",
                "status": "1",
                "value": "0"
            }
        ]
    ]
}
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
# ● 满意度评价明细

请求方式：

POST

请求地址：

/chat-static-api/api/robot/robotSatisfaction/robotSatisfactionEvaluation
1

请求参数：

参数 类型 必填 描述 备注
robot_ids String 否 机器人ID 多个以英文逗号分割例"1,2"
sources String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flags String 否 子渠道类型 多个以英文逗号分割例"0_16,0_1"
start_date String 否 会话开始时间 pattern:yyyy-MM-dd
end_date String 否 会话结束时间 pattern:yyyy-MM-dd
solved String 否 是否已解决 多个以英文逗号分割例"1,2"，已解决（1）、未解决（2）
page String 否 页码 默认1
size String 否 每页数量 默认15

返回参数：

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

items 对象：

参数 类型 必填 描述
company_id String 否 公司ID
staff_id String 否 客服ID
staff_name String 否 客服名称
admin_name String 否
is_robot boolean 否 是否是机器人
score int 否 当为机器人时，0代表未解决，5代表解决
datetime long 否
datetime_str String 否 字符串表示:无
log_type int 否
cid String 否 会话ID
tag String 否 标签
remark String 否 备注
visitor_id String 否 访客ID
source int 否 咨询渠道
uname String 否 访客昵称
comment_type Integer 否 评价类型 主动评价1 邀请评价0
solved Integer 否 是
solved_str String 否 字符串表示:评价类型
group_name String 否 技能组名称
group_id String 否 技能组ID
visit_start_time long 会话开始时间
platform_id String 否
is_help Integer 否 帮接字段
reset_flag Integer 否 重置标记，重置时，其他所有评价字段都不展示在页面端
nps_score int 否
score_flag Integer 否

请求示例：

curl --location '/chat-static-api/api/robot/robotSatisfaction/robotSatisfactionEvaluation' \
--header 'token: d56f13525ad14f279f71feec370dd2d2' \
--header 'Content-Type: application/json' \
--data '{
    "start_date": "2023-06-30",
    "end_date": "2023-08-31",
    "sources": "0,4",
    "channel_flags": "",
    "robot_ids": "1,2,3",
    "page":"1",
    "size":"15",
    "solved":"2"
}'
1
2
3
4
5
6
7
8
9
10
11
12
13

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "操作成功",
    "page_no": 1,
    "page_count": 3,
    "total_count": 12,
    "page_size": 5,
    "items": [
        {
            "company_id": "26d36574528541b4a8eb906dbffdeb52",
            "staff_id": "1",
            "admin_name": "机器人1",
            "is_robot": true,
            "score": 0,
            "datetime": 1693378903908,
            "datetime_str": "2023-08-30 15:01:43",
            "log_type": 3,
            "cid": "111a1987b7d7483fbf2b4a0fed7c2f64",
            "tag": "回答不完整，理解能力差，回答错误，没有解决问题",
            "remark": "不同人官方的撒",
            "visitor_id": "68899aece4614a3e40a45a9c1615ac23",
            "source": 0,
            "uname": "客户24小时测试",
            "comment_type": 1,
            "solved": 0,
            "solved_str": "未解决",
            "group_name": "其他",
            "group_id": "-1",
            "visit_start_time": 1693378853107,
            "platform_id": "010",
            "is_help": 0,
            "reset_flag": 0,
            "nps_score": -1,
            "score_flag": 0
        },
        {
            "company_id": "26d36574528541b4a8eb906dbffdeb52",
            "staff_id": "1",
            "admin_name": "小智机器人-lily",
            "is_robot": true,
            "score": 0,
            "datetime": 1692760787689,
            "datetime_str": "2023-08-23 11:19:47",
            "log_type": 3,
            "cid": "083926af31df451ebfe86a779c7a8d0a",
            "tag": "",
            "remark": "才",
            "visitor_id": "ce0be0d1f2efe9b7dd82c2e000159bdb",
            "source": 0,
            "uname": "未知位置客户",
            "comment_type": 1,
            "solved": 0,
            "solved_str": "未解决",
            "group_name": "其他",
            "group_id": "-1",
            "visit_start_time": 1692760728748,
            "platform_id": "000",
            "is_help": 0,
            "reset_flag": 0,
            "nps_score": -1,
            "score_flag": 0
        },
        {
            "company_id": "26d36574528541b4a8eb906dbffdeb52",
            "staff_id": "1",
            "admin_name": "机器人1",
            "is_robot": true,
            "score": 0,
            "datetime": 1692265474774,
            "datetime_str": "2023-08-17 17:44:34",
            "log_type": 3,
            "cid": "742ec71e5f9242b1be6f173b821517ea",
            "tag": "理解能力差，回答错误，没有解决问题",
            "remark": "范德萨",
            "visitor_id": "68899aece4614a3e40a45a9c1615ac23",
            "source": 0,
            "uname": "客户24小时测试",
            "comment_type": 1,
            "solved": 0,
            "solved_str": "未解决",
            "group_name": "其他",
            "group_id": "-1",
            "visit_start_time": 1692265469251,
            "platform_id": "010",
            "is_help": 0,
            "reset_flag": 0,
            "nps_score": -1,
            "score_flag": 0
        },
        {
            "company_id": "26d36574528541b4a8eb906dbffdeb52",
            "staff_id": "1",
            "admin_name": "小智机器人-lily",
            "is_robot": true,
            "score": 0,
            "datetime": 1692067296395,
            "datetime_str": "2023-08-15 10:41:36",
            "log_type": 3,
            "cid": "41799939be8e443cb2f942930104d9e5",
            "tag": "Wrong answer",
            "remark": "发",
            "visitor_id": "9e5dccde654a8e31913014c65bead016",
            "source": 0,
            "uname": "未知位置客户",
            "comment_type": 1,
            "solved": 0,
            "solved_str": "未解决",
            "group_name": "其他",
            "group_id": "-1",
            "visit_start_time": 1692067228796,
            "platform_id": "000",
            "is_help": 0,
            "reset_flag": 0,
            "nps_score": -1,
            "score_flag": 0
        },
        {
            "company_id": "26d36574528541b4a8eb906dbffdeb52",
            "staff_id": "1",
            "admin_name": "小智机器人",
            "is_robot": true,
            "score": 0,
            "datetime": 1691401399797,
            "datetime_str": "2023-08-07 17:43:19",
            "log_type": 3,
            "cid": "e707d36fc527468f96e2b8c61ff73955",
            "tag": "",
            "remark": "",
            "visitor_id": "7084e4c52e424d3c889a32359d0f205b",
            "source": 0,
            "uname": "导出的会话",
            "comment_type": 1,
            "solved": 0,
            "solved_str": "未解决",
            "group_name": "其他",
            "group_id": "-1",
            "visit_start_time": 1691401393484,
            "platform_id": "000",
            "is_help": 0,
            "reset_flag": 0,
            "nps_score": -1,
            "score_flag": 0
        }
    ]
}
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

# 转人工统计接口调用

# ● 概览数据

请求方式：

POST

请求地址：

/chat-static-api/api/robot/transferToStaffStatistics/getTransferToStaffStatistics
1

请求参数：

参数 类型 必填 描述 备注
robot_ids String 否 机器人ID 多个以英文逗号分割例"1,2"
sources String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flags String 否 子渠道类型 多个以英文逗号分割例"0_16,0_1"
start_date String 否 会话开始时间 pattern:yyyy-MM-dd HH:mm:ss
end_date String 否 会话结束时间 pattern:yyyy-MM-dd HH:mm:ss

返回参数：

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

item 对象：

参数 类型 必填 描述
robot_consult Integer 否 总会话数
robot_transfer_to_staff_total Integer 否 转人工会话总数（有效会话转人工数+直接转人工数）
robot_transfer_to_staff_total_rate Double 否 总会话占比:(转人工会话总数/总会话数)
robot_transfer_to_staff_total_rate_str String 否 字符串表示:总会话占比:(转人工会话总数/总会话数)
robot_transfer_to_staff_total_pre Integer 否
robot_transfer_to_staff_total_ratio Double 否 转人工会话总数的环比值
robot_transfer_to_staff_total_ratio_str String 否 转人工会话总数的环比字符串表示
robot_valid_to_staff Integer 否 有效会话转人工数
robot_valid_to_staff_total_consult_rate Double 否 有效会话转人工数 总会话占比:(有效会话转人工数/总会话数)
robot_valid_to_staff_total_consult_rate_str String 否 字符串表示:有效会话转人工数总会话占比:(有效会话转人工数/总会话数)
robot_valid_to_staff_total_transfer_rate Double 否 有效会话转人工数总转人工占比:（有效会话转人工数/转人工会话总数）
robot_valid_to_staff_total_transfer_rate_str String 否 字符串表示:有效会话转人工数 总转人工占比:（有效会话转人工数/转人工会话总数）
robot_valid_to_staff_pre Integer 否
robot_valid_to_staff_ratio Double 否 有效会话转人工数的环比值
robot_valid_to_staff_ratio_str String 否 有效会话转人工数的环比字符串表示
robot_of_visitor_direct_transfer Integer 否 直接转人工数(无效会话转人工)
robot_direct_transfer_total_consult_rate Double 否 直接转人工数 总会话占比:(直接转人工数/总会话数)
robot_direct_transfer_total_consult_rate_str String 否 字符串表示:直接转人工数总会话占比:(直接转人工数/总会话数)
robot_direct_transfer_total_transfer_rate Double 否 直接转人工数总转人工占比(直接转人工数/转人工会话总数)
robot_direct_transfer_total_transfer_rate_str String 否 字符串表示:直接转人工数总转人工占比(直接转人工数/转人工会话总数)
robot_of_visitor_direct_transfer_pre Integer 否
robot_of_visitor_direct_transfer_ratio Double 否 直接转人工数的环比值
robot_of_visitor_direct_transfer_ratio_str String 否 直接转人工数的环比字符串表示
robot_to_staff_active Integer 否 客户主动点击转人工
robot_to_staff_active_total_consult_rate Double 否 客户主动点击转人工:总会话比
robot_to_staff_active_total_consult_rate_str String 否 字符串表示:客户主动点击转人工:总会话比
robot_to_staff_active_total_transfer_rate Double 否 客户主动点击转人工:总转人工占比
robot_to_staff_active_total_transfer_rate_str String 否 字符串表示:客户主动点击转人工:总转人工占比
robot_to_staff_active_pre Integer 否
robot_to_staff_active_ratio Double 否 客户主动点击转人工的环比值
robot_to_staff_active_ratio_str String 否 客户主动点击转人工的环比字符串表示
robot_to_staff_active_direct Integer 否 直接回答转人工按钮
robot_to_staff_active_direct_total_consult_rate Double 否 直接回答转人工按钮总会话比
robot_to_staff_active_direct_total_consult_rate_str String 否 字符串表示:直接回答转人工按钮总会话比
robot_to_staff_active_direct_total_transfer_rate Double 否 直接回答转人工按钮总转人工占比
robot_to_staff_active_direct_total_transfer_rate_str String 否 字符串表示:直接回答转人工按钮总转人工占比
robot_to_staff_active_direct_pre Integer 否
robot_to_staff_active_direct_ratio Double 否 直接回答转人工按钮的环比值
robot_to_staff_active_direct_ratio_str String 否 直接回答转人工按钮的环比字符串表示
robot_to_staff_active_apprehend Integer 否 理解回答转人工按钮
robot_to_staff_active_apprehend_total_consult_rate Double 否 理解回答转人工按钮:总会话比
robot_to_staff_active_apprehend_total_consult_rate_str String 否 字符串表示:理解回答转人工按钮:总会话比
robot_to_staff_active_apprehend_total_transfer_rate Double 否 理解回答转人工按钮:总转人工占比
robot_to_staff_active_apprehend_total_transfer_rate_str String 否 字符串表示:理解回答转人工按钮:总转人工占比
robot_to_staff_active_apprehend_pre Integer 否
robot_to_staff_active_apprehend_ratio Double 否 理解回答转人工按钮的环比值
robot_to_staff_active_apprehend_ratio_str String 否 理解回答转人工按钮的环比字符串表示
robot_to_staff_active_guide Integer 否 引导回答转人工按钮
robot_to_staff_active_guide_total_consult_rate Double 否 引导回答转人工按钮:总会话比
robot_to_staff_active_guide_total_consult_rate_str String 否 字符串表示:引导回答转人工按钮:总会话比
robot_to_staff_active_guide_total_transfer_rate Double 否 引导回答转人工按钮:总转人工占比
robot_to_staff_active_guide_total_transfer_rate_str String 否 字符串表示:引导回答转人工按钮:总转人工占比
robot_to_staff_active_guide_pre Integer 否
robot_to_staff_active_guide_ratio Double 否 引导回答转人工按钮的环比值
robot_to_staff_active_guide_ratio_str String 否 引导回答转人工按钮的环比字符串表示
robot_to_staff_active_unknown Integer 否 未知回答转人工按钮
robot_to_staff_active_unknown_total_consult_rate Double 否 未知回答转人工按钮:总会话比
robot_to_staff_active_unknown_total_consult_rate_str String 否 字符串表示:未知回答转人工按钮:总会话比
robot_to_staff_active_unknown_total_transfer_rate Double 否 未知回答转人工按钮:总转人工占比
robot_to_staff_active_unknown_total_transfer_rate_str String 否 字符串表示:未知回答转人工按钮:总转人工占比
robot_to_staff_active_unknown_pre Integer 否
robot_to_staff_active_unknown_ratio Double 否 未知回答转人工按钮的环比值
robot_to_staff_active_unknown_ratio_str String 否 未知回答转人工按钮的环比字符串表示
robot_to_staff_active_box Integer 否 常驻转人工按钮
robot_to_staff_active_box_total_consult_rate Double 否 常驻转人工按钮:总会话比
robot_to_staff_active_box_total_consult_rate_str String 否 字符串表示:常驻转人工按钮:总会话比
robot_to_staff_active_box_total_transfer_rate Double 否 常驻转人工按钮: 总转人工占比
robot_to_staff_active_box_total_transfer_rate_str String 否 字符串表示:常驻转人工按钮:总转人工占比
robot_to_staff_active_box_pre Integer 否
robot_to_staff_active_box_ratio Double 否 常驻转人工按钮的环比值
robot_to_staff_active_box_ratio_str String 否 常驻转人工按钮的环比字符串表示
robot_to_staff_active_feedback Integer 否
robot_to_staff_active_feedback_total_consult_rate Double 否 客户点踩后转人工:总会话比
robot_to_staff_active_feedback_total_consult_rate_str String 否 字符串表示: 客户点踩后转人工:总会话比
robot_to_staff_active_feedback_total_transfer_rate Double 否 客户点踩后转人工
robot_to_staff_active_feedback_total_transfer_rate_str String 否 字符串表示客户点踩后转人工
robot_to_staff_active_feedback_pre Integer 否
robot_to_staff_active_feedback_ratio Double 否 客户点踩后转人工的环比值
robot_to_staff_active_feedback_ratio_str String 否 客户点踩后转人工的环比字符串表示
robot_to_staff_active_multiwheel Integer 否 多轮问题转人工按钮
robot_to_staff_active_multiwheel_total_consult_rate Double 否 多轮问题转人工按钮:总会话比
robot_to_staff_active_multiwheel_total_consult_rate_str String 否 字符串表示:多轮问题转人工按钮:总会话比
robot_to_staff_active_multiwheel_total_transfer_rate Double 否 多轮问题转人工按钮:总转人工占比
robot_to_staff_active_multiwheel_total_transfer_rate_str String 否 字符串表示:多轮问题转人工按钮:总转人工占比
robot_to_staff_active_multiwheel_pre Integer 否
robot_to_staff_active_multiwheel_ratio Double 否 多轮问题转人工按钮的环比值
robot_to_staff_active_multiwheel_ratio_str String 否 多轮问题转人工按钮的环比字符串表示
robot_to_staff_trigger Integer 否 机器人触发自动转人工
robot_to_staff_trigger_total_consult_rate Double 否 机器人触发自动转人工:总会话比
robot_to_staff_trigger_total_consult_rate_str String 否 字符串表示:机器人触发自动转人工:总会话比
robot_to_staff_trigger_total_transfer_rate Double 否 机器人触发自动转人工:总转人工占比
robot_to_staff_trigger_total_transfer_rate_str String 否 字符串表示:机器人触发自动转人工:总转人工占比
robot_to_staff_trigger_pre Integer 否
robot_to_staff_trigger_ratio Double 否 机器人触发自动转人工的环比值
robot_to_staff_trigger_ratio_str String 否 机器人触发自动转人工的环比字符串表示
robot_to_staff_trigger_emotion Integer 否 情绪负向转人工
robot_to_staff_trigger_emotion_total_consult_rate Double 否 情绪负向转人工:总会话比
robot_to_staff_trigger_emotion_total_consult_rate_str String 否 字符串表示:情绪负向转人工:总会话比
robot_to_staff_trigger_emotion_total_transfer_rate Double 否 情绪负向转人工: 总转人工占比
robot_to_staff_trigger_emotion_total_transfer_rate_str String 否 字符串表示:情绪负向转人工:总转人工占比
robot_to_staff_trigger_emotion_pre Integer 否
robot_to_staff_trigger_emotion_ratio Double 否 情绪负向转人工的环比值
robot_to_staff_trigger_emotion_ratio_str String 否 情绪负向转人工的环比字符串表示
robot_to_staff_trigger_repeated Integer 否 连续重复提问转人工
robot_to_staff_trigger_repeated_total_consult_rate Double 否 连续重复提问转人工:总会话比
robot_to_staff_trigger_repeated_total_consult_rate_str String 否 字符串表示:连续重复提问转人工:总会话比
robot_to_staff_trigger_repeated_total_transfer_rate Double 否 连续重复提问转人工:总转人工占比
robot_to_staff_trigger_repeated_total_transfer_rate_str String 否 字符串表示:连续重复提问转人工:总转人工占比
robot_to_staff_trigger_repeated_pre Integer 否
robot_to_staff_trigger_repeated_ratio Double 否 连续重复提问转人工的环比值
robot_to_staff_trigger_repeated_ratio_str String 否 连续重复提问转人工的环比字符串表示
robot_to_staff_trigger_key_word Integer 否 触发关键词转人工
robot_to_staff_trigger_key_word_total_consult_rate Double 否 触发关键词转人工:总会话比
robot_to_staff_trigger_key_word_total_consult_rate_str String 否 字符串表示:触发关键词转人工:总会话比
robot_to_staff_trigger_key_word_total_transfer_rate Double 否 触发关键词转人工:总转人工占比
robot_to_staff_trigger_key_word_total_transfer_rate_str String 否 字符串表示:触发关键词转人工:总转人工占比
robot_to_staff_trigger_key_word_pre Integer 否
robot_to_staff_trigger_key_word_ratio Double 否 触发关键词转人工的环比值
robot_to_staff_trigger_key_word_ratio_str String 否 触发关键词转人工的环比字符串表示
robot_to_staff_trigger_apprehend Integer 否 理解回答触发转人工会话数
robot_to_staff_trigger_apprehend_total_consult_rate Double 否 理解回答触发转人工会话数总会话比
robot_to_staff_trigger_apprehend_total_consult_rate_str String 否 字符串表示:理解回答触发转人工会话数总会话比
robot_to_staff_trigger_apprehend_total_transfer_rate Double 否 理解回答触发转人工会话数 总转人工占比
robot_to_staff_trigger_apprehend_total_transfer_rate_str String 否 字符串表示:理解回答触发转人工会话数总转人工占比
robot_to_staff_trigger_apprehend_pre Integer 否
robot_to_staff_trigger_apprehend_ratio Double 否 理解回答触发转人工会话数的环比值
robot_to_staff_trigger_apprehend_ratio_str String 否 理解回答触发转人工会话数的环比字符串表示
robot_to_staff_trigger_guide Integer 否 引导回答触发转人工会话数
robot_to_staff_trigger_guide_total_consult_rate Double 否 引导回答触发转人工会话数总会话比
robot_to_staff_trigger_guide_total_consult_rate_str String 否 字符串表示: 引导回答触发转人工会话数总会话比
robot_to_staff_trigger_guide_total_transfer_rate Double 否 引导回答触发转人工会话数总转人工占比
robot_to_staff_trigger_guide_total_transfer_rate_str String 否 字符串表示:引导回答触发转人工会话数总转人工占比
robot_to_staff_trigger_guide_pre Integer 否
robot_to_staff_trigger_guide_ratio Double 否 引导回答触发转人工会话数的环比值
robot_to_staff_trigger_guide_ratio_str String 否 引导回答触发转人工会话数的环比字符串表示
robot_to_staff_trigger_unknown Integer 否 未知回答转人工
robot_to_staff_trigger_unknown_total_consult_rate Double 否
robot_to_staff_trigger_unknown_total_consult_rate_str String 否 字符串表示:未知回答转人工总会话比
robot_to_staff_trigger_unknown_total_transfer_rate Double 否 未知回答转人工总转人工占比
robot_to_staff_trigger_unknown_total_transfer_rate_str String 否 字符串表示:未知回答转人工总转人工占比
robot_to_staff_trigger_unknown_pre Integer 否
robot_to_staff_trigger_unknown_ratio Double 否 未知回答转人工的环比值
robot_to_staff_trigger_unknown_ratio_str String 否 未知回答转人工的环比字符串表示

请求示例：

curl --location '/chat-static-api/api/robot/transferToStaffStatistics/getTransferToStaffStatistics' \
--header 'token: 6bf8cf002c5d4575af7d915813d28f1d' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "sources": "",
    "start_date": "2023-07-26 00:00:00",
    "end_date": "2023-08-24  23:59:00",
    "robot_ids": "1",
    "channel_flags": ""
}'
1
2
3
4
5
6
7
8
9
10
11
12

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "item": {
        "robot_consult": 13,
        "robot_transfer_to_staff_total": 7,
        "robot_transfer_to_staff_total_rate": 0.5384615384615384,
        "robot_transfer_to_staff_total_rate_str": "53.85%",
        "robot_transfer_to_staff_total_pre": 8,
        "robot_transfer_to_staff_total_ratio": -0.13,
        "robot_transfer_to_staff_total_ratio_str": "-13.00%",
        "robot_valid_to_staff": 2,
        "robot_valid_to_staff_total_consult_rate": 0.15384615384615385,
        "robot_valid_to_staff_total_consult_rate_str": "15.38%",
        "robot_valid_to_staff_total_transfer_rate": 0.2857142857142857,
        "robot_valid_to_staff_total_transfer_rate_str": "28.57%",
        "robot_valid_to_staff_pre": 0,
        "robot_valid_to_staff_ratio": 0.0,
        "robot_valid_to_staff_ratio_str": "0.00%",
        "robot_of_visitor_direct_transfer": 5,
        "robot_direct_transfer_total_consult_rate": 0.38461538461538464,
        "robot_direct_transfer_total_consult_rate_str": "38.46%",
        "robot_direct_transfer_total_transfer_rate": 0.7142857142857143,
        "robot_direct_transfer_total_transfer_rate_str": "71.43%",
        "robot_of_visitor_direct_transfer_pre": 8,
        "robot_of_visitor_direct_transfer_ratio": -0.38,
        "robot_of_visitor_direct_transfer_ratio_str": "-38.00%",
        "robot_to_staff_active": 7,
        "robot_to_staff_active_total_consult_rate": 0.5384615384615384,
        "robot_to_staff_active_total_consult_rate_str": "53.85%",
        "robot_to_staff_active_total_transfer_rate": 1.0,
        "robot_to_staff_active_total_transfer_rate_str": "100.00%",
        "robot_to_staff_active_pre": 8,
        "robot_to_staff_active_ratio": -0.13,
        "robot_to_staff_active_ratio_str": "-13.00%",
        "robot_to_staff_active_direct": 0,
        "robot_to_staff_active_direct_total_consult_rate": 0.0,
        "robot_to_staff_active_direct_total_consult_rate_str": "0.00%",
        "robot_to_staff_active_direct_total_transfer_rate": 0.0,
        "robot_to_staff_active_direct_total_transfer_rate_str": "0.00%",
        "robot_to_staff_active_direct_pre": 0,
        "robot_to_staff_active_direct_ratio": 0.0,
        "robot_to_staff_active_direct_ratio_str": "0.00%",
        "robot_to_staff_active_apprehend": 0,
        "robot_to_staff_active_apprehend_total_consult_rate": 0.0,
        "robot_to_staff_active_apprehend_total_consult_rate_str": "0.00%",
        "robot_to_staff_active_apprehend_total_transfer_rate": 0.0,
        "robot_to_staff_active_apprehend_total_transfer_rate_str": "0.00%",
        "robot_to_staff_active_apprehend_pre": 0,
        "robot_to_staff_active_apprehend_ratio": 0.0,
        "robot_to_staff_active_apprehend_ratio_str": "0.00%",
        "robot_to_staff_active_guide": 0,
        "robot_to_staff_active_guide_total_consult_rate": 0.0,
        "robot_to_staff_active_guide_total_consult_rate_str": "0.00%",
        "robot_to_staff_active_guide_total_transfer_rate": 0.0,
        "robot_to_staff_active_guide_total_transfer_rate_str": "0.00%",
        "robot_to_staff_active_guide_pre": 0,
        "robot_to_staff_active_guide_ratio": 0.0,
        "robot_to_staff_active_guide_ratio_str": "0.00%",
        "robot_to_staff_active_unknown": 0,
        "robot_to_staff_active_unknown_total_consult_rate": 0.0,
        "robot_to_staff_active_unknown_total_consult_rate_str": "0.00%",
        "robot_to_staff_active_unknown_total_transfer_rate": 0.0,
        "robot_to_staff_active_unknown_total_transfer_rate_str": "0.00%",
        "robot_to_staff_active_unknown_pre": 0,
        "robot_to_staff_active_unknown_ratio": 0.0,
        "robot_to_staff_active_unknown_ratio_str": "0.00%",
        "robot_to_staff_active_box": 7,
        "robot_to_staff_active_box_total_consult_rate": 0.5384615384615384,
        "robot_to_staff_active_box_total_consult_rate_str": "53.85%",
        "robot_to_staff_active_box_total_transfer_rate": 1.0,
        "robot_to_staff_active_box_total_transfer_rate_str": "100.00%",
        "robot_to_staff_active_box_pre": 8,
        "robot_to_staff_active_box_ratio": -0.13,
        "robot_to_staff_active_box_ratio_str": "-13.00%",
        "robot_to_staff_active_feedback": 0,
        "robot_to_staff_active_feedback_total_consult_rate": 0.0,
        "robot_to_staff_active_feedback_total_consult_rate_str": "0.00%",
        "robot_to_staff_active_feedback_total_transfer_rate": 0.0,
        "robot_to_staff_active_feedback_total_transfer_rate_str": "0.00%",
        "robot_to_staff_active_feedback_pre": 0,
        "robot_to_staff_active_feedback_ratio": 0.0,
        "robot_to_staff_active_feedback_ratio_str": "0.00%",
        "robot_to_staff_active_multiwheel": 0,
        "robot_to_staff_active_multiwheel_total_consult_rate": 0.0,
        "robot_to_staff_active_multiwheel_total_consult_rate_str": "0.00%",
        "robot_to_staff_active_multiwheel_total_transfer_rate": 0.0,
        "robot_to_staff_active_multiwheel_total_transfer_rate_str": "0.00%",
        "robot_to_staff_active_multiwheel_pre": 0,
        "robot_to_staff_active_multiwheel_ratio": 0.0,
        "robot_to_staff_active_multiwheel_ratio_str": "0.00%",
        "robot_to_staff_trigger": 0,
        "robot_to_staff_trigger_total_consult_rate": 0.0,
        "robot_to_staff_trigger_total_consult_rate_str": "0.00%",
        "robot_to_staff_trigger_total_transfer_rate": 0.0,
        "robot_to_staff_trigger_total_transfer_rate_str": "0.00%",
        "robot_to_staff_trigger_pre": 0,
        "robot_to_staff_trigger_ratio": 0.0,
        "robot_to_staff_trigger_ratio_str": "0.00%",
        "robot_to_staff_trigger_emotion": 0,
        "robot_to_staff_trigger_emotion_total_consult_rate": 0.0,
        "robot_to_staff_trigger_emotion_total_consult_rate_str": "0.00%",
        "robot_to_staff_trigger_emotion_total_transfer_rate": 0.0,
        "robot_to_staff_trigger_emotion_total_transfer_rate_str": "0.00%",
        "robot_to_staff_trigger_emotion_pre": 0,
        "robot_to_staff_trigger_emotion_ratio": 0.0,
        "robot_to_staff_trigger_emotion_ratio_str": "0.00%",
        "robot_to_staff_trigger_repeated": 0,
        "robot_to_staff_trigger_repeated_total_consult_rate": 0.0,
        "robot_to_staff_trigger_repeated_total_consult_rate_str": "0.00%",
        "robot_to_staff_trigger_repeated_total_transfer_rate": 0.0,
        "robot_to_staff_trigger_repeated_total_transfer_rate_str": "0.00%",
        "robot_to_staff_trigger_repeated_pre": 0,
        "robot_to_staff_trigger_repeated_ratio": 0.0,
        "robot_to_staff_trigger_repeated_ratio_str": "0.00%",
        "robot_to_staff_trigger_key_word": 0,
        "robot_to_staff_trigger_key_word_total_consult_rate": 0.0,
        "robot_to_staff_trigger_key_word_total_consult_rate_str": "0.00%",
        "robot_to_staff_trigger_key_word_total_transfer_rate": 0.0,
        "robot_to_staff_trigger_key_word_total_transfer_rate_str": "0.00%",
        "robot_to_staff_trigger_key_word_pre": 0,
        "robot_to_staff_trigger_key_word_ratio": 0.0,
        "robot_to_staff_trigger_key_word_ratio_str": "0.00%",
        "robot_to_staff_trigger_apprehend": 0,
        "robot_to_staff_trigger_apprehend_total_consult_rate": 0.0,
        "robot_to_staff_trigger_apprehend_total_consult_rate_str": "0.00%",
        "robot_to_staff_trigger_apprehend_total_transfer_rate": 0.0,
        "robot_to_staff_trigger_apprehend_total_transfer_rate_str": "0.00%",
        "robot_to_staff_trigger_apprehend_pre": 0,
        "robot_to_staff_trigger_apprehend_ratio": 0.0,
        "robot_to_staff_trigger_apprehend_ratio_str": "0.00%",
        "robot_to_staff_trigger_guide": 0,
        "robot_to_staff_trigger_guide_total_consult_rate": 0.0,
        "robot_to_staff_trigger_guide_total_consult_rate_str": "0.00%",
        "robot_to_staff_trigger_guide_total_transfer_rate": 0.0,
        "robot_to_staff_trigger_guide_total_transfer_rate_str": "0.00%",
        "robot_to_staff_trigger_guide_pre": 0,
        "robot_to_staff_trigger_guide_ratio": 0.0,
        "robot_to_staff_trigger_guide_ratio_str": "0.00%",
        "robot_to_staff_trigger_unknown": 0,
        "robot_to_staff_trigger_unknown_total_consult_rate": 0.0,
        "robot_to_staff_trigger_unknown_total_consult_rate_str": "0.00%",
        "robot_to_staff_trigger_unknown_total_transfer_rate": 0.0,
        "robot_to_staff_trigger_unknown_total_transfer_rate_str": "0.00%",
        "robot_to_staff_trigger_unknown_pre": 0,
        "robot_to_staff_trigger_unknown_ratio": 0.0,
        "robot_to_staff_trigger_unknown_ratio_str": "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
139
140
141
142
143
144
145
146
147
148
149
# ● 未知问题转人工 Top20

请求方式：

POST

请求地址：

/chat-static-api/api/robot/transferToStaffStatistics/getTransferUnKnownTop20
1

请求参数：

参数 类型 必填 描述 备注
robot_ids String 否 机器人ID 多个以英文逗号分割例"1,2"
sources String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flags String 否 子渠道类型 多个以英文逗号分割例"0_16,0_1"
start_date String 否 会话开始时间 pattern:yyyy-MM-dd HH:mm:ss
end_date String 否 会话结束时间 pattern:yyyy-MM-dd HH:mm:ss

返回参数：

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

items 对象：

参数 类型 必填 描述
transfer_to_staff_succ_flag Integer 否 1 转人工成功 0失败
robot_valid_to_staff Integer 否 有效会话触发转人工
robot_of_visitor_direct_transfer Integer 否 直接转人工会话数
hit_id String 否 机器人回答转人工时为docId, 未知问题转人工时为 问题的md5
question_hit Double 否 命中数
transfer_to_staff_succ_rate Double 否 转人工占比(提问次数/转人工会话总数)
transfer_to_staff_succ_rate_str String 否 转人工占比 百分比形式
unknown_question String 否 未知问题文本

请求示例：

curl --location '/chat-static-api/api/robot/transferToStaffStatistics/getTransferUnKnownTop20' \
--header 'token: 6bf8cf002c5d4575af7d915813d28f1d' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "sources": "",
    "start_date": "2023-07-26 00:00:00",
    "end_date": "2023-08-24  23:59:00",
    "robot_ids": "1",
    "channel_flags": ""
}'
1
2
3
4
5
6
7
8
9
10
11
12

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "items": [
        {
            "transfer_to_staff_succ_flag": 1,
            "robot_valid_to_staff": 40,
            "robot_of_visitor_direct_transfer": 307,
            "hit_id": "3816b273a9fb84920412b2f9e4e8be2d",
            "question_hit": 1,
            "transfer_to_staff_succ_rate": 0.002881844380403458,
            "transfer_to_staff_succ_rate_str": "0.29%"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# ● 机器人回答转人工 Top20

请求方式：

POST

请求地址：

/chat-static-api/api/robot/transferToStaffStatistics/getTransferRobotAnswerTop20
1

请求参数：

参数 类型 必填 描述 备注
robot_ids String 否 机器人ID 多个以英文逗号分割例"1,2"
sources String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flags String 否 子渠道类型 多个以英文逗号分割例"0_16,0_1"
start_date String 否 会话开始时间 pattern:yyyy-MM-dd HH:mm:ss
end_date String 否 会话结束时间 pattern:yyyy-MM-dd HH:mm:ss

返回参数：

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

items 对象：

参数 类型 必填 描述
transfer_to_staff_succ_flag Integer 否 1 转人工成功 0失败
robot_valid_to_staff Integer 否 有效会话触发转人工
robot_of_visitor_direct_transfer Integer 否 直接转人工会话数
hit_id String 否 机器人回答转人工时为docId, 未知问题转人工时为 问题的md5
question_title String 否 标问
question_hit Double 否 命中数
transfer_to_staff_succ_rate Double 否 转人工占比 (命中次数/转人工会话总数)
transfer_to_staff_succ_rate_str String 否 转人工占比 百分比形式
kb_id String 否 知识库id
kb_name String 否 知识库名称

请求示例：

curl --location '/chat-static-api/api/robot/transferToStaffStatistics/getTransferRobotAnswerTop20' \
--header 'token: 6bf8cf002c5d4575af7d915813d28f1d' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "sources": "",
    "start_date": "2023-07-26 00:00:00",
    "end_date": "2023-08-24  23:59:00",
    "robot_ids": "1",
    "channel_flags": ""
}'
1
2
3
4
5
6
7
8
9
10
11
12

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "items": [
        {
            "transfer_to_staff_succ_flag": 1,
            "robot_valid_to_staff": 40,
            "robot_of_visitor_direct_transfer": 307,
            "hit_id": "c97f8b370bd642c5b1e4e0b5abeb90f1",
            "question_title": "文件+图片",
            "question_hit": 1,
            "transfer_to_staff_succ_rate": 0.002881844380403458,
            "transfer_to_staff_succ_rate_str": "0.29%",
            "kb_id": "1",
            "kb_name": "小智机器人"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# ● 关键词转人工 Top20

请求方式：

POST

请求地址：

/chat-static-api/api/robot/transferToStaffStatistics/getTransferKeyWordTop20
1

请求参数：

参数 类型 必填 描述 备注
robot_ids String 否 机器人ID 多个以英文逗号分割例"1,2"
sources String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flags String 否 子渠道类型 多个以英文逗号分割例"0_16,0_1"
start_date String 否 会话开始时间 pattern:yyyy-MM-dd HH:mm:ss
end_date String 否 会话结束时间 pattern:yyyy-MM-dd HH:mm:ss

返回参数：

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

items 对象：

参数 类型 必填 描述
transfer_to_staff_succ_flag Integer 否 1 转人工成功 0失败
robot_valid_to_staff Integer 否 有效会话触发转人工
robot_of_visitor_direct_transfer Integer 否 直接转人工会话数
robot_to_staff_trigger_key_word Integer 否 触发关键词转人工:
transfer_to_staff_succ_rate Double 否 转人工占比 (关键词转人工数/转人工会话总数)
transfer_to_staff_succ_rate_str String 否 转人工占比 百分比形式
hit_keyword String 否 关键词

请求示例：

curl --location '/chat-static-api/api/robot/transferToStaffStatistics/getTransferKeyWordTop20' \
--header 'token: 6bf8cf002c5d4575af7d915813d28f1d' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "sources": "",
    "start_date": "2023-07-26 00:00:00",
    "end_date": "2023-08-24 23:59:00",
    "robot_ids": "1",
    "channel_flags": ""
}'
1
2
3
4
5
6
7
8
9
10
11
12

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "items": [
        {
            "transfer_to_staff_succ_flag": 1,
            "robot_valid_to_staff": 3,
            "robot_of_visitor_direct_transfer": 18,
            "robot_to_staff_trigger_key_word": 1,
            "transfer_to_staff_succ_rate": 0.047619047619047616,
            "transfer_to_staff_succ_rate_str": "4.76%",
            "hit_keyword": "本兮"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# ● 转人工会话记录(分页)

请求方式：

POST

请求地址：

/chat-static-api/api/robot/transferToStaffStatistics/getTransferSessionRecordPage
1

请求参数：

参数 类型 必填 描述 备注
robot_ids String 否 机器人ID 多个以英文逗号分割例"1,2"
sources String 否 渠道类型 多个以英文逗号分割例"1,2"
channel_flags String 否 子渠道类型 多个以英文逗号分割例"0_16,0_1"
start_date String 否 会话开始时间 pattern:yyyy-MM-dd HH:mm:ss
end_date String 否 会话结束时间 pattern:yyyy-MM-dd HH:mm:ss
page_no String 是 当前页 默认1
page_size String 是 页面条数 默认15
transfer_types String 否 转人工类型 多个以英文逗号分割例"1,2"
transfer_keyword String 否 转人工关键词(可以是 关键词全文本 也可以是 关键词的id)

返回参数：

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

items 对象：

参数 类型 必填 描述
uname String 否 客户昵称
partner_id String 否 客户对接id
realname String 否 客户姓名
visitor_id String 否 客户id
ip String 否 客户访问ip
ip_address String 否 客户地域
is_vip Integer 否 是否VIP会员
is_new String 否 新老客户
email String 否 客户邮箱
tel String 否 客户电话
qq String 否 客户qq
city_name String 否 城市
remark String 否 客户备注
enterprise_name String 否 企业name(客户他自己 的客户的所属企业)
os String 否 使用系统 1.windows_xp 2.windows_7 3.windows_8 4.windows_vista 5.windows 6.linux 7.mac_os 8.android 9.ios 11.windows_2000 12.windows_10 10.其他
terminal String 否 访问终端
chat_end_time Long 否 会话结束时间
session_recep_duration long 否 会话接待时长
queue_duration Long 否 排队时长=排队接通时长+离开时长
human_accept_queue_duration Long 否 排队接待时长
human_leave_queue_duration Long 否 排队离开时长
access_staff_time Long 否 接入人工客服时间
cid String 否 会话id
company_id String 否 公司id
robot_recep_duration Long 否 与机器人会话时长
robot_recep_duration_str String 否 与机器人会话时长(00:00:00 表现形式字符串)
robot_transfer_str String 否 转人工类型(以逗号分割)
robot_transfer_flag Integer 否 转人工结果 1 转接成功 0 转接失败
robot_transfer_types String 否 转人工类型（字符串表现）
robot_transfer_result String 否 转人工结果(字符串表现)
source_str String 否 渠道类型Str
source Integer 否 渠道类型编号
channel_name String 否 子渠道名称
channel_flag String 否 子渠道编号
chat_start_time Long 否 会话创建时间
chat_start_time_str String 否 会话创建时间 str
robot_valid_to_staff Integer 否 有效会话转人工
robot_of_visitor_direct_transfer Integer 否 直接转人工
if_valid_transfer_str String 否 转人工会话类型

请求示例：

curl --location '/chat-static-api/api/robot/transferToStaffStatistics/getTransferSessionRecordPage' \
--header 'token: 5e1ba2acd5ef42e48ff391574bb94c25' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "sources": "",
    "start_date": "2023-07-30 00:00:00",
    "end_date": "2023-08-28  23:59:00",
    "robot_ids": "1",
    "channel_flags": "",
    "transfer_types": "1,3,6,4,7,2,8,9,10,11,13,12,5",
    "transfer_keyword": "",
    "page_no": "1",
    "page_size": "15"
}'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "page_no": 1,
    "page_count": 1,
    "total_count": 7,
    "page_size": 15,
    "items": [
        {
            "uname": "未知位置0823-3590",
            "partner_id": "",
            "realname": "",
            "visitor_id": "91e441160ac04325a38f42b944d286ba",
            "ip": "192.168.7.5",
            "ip_address": "未知位置",
            "is_vip": -1,
            "is_new": "1",
            "email": "",
            "tel": "",
            "qq": "",
            "city_name": "",
            "remark": "",
            "enterprise_name": "",
            "os": "10",
            "terminal": "Google Chrome",
            "chat_end_time": 1692776414707,
            "session_recep_duration": 954466,
            "queue_duration": 0,
            "human_accept_queue_duration": 0,
            "human_leave_queue_duration": 0,
            "access_staff_time": 1692775452159,
            "cid": "36768b6706dd4c6f9fa39a3e49ea2e7a",
            "company_id": "8d8a61706066470f98a1ba02d6b6d7a5",
            "robot_recep_duration": 0,
            "robot_recep_duration_str": "00:00:00",
            "robot_transfer_str": "5",
            "robot_transfer_flag": 1,
            "robot_transfer_types": "常驻转人工按钮",
            "robot_transfer_result": "转接成功",
            "source": 0,
            "channel_name": "默认桌面网站",
            "channel_flag": "1",
            "chat_start_time": 1692775450410,
            "robot_valid_to_staff": 0,
            "robot_of_visitor_direct_transfer": 1,
            "if_valid_transfer_str": "有效会话转人工"
        },
        {
            "uname": "未知位置0816-0858",
            "partner_id": "",
            "realname": "",
            "visitor_id": "a932be06e57b497aace8da7f2a379992",
            "ip": "192.168.7.5",
            "ip_address": "未知位置",
            "is_vip": 0,
            "is_new": "0",
            "email": "",
            "tel": "",
            "qq": "",
            "city_name": "",
            "remark": "",
            "enterprise_name": "",
            "os": "10",
            "terminal": "Google Chrome",
            "chat_end_time": 1692773860572,
            "session_recep_duration": 333150,
            "queue_duration": 5933,
            "human_accept_queue_duration": 5933,
            "human_leave_queue_duration": 0,
            "access_staff_time": 1692773513647,
            "cid": "77fe8af12f594332a229c979c2642212",
            "company_id": "8d8a61706066470f98a1ba02d6b6d7a5",
            "robot_recep_duration": 0,
            "robot_recep_duration_str": "00:00:00",
            "robot_transfer_str": "5",
            "robot_transfer_flag": 1,
            "robot_transfer_types": "常驻转人工按钮",
            "robot_transfer_result": "转接成功",
            "source": 0,
            "channel_name": "默认桌面网站",
            "channel_flag": "1",
            "chat_start_time": 1692773044843,
            "robot_valid_to_staff": 0,
            "robot_of_visitor_direct_transfer": 1,
            "if_valid_transfer_str": "有效会话转人工"
        },
        {
            "uname": "未知位置0816-2392",
            "partner_id": "",
            "realname": "",
            "visitor_id": "4a1ebdf1ecb944fbbd6a0a0b6344c4c6",
            "ip": "192.168.7.5",
            "ip_address": "未知位置",
            "is_vip": -1,
            "is_new": "1",
            "email": "",
            "tel": "",
            "qq": "",
            "city_name": "",
            "remark": "",
            "enterprise_name": "",
            "os": "5",
            "terminal": "Google Chrome",
            "chat_end_time": 1692175283815,
            "session_recep_duration": 412994,
            "queue_duration": 0,
            "human_accept_queue_duration": 0,
            "human_leave_queue_duration": 0,
            "access_staff_time": 1692174868595,
            "cid": "60217c41494b4945ba31a5f24f494ea9",
            "company_id": "8d8a61706066470f98a1ba02d6b6d7a5",
            "robot_recep_duration": 3,
            "robot_recep_duration_str": "00:00:00",
            "robot_transfer_str": "5",
            "robot_transfer_flag": 1,
            "robot_transfer_types": "常驻转人工按钮",
            "robot_transfer_result": "转接成功",
            "source": 0,
            "channel_name": "默认桌面网站",
            "channel_flag": "1",
            "chat_start_time": 1692174866021,
            "robot_valid_to_staff": 1,
            "robot_of_visitor_direct_transfer": 0,
            "if_valid_transfer_str": "有效会话转人工"
        },
        {
            "uname": "未知位置0816-4994",
            "partner_id": "",
            "realname": "",
            "visitor_id": "95b4b09c5ae940d1a9674e66240306f0",
            "ip": "192.168.7.5",
            "ip_address": "未知位置",
            "is_vip": -1,
            "is_new": "1",
            "email": "",
            "tel": "",
            "qq": "",
            "city_name": "",
            "remark": "",
            "enterprise_name": "",
            "os": "5",
            "terminal": "Google Chrome",
            "chat_end_time": 1692175283752,
            "session_recep_duration": 0,
            "queue_duration": 0,
            "human_accept_queue_duration": 0,
            "human_leave_queue_duration": 0,
            "access_staff_time": 1692174851712,
            "cid": "23b07bd7faaa489081db291a51d482f0",
            "company_id": "8d8a61706066470f98a1ba02d6b6d7a5",
            "robot_recep_duration": 0,
            "robot_recep_duration_str": "00:00:00",
            "robot_transfer_str": "5",
            "robot_transfer_flag": 1,
            "robot_transfer_types": "常驻转人工按钮",
            "robot_transfer_result": "转接成功",
            "source": 0,
            "channel_name": "默认桌面网站",
            "channel_flag": "1",
            "chat_start_time": 1692174712859,
            "robot_valid_to_staff": 0,
            "robot_of_visitor_direct_transfer": 1,
            "if_valid_transfer_str": "有效会话转人工"
        },
        {
            "uname": "未知位置0811-5060",
            "partner_id": "",
            "realname": "",
            "visitor_id": "66c2f1e8b43144bbaec492dd7787411e",
            "ip": "192.168.7.5",
            "ip_address": "未知位置",
            "is_vip": -1,
            "is_new": "1",
            "email": "",
            "tel": "",
            "qq": "",
            "city_name": "",
            "remark": "",
            "enterprise_name": "",
            "os": "5",
            "terminal": "Firefox",
            "chat_end_time": 1691725867321,
            "session_recep_duration": 4314,
            "queue_duration": 0,
            "human_accept_queue_duration": 0,
            "human_leave_queue_duration": 0,
            "access_staff_time": 1691725845256,
            "cid": "f69ffdaf0d00478daf2fede1deadc2df",
            "company_id": "8d8a61706066470f98a1ba02d6b6d7a5",
            "robot_recep_duration": 0,
            "robot_recep_duration_str": "00:00:00",
            "robot_transfer_str": "5",
            "robot_transfer_flag": 1,
            "robot_transfer_types": "常驻转人工按钮",
            "robot_transfer_result": "转接成功",
            "source": 0,
            "channel_name": "默认桌面网站",
            "channel_flag": "1",
            "chat_start_time": 1691725828026,
            "robot_valid_to_staff": 0,
            "robot_of_visitor_direct_transfer": 1,
            "if_valid_transfer_str": "有效会话转人工"
        },
        {
            "uname": "未知位置0807-1011",
            "partner_id": "",
            "realname": "",
            "visitor_id": "010b6f0472ed489ab9cc341ca79d47a5",
            "ip": "192.168.7.5",
            "ip_address": "未知位置",
            "is_vip": -1,
            "is_new": "1",
            "email": "",
            "tel": "",
            "qq": "",
            "city_name": "",
            "remark": "",
            "enterprise_name": "",
            "os": "5",
            "terminal": "Google Chrome",
            "chat_end_time": 1691390424274,
            "session_recep_duration": 4201,
            "queue_duration": 0,
            "human_accept_queue_duration": 0,
            "human_leave_queue_duration": 0,
            "access_staff_time": 1691388788941,
            "cid": "08d1b8eeb78a48ae9e02a31b29b9c56e",
            "company_id": "8d8a61706066470f98a1ba02d6b6d7a5",
            "robot_recep_duration": 0,
            "robot_recep_duration_str": "00:00:00",
            "robot_transfer_str": "5",
            "robot_transfer_flag": 1,
            "robot_transfer_types": "常驻转人工按钮",
            "robot_transfer_result": "转接成功",
            "source": 0,
            "channel_name": "默认桌面网站",
            "channel_flag": "1",
            "chat_start_time": 1691388788694,
            "robot_valid_to_staff": 0,
            "robot_of_visitor_direct_transfer": 1,
            "if_valid_transfer_str": "有效会话转人工"
        },
        {
            "uname": "未知位置0807-5652",
            "partner_id": "",
            "realname": "",
            "visitor_id": "cf36e3d8c59c4eeaa40b86da7edfcda0",
            "ip": "192.168.7.5",
            "ip_address": "未知位置",
            "is_vip": -1,
            "is_new": "1",
            "email": "",
            "tel": "",
            "qq": "",
            "city_name": "",
            "remark": "",
            "enterprise_name": "",
            "os": "10",
            "terminal": "Google Chrome",
            "chat_end_time": 1691388002375,
            "session_recep_duration": 10074,
            "queue_duration": 0,
            "human_accept_queue_duration": 0,
            "human_leave_queue_duration": 0,
            "access_staff_time": 0,
            "cid": "e830240240374bb39de9b561c79d6572",
            "company_id": "8d8a61706066470f98a1ba02d6b6d7a5",
            "robot_recep_duration": 10074,
            "robot_recep_duration_str": "00:00:10",
            "robot_transfer_str": "5",
            "robot_transfer_flag": 0,
            "robot_transfer_types": "常驻转人工按钮",
            "robot_transfer_result": "转接失败",
            "source": 0,
            "channel_name": "默认桌面网站",
            "channel_flag": "1",
            "chat_start_time": 1691387889557,
            "robot_valid_to_staff": 1,
            "robot_of_visitor_direct_transfer": 0,
            "if_valid_transfer_str": "有效会话转人工"
        }
    ]
}
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
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283

# 知识运营统计接口调用

# ● 客服工作量统计-知识库概览

请求方式：

POST

请求地址：

/chat-static-api/api/robot/staffWorkStatis/getKbOverview
1

请求参数：

参数 类型 必填 描述 备注
robot_ids String 否 机器人ID 多个以英文逗号分割例"1,2"
version String 否 查询版本 v6（6）、v1（1），默认6

返回参数：

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

item 对象：

参数 类型 必填 描述
doc_total_count Integer 否 知识总数
doc_single_count Integer 否 单轮问题
doc_multi_count Integer 否 多轮问题
doc_deactivate_count Integer 否 无效知识数
doc_enable_count Integer 否 有效知识数
doc_intellect_pending_count Integer 否 智能学习待处理数
doc_un_know_pending_count Integer 否 未知问题待处理数
doc_un_take_pending_count Integer 否 引导未采纳待处理数
doc_silent_count Integer 否 沉寂知识数
doc_single_deactivate_count Integer 否 单轮问题(停用)
doc_multi_deactivate_count Integer 否 多轮问题(停用)
doc_single_enable_count Integer 否 单论问题(启用)
doc_multi_enable_count Integer 否 多轮问题(启用)
doc_feed_back_count Integer 否 点踩问题待处理数
doc_transfer_count Integer 否 转人工问题待处理数
kb_count Integer 否 知识库总数
doc_ai_qa_info_count Integer 否 AI应答学习待处理数

请求示例：

curl --location '/chat-static-api/api/robot/staffWorkStatis/getKbOverview' \
--header 'token: c84f8b6f5885434da40d8449eb15c7f1' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "robot_ids":"0,1"
}'
1
2
3
4
5
6
7
8

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "操作成功",
    "item": {
        "doc_total_count": 57,
        "doc_single_count": 55,
        "doc_multi_count": 2,
        "doc_deactivate_count": 5,
        "doc_enable_count": 52,
        "doc_intellect_pending_count": 0,
        "doc_un_know_pending_count": 13,
        "doc_un_take_pending_count": 0,
        "doc_silent_count": 29,
        "doc_single_deactivate_count": 5,
        "doc_multi_deactivate_count": 0,
        "doc_single_enable_count": 50,
        "doc_multi_enable_count": 2,
        "doc_feed_back_count": 0,
        "doc_transfer_count": 0,
        "kb_count": 0,
        "doc_ai_qa_info_count": 0
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# ● 客服工作量统计-工作统计（分页）

请求方式：

POST

请求地址：

/chat-static-api/api/robot/staffWorkStatis/StaffWorkStatis
1

请求参数：

参数 类型 必填 描述 备注
robot_ids List 否 机器人ID ["1","2"]
source_ids List 否 渠道类型 ["1","2"]
channel_flags List 否 子渠道类型 ["0_16","0_1"]
start_date String 否 操作开始时间 pattern:yyyy-MM-dd HH:mm:ss
end_date String 否 操作结束时间 pattern:yyyy-MM-dd HH:mm:ss
page_no String 否 页码 默认1
page_size String 否 每页数量 默认15,最大允许为100,如果超过100则重置为100
staff_ids String 否 客服ID，多个以英文逗号分割
version String 否 查询版本 v6（6）、v1（1），默认6

返回参数：

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

items 对象：

参数 类型 必填 描述
str_operator_service_id String 否 客服id
operator_service_name String 否 客服名称
add_batch_doc Integer 否 新增问题(单轮)
update_robot_doc Integer 否 更新问题(单轮)
del_doc_total Integer 否 删除问题(单轮)
enable_doc_total Integer 否 启用问题(单轮)
stop_doc_total Integer 否 停用问题(单轮)
move_doc_total Integer 否 转移问题(单轮)
copy_doc_total Integer 否 复制问题(单轮)
link_batch_doc Integer 否 单相似问法学习(单轮)
import_kb_doc Integer 否 导入问题(单轮)
add_multi_doc Integer 否 新增问题(多轮)
update_multi_doc Integer 否 更新问题(多轮)
del_batch_multi_doc Integer 否 删除问题(多轮)
enable_batch_multi_doc Integer 否 启用问题(多轮)
stop_batch_multi_doc Integer 否 停用问题(多轮)
save_multi_process_info Integer 否 新增流程(多轮)
update_multi_process_info Integer 否 更新流程(多轮)
delete_multi_process Integer 否 删除流程(多轮)
link_batch_multi_doc Integer 否 相似问法学习(多轮)
delay_un_known_doc Integer 否 延后处理问题
add_forever_ignore_by_unknown Integer 否 永久忽略问题
ignore_batch_doc Integer 否 忽略问题 (未知问题忽略问题+智能学习忽略问题)
del_forever_ignore Integer 否 永久忽略问题-删除问题
add_interface Integer 否 新增接口
update_interface Integer 否 更新接口
delete_interface Integer 否 删除接口
add_prv_word_same Integer 否 新增同义词
update_prv_word_same Integer 否 更新同义词
delete_prv_word_same Integer 否 删除同义词
import_prv_word_same Integer 否 导入同义词
add_professional_word Integer 否 新增专业名词
update_professional_word Integer 否 更新专业名词
delete_professional_word Integer 否 删除专业名词
import_professional_word Integer 否 导入专业名词
add_variable Integer 否 新增变量
update_variable Integer 否 更新变量
del_variable Integer 否 删除变量
add_entity Integer 否 新增实体 新增关键词实体+新增语义实体
update_entity Integer 否 更新实体 更新关键词实体+更新语义实体
delete_entity Integer 否 删除实体 删除关键词实体+删除语义实体
enable_entity Integer 否 启用实体 启用关键词实体+启用语义实体
stop_semantice_entity Integer 否 停用实体 停用关键词实体+停用语义实体
add_greet_doc Integer 否 新增问题(寒暄)
update_greet_doc Integer 否 更新问题(寒暄)
delete_greet_doc Integer 否 删除问题(寒暄)
import_greet_doc Integer 否 导入问题(寒暄)
ignore_transfer_question Integer 否 转人工学习-- 永久忽略问题
del_transfer_question Integer 否 转人工学习-- 删除问题
remove_ignore_question Integer 否 转人工学习-- 删除永久忽略问题
delete_feed_back_question_info Integer 否 点踩问题学习-删除问题
delete_ai_qa_info Integer 否 AI应答学习-删除问题
add_robot_kb Integer 否 新增知识库
update_robot_kb Integer 否 编辑知识库
add_robot_kb_rel Integer 否 关联知识库
cancel_robot_kb_rel Integer 否 解绑知识库
delete_robot_kb Integer 否 删除知识库
add_robot_admin Integer 否 新增管理员
delete_robot_admin Integer 否 删除管理员
update_robot_info Integer 否 修改机器人信息
faq_extraction_times Integer 否 知识抽取次数
faq_extraction_question_count Integer 否 抽取问答对数量
faq_extraction_similar_question_count Integer 否 丰富相似问数量
del_faq_extraction_question_count Integer 否 删除问答对数量
create_similar_question Integer 否 优化或生成相似问
use_similar_question Integer 否 使用相似问
create_answer Integer 否 生成答案
optimize_answer Integer 否 优化答案
use_answer Integer 否 使用答案

请求示例：

curl --location '/chat-static-api/api/robot/staffWorkStatis/StaffWorkStatis' \
--header 'token: c84f8b6f5885434da40d8449eb15c7f1' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "robot_ids": "0",
    "start_date": "2023-04-01 18:01:00",
    "end_date": "2023-06-30 18:01:00",
    "staff_ids": "",
    "page_no": "1",
    "page_size": "2",
    "version": "6"
}'
1
2
3
4
5
6
7
8
9
10
11
12
13
14

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "操作成功",
    "page_no": 1,
    "page_count": 8,
    "total_count": 16,
    "page_size": 2,
    "items": [
        {
            "operator_service_name": "Baoxin真实姓名",
            "add_batch_doc": 0,
            "update_robot_doc": 0,
            "del_doc_total": 0,
            "enable_doc_total": 0,
            "stop_doc_total": 0,
            "move_doc_total": 0,
            "copy_doc_total": 0,
            "link_batch_doc": 0,
            "import_kb_doc": 0,
            "add_multi_doc": 0,
            "update_multi_doc": 0,
            "del_batch_multi_doc": 0,
            "enable_batch_multi_doc": 0,
            "stop_batch_multi_doc": 0,
            "save_multi_process_info": 0,
            "update_multi_process_info": 0,
            "delete_multi_process": 0,
            "link_batch_multi_doc": 0,
            "delay_un_known_doc": 0,
            "add_forever_ignore_by_unknown": 0,
            "ignore_batch_doc": 0,
            "del_forever_ignore": 0,
            "add_interface": 0,
            "update_interface": 0,
            "delete_interface": 0,
            "add_prv_word_same": 0,
            "update_prv_word_same": 0,
            "delete_prv_word_same": 0,
            "import_prv_word_same": 0,
            "add_professional_word": 0,
            "update_professional_word": 0,
            "delete_professional_word": 0,
            "import_professional_word": 0,
            "add_variable": 0,
            "update_variable": 0,
            "del_variable": 0,
            "add_entity": 1,
            "update_entity": 1,
            "delete_entity": 1,
            "enable_entity": 0,
            "stop_semantice_entity": 0,
            "add_greet_doc": 4,
            "update_greet_doc": 0,
            "delete_greet_doc": 4,
            "import_greet_doc": 0,
            "ignore_transfer_question": 0,
            "del_transfer_question": 0,
            "remove_ignore_question": 0,
            "delete_feed_back_question_info": 0,
            "delete_ai_qa_info": 0,
            "add_robot_kb": 0,
            "update_robot_kb": 0,
            "add_robot_kb_rel": 0,
            "cancel_robot_kb_rel": 0,
            "delete_robot_kb": 0,
            "add_robot_admin": 0,
            "delete_robot_admin": 0,
            "update_robot_info": 0,
            "faq_extraction_times": 0,
            "faq_extraction_question_count": 0,
            "faq_extraction_similar_question_count": 0,
            "del_faq_extraction_question_count": 0,
            "create_similar_question": 0,
            "use_similar_question": 0,
            "create_answer": 0,
            "optimize_answer": 0,
            "use_answer": 0
        },
        {
            "operator_service_name": "lily清明",
            "add_batch_doc": 0,
            "update_robot_doc": 0,
            "del_doc_total": 0,
            "enable_doc_total": 0,
            "stop_doc_total": 0,
            "move_doc_total": 0,
            "copy_doc_total": 0,
            "link_batch_doc": 0,
            "import_kb_doc": 0,
            "add_multi_doc": 0,
            "update_multi_doc": 0,
            "del_batch_multi_doc": 0,
            "enable_batch_multi_doc": 0,
            "stop_batch_multi_doc": 0,
            "save_multi_process_info": 0,
            "update_multi_process_info": 0,
            "delete_multi_process": 0,
            "link_batch_multi_doc": 0,
            "delay_un_known_doc": 0,
            "add_forever_ignore_by_unknown": 0,
            "ignore_batch_doc": 0,
            "del_forever_ignore": 0,
            "add_interface": 0,
            "update_interface": 0,
            "delete_interface": 0,
            "add_prv_word_same": 0,
            "update_prv_word_same": 0,
            "delete_prv_word_same": 0,
            "import_prv_word_same": 0,
            "add_professional_word": 0,
            "update_professional_word": 0,
            "delete_professional_word": 0,
            "import_professional_word": 0,
            "add_variable": 0,
            "update_variable": 0,
            "del_variable": 0,
            "add_entity": 0,
            "update_entity": 0,
            "delete_entity": 0,
            "enable_entity": 0,
            "stop_semantice_entity": 0,
            "add_greet_doc": 1,
            "update_greet_doc": 0,
            "delete_greet_doc": 0,
            "import_greet_doc": 0,
            "ignore_transfer_question": 0,
            "del_transfer_question": 0,
            "remove_ignore_question": 0,
            "delete_feed_back_question_info": 0,
            "delete_ai_qa_info": 0,
            "add_robot_kb": 0,
            "update_robot_kb": 0,
            "add_robot_kb_rel": 0,
            "cancel_robot_kb_rel": 0,
            "delete_robot_kb": 0,
            "add_robot_admin": 0,
            "delete_robot_admin": 0,
            "update_robot_info": 0,
            "faq_extraction_times": 0,
            "faq_extraction_question_count": 0,
            "faq_extraction_similar_question_count": 0,
            "del_faq_extraction_question_count": 0,
            "create_similar_question": 0,
            "use_similar_question": 0,
            "create_answer": 0,
            "optimize_answer": 0,
            "use_answer": 0
        }
    ]
}
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
# ● 运营记录-操作日志明细（分页）

请求方式：

POST

请求地址：

/chat-static-api/api/robot/staffWorkStatis/getReceptionStatistDetailPage
1

请求参数：

参数 类型 必填 描述 备注
robot_ids String 否 机器人ID 多个以英文逗号分割例"1,2"
start_date String 否 操作开始时间 pattern:yyyy-MM-dd HH:mm:ss
end_date String 否 操作结束时间 pattern:yyyy-MM-dd HH:mm:ss
page_no String 否 页码 默认1
page_size String 否 每页数量 默认15,最大允许为100,如果超过100则重置为100
staff_ids String 否 客服ID，多个以英文逗号分割
version String 否 查询版本 v6（6）、v1（1），默认6
ret_code String 否 操作结果 成功（1）、失败（2）、其他（3）
operate_types String 否 操作方式 多个以英文逗号分割"1,2,3"，单次操作（1）、批量操作（2）、导入操作（3）
content String 否 关键词

返回参数：

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

items 对象：

参数 类型 必填 描述
operation_time String 否 操作时间
ret_code String 否 000000成功、119000其他、其他状态码都为失败
operator_service_name String 否 操作人名字
ret_msg String 否 操作结果描述
operator_time Long 否 操作时间 long
operator_content String 否 操作内容
log_id String 否 logid
operate_num Integer 否 操作的数量
operate_type Integer 否 操作方式 1 单次操作 2批量操作 3 导入操作
ret_desc String 否 结果描述
export_url String 否 需要导出的文件url

请求示例：

curl --location '/chat-static-api/api/robot/staffWorkStatis/getReceptionStatistDetailPage' \
--header 'token: d56f13525ad14f279f71feec370dd2d2' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "robot_ids": "0",
    "start_date": "2023-08-02 00:00:00",
    "end_date": "2023-08-31 23:59:00",
    "ret_code": "1",
    "operate_types": "1,2,3",
    "content": "",
    "staff_ids": "",
    "page_no": "1",
    "page_size": "2",
    "version": "6"
}'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "操作成功",
    "page_no": 1,
    "page_count": 350,
    "total_count": 700,
    "page_size": 2,
    "items": [
        {
            "ret_code": "000000",
            "operator_service_name": "李丽",
            "ret_msg": "操作成功",
            "operator_time": 1693389672584,
            "operator_content": "在【寒暄问题】中添加了寒暄问题【我要归纳到沉寂问题】",
            "log_id": "40d8940f1e854642b41f7c21f790b8e3_2023-08-30-18-01-12_5bd73377c773417ca3969a41ad727f8c",
            "operate_num": 1,
            "operate_type": 1,
            "ret_desc": "",
            "export_url": ""
        },
        {
            "ret_code": "000000",
            "operator_service_name": "李丽",
            "ret_msg": "操作成功",
            "operator_time": 1693389101095,
            "operator_content": "在【专业名词】中添加了专业名词【intel】",
            "log_id": "40d8940f1e854642b41f7c21f790b8e3_2023-08-30-17-51-41_14b30fad1e78415abbc2c2549c90a3ca",
            "operate_num": 1,
            "operate_type": 1,
            "ret_desc": "",
            "export_url": ""
        }
    ]
}
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

# 问答质量统计接口调用

# ● 问答质量概览-问答数据

请求方式：

POST

请求地址：

/chat-static-api/api/robot/qAQuality/getGeneralView
1

请求参数：

参数 类型 必填 描述 备注
robot_ids List 否 机器人ID ["1","2"]
source_ids List 否 渠道类型 ["1","2"]
channel_flags List 否 子渠道类型 ["0_16","0_1"]
start_time String 否 会话开始时间 pattern:yyyy-MM-dd HH:mm
end_time String 否 会话结束时间 pattern:yyyy-MM-dd HH:mm

返回参数：

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

item 对象：

参数 类型 必填 描述
question_total double 否 客户提问总数
question_total_cycle String 否 客户提问总数同比
answer_total double 否 机器人消息数
answer_total_cycle String 否 机器人回答数同比
msg_robot_unknown double 否 机器人未知回答数
matching_rate String 否 回答匹配率
direct_response_count double 否 直接回答数：直接回答单轮数+直接回答多轮数
direct_response_count_cycle String 否 直接回答数同比
direct_response_rate String 否 直接回答率 old:直接回答单轮数+直接回答多轮数+系统寒暄+自定义寒暄/机器人回答总数 new:直接回答单轮数+直接回答多轮数/机器人回答总数
msg_robot_direct_multi double 否 直接回答多轮
msg_gpt_direct_single double 否 ai应答直接匹配数
msg_robot_direct_single double 否 直接回答单轮
direct_response_rate_cycle String 否 直接回答率同比
similarity_matching_count double 否 相似匹配数
similarity_matching_count_cycle String 否 相似匹配数同比
similarity_matching_rate String 否 相似匹配率：理解回答单论+理解回答多轮+引导回答单论+引导回答多轮(引导回答命中N个，按1统计)/机器人回答总数
similarity_matching_rate_cycle String 否 相似匹配率同比
similar_matching_adoption double 否 相似匹配采纳数：用户点击候选的问题数
similar_matching_adoption_cycle String 否 相似匹配采纳数同比
msg_robot_apprehend_r double 否 理解回答匹配数
msg_robot_guide_r double 否 引导问题匹配数
guide_advise_count double 否 引导回答推荐问题数
greet_total double 否 寒暄回答匹配数
greet_total_cycle String 否 寒暄回答匹配数同比
msg_robot_greet_sys double 否 系统寒暄：机器人给出的系统寒暄回答数
msg_robot_greet_custom double 否 自定义寒暄：机器人给出的自定义寒暄回答数
resolution_rate String 否 解决率：解决会话数/参评数
resolution_rate_cycle String 否 解决率同比
resolution_and_satisfaction_rate String 否 解决且满意占比：已解决且满意/参评数
resolved_but_dissatisfied_rate String 否 解决但不满意占比：已解决不满意/参评数
satisfaction_rate String 否 满意率：满意会话数/参评数
satisfaction_rate_cycle String 否 满意率同比
satisfactory_but_unresolved_rate String 否 满意但未解决占比：满意未解决/参评数
dissatisfied_and_unresolved_rate String 否 不满意且未解决占比：不满意未解决/参评数
msg_robot_answer double 否 机器人回答数
unknown_rate String 否 未知回答率

请求示例：

curl --location '/chat-static-api/api/robot/qAQuality/getGeneralView' \
--header 'token: 63cb0a4f1e5b4678b17504e876b8673a' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "robot_ids": [
        1
    ],
    "start_time": "2023-07-30 00:00",
    "end_time": "2023-08-28 23:59",
    "source_ids": [
        "0",
        "2"
    ],
    "channel_flags": [
        "0_1"
    ]
}'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "操作成功",
    "item": {
        "question_total": 21.0,
        "question_total_cycle": "600.00%",
        "answer_total": 21.0,
        "answer_total_cycle": "950.00%",
        "msg_robot_unknown": 14.0,
        "matching_rate": "33.33%",
        "direct_response_count": 1.0,
        "direct_response_count_cycle": "0.00%",
        "direct_response_rate": "4.76%",
        "msg_robot_direct_multi": 0.0,
        "msg_gpt_direct_single": 0.0,
        "msg_robot_direct_single": 1.0,
        "direct_response_rate_cycle": "0.00%",
        "similarity_matching_count": 0.0,
        "similarity_matching_count_cycle": "0.00%",
        "similarity_matching_rate": "0.00%",
        "similarity_matching_rate_cycle": "0.00%",
        "similar_matching_adoption": 0.0,
        "similar_matching_adoption_cycle": "0.00%",
        "msg_robot_apprehend_r": 0.0,
        "msg_robot_guide_r": 0.0,
        "guide_advise_count": 0.0,
        "greet_total": 6.0,
        "greet_total_cycle": "200.00%",
        "msg_robot_greet_sys": 6.0,
        "msg_robot_greet_custom": 0.0,
        "resolution_rate": "0.00%",
        "resolution_rate_cycle": "0.00%",
        "resolution_and_satisfaction_rate": "0.00%",
        "resolved_but_dissatisfied_rate": "0.00%",
        "satisfaction_rate": "0.00%",
        "satisfaction_rate_cycle": "0.00%",
        "satisfactory_but_unresolved_rate": "0.00%",
        "dissatisfied_and_unresolved_rate": "0.00%",
        "msg_robot_answer": 21.0,
        "unknown_rate": "66.67%"
    }
}
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
# ● 问答质量概览-折线图、趋势图

请求方式：

POST

请求地址：

/chat-static-api/api/robot/qAQuality/getLineChart
1

请求参数：

参数 类型 必填 描述 备注
robot_ids List 否 机器人ID ["1","2"]
source_ids List 否 渠道类型 ["1","2"]
channel_flags List 否 子渠道类型 ["0_16","0_1"]
start_time String 否 会话开始时间 pattern:yyyy-MM-dd HH:mm
end_time String 否 会话结束时间 pattern:yyyy-MM-dd HH:mm
show_flag String 是 展示标识位 数量（num）、百分比（percentage），默认num
chart_type String 是 报表类型 趋势图（trend）、对比图（comparison）
show_fields List 是 展示的字段 详见下面说明

show_fields入参说明，与返回的item中属性对应

参数 类型 必填 描述
resolutionAndSatisfaction String 否 解决且满意数
resolvedButDissatisfied String 否 解决但不满意数
satisfactoryButUnresolved String 否 满意但未解决数
dissatisfiedAndUnresolved String 否 不满意且未解数
total String 否 点踩总数
usefulCount String 否 点赞数
uselessCount String 否 点踩数
evaluateRobotInvites String 否 会话评价邀请数:会话评价邀请触发数
evaluateRobot String 否 参评数:有评价结果的会话数
satisfied String 否 满意会话数:评价为“满意”会话数
dissatisfied String 否 不满意数:标记为“不满意”的会话数
robotSolved String 否 解决会话数:评价为“解决”会话数
robotNotSolved String 否 未解决会话数:评价为“未解决”会话数
msgVisitorToRobot String 否 客户提问总数：访客和机器人会话时，访客消息总数
msgRobot String 否 机器人回答数：机器人消息总数（不含引导语+欢迎语）
msgVisitorToRobotUnknown String 否 未匹配回答数：机器人回答类型为“未知回答”的客户提问数
msgRobotDirectSingle String 否 直接回答-单轮问题：机器人直接回答的问题中单轮问题的数
msgRobotDirectMulti String 否 直接回答-多轮问题：机器人直接回答的问题中多轮问题的数
msgRobotGuideSingle String 否 引导-单轮问题：机器人引导回答的问题中出现单轮问题的数
msgRobotApprehendSingle String 否 理解-单轮问题：机器人理解回答的问题中出现单轮问题的数
msgRobotGuideMulti String 否 引导-多轮问题：机器人引导回答的问题中出现多轮问题的数
msgRobotApprehendMulti String 否 引导-多轮问题：机器人理解回答的问题中出现多轮问题的数
msgRobotUnknown String 否 无效回答数：机器人给出未知问题说辞的数
msgRobotGreet String 否 寒暄回答数：机器人给出的寒暄回答数（包含系统寒暄和自定义寒暄）
msgRobotGreetSys String 否 系统寒暄：机器人给出的系统寒暄回答数
msgRobotGreetCustom String 否 自定义寒暄：机器人给出的自定义寒暄回答数
directMatchingNumber String 否 直接匹配数
similarMatchingNumber String 否 相似匹配数
answerMatchingNumber String 否 回答匹配数
clickSimilarityAnswerCount String 否 相似匹配采纳数：用户点击了引导、理解回答候选答案的次数
resolutionRate String 否 解决率：解决会话数/参评数
satisfactionRate String 否 满意率：满意会话数/参评数
participationRate String 否 参评率：参评数/会话评价邀请数
unresolvedRate String 否 未解决率：未解决会话数/参评数
matchingRate String 否 回答匹配率：回答匹配数/客户提问总数
directResponseRate String 否 直接回答率：直接回答单轮数+直接回答多轮数+系统寒暄+自定义寒暄/机器人回答总数
similarityMatchingRate String 否 相似匹配率：理解回答单论+理解回答多轮+引导回答单论+引导回答多轮(引导回答命中N个，按1统计)/机器人回答总数
similarMatchingAdoptionRate String 否 相似匹配采纳率：用户点击候选的问题数/总的给出引导+理解的问题数 【引导（理解）回答命中N个，按1统计】
resolutionAndSatisfactionRate String 否 解决且满意占比：已解决且满意/参评数
resolvedButDissatisfiedRate String 否 解决但不满意占比：已解决不满意/参评数
satisfactoryButUnresolvedRate String 否 满意但未解决占比：满意未解决/参评数
dissatisfiedAndUnresolvedRate String 否 不满意且未解决占比：不满意未解决/参评数
usefulRate String 否 点赞率
uselessRate String 否 点踩率

返回参数：

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

item 对象：

参数 类型 必填 描述
name String 否 名称
value String 否 数值
timestamp String 否 时间

请求示例：

curl --location '/chat-static-api/api/robot/qAQuality/getLineChart' \
--header 'token: 21634d39bc674656a35fc4814746d90c' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "robot_ids": [
        1
    ],
    "start_time": "2023-06-14 00:00",
    "end_time": "2023-06-15 23:59",
    "source_ids": [
        "0",
        "2"
    ],
    "channel_flags": [
        "0_1"
    ],
    "show_fields":["msgVisitorToRobot","resolutionAndSatisfaction"],
    "show_flag":"num",
    "chart_type":"trend"
}'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "操作成功",
    "item": {
        "msgVisitorToRobot": [
            {
                "name": "msgVisitorToRobot",
                "timestamp": "2023-06-14",
                "value": "2.0"
            },
            {
                "name": "msgVisitorToRobot",
                "timestamp": "2023-06-15",
                "value": "0.0"
            }
        ],
        "resolutionAndSatisfaction": [
            {
                "name": "resolutionAndSatisfaction",
                "timestamp": "2023-06-14",
                "value": "0.0"
            },
            {
                "name": "resolutionAndSatisfaction",
                "timestamp": "2023-06-15",
                "value": "0.0"
            }
        ]
    }
}
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
# ● 问答质量概览-机器人回答类型分布

请求方式：

POST

请求地址：

/chat-static-api/api/robot/qAQuality/getRobotAnswerTypeResp
1

请求参数：

参数 类型 必填 描述 备注
robot_ids List 否 机器人ID ["1","2"]
source_ids List 否 渠道类型 ["1","2"]
channel_flags List 否 子渠道类型 ["0_16","0_1"]
start_time String 否 会话开始时间 pattern:yyyy-MM-dd HH:mm
end_time String 否 会话结束时间 pattern:yyyy-MM-dd HH:mm

返回参数：

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

item 对象：

参数 类型 必填 描述
msg_robot_direct Object 是 直接回答
msg_robot_apprehend_R_and_guide_r Object 是 相似匹配回答
msg_robot_unknown Object 是 无效回答
msg_robot_greet Object 是 寒暄回答

msg_robot_direct对象

参数 类型 必填 描述
msg_robot_direct_multi Double 是 直接回答-多轮问题：机器人直接回答的问题中多轮问题的数
msg_robot_direct_single Double 是 直接回答-单轮问题：机器人直接回答的问题中单轮问题的数
msg_gpt_direct_single Double 是 直接回答-AI直接回答
msg_robot_direct Double 是 直接回答总数：机器人直接回答的问题数

msg_robot_apprehend_R_and_guide_r对象

参数 类型 必填 描述
msg_robot_apprehend_R_and_guide_r Double 是 理解与引导问题轮次
msg_robot_apprehend_r Double 是 理解问题轮次
msg_robot_guide_r Double 是 引导问题轮次

msg_robot_unknown对象

参数 类型 必填 描述
msg_robot_unknown Double 是 无效回答数：机器人给出未知问题说辞的数

msg_robot_greet对象

参数 类型 必填 描述
msg_robot_greet_custom Double 是 自定义寒暄：机器人给出的自定义寒暄回答数
msg_robot_greet_sys Double 是 系统寒暄：机器人给出的系统寒暄回答数
msg_robot_greet Double 是 寒暄回答数：机器人给出的寒暄回答数（包含系统寒暄和自定义寒暄）

请求示例：

curl --location '/chat-static-api/api/robot/qAQuality/getRobotAnswerTypeResp' \
--header 'token: 63cb0a4f1e5b4678b17504e876b8673a' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "robot_ids": [
        1
    ],
    "start_time": "2023-07-30 00:00",
    "end_time": "2023-08-28 23:59",
    "source_ids": [
        "0",
        "2"
    ],
    "channel_flags": [
        "0_1"
    ]
}'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "item": {
        "msg_robot_direct": {
            "msg_robot_direct_multi": 0.0,
            "msg_robot_direct_single": 1.0,
            "msg_gpt_direct_single": 0.0,
            "msg_robot_direct": 1.0
        },
        "msg_robot_apprehend_R_and_guide_r": {
            "msg_robot_guide_r": 0.0,
            "msg_robot_apprehend_r": 0.0,
            "msg_robot_apprehend_R_and_guide_r": 0.0
        },
        "msg_robot_unknown": {
            "msg_robot_unknown": 14.0
        },
        "msg_robot_greet": {
            "msg_robot_greet": 6.0,
            "msg_robot_greet_custom": 0.0,
            "msg_robot_greet_sys": 6.0
        }
    }
}
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
# ● 问答质量概览-会话评价

请求方式：

POST

请求地址：

/chat-static-api/api/robot/qAQuality/getEvaluationResp
1

请求参数：

参数 类型 必填 描述 备注
robot_ids List 否 机器人ID ["1","2"]
source_ids List 否 渠道类型 ["1","2"]
channel_flags List 否 子渠道类型 ["0_16","0_1"]
start_time String 否 会话开始时间 pattern:yyyy-MM-dd HH:mm
end_time String 否 会话结束时间 pattern:yyyy-MM-dd HH:mm

返回参数：

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

item 对象：

参数 类型 必填 描述
evaluate_robot_invites double 否 会话评价邀请数:会话评价邀请触发数
evaluate_robot_invites_cycle String 否 会话评价邀请数同比
evaluate_robot double 否 参评数:有评价结果的会话数
evaluate_robot_cycle String 否 参评数同比
satisfied double 否 满意会话数:评价为“满意”会话数
satisfied_cycle String 否 满意会话数同比
robot_solved double 否 解决会话数:评价为“解决”会话数
robot_solved_cycle String 否 解决会话数同比
robot_not_solved double 否 未解决会话数:评价为“未解决”会话数
robot_not_solved_cycle String 否 未解决会话数同比
resolution_rate String 否 解决率：解决会话数/参评数
resolution_rate_cycle String 否 解决率同比
satisfaction_rate String 否 满意率：满意会话数/参评数
satisfaction_rate_cycle String 否 满意率同比
participation_rate String 否 参评率：参评数/会话评价邀请数
participation_rate_cycle String 否 参评率同比
unresolved_rate String 否 未解决率：未解决会话数/参评数
unresolved_rate_cycle String 否 未解决率同比

请求示例：

curl --location '/chat-static-api/api/robot/qAQuality/getEvaluationResp' \
--header 'token: 63cb0a4f1e5b4678b17504e876b8673a' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "robot_ids": [
        1
    ],
    "start_time": "2023-07-30 00:00",
    "end_time": "2023-08-28 23:59",
    "source_ids": [
        "0",
        "2"
    ],
    "channel_flags": [
        "0_1"
    ]
}'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "操作成功",
    "item": {
        "robot_solved_cycle": "300.00%",
        "unresolved_rate_cycle": "-93.75%",
        "unresolved_rate": "0.00%",
        "satisfied": 3,
        "evaluate_robot": 4,
        "resolution_rate": "100%",
        "robot_solved": 4,
        "evaluate_robot_invites_cycle": "0.00%",
        "satisfied_cycle": "0.00%",
        "robot_not_solved": 0,
        "evaluate_robot_invites": 0,
        "participation_rate_cycle": "0.00%",
        "satisfaction_rate": "75.00%",
        "evaluate_robot_cycle": "-75.00%",
        "participation_rate": "0.00%",
        "satisfaction_rate_cycle": "0.00%",
        "robot_not_solved_cycle": "-100.00%",
        "resolution_rate_cycle": "93.75%"
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# ● 问答质量概览-答案评价

请求方式：

POST

请求地址：

/chat-static-api/api/robot/qAQuality/getAnswerEvaluationResp
1

请求参数：

参数 类型 必填 描述 备注
robot_ids List 否 机器人ID ["1","2"]
source_ids List 否 渠道类型 ["1","2"]
channel_flags List 否 子渠道类型 ["0_16","0_1"]
start_time String 否 会话开始时间 pattern:yyyy-MM-dd HH:mm
end_time String 否 会话结束时间 pattern:yyyy-MM-dd HH:mm

返回参数：

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

item 对象：

参数 类型 必填 描述
total double 否 点踩总数
total_cycle String 否 点踩总数同比
useful_count double 否 点赞数
useful_count_cycle String 否 点赞数同比
useless_count double 否 点踩数
useless_count_cycle String 否 点踩数同比
useful_rate String 否 点赞率
useful_rate_cycle String 否 点赞率同比
useless_rate String 否 点踩率
useless_rate_cycle String 否 点踩率同比

请求示例：

curl --location '/chat-static-api/api/robot/qAQuality/getAnswerEvaluationResp' \
--header 'token: 63cb0a4f1e5b4678b17504e876b8673a' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "robot_ids": [
        1
    ],
    "start_time": "2023-07-30 00:00",
    "end_time": "2023-08-28 23:59",
    "source_ids": [
        "0",
        "2"
    ],
    "channel_flags": [
        "0_1"
    ]
}'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "操作成功",
    "item": {
        "total": 4,
        "useful_rate_cycle": "0.00%",
        "useful_rate": "75.00%",
        "useless_rate": "25.00%",
        "useless_count_cycle": "-50.00%",
        "useless_count": 1,
        "total_cycle": "100%",
        "useful_count_cycle": "0.00%",
        "useless_rate_cycle": "-75.00%",
        "useful_count": 3
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# ● 知识匹配统计-查询全量的知识库和问题分类

请求方式：

POST

请求地址：

/chat-static-api/api/condition/robot/getAllKbTypeList
1

请求参数：

参数 类型 必填 描述 备注
robot_ids List 否 机器人ID ["1","2"]

返回参数：

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

items 对象：

参数 类型 必填 描述
id String 否 type=1知识库id  type=2问题分类id
name String 否 名称，根据type
type String 否 1知识库、2问题分类
question_type_id String 否 所属机器人
parent_type_id String 否 父节点id
question_type_name String 否 无
child_type_list String 否 叶子节点

请求示例：

curl --location '/chat-static-api/api/condition/robot/getAllKbTypeList' \
--header 'token: 7ea3e608a48e45a08c2cbd05b33836dc' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "robot_ids": [
        "3"
    ]
}'
1
2
3
4
5
6
7
8
9
10

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "items": [
        {
            "id": "7b78368a0ffb40ff9bf0bb24a770d2b5",
            "name": "小智机器人",
            "type": 1,
            "robot_flag": 1,
            "child_type_list": [
                {
                    "id": "992b578e3bc5441e944d70aaeab53fc0",
                    "name": "企微跳转测试",
                    "type": 2,
                    "question_type_id": "992b578e3bc5441e944d70aaeab53fc0",
                    "parent_type_id": "-1",
                    "question_type_name": "企微跳转测试",
                    "child_type_list": []
                },
                {
                    "id": "ff6ec96f3f2f46fbbf1b39ee1d720b17",
                    "name": "常见问题测试",
                    "type": 2,
                    "question_type_id": "ff6ec96f3f2f46fbbf1b39ee1d720b17",
                    "parent_type_id": "-1",
                    "question_type_name": "常见问题测试",
                    "child_type_list": []
                },
                {
                    "id": "4790b7db876f43bb88a048d73d833eb1",
                    "name": "消息体设置专用",
                    "type": 2,
                    "question_type_id": "4790b7db876f43bb88a048d73d833eb1",
                    "parent_type_id": "-1",
                    "question_type_name": "消息体设置专用",
                    "child_type_list": []
                }
            ]
        },
        {
            "id": "c523554db43f40c9ae75df51d680c5d6",
            "name": "小智机器人-2",
            "type": 1,
            "robot_flag": 2,
            "child_type_list": [
                {
                    "id": "1979ebb6109a42398dbf580626411b51",
                    "name": "默认分类",
                    "type": 2,
                    "question_type_id": "1979ebb6109a42398dbf580626411b51",
                    "parent_type_id": "-1",
                    "question_type_name": "默认分类",
                    "child_type_list": []
                },
                {
                    "id": "424f5dfe92c4479684fc6b9e29ead91e",
                    "name": "默认分类",
                    "type": 2,
                    "question_type_id": "424f5dfe92c4479684fc6b9e29ead91e",
                    "parent_type_id": "-1",
                    "question_type_name": "默认分类",
                    "child_type_list": []
                }
            ]
        },
        {
            "id": "51b9b924b8064faf96d73a6552ac9faa",
            "name": "小智机器人-3",
            "type": 1,
            "robot_flag": 3,
            "child_type_list": [
                {
                    "id": "61907e3b2ffd42abbe625b4c05448450",
                    "name": "默认分类",
                    "type": 2,
                    "question_type_id": "61907e3b2ffd42abbe625b4c05448450",
                    "parent_type_id": "-1",
                    "question_type_name": "默认分类",
                    "child_type_list": []
                },
                {
                    "id": "da649283d1cf4469bce46b92c10d2f91",
                    "name": "默认分类",
                    "type": 2,
                    "question_type_id": "da649283d1cf4469bce46b92c10d2f91",
                    "parent_type_id": "-1",
                    "question_type_name": "默认分类",
                    "child_type_list": []
                }
            ]
        },
        {
            "id": "648aadbb3dae41f6a4b15bde2168d8dc",
            "name": "小智机器人-4",
            "type": 1,
            "robot_flag": 4,
            "child_type_list": [
                {
                    "id": "ad1549a51bca40279eaf912d8ae712fd",
                    "name": "默认分类",
                    "type": 2,
                    "question_type_id": "ad1549a51bca40279eaf912d8ae712fd",
                    "parent_type_id": "-1",
                    "question_type_name": "默认分类",
                    "child_type_list": []
                },
                {
                    "id": "3ae718c31dd34fa987a984ed05e06112",
                    "name": "默认分类",
                    "type": 2,
                    "question_type_id": "3ae718c31dd34fa987a984ed05e06112",
                    "parent_type_id": "-1",
                    "question_type_name": "默认分类",
                    "child_type_list": []
                }
            ]
        },
        {
            "id": "802fda3a8add482ab1f140baca948f68",
            "name": "小智机器人-5",
            "type": 1,
            "robot_flag": 5,
            "child_type_list": [
                {
                    "id": "0dadecbf6f0d4981ae5331195b0f55ac",
                    "name": "默认分类",
                    "type": 2,
                    "question_type_id": "0dadecbf6f0d4981ae5331195b0f55ac",
                    "parent_type_id": "-1",
                    "question_type_name": "默认分类",
                    "child_type_list": []
                },
                {
                    "id": "64d80e13b7ff42ccbde5912afdf472de",
                    "name": "默认分类",
                    "type": 2,
                    "question_type_id": "64d80e13b7ff42ccbde5912afdf472de",
                    "parent_type_id": "-1",
                    "question_type_name": "默认分类",
                    "child_type_list": []
                }
            ]
        },
        {
            "id": "625ca7b14d8e42aa9438c2051ec4452a",
            "name": "公共知识库11",
            "type": 1,
            "robot_flag": 11,
            "child_type_list": [
                {
                    "id": "7f5c500cd1b94064940c1042ef7fa146",
                    "name": "默认分类",
                    "type": 2,
                    "question_type_id": "7f5c500cd1b94064940c1042ef7fa146",
                    "parent_type_id": "-1",
                    "question_type_name": "默认分类",
                    "child_type_list": []
                }
            ]
        },
        {
            "id": "0a2599be8d35493dab188bc685307aa6",
            "name": "公共知识库12",
            "type": 1,
            "robot_flag": 12,
            "child_type_list": [
                {
                    "id": "53a80566f10946658c154a3c6766cd6d",
                    "name": "默认分类",
                    "type": 2,
                    "question_type_id": "53a80566f10946658c154a3c6766cd6d",
                    "parent_type_id": "-1",
                    "question_type_name": "默认分类",
                    "child_type_list": []
                }
            ]
        },
        {
            "id": "0ea99eab41c4411abac420439cb4014c",
            "name": "公共知识库13",
            "type": 1,
            "robot_flag": 13,
            "child_type_list": [
                {
                    "id": "730fea8abdd8420e9481ea207bf9c90f",
                    "name": "默认分类",
                    "type": 2,
                    "question_type_id": "730fea8abdd8420e9481ea207bf9c90f",
                    "parent_type_id": "-1",
                    "question_type_name": "默认分类",
                    "child_type_list": []
                }
            ]
        },
        {
            "id": "6e3486b40a0145c0b450f87a67faa1c9",
            "name": "公共知识库14",
            "type": 1,
            "robot_flag": 14,
            "child_type_list": [
                {
                    "id": "d6cf09c1a0474fd98109405ec6c9b206",
                    "name": "默认分类",
                    "type": 2,
                    "question_type_id": "d6cf09c1a0474fd98109405ec6c9b206",
                    "parent_type_id": "-1",
                    "question_type_name": "默认分类",
                    "child_type_list": []
                }
            ]
        },
        {
            "id": "ccbea48fa7ca432789fcb366765bd64e",
            "name": "公共知识库15",
            "type": 1,
            "robot_flag": 15,
            "child_type_list": [
                {
                    "id": "a32803be6dd64a5987be3b75c6065c4c",
                    "name": "默认分类",
                    "type": 2,
                    "question_type_id": "a32803be6dd64a5987be3b75c6065c4c",
                    "parent_type_id": "-1",
                    "question_type_name": "默认分类",
                    "child_type_list": []
                }
            ]
        }
    ]
}
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
# ● 知识匹配统计-知识匹配统计（分页）

请求方式：

POST

请求地址：

/chat-static-api/api/robot/qAQuality/getKnowledgeMatchByPages
1

请求参数：

参数 类型 必填 描述 备注
robot_ids List 否 机器人ID ["1","2"]
source_ids List 否 渠道类型 ["1","2"]
start_time String 否 会话开始时间 pattern:yyyy-MM-dd
end_time String 否 会话结束时间 pattern:yyyy-MM-dd
page_num String 否 页码 默认1
page_size String 否 每页数量 默认15,最大允许为100,如果超过100则重置为100
question_type_id String 否 问题分类id
answer_type_list List 否 回答类型 ["directly","directlysingle","directlymulti","similarity","greet","apprehend","guide"]，直接回答匹配数（directly）、单轮回答匹配数（directlysingle）、多轮回答匹配数（directlymulti）、相似回答匹配数（similarity）、寒暄回答匹配数（greet）、理解回答匹配数（apprehend）、引导回答匹配数（guide）
question_type_list List 否 问题类型 ["0","2","1"]，单轮问题（0）、多轮问题（2）、自定义寒暄问题（1）

返回参数：

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

items 对象：

参数 类型 必填 描述
doc_id String 否 词条id
doc_name String 否 命中的标准问题
robot_id String 否 机器人id
robot_name String 否 所属机器人
kb_name String 否 知识库名称
question_type_id String 否 所属分类
question_type_desc String 否 所属分类描述
question_type String 否 问题类型
question_type_name String 否 问题类型
question_count double 否 总匹配数
greeting_count double 否 寒暄匹配总数
cus_greeting_count double 否 自定义寒暄匹配数
directly_total double 否 直接匹配=单轮+多轮
directly_count double 否 单轮直接匹配
multi_count double 否 多轮直接匹配
guide_count double 否 引导匹配数
apprehend_count double 否 理解匹配数
click_count double 否 引导采纳
un_click_count double 否 引导未采纳
useful_count double 否 点赞数
useful_rate String 否 点赞占比
useless_count double 否 点踩数
useless_rate String 否 点踩占比

请求示例：

curl --location '/chat-static-api/api/robot/qAQuality/getKnowledgeMatchByPages' \
--header 'token: 7ea3e608a48e45a08c2cbd05b33836dc' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "robot_ids": [
        1,
        2,
        3
    ],
    "source_ids": [
        4,
        2,
        17,
        12
    ],
    "page_size": 15,
    "page_num": 1,
    "start_time": "2023-07-01",
    "end_time": "2023-09-06",
    "answer_type_list": [
        "directly",
        "directlysingle",
        "directlymulti",
        "similarity",
        "greet",
        "apprehend",
        "guide"
    ],
    "question_type_list": [
        "0",
        "2",
        "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
31
32
33
34
35
36

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "page_no": 1,
    "page_count": 7,
    "total_count": 32,
    "page_size": 5,
    "items": [
        {
            "doc_id": "365e94b37106412ab3ad680f7aecd289",
            "doc_name": "验证图片无法放大",
            "robot_id": "1",
            "robot_name": "小智机器人-卡哇伊",
            "kb_name": "",
            "question_type_id": "a7113d976f084054b9596c9514898bc7",
            "question_type_desc": "黄欢",
            "question_type": "0",
            "question_type_name": "单轮问题",
            "question_count": 110.0,
            "greeting_count": 0.0,
            "cus_greeting_count": 0.0,
            "directly_total": 109.0,
            "directly_count": 109.0,
            "multi_count": 0.0,
            "guide_count": 1.0,
            "apprehend_count": 0.0,
            "click_count": 0.0,
            "un_click_count": 1.0,
            "useful_count": 0.0,
            "useful_rate": "0.00%",
            "useless_count": 54.0,
            "useless_rate": "49.09%"
        },
        {
            "doc_id": "b7bea666254d462f98edad620496134b",
            "doc_name": "引导问题测试1",
            "robot_id": "1",
            "robot_name": "小智机器人-卡哇伊",
            "kb_name": "",
            "question_type_id": "577242c84a504d569c5fcc34117ebccf",
            "question_type_desc": "引导问题测试",
            "question_type": "0",
            "question_type_name": "单轮问题",
            "question_count": 49.0,
            "greeting_count": 0.0,
            "cus_greeting_count": 0.0,
            "directly_total": 4.0,
            "directly_count": 4.0,
            "multi_count": 0.0,
            "guide_count": 45.0,
            "apprehend_count": 0.0,
            "click_count": 4.0,
            "un_click_count": 41.0,
            "useful_count": 0.0,
            "useful_rate": "0.00%",
            "useless_count": 0.0,
            "useless_rate": "0.00%"
        },
        {
            "doc_id": "2f1df6406d604a41a3e7da4dd4fd5ffd",
            "doc_name": "引导问题测试5",
            "robot_id": "1",
            "robot_name": "小智机器人-卡哇伊",
            "kb_name": "",
            "question_type_id": "577242c84a504d569c5fcc34117ebccf",
            "question_type_desc": "引导问题测试",
            "question_type": "0",
            "question_type_name": "单轮问题",
            "question_count": 48.0,
            "greeting_count": 0.0,
            "cus_greeting_count": 0.0,
            "directly_total": 2.0,
            "directly_count": 2.0,
            "multi_count": 0.0,
            "guide_count": 46.0,
            "apprehend_count": 0.0,
            "click_count": 2.0,
            "un_click_count": 44.0,
            "useful_count": 0.0,
            "useful_rate": "0.00%",
            "useless_count": 0.0,
            "useless_rate": "0.00%"
        },
        {
            "doc_id": "2d0cc89835d24e96809975093ea6df4e",
            "doc_name": "引导问题测试3",
            "robot_id": "1",
            "robot_name": "小智机器人-卡哇伊",
            "kb_name": "",
            "question_type_id": "577242c84a504d569c5fcc34117ebccf",
            "question_type_desc": "引导问题测试",
            "question_type": "0",
            "question_type_name": "单轮问题",
            "question_count": 40.0,
            "greeting_count": 0.0,
            "cus_greeting_count": 0.0,
            "directly_total": 0.0,
            "directly_count": 0.0,
            "multi_count": 0.0,
            "guide_count": 40.0,
            "apprehend_count": 0.0,
            "click_count": 0.0,
            "un_click_count": 40.0,
            "useful_count": 0.0,
            "useful_rate": "0.00%",
            "useless_count": 0.0,
            "useless_rate": "0.00%"
        },
        {
            "doc_id": "3bbce2a405f5451da028eab283bd4b34",
            "doc_name": "引导问题测试4",
            "robot_id": "1",
            "robot_name": "小智机器人-卡哇伊",
            "kb_name": "",
            "question_type_id": "577242c84a504d569c5fcc34117ebccf",
            "question_type_desc": "引导问题测试",
            "question_type": "0",
            "question_type_name": "单轮问题",
            "question_count": 37.0,
            "greeting_count": 0.0,
            "cus_greeting_count": 0.0,
            "directly_total": 0.0,
            "directly_count": 0.0,
            "multi_count": 0.0,
            "guide_count": 37.0,
            "apprehend_count": 0.0,
            "click_count": 0.0,
            "un_click_count": 37.0,
            "useful_count": 0.0,
            "useful_rate": "0.00%",
            "useless_count": 0.0,
            "useless_rate": "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
# ● 知识点踩统计-获取点踩评价统计（分页）

请求方式：

POST

请求地址：

/chat-static-api/api/robot/qAQuality/getLikeItOrNotRespByPages
1

请求参数：

参数 类型 必填 描述 备注
robot_ids List 否 机器人ID ["1","2"]
source_ids List 否 渠道类型 ["1","2"]
channel_flags List 否 子渠道类型 ["0_16","0_1"]
start_time String 否 会话开始时间 pattern:yyyy-MM-dd HH:mm
end_time String 否 会话结束时间 pattern:yyyy-MM-dd HH:mm
order_column String 否 排序字段 点踩总数（total）、理解回答被点踩（apprehend）、直接回答被点踩（direct）
order Boolean 否 排序方式 升序asc（true）、降序desc（false）
page_num String 否 页码 默认1
page_size String 否 每页数量 默认15,最大允许为100,如果超过100则重置为100
kb_id_list List 否 知识库ID集合 ["1","2"]

返回参数：

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

items 对象：

参数 类型 必填 描述
data_id String 否 数据主键
standard_question_id String 否 标准问法ID
standard_question String 否 标准问法
kb_id String 否 知识库id
kb_name String 否 知识库名称
rule_id String 否 规则id
rule String 否 规则
rule_title String 否 规则名称
answer_id String 否 答案id
answer String 否 答案
robot_flag String 否 机器人id
more_answer_type String 否 一问多答标识
robot_name String 否 机器人名称
like_it_or_not_total String 否 点踩总数
direct_like_it_or_not_number String 否 直接回答点踩数
apprehend_like_it_or_not_number String 否 理解回答点踩
rich_messages List 否 展示字段

rich_messages 对象

参数 类型 必填 描述
type Integer 否 富文本类型 0-文本，1-图片，2-音频，3-视频，4-文件（包含音频视频文档之类的）
msg String 否 消息体
name String 否 消息体名称，一般是指两个a标签之间的纯文字
wei_xin_type Integer 否 供微信使用的类型
width String 否 宽
height String 否 高
file_size String 否 文件大小
show_type Integer 否 超链接展示格式
video_img_url String 否 视频缩略图

请求示例：

curl --location '/chat-static-api/api/robot/qAQuality/getLikeItOrNotRespByPages' \
--header 'token: e6809a1178524b78ac11b55ad8c7f4e5' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "order_column": "apprehend",
    "order": true,
    "robot_ids": [
        1,
        2,
        3
    ],
    "kb_id_list": [],
    "page_size": 15,
    "page_num": 1,
    "start_time": "2023-07-30 00:00",
    "end_time": "2023-08-28 23:59"
}'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "成功",
    "page_no": 0,
    "page_count": 1,
    "total_count": 5,
    "page_size": 5,
    "items": [
        {
            "data_id": "2c80e1eb386e4e6cb8141ab16b75c19e",
            "standard_question_id": "365e94b37106412ab3ad680f7aecd289",
            "standard_question": "验证图片无法放大",
            "kb_id": "",
            "kb_name": "",
            "rule_id": "",
            "answer_id": "b9064e637c0e4b1d9d12534424019717",
            "answer": "[\"<p></p><div class=\\\"media-wrap image-wrap\\\"><img src=\\\"https://img.sobot.com/console/8d8a61706066470f98a1ba02d6b6d7a5/kb/file/63fb0c08b36746349bc88220b70a6c17.jpeg\\\"/></div><p></p>\"]",
            "robot_flag": "1",
            "more_answer_type": "",
            "robot_name": "小智机器人-卡哇伊",
            "like_it_or_not_total": "54",
            "direct_like_it_or_not_number": "54",
            "apprehend_like_it_or_not_number": "0",
            "rich_messages": [
                {
                    "type": 1,
                    "msg": "https://img.sobot.com/console/8d8a61706066470f98a1ba02d6b6d7a5/kb/file/63fb0c08b36746349bc88220b70a6c17.jpeg",
                    "wei_xin_type": 1,
                    "width": "",
                    "height": ""
                }
            ],
            "doc_question_type": "0"
        },
        {
            "data_id": "dd3cd423103841099ab871132bbf2f78",
            "standard_question_id": "7c8a7b53330b456ab974331d5bceb51d",
            "standard_question": "宽图片",
            "kb_id": "",
            "kb_name": "",
            "rule_id": "",
            "answer_id": "a17e32c23cfb4a98b498e32ebc219da0",
            "answer": "[\"<p></p><div class=\\\"media-wrap image-wrap\\\"><img src=\\\"https://img.sobot.com/console/8d8a61706066470f98a1ba02d6b6d7a5/kb/file/1ac4da4412554acfb3cf22c2b9398f73.JPG\\\"/></div><p></p>\"]",
            "robot_flag": "1",
            "more_answer_type": "",
            "robot_name": "小智机器人-卡哇伊",
            "like_it_or_not_total": "1",
            "direct_like_it_or_not_number": "1",
            "apprehend_like_it_or_not_number": "0",
            "rich_messages": [
                {
                    "type": 1,
                    "msg": "https://img.sobot.com/console/8d8a61706066470f98a1ba02d6b6d7a5/kb/file/1ac4da4412554acfb3cf22c2b9398f73.JPG",
                    "wei_xin_type": 1,
                    "width": "",
                    "height": ""
                }
            ],
            "doc_question_type": "0"
        },
        {
            "data_id": "f37ac631d86847949a827ecd981bb798",
            "standard_question_id": "5ca50e0a56264368856332804f98dd12",
            "standard_question": "音乐歌曲2",
            "kb_id": "",
            "kb_name": "",
            "rule_id": "",
            "answer_id": "74a8af62fa9141b389d804eef02afa38",
            "answer": "[\"<p>音乐歌曲2</p>\"]",
            "robot_flag": "1",
            "more_answer_type": "",
            "robot_name": "小智机器人-卡哇伊",
            "like_it_or_not_total": "2",
            "direct_like_it_or_not_number": "2",
            "apprehend_like_it_or_not_number": "0",
            "rich_messages": [
                {
                    "type": 0,
                    "msg": "音乐歌曲2",
                    "wei_xin_type": 0
                }
            ],
            "doc_question_type": "0"
        },
        {
            "data_id": "3dfb1029b4fc4302bfb3b231e9b98c81",
            "standard_question_id": "22dbc893c6ed46f2841529c51f01d09f",
            "standard_question": "音乐歌曲1",
            "kb_id": "",
            "kb_name": "",
            "rule_id": "",
            "answer_id": "5a9dd8db0494406696afcaaa2ee63ad6",
            "answer": "[\"<p>音乐歌曲1</p>\"]",
            "robot_flag": "1",
            "more_answer_type": "",
            "robot_name": "小智机器人-卡哇伊",
            "like_it_or_not_total": "1",
            "direct_like_it_or_not_number": "1",
            "apprehend_like_it_or_not_number": "0",
            "rich_messages": [
                {
                    "type": 0,
                    "msg": "音乐歌曲1",
                    "wei_xin_type": 0
                }
            ],
            "doc_question_type": "0"
        },
        {
            "data_id": "fba5307e48fe4c4693e899067bb3381f",
            "standard_question_id": "22dbc893c6ed46f2841529c51f01d09f",
            "standard_question": "音乐歌曲1",
            "kb_id": "1",
            "kb_name": "",
            "rule_id": "",
            "answer_id": "5a9dd8db0494406696afcaaa2ee63ad6",
            "answer": "[\"<p>音乐歌曲1</p>\"]",
            "robot_flag": "1",
            "more_answer_type": "",
            "robot_name": "小智机器人-卡哇伊",
            "like_it_or_not_total": "1",
            "direct_like_it_or_not_number": "1",
            "apprehend_like_it_or_not_number": "0",
            "rich_messages": [
                {
                    "type": 0,
                    "msg": "音乐歌曲1",
                    "wei_xin_type": 0
                }
            ],
            "doc_question_type": "0"
        }
    ]
}
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
# ● 知识点踩统计-获取点踩详情（分页）

请求方式：

POST

请求地址：

/chat-static-api/api/robot/qAQuality/getLikeItOrNotDetail
1

请求参数：

参数 类型 必填 描述 备注
robot_ids List 否 机器人ID ["1","2"]
source_ids List 否 渠道类型 ["1","2"]
channel_flags List 否 子渠道类型 ["0_16","0_1"]
start_time String 否 会话开始时间 pattern:yyyy-MM-dd HH:mm
end_time String 否 会话结束时间 pattern:yyyy-MM-dd HH:mm
standard_question_id String 是 标准问法ID
page_num 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 对象：

参数 类型 必填 描述
standard_question_id String 否 标准问法ID
message_id String 否 信息id
standard_question String 否 标准问法
origin_question String 否 客户提问
cid String 否 会话ID
question_time String 否 提问时间
status String 否 1 赞 -1 踩

请求示例：

curl --location 'www.sobot.com/chat-static-api/api/robot/qAQuality/getLikeItOrNotDetail' \
--header 'token: e6809a1178524b78ac11b55ad8c7f4e5' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "robot_ids": [
        1,
        2,
        3
    ],
    "standard_question_id": "002244da4ce447ecb3eeaea917ad7226",
    "page_size": 15,
    "page_num": 1,
    "start_time": "2023-07-30 00:00",
    "end_time": "2023-08-28 23:59"
}'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "操作成功",
    "page_no": 1,
    "page_count": 1,
    "total_count": 1,
    "page_size": 1,
    "items": [
        {
            "standard_question_id": "43d1ae439e704f5fb8330f9de067c3c5",
            "message_id": "dc50b18fa05343bb8a0497f7f90e67a8",
            "standard_question": "电子科技大学",
            "origin_question": "电子科技大学",
            "cid": "6d8b0a2e25294f72a3e583f853000095",
            "question_time": "2023-08-03 18:47:57"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# ● 会话评价统计-获取会话评价（分页）

请求方式：

POST

请求地址：

/chat-static-api/api/robot/qAQuality/getConversationEvaluationByPages
1

请求参数：

参数 类型 必填 描述 备注
robot_ids List 否 机器人ID ["1","2"]
source_ids List 否 渠道类型 ["1","2"]
channel_flags List 否 子渠道类型 ["0_16","0_1"]
start_time String 否 会话开始时间 pattern:yyyy-MM-dd HH:mm
end_time String 否 会话结束时间 pattern:yyyy-MM-dd HH:mm
page_num String 否 页码 默认1
page_size String 否 每页数量 默认15,最大允许为100,如果超过100则重置为100
cid String 否 会话ID
evaluation_results String 否 会话评价 已解决（robotSolved）、未解决（robotNotSolved）

返回参数：

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

items 对象：

参数 类型 必填 描述
cid String 否 会话id
customer_name String 否 客户名称
channel_name String 否 渠道名称
resolved String 否 是否解决
evaluation_results String 否 评价结果
evaluation_label String 否 评价标签

请求示例：

curl --location '/chat-static-api/api/robot/qAQuality/getConversationEvaluationByPages' \
--header 'token: e6809a1178524b78ac11b55ad8c7f4e5' \
--header 'language: zh' \
--header 'timezoneid: Asia/Shanghai' \
--header 'Content-Type: application/json' \
--data '{
    "robot_ids": [
        1,
        2,
        3
    ],
    "cid": "7660594c1e084228aac98d6e79e2db91",
    "evaluation_results": "robotNotSolved",
    "page_size": 15,
    "page_num": 1,
    "start_time": "2023-07-30 00:00",
    "end_time": "2023-08-28 23:59"
}'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

返回示例：

{
    "ret_code": "000000",
    "ret_msg": "操作成功",
    "page_no": 1,
    "page_count": 1,
    "total_count": 1,
    "page_size": 1,
    "items": [
        {
            "cid": "7660594c1e084228aac98d6e79e2db91",
            "customer_name": "未知位置0720-4725",
            "channel_name": "默认桌面网站",
            "resolved": "未解决",
            "evaluation_label": ""
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
上次更新: 2024/1/3 17:22:29

← 企业主动发送离线消息API→

最近更新
01
大模型机器人API
09-09
02
LINE API
06-25
03
Facebook Messenger API
04-28
更多文章>
Theme by Vdoing