知识中心
所有文章
帮助中心
AI客户联络中心 升级日志
API文档
AI客户联络
API接口
【新】云节点列表
对话接口
白标接口及地址
【更新】通话列表
最后更新于 2023/11/16   阅读数 1070

通话列表URL:/agent-api/user/{id}/task/{task_id}/record●Method:GET●需要鉴权

💡 注意:1原请求地址为GET /agent-api/task/{task_id}/record,新增参数用户id,且为必填2如果仍使用老版本的接口,将使用系统默认的云节点ID,无法操作其他云节点的数据3老版接口将于2023年2月1日下线,请尽快进行更换

请求参数

参数

类型

必填

描述

id

string

Y

账号ID

task_id

string

Y

任务ID

levels

array

N

评分区间(注意是二维数组)

keyword

string

N

被叫号码

start_at

string

N

开始时间

end_at

string

N

结束时间

page

int

N

页码

per_page

int

N

页容量

sub_user_id

string

N

子账户id(传递此参数则是对子账户操作)

请求示例GET /agent-api/user/4d99d91c-f5d9-49da-88da-758977cc58a9/task/287e19c4-1966-49d6-8f02-b53ef11c0a55/record?page=1&keyword=18555525545

成功响应

条件:任务存在,且各项资源也存在(如转接组ID)。

状态码:200 OK

响应示例

