查询号码组详情V4
更新时间:2026-10-21
URL
https://aiob-open.baidu.com/api/v4/console/apitask/member/detail2
HTTP Method
POST
接口说明
根据百度侧号码组ID查询号码组元信息及该号码组下每通电话的会话详情。
请求参数
Header
| 参数名称 | 是否必须 | 说明 | 示例 |
|---|---|---|---|
| Content-Type | 是 | 请求内容类型,固定为application/json。 | application/json |
| Authorization | 是 | 认证Token,生成方式参考「生成认证Token」文档。 | 按认证文档生成的Token |
Body
| 参数名称 | 类型 | 是否必须 | 说明 | 示例 |
|---|---|---|---|---|
| taskMemberId | long | 是 | 百度侧号码组ID,用于查询该号码组的元信息及通话记录。 | 732530014224641 |
响应参数
| 名称 | 类型 | 备注 |
|---|---|---|
| requestId | string | 请求追踪ID,用于定位本次请求。 |
| time | long | 响应生成时间,Unix时间戳,单位:毫秒。 |
| code | int | 响应状态码,200表示成功。 |
| msg | string | 响应信息,成功时为OK,失败时为具体原因。 |
| data | object | 号码组详情,包括号码组元信息和每通会话的详情。 |
data数据
| 名称 | 类型 | 备注 |
|---|---|---|
| memberInfo | object | 号码组元信息,包括号码组状态、拨打次数和接通次数等。 |
| sessions | object[] | 号码组中的通话详情列表,没有通话记录时返回空数组。 |
memberInfo数据
| 名称 | 类型 | 备注 |
|---|---|---|
| taskMemberId | string | 百度侧号码组ID,以字符串形式返回。 |
| tenantId | long | 租户唯一标识。 |
| status | int | 号码组状态:1-未执行;2-未完成;3-已完成;4-已打完;5-已外呼;99-异常。 |
| callEndTime | long | 号码组呼叫结束时间,Unix时间戳,单位:毫秒;未产生结束时间时可能为空。 |
| finished | int | 号码组完成标识:0-未完成;1-已完成。 |
| totalTimes | int | 号码组已拨打次数。 |
| connectedTimes | int | 号码组接通次数,未保存时返回0。 |
| extJson | string | 导入号码组时传入的随路字段。 |
sessions数据
以下字段属于data.sessions中的单条会话。可选字段在未产生对应业务数据或历史记录未保存时可能为空。
| 参数名称 | 类型 | 是否必须 | 说明 | 示例 |
|---|---|---|---|---|
| sessionId | string | 是 | 通话唯一标识。 | "10215_6f8146adfa504d3c94757bdfda529b18" |
| tenantId | long | 是 | 租户唯一标识。 | 10215 |
| taskId | long | 是 | 任务ID,实时任务返回租户ID。 | 732721695686912 |
| taskName | string | 是 | 任务名称,实时任务返回“实时任务”。 | "拨测任务" |
| robotId | string | 是 | 机器人ID。 | "f06c086a-186a-4ca9-a800-79946481ee19" |
| robotName | string | 是 | 外呼机器人名称。 | "满意度调研机器人" |
| memberId | long | 是 | 号码组唯一标识,对应查询请求中的taskMemberId。 | 732530014224641 |
| mobile | string | 是 | 被叫号码,展示形式与号码加密配置及解密结果有关。 | "186****3394" |
| callTimes | long | 是 | 当前号码的拨打次数。 | 1 |
| callerNum | string | 是 | 主叫号码。 | "02120002017" |
| endType | int | 是 | 接通状态:1-已接通;0-未接通。 | 1 |
| callType | int | 是 | 呼叫类型:0-首次呼叫;1-重试呼叫;2-预约呼叫;3-实时呼叫;4-拦截重呼。 | 0 |
| endTypeReason | string | 否 | 未接通原因,已接通时可能为空。 | null |
| contactUUID | string | 否 | 通话录音标识,可用于获取录音。 | "1734320931264591_142062" |
| fileId | long | 否 | 名单导入时生成的文件ID,非文件导入场景可能为空。 | 732722299388160 |
| collectInfo | object | 是 | 机器人信息收集结果,没有结果时返回空对象。 | {"意向":"有意向"} |
| record | object[] | 是 | 会话还原记录,元素结构见record数据。 | 详见子结构 |
| durationTimeLen | long | 是 | 拨号总时长,单位:秒。 | 165 |
| ringingTimeLen | long | 是 | 振铃时长,单位:秒。 | 5 |
| talkingTimeLen | long | 是 | 通话时长,单位:秒。 | 159 |
| startTime | long | 是 | 呼叫开始时间,Unix时间戳,单位:毫秒。 | 1734320931000 |
| ringStartTime | long | 否 | 振铃开始时间,Unix时间戳,单位:毫秒;未产生振铃时间时可能为空。 | 1734320932000 |
| talkingStartTime | long | 否 | 通话接通时间,Unix时间戳,单位:毫秒;未接通时可能为空。 | 1734320937000 |
| endTime | long | 是 | 呼叫结束时间,Unix时间戳,单位:毫秒。 | 1734321096000 |
| intent | string | 否 | 机器人意向,在机器人流程的信息收集中配置的“意向”对应值。 | "有意向" |
| action | string[] | 否 | 会话动作列表,例如HANGUP表示挂机。 | ["HANGUP"] |
| isRobotHangup | boolean | 是 | 是否由机器人主动挂机。 | false |
| dialogVar | object | 是 | 导入名单时传入的对话变量,没有变量时返回空对象。 | {"客户姓名":"客户A"} |
| smsVar | object | 否 | 短信模板使用的变量。 | {"客户姓名":"客户A"} |
| extJson | string | 否 | 导入名单时传入的随路字段。 | "extJson" |
| transResult | int | 否 | 转人工结果:-1-失败;0-未发起;1-成功;2-主动放弃;3-队列超时;5-队列溢出。4为筛选枚举“全部”,不代表具体业务结果。 | 1 |
| sipCode | string | 否 | 呼叫SIP状态码,例如200、480、407。 | "200" |
| sipInfo | string | 否 | 呼叫SIP状态描述。 | "OK" |
| tagExtractInfo | object | 否 | 机器人标签抽取结果,开启标签抽取且存在结果时返回。 | {"是否有意愿":"是"} |
| recordFileUrl | string | 否 | 通话录音文件地址或路径,没有录音时可能为空。 | "2024/12/16/10215/record.wav" |
| batchMarking | string | 否 | 历史标注批次字段,未返回时为空。 | null |
| memberCallTimes | long | 否 | 号码组拨打次数,历史记录可能为空。 | 1 |
| completeType | int | 否 | 会话完成状态,历史记录可能为空。 | 3 |
| smsStatus | int | 否 | 短信发送结果,0-成功;2-失败;没有短信结果时可能为空。 | null |
| contactId | string | 否 | 联络中心侧的通话标识。 | "1734320931247329_426323" |
| secretType | int | 否 | 号码加密类型:1-业务加密;2-系统加密;3-自定义加密;4-不加密;5-不解密。 | 2 |
| agentEndTime | long | 否 | 坐席挂断时间,Unix时间戳,单位:毫秒;未记录时为空。 | null |
| createTime | long | 否 | 会话记录创建时间,Unix时间戳,单位:毫秒。 | 1734321099000 |
| executiveStrategy | string[] | 否 | 执行策略的完成节点列表,没有相关记录时可能为空。 | null |
| mobileArea | string | 否 | 被叫号码归属地,通常为“省-市”;未知地区可能为“未知-未知”。 | "北京-北京" |
| talkingTurn | int | 否 | 机器人回复数,即通话轮次。 | 15 |
| customManualTagList | object[] | 否 | 人工核验后的规则标签列表,元素结构见customManualTagList数据。 | 详见子结构 |
| triggerSmsMessage | int | 否 | 是否触发短信:0-未触发;1-已触发。该字段不表示短信发送是否成功。 | 0 |
| callerArea | string | 否 | 主叫号码归属地,通常为“省-市”;未知地区可能为“未知-未知”。 | "上海-上海" |
| asrModelName | string | 否 | 语音识别模型名称,历史记录未保存时可能为空。 | "语音模型1" |
| ttsVoiceName | string | 否 | 发音人名称,未找到对应发音人时返回空字符串。 | "度小美" |
| robotChargeDuration | int | 否 | 机器人计费时长,单位:分钟。 | 1 |
| lineChargeDuration | int | 否 | 通话计费时长,单位:分钟。 | 3 |
| transAgentBillingChargeDuration | int | 否 | 转人工后的人工通话计费时长,单位:分钟。 | 3 |
| voiceTalkingTurn | int | 否 | 用户回复数。 | 14 |
| addFriendStatus | int | 否 | 加微结果:-1-失败;0-已发起;1-成功;未发起或无结果时可能为空。 | null |
| weChatPushStatus | int | 否 | 公众号推送状态:-1-失败;0-未发起;1-成功;未配置或无结果时可能为空。 | null |
| tagExtractManualInfo | object | 否 | 人工核验后的大模型标签;未核验时沿用原标签提取结果。 | {"是否有意愿":"是"} |
| skillGroupList | object[] | 否 | 本次会话涉及的转接技能组列表,元素结构见skillGroupList数据。 | 详见子结构 |
| agentInfoList | object[] | 否 | 本次会话涉及的接待坐席列表,坐席工号使用agentCode,元素结构见agentInfoList数据。 | 详见子结构 |
| transferFailReason | string | 否 | 转人工失败原因说明,如“主动放弃”“队列超时”“队列溢出”;无对应细分原因时可能为空。 | null |
| manualIntent | string | 否 | 最新一条坐席小结中的规则标签名称,即userIntent。 | "有意向" |
| manualRemark | string | 否 | 最新一条坐席小结中的坐席备注,即userRemark。 | "客户希望后续联系" |
| userSummaryList | object[] | 否 | 坐席小结列表,元素结构见userSummaryList数据;没有小结时可能为空。 | 详见子结构 |
| agentOutboundType | int | 否 | 坐席呼叫类型:0-AI转人工;1-回拨;2-主动拨号;无法判断时可能为空。 | 0 |
| auditUserName | string | 否 | 质检员姓名,未分配或未查询到对应人员时可能为空。 | "质检员A" |
| auditStatus | int | 否 | 人工质检状态:0-未质检;1-已质检;历史记录可能为空。 | 1 |
record数据
对应data.sessions[].record[]。
| 名称 | 类型 | 备注 |
|---|---|---|
| role | string | 角色:speech-机器人或坐席侧;voice-客户侧。 |
| timestamp | long | 记录时间戳,单位:毫秒。 |
| content | string | 记录中的文本内容,可能为空;会话还原优先使用contextText。 |
| contextText | string | 会话展示文本,speech角色对应机器人或坐席侧回复,voice角色对应客户侧回复。 |
| sn | string | 文本片段唯一标识。 |
| intent | string | 该片段对应的意图,没有结果时可能为空。 |
| start | string | 片段开始时间,相对于对话开始的时间,格式为mm:ss.SSS。 |
| stop | string | 片段结束时间,相对于对话开始的时间,格式为mm:ss.SSS。 |
| timeLen | long | 片段时长,单位:毫秒。 |
| interrupted | boolean | 是否被打断:true-被打断;false-未被打断。 |
| interruptedTime | string | 打断时间,相对于对话开始的时间;没有记录时可能为空。 |
| silent | boolean | 是否为静默片段。 |
| nodeInfo | string | 流程节点信息,没有记录时可能为空。 |
| prePlayWordType | int | 承接词类型:1-文本;2-音频;无承接词时可能为空。 |
| prePlayWordText | string | 承接词内容;无承接词时可能为空。 |
skillGroupList数据
对应data.sessions[].skillGroupList[]。
| 参数名称 | 类型 | 是否必须 | 说明 | 示例 |
|---|---|---|---|---|
| skillGroupId | long | 否 | 技能组ID。 | 1234567 |
| skillGroupName | string | 否 | 技能组名称。 | "客服技能组" |
| enterSkillGroupTime | string | 否 | 进入技能组时间,格式为yyyy-MM-dd HH:mm:ss。 | "2024-12-16 11:49:00" |
| queueDuration | int | 否 | 在技能组中的等待时长,沿用联络中心回传值。 | 6 |
agentInfoList数据
对应data.sessions[].agentInfoList[]。
| 参数名称 | 类型 | 是否必须 | 说明 | 示例 |
|---|---|---|---|---|
| agentCode | string | 否 | 坐席工号;历史记录无法补齐时可能为空。 | "A001" |
| agentName | string | 否 | 坐席名称。 | "坐席A" |
| ringTime | string | 否 | 坐席振铃时间,格式为yyyy-MM-dd HH:mm:ss。 | "2024-12-16 11:49:01" |
| assignTime | string | 否 | 坐席分配时间,格式为yyyy-MM-dd HH:mm:ss。 | "2024-12-16 11:49:01" |
| answerTime | string | 否 | 坐席接通时间,格式为yyyy-MM-dd HH:mm:ss;未接通时可能为空。 | "2024-12-16 11:49:06" |
| hangupTime | string | 否 | 坐席挂断时间,格式为yyyy-MM-dd HH:mm:ss。 | "2024-12-16 11:51:36" |
| hangupParty | string | 否 | 挂断方,未返回时可能为空。 | null |
| skillGroupId | string | 否 | 坐席所属技能组ID。 | "1234567" |
| queueLen | int | 否 | 排队时长,沿用联络中心回传值。 | 5 |
| talkLen | int | 否 | 通话时长,沿用联络中心回传值。 | 150 |
| wrapUpLen | int | 否 | 话后整理时长,未返回时可能为空。 | null |
| resultCode | int | 否 | 转接结果码:0表示成功;其他值沿用联络中心原始原因码。上游未返回结果码时,当前实现默认填0。 | 0 |
userSummaryList数据
对应data.sessions[].userSummaryList[]。
| 参数名称 | 类型 | 是否必须 | 说明 | 示例 |
|---|---|---|---|---|
| userIntent | string | 否 | 坐席选择的规则标签名称,即用户意向。 | "有意向" |
| userRemark | string | 否 | 坐席填写的小结备注。 | "客户希望后续联系" |
| formId | long | 否 | 小结关联的表单ID。 | 1001 |
| formName | string | 否 | 小结关联的表单名称。 | "客户信息表" |
| formValueList | object[] | 否 | 表单字段值列表,元素结构见formValueList数据。 | 详见子结构 |
formValueList数据
对应data.sessions[].userSummaryList[].formValueList[]。
| 参数名称 | 类型 | 是否必须 | 说明 | 示例 |
|---|---|---|---|---|
| fieldId | string | 否 | 表单字段ID。 | "field001" |
| fieldName | string | 否 | 表单字段名称。 | "客户姓名" |
| componentType | string | 否 | 表单组件类型标识,以实际表单配置为准。 | "input" |
| fieldValue | any | 否 | 表单字段值,JSON类型由表单组件决定,可能为字符串、数字、布尔值、数组或对象。 | "客户A" |
customManualTagList数据
对应data.sessions[].customManualTagList[]。
| 参数名称 | 类型 | 是否必须 | 说明 | 示例 |
|---|---|---|---|---|
| id | string | 否 | 规则标签ID。 | "tag001" |
| tag | string | 否 | 规则标签值。 | "有意向" |
请求示例
JSON
1{
2 "taskMemberId": 732530014224641
3}
返回示例
以下为结构示例,record仅展示两条片段,工号、标签和录音路径等均为示例值。
JSON
1{
2 "requestId": "4c24645b0e5b4d1fab60494f5dfb1445",
3 "time": 1734321100000,
4 "code": 200,
5 "msg": "OK",
6 "data": {
7 "memberInfo": {
8 "taskMemberId": "732530014224641",
9 "tenantId": 10215,
10 "status": 3,
11 "callEndTime": 1734321096000,
12 "finished": 1,
13 "totalTimes": 1,
14 "connectedTimes": 1,
15 "extJson": "extJson"
16 },
17 "sessions": [
18 {
19 "tenantId": 10215,
20 "memberId": 732530014224641,
21 "sessionId": "10215_6f8146adfa504d3c94757bdfda529b18",
22 "collectInfo": {},
23 "record": [
24 {
25 "role": "speech",
26 "timestamp": 1734320937162,
27 "content": null,
28 "contextText": "您好,请问现在方便做个简短调研吗?",
29 "sn": "603b96b2-84b6-4ce4-b564-3f65a4948869",
30 "intent": null,
31 "start": "00:00.043",
32 "stop": "00:05.889",
33 "timeLen": 5846,
34 "interrupted": false,
35 "interruptedTime": null,
36 "silent": false,
37 "nodeInfo": null,
38 "prePlayWordType": null,
39 "prePlayWordText": null
40 },
41 {
42 "role": "voice",
43 "timestamp": 1734320945841,
44 "content": "你好,方便。",
45 "contextText": "你好,方便。",
46 "sn": "ad59ab5ebb6011ef_2_1",
47 "intent": null,
48 "start": "00:05.557",
49 "stop": "00:07.997",
50 "timeLen": 2440,
51 "interrupted": false,
52 "interruptedTime": null,
53 "silent": false,
54 "nodeInfo": null,
55 "prePlayWordType": null,
56 "prePlayWordText": null
57 }
58 ],
59 "intent": "有意向",
60 "callerNum": "02120002017",
61 "endType": 1,
62 "endTypeReason": null,
63 "contactUUID": "1734320931264591_142062",
64 "durationTimeLen": 165,
65 "ringingTimeLen": 5,
66 "talkingTimeLen": 159,
67 "startTime": 1734320931000,
68 "ringStartTime": 1734320932000,
69 "talkingStartTime": 1734320937000,
70 "endTime": 1734321096000,
71 "mobile": "186****3394",
72 "robotId": "f06c086a-186a-4ca9-a800-79946481ee19",
73 "action": [
74 "HANGUP"
75 ],
76 "isRobotHangup": false,
77 "dialogVar": {},
78 "transResult": 1,
79 "extJson": "extJson",
80 "recordFileUrl": "2024/12/16/10215/record.wav",
81 "sipCode": "200",
82 "sipInfo": "OK",
83 "tagExtractInfo": {
84 "是否有意愿": "是"
85 },
86 "batchMarking": null,
87 "taskId": 732721695686912,
88 "taskName": "拨测任务",
89 "robotName": "满意度调研机器人",
90 "callTimes": 1,
91 "memberCallTimes": 1,
92 "completeType": 3,
93 "callType": 0,
94 "smsStatus": null,
95 "contactId": "1734320931247329_426323",
96 "fileId": null,
97 "secretType": 2,
98 "agentEndTime": null,
99 "smsVar": null,
100 "createTime": 1734321099000,
101 "executiveStrategy": null,
102 "mobileArea": "北京-北京",
103 "talkingTurn": 15,
104 "customManualTagList": [
105 {
106 "id": "tag001",
107 "tag": "有意向"
108 }
109 ],
110 "triggerSmsMessage": 0,
111 "callerArea": "上海-上海",
112 "asrModelName": "语音模型1",
113 "ttsVoiceName": "度小美",
114 "robotChargeDuration": 1,
115 "lineChargeDuration": 3,
116 "transAgentBillingChargeDuration": 3,
117 "voiceTalkingTurn": 14,
118 "addFriendStatus": null,
119 "weChatPushStatus": null,
120 "tagExtractManualInfo": {
121 "是否有意愿": "是"
122 },
123 "skillGroupList": [
124 {
125 "skillGroupId": 1234567,
126 "skillGroupName": "客服技能组",
127 "enterSkillGroupTime": "2024-12-16 11:49:00",
128 "queueDuration": 6
129 }
130 ],
131 "agentInfoList": [
132 {
133 "agentCode": "A001",
134 "agentName": "坐席A",
135 "ringTime": "2024-12-16 11:49:01",
136 "assignTime": "2024-12-16 11:49:01",
137 "answerTime": "2024-12-16 11:49:06",
138 "hangupTime": "2024-12-16 11:51:36",
139 "hangupParty": null,
140 "skillGroupId": "1234567",
141 "queueLen": 5,
142 "talkLen": 150,
143 "wrapUpLen": null,
144 "resultCode": 0
145 }
146 ],
147 "transferFailReason": null,
148 "manualIntent": "有意向",
149 "manualRemark": "客户希望后续联系",
150 "userSummaryList": [
151 {
152 "userIntent": "有意向",
153 "userRemark": "客户希望后续联系",
154 "formId": 1001,
155 "formName": "客户信息表",
156 "formValueList": [
157 {
158 "fieldId": "field001",
159 "fieldName": "客户姓名",
160 "componentType": "input",
161 "fieldValue": "客户A"
162 }
163 ]
164 }
165 ],
166 "agentOutboundType": 0,
167 "auditUserName": "质检员A",
168 "auditStatus": 1
169 }
170 ]
171 }
172}
评价此篇文章