{
    "code": 200,
    "status": "success",
    "message": "查看通话记录列表成功",
    "meta": {
        "has_pages": true,
        "total": 29,
        "last_page": 29,
        "current_page": 1,
        "per_page": "1"
    },
    "data": [
        {
            "tags": [],
            "tag_groups": [],
            "operator_name": "联通",
            "extra": null,
            "name": "测试掉保时间1",
            "company": "诡事屋剧本推理社",
            "send_wechat_data": [],
            "components": [
                {
                    "id": "733b8535-a1f9-4db9-9945-98a2a0c5490e",
                    "name": "微信",
                    "type": "text",
                    "value": "17710726421"
                }
            ],
            "id": "50971322-2e84-4701-836c-fd1181306885",
            "task_id": "287e19c4-1966-49d6-8f02-b53ef11c0a55",
            "group_id": 8888,
            "callid": "ed26665c-873f-4917-a346-ce38cd2be7b5",
            "score": 1000,
            "callee": "18555525545",
            "caller_number": "0000000000",
            "duration": 39500,
            "error_code": 0,
            "gender": 2,
            "level_id": "23059613-da4c-4e52-94e1-42e3a5c0c40d",
            "calldate": "2022-09-29 15:09:13",
            "bill": 37140,
            "hangupcause": "NORMAL_CLEARING",
            "hangupdate": "2022-09-29 15:09:53",
            "answerdate": "2022-09-29 15:09:16",
            "bridge_callid": null,
            "bridge_number": null,
            "bridge_calldate": null,
            "bridge_answerdate": null,
            "hangup_disposition": 2,
            "created_at": "2022-09-29 15:09:19",
            "updated_at": "2022-10-19 14:56:42",
            "rounds": 2,
            "level_name": "A类客户()",
            "read_at": "2022-10-19 14:56:42",
            "province_id": 5,
            "city_id": 90,
            "operator": 2,
            "customer_id": "e973e23f-32da-44ea-921a-1988d2c5c7f2",
            "user_id": "4d99d91c-f5d9-49da-88da-758977cc58a9",
            "processed_at": null,
            "number_created_at": "2022-08-02 16:10:48",
            "intention_results": 1,
            "level": null,
            "gender_str": "男",
            "hangup_disposition_str": "客户",
            "details": [
                {
                    "id": "0c6a21f9-404c-4bd7-be04-35b0baca0b41",
                    "record_id": "50971322-2e84-4701-836c-fd1181306885",
                    "task_id": "287e19c4-1966-49d6-8f02-b53ef11c0a55",
                    "notify": "asrprogress_notify",
                    "callid": "ed26665c-873f-4917-a346-ce38cd2be7b5",
                    "error_code": 0,
                    "asrtype": "aliyunv2",
                    "callee": "18555525545",
                    "gender": 0,
                    "asr_elapse": 544,
                    "record_ms": 1250,
                    "volume_gain": 4.2693159999999999,
                    "question": "挂了吧。",
                    "split_question": null,
                    "question_index": 9,
                    "speak_ms": 0,
                    "play_ms": 4900,
                    "keyword": null,
                    "answer_id": null,
                    "answer_text": null,
                    "answer_content": null,
                    "word_class": null,
                    "answer_action": null,
                    "playback_after_action": 0,
                    "upstream_answer_action": null,
                    "upstream_answer_content": null,
                    "upstream_answer_text": null,
                    "upstream_answer_id": null,
                    "score": 0,
                    "sequence": 11,
                    "created_at": "2022-09-29 15:09:44",
                    "updated_at": "2022-09-29 15:09:44",
                    "bridge_status": 0,
                    "user_id": "4d99d91c-f5d9-49da-88da-758977cc58a9",
                    "is_regular": 0,
                    "expression": null,
                    "tags": []
                },
                {
                    "id": "11e3fbf3-b35f-43e9-bee8-4f2c746bcc3d",
                    "record_id": "50971322-2e84-4701-836c-fd1181306885",
                    "task_id": "287e19c4-1966-49d6-8f02-b53ef11c0a55",
                    "notify": "playback_result",
                    "callid": "ed26665c-873f-4917-a346-ce38cd2be7b5",
                    "error_code": 0,
                    "asrtype": null,
                    "callee": "18555525545",
                    "gender": null,
                    "asr_elapse": null,
                    "record_ms": null,
                    "volume_gain": null,
                    "question": "挂了吧。 挂了吧。",
                    "split_question": null,
                    "question_index": 0,
                    "speak_ms": 0,
                    "play_ms": 0,
                    "keyword": "挂了,挂了吧",
                    "answer_id": "97562248-d734-4e8d-97e4-eb37d51344cd",
                    "answer_text": "结束语挂断",
                    "answer_content": "结束语挂断结束语挂断结束语挂断",
                    "word_class": "1",
                    "answer_action": 2,
                    "playback_after_action": 0,
                    "upstream_answer_action": null,
                    "upstream_answer_content": null,
                    "upstream_answer_text": null,
                    "upstream_answer_id": null,
                    "score": 1000,
                    "sequence": 12,
                    "created_at": "2022-09-29 15:09:53",
                    "updated_at": "2022-09-29 15:09:53",
                    "bridge_status": null,
                    "user_id": "4d99d91c-f5d9-49da-88da-758977cc58a9",
                    "is_regular": 0,
                    "expression": null,
                    "tags": []
                },
                {
                    "id": "25a20247-a94e-44f0-a6f2-e26cd4d0d2e3",
                    "record_id": "50971322-2e84-4701-836c-fd1181306885",
                    "task_id": "287e19c4-1966-49d6-8f02-b53ef11c0a55",
                    "notify": "asrprogress_notify",
                    "callid": "ed26665c-873f-4917-a346-ce38cd2be7b5",
                    "error_code": 0,
                    "asrtype": "aliyunv2",
                    "callee": "18555525545",
                    "gender": 0,
                    "asr_elapse": 709,
                    "record_ms": 930,
                    "volume_gain": 5.393745,
                    "question": "挂了吧。",
                    "split_question": null,
                    "question_index": 8,
                    "speak_ms": 0,
                    "play_ms": 3360,
                    "keyword": null,
                    "answer_id": null,
                    "answer_text": null,
                    "answer_content": null,
                    "word_class": null,
                    "answer_action": null,
                    "playback_after_action": 0,
                    "upstream_answer_action": null,
                    "upstream_answer_content": null,
                    "upstream_answer_text": null,
                    "upstream_answer_id": null,
                    "score": 0,
                    "sequence": 10,
                    "created_at": "2022-09-29 15:09:41",
                    "updated_at": "2022-09-29 15:09:41",
                    "bridge_status": 0,
                    "user_id": "4d99d91c-f5d9-49da-88da-758977cc58a9",
                    "is_regular": 0,
                    "expression": null,
                    "tags": []
                }
            ],
            "province": {
                "id": 5,
                "pid": null,
                "city": "安徽",
                "area_code": "0551",
                "post_code": "238000",
                "created_at": "2021-04-21 10:20:33",
                "updated_at": "2021-04-21 10:20:33"
            },
            "city": {
                "id": 90,
                "pid": 5,
                "city": "蚌埠",
                "area_code": "0552",
                "post_code": "233000",
                "created_at": "2021-04-21 10:20:33",
                "updated_at": "2021-04-21 10:20:33"
            }
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
plaintext

参数

类型

描述

tags

array

标签

tag_groups

array

母标签

operator_name

string

运营商

extra

string

额外数据,可用于标识第三方数据

name

string

客户姓名

company

string

公司

send_wechat_data

array

推送微信人员数据

components

array

CRM组件信息

id

string

id

task_id

string

任务id

group_id

int

话数组id

callid

string

呼叫id

score

int

通话得分

callee

string

被叫号码

caller_number

string

主叫号码(注意:不是客户真正接听的号码)

duration

int

外呼时长(毫秒)

error_code

int

错误码(暂时无用)

gender

int

性别

level_id

string

通话质量id

calldate

string

呼叫时间

bill

int

接听时长(毫秒)

hangupcause

string

挂断原因(通信层面,没有使用价值)

hangupdate

string

挂断时间

answerdate

string

接听时间

bridge_callid

string

转接呼叫id

bridge_number

string

转接号码

bridge_calldate

string

转接时间

bridge_answerdate

string

转接接听时间

hangup_disposition

int

挂断方1AI、2客户

created_at

string

创建时间

updated_at

string

更新时间

rounds

int

交互轮数

level_name

string

通话质量名称

read_at

string

查看时间

province_id

int

省份id

city_id

int

城市id

operator

int

运营商:1电信、2联通、3移动

customer_id

string

CRM公海ID

user_id

string

用户id

processed_at

string

处理时间

number_created_at

string

CRM公海号码创建时间

intention_results

int

意向标签1A、2B、3C、4D、5E

level

object

通话质量

gender_str

string

性别

hangup_disposition_str

string

挂断方

details

array

通话详情

province

object

省份

city

object

城市

错误响应

错误1

条件:任务ID不存在。

状态码200 OK

响应示例:

{
    "code": 5002,
    "status": "error",
    "message": "任务不存在",
    "data": []
}
1
2
3
4
5
6
plaintext

错误2

条件:账号ID错误,云节点不存在。

状态码200 OK

响应示例:

{
    "code": 1002,
    "status": "error",
    "message": "【user】参数错误,未找到对应云节点",
    "data": []
}
1
2
3
4
5
6
plaintext

未能解决您的问题?请联系
本篇目录

成功响应

错误响应

错误1

错误2