呼叫数据
更新时间：2023-07-05
呼叫中心数据
数据查询
通话结果明细查询
调用地址 : https://bior.bce.baidu.com/data_consumer/Interface/{token}/callResultDetail
Http请求方式 : Post/JSON
| 参数名 | 类型(长度) | 说明 | 是否必填 |
|---|---|---|---|
| sessionId | String(20) | 呼叫标识编号 | N |
| timestamp | String(32) | 时间戳 | Y |
| startTime | String(32) | 开始时间 | N |
| endTime | String(32) | 结束时间 | N |
| endType | String(32) | 结束类型( 呼入-252-正常挂断 呼入-210-排队挂断 呼入-251-振铃挂断 呼出-205-正常挂断 呼出-204-排队挂断) |
N |
| callType | String(32) | 通话类型0-呼入 1-呼出 | Y |
Plain Text
1JSON实例：
2{
3 "sessionId": "7952655269589156120",
4"timestamp":"20191026191919",
5"startTime":"2021-01-03 19:19:19",
6"endTime":"2021-01-28 19:19:19",
7"endType":"1",
8"callType":"1"
9
10
11}返回参数：
| 参数名 | 类型(长度) | 说明 |
|---|---|---|
| code | Int(6) | 状态说明 |
| msg | String(50) | 请求成功 |
| data | JSONObject | 明细数据 |
| sessionId | String(20) | 通话标识 |
| startTime | String(32) | 开始时间 |
| endTime | String(32) | 结束时间 |
| calledStartTime | String(32) | 被叫接通时间 |
| callerStartTime | String(32) | 主叫接通时间 |
| custNum | String(32) | 客户号码 |
| managerNum | String(32) | 坐席号码 |
| dialNum | String(32) | 外显号码 |
| custRingTime | String(10) | 客户振铃时长 |
| managerRingTime | String(10) | 坐席振铃时长 |
| talkLength | String(10) | 通话时长 |
| endType | String(6) | 结束类型 , 参考通话结束类型说明 |
| agentId | String(32) | 坐席工号 |
| callType | String(2) | 呼叫类型 ,参考 呼叫类型说明 |
| recordStartTime | String(32) | 录音开始时间 |
| recordEndTime | String(32) | 录音结束时间 |
| recordPath | String(100) | 录音文件路径 |
| totalDuration | String(20) | 通话总时长 |
Plain Text
1JSON实例：
2{
3"code":"200",
4"msg":"请求成功",
5"data": {
6"sessionId": "7952655269589156120",
7"startTime": "2019-09-18 14:57:02",
8"endTime": "2019-09-18 14:57:12",
9"calledStartTime": "2019-09-18 14:57:12",
10"callerStartTime": "2019-09-18 14:57:12",
11"custNum": "158xxxxxxxx",
12"custManagerNum": "185xxxxxxxx",
13"dialNum": "021xxxxxxxx",
14“custRingTime”:”00:00:00”,
15“managerRingTime”:”00:00:02”,
16"talkLength": "00:00:10",
17"endType": "252",
18"agentId": "1020",
19"callType": "1",
20"recordStartTime": "2019-09-18 14:57:02",
21"recordEndTime": "2019-09-18 14:57:12",
22"recordPath": "/xx/xxx/xx/"
23}
24 }呼损明细查询
调用地址 : https://bior.bce.baidu.com/data_consumer/Interface/{token}/callLossDetail
Http请求方式 : Post/JSON
| 参数名 | 类型(长度) | 说明 | 是否必填 |
|---|---|---|---|
| sessionId | String(20) | 呼叫标识编号 | N |
| timestamp | String(32) | 时间戳 | Y |
| startTime | String(32) | 开始时间 | Y |
| endTime | String(32) | 结束时间 | Y |
Plain Text
1JSON实例：
2{
3 "sessionId":"7952655269589156120",
4"timestamp":"20191026191919",
5"startTime":"2021-01-03 19:19:19",
6"endTime":"2021-01-02 19:19:19"
7}返回参数：
| 参数名 | 类型(长度) | 说明 |
|---|---|---|
| code | Int(6) | 状态说明 |
| msg | String(50) | 请求成功 |
| data | JSONObject | 明细数据 |
| custNum | String(32) | 客户号码 |
| managerNum | String(32) | 坐席号码 |
| managerRingTime | String(10) | 坐席振铃时长 |
| agentId | String(32) | 坐席工号 |
| callType | String(2) | 呼叫类型 ,参考 呼叫类型说明 |
| sessionId | String(32) | 会话标识 |
| startTime | String(32) | 开始时间 |
| endTime | String(32) | 结束时间 |
Plain Text
1JSON实例：
2{
3 "code":"200",
4 "msg":"请求成功",
5 "data": {
6 "managerNum": "037xxxxxxxx",
7 "agentId": "agent001",
8 "custNum": "015522635760",
9 "startTime": "2021-02-03 12:41:27.0",
10 "managerRingTime": "15",
11 "sessionId": "7953385707328766030",
12 "endTime": "2021-02-03 12:41:42.0",
13 "callType": "0"
14 }
15 }查询来电次数接口
调用地址 : https://bior.bce.baidu.com/report_consumer/report/{token}/getCallNumber
Http请求方式：POST
请求参数说明：
| 参数名称 | 参数说明 | 参数类型 |
|---|---|---|
| telephone | 电话号码 | String |
| timestamp | 时间戳(yyyyMMddhhmmss) | String |
返回参数说明：
| 参数名称 | 参数说明 | 备注 |
|---|---|---|
| code | 返回状态码 | 200(成功) |
| msg | 返回系统信息 | 请求成功 |
| todayCount | 返回本日数量 | 整型，来电次数 |
| yearCount | 返回本年数量 | 整型，来电次数 |
返回说明 示例： 成功:
Plain Text
1{
2 "msg": "请求成功",
3 "code": 200,
4"todayCount": 5，
5"yearCount"：20
6}失败:
Plain Text
1{"code":"403","msg":"请求无效，鉴权失败"}通话结果月明细查询
调用地址 : https://bior.bce.baidu.com/data_consumer/Interface/{token}/callResultMonthDetail
Http请求方式 : Post/JSON
| 参数名 | 类型(长度) | 说明 | 是否必填 |
|---|---|---|---|
| sessionId | String(20) | 呼叫标识编号 | N |
| timestamp | String(32) | 时间戳 | Y |
| startTime | String(32) | 开始时间 | Y |
| endTime | String(32) | 结束时间 | N |
| endType | String(32) | 结束类型( 呼入-252-正常挂断 呼入-210-排队挂断 呼入-251-振铃挂断 呼出-205-正常挂断 呼出-204-排队挂断) |
N |
| callType | String(32) | 通话类型0-呼入 1-呼出 | Y |
JSON实例：
Plain Text
1{
2 "sessionId": "7952655269589156120",
3"timestamp":"20191026191919"
4"startTime":"2021-01-03 19:19:19"
5"endTime":"2021-05-25 19:19:19",
6"endType":"1",
7"callType":"1"
8
9
10}返回参数：
| 参数名 | 类型(长度) | 说明 |
|---|---|---|
| code | Int(6) | 状态说明 |
| msg | String(50) | 请求成功 |
| data | JSONObject | 明细数据 |
| sessionId | String(20) | 通话标识 |
| startTime | String(32) | 开始时间 |
| endTime | String(32) | 结束时间 |
| calledStartTime | String(32) | 被叫接通时间 |
| callerStartTime | String(32) | 主叫接通时间 |
| custNum | String(32) | 客户号码 |
| managerNum | String(32) | 坐席号码 |
| dialNum | String(32) | 外显号码 |
| custRingTime | String(10) | 客户振铃时长 |
| managerRingTime | String(10) | 坐席振铃时长 |
| talkLength | String(10) | 通话时长 |
| endType | String(6) | 结束类型 , 参考通话结束类型说明 |
| agentId | String(32) | 坐席工号 |
| callType | String(2) | 呼叫类型 ,参考 呼叫类型说明 |
| recordStartTime | String(32) | 录音开始时间 |
| recordEndTime | String(32) | 录音结束时间 |
| recordPath | String(100) | 录音文件路径 |
| totalDuration | String(20) | 通话总时长 |
JSON实例：
Plain Text
1{
2 "code":"200",
3 "msg":"请求成功",
4 "data": {
5 "sessionId": "7952655269589156120",
6 "startTime": "2019-09-18 14:57:02",
7 "endTime": "2019-09-18 14:57:12",
8"calledStartTime": "2019-09-18 14:57:12",
9"callerStartTime": "2019-09-18 14:57:12",
10 "custNum": "15835102037",
11 "custManagerNum": "185xxxxxxxx",
12 "dialNum": "021xxxxxxxx",
13“custRingTime”:”00:00:00”,
14“managerRingTime”:”00:00:02”,
15 "talkLength": "00:00:10",
16 "endType": "252",
17 "agentId": "1020",
18 "callType": "1",
19 "recordStartTime": "2019-09-18 14:57:02",
20 "recordEndTime": "2019-09-18 14:57:12",
21 "recordPath": "/xx/xxx/xx/",
22"entId": "XXXX"
23 }
24 }话务结果明细查询
调用地址 : https://bior.bce.baidu.com/data_consumer/Interface/{token}/callDetailsThereport
Http请求方式 : Post/JSON
| 参数名 | 类型(长度) | 说明 | 是否必填 |
|---|---|---|---|
| sessionId | String(20) | 呼叫标识编号 | N |
| timestamp | String(32) | 时间戳 | Y |
| startTime | String(32) | 开始时间 | Y |
| endTime | String(32) | 结束时间 | Y |
JSON实例：
Plain Text
1{
2"sessionId": "7952655269589156120",
3"timestamp":"20231026191919",
4"startTime":"2021-01-03 19:19:19",
5"endTime":"2021-05-25 19:19:19"
6}返回参数：
| 参数名 | 类型(长度) | 说明 |
|---|---|---|
| code | Int(6) | 状态说明 |
| msg | String(50) | 请求成功 |
| count | Int(32) | 结果数据条数 |
| data | JSONObject | 明细数据 |
| result | JSONArray | 结果数据 |
| sessionId | String(32) | 通话标识 |
| skillId | String(32) | 技能组ID或地区ID |
| skillName | String(32) | 技能组或地区 |
| startTime | String(32) | 话单开始时间 |
| endTime | String(32) | 话单结束时间 |
| callType | String(32) | 呼叫类型(呼入,呼出) |
| localUrl | String(32) | 本地号码 |
| remoteUrl | String(32) | 远端号码 |
| talkDuration | int(32) | 通话时长 |
| endType | String(32) | 结束类型(接通,未接通) |
| userAppraise | String(32) | 用户满意度(满意,不满意) |
| ivrDuration | int(32) | Ivr时长(秒) |
| alertDuration | int(32) | 振铃时长(秒) |
| queueDuration | int(32) | 排队时长(秒) |
| queueNum | int(32) | 排队次数 |
JSON实例：
Plain Text
1{
2 "msg": "请求成功",
3 "code": 200,
4 "data": {
5 "result": [
6 {
7 "queueNum": 1,
8 "endType": "未接通",
9 "ivrDuration": 8,
10 "sessionId": "7954177067065540636",
11 "callType": "呼入",
12 "userAppraise": null,
13 "localUrl": "15534042794",
14 "skillName": "测试组",
15 "skillId": "363",
16 "queueDuration": 1,
17 "alertDuration": 0,
18 "remoteUrl": "031xxxxxxxx",
19 "startTime": "2022-08-03 11:06:43",
20 "talkDuration": 0,
21 "endTime": "2022-08-03 11:06:52"
22 }
23 ],
24 "count": 1
25 }
26}数据推送接口
通话事件回调接口
调用地址 : https://bior.bce.baidu.com/customer/
Http请求方式：POST /JSON
请求参数说明：
| 名称 | 类型 | 说明 |
|---|---|---|
| EventType | string | 事件类型，详见事件属性 |
| CallDetailEvent | string | 事件名称，详见事件属性 |
| MessageID | string | 消息ID |
| OrgANI | string | 原始主叫号码 |
| OrgDNIS | string | 原始被叫号码 |
| ANI | string | 主叫号码 |
| DNIS | string | 被叫号码 |
| CslANI | string | 咨询主叫号码 |
| CslDNIS | string | 咨询被叫号码 |
| ServiceType | string | 服务类型 (ACDService：呼出，IVRService：呼入，NoService：其他状态) |
| OrgReqSkill | string | 原始请求技能（nodata：呼出，呼入： 具体的技能组 例如：业务咨询） |
| ResSkill | string | 请求技能 |
| CallType | string | 呼叫方向（INTERNAL：呼入， OUTBOUND：呼出） |
| SessionID | string | 通话标识（格式： SessionID:企业账号） |
| IVRData | string | IVR随路数据（ nodata：无数据） |
| AgentMessage | string | 坐席消息描述 |
| StrDestAgentId | string | 坐席工号 |
| CallStartTime | string | 外呼开始时间 |
Json示例{
Plain Text
1 {
2 "CslDNIS": "",
3 "IVRData": "",
4 “CallStartTime”:” 2022-06-17 00:00:19”,
5 "EventType": " ",
6 "ResSkill": "",
7 "CallType": "OUTBOUND",
8 "OrgReqSkill": "",
9 "AgentMessage": "通话事件: 外部呼叫本方振铃(CALL_EVENT_OUTBOUND_ALERTING_TP)",
10 "EnterpriseId": "HUDD",
11 "Result": "0",
12 "bIsInfo": "False",
13 "CallDetailEvent": "CA_CALL_EVENT_OUTBOUND_ALERTING_TP",
14 "DNIS": " ",
15 "ServiceType": "NoService",
16 "OrgDNIS": " ",
17 "webSocketSessionId": "",
18 "CslANI": "",
19 "strDestAgentId": "",
20 "ANI": "",
21 "OrgANI": "",
22 "SessionID": "",
23 "MessageID": " "
24}
25
26}常量属性
事件状态属性
| 类型 | 名称 | 说明 |
| EventType | AgentStatus_Connecting | 外呼对方振铃 | AgentStatus_Disconnected | 挂断事件 | AgentStatus_Connected_Normal | 通话事件 | AgentStatus_Alerting | 振铃事件 | AgentStatus_ACW | 事后整理 | AgentStatus_Ready | 坐席置闲 | AgentStatus_Otherwork | 坐席置忙 | AgentStatus_Logout | UC未登陆/登出 | AgentStatus_Suspended | 坐席保持 | AgentStatus_Login | 坐席登录 | AgentStatus_Consulted | 咨询事件 | AgentStatus_Conferenced | 会议事件 | AgentStatus_Monitored | 监听事件 | AgentStatus_Inserted | 强插事件 |
| CallDetailEvent | CA_CALL_EVENT_ALERTING | 呼入振铃 | CA_CALL_EVENT_CONNECTED | 呼入接通 | CA_CALL_EVENT_OP_DISCONNECT | 对方挂机 | CA_CALL_EVENT_TP_DISCONNECT | 本方挂机 | CA_CALL_EVENT_THIRD_PARTY_DISCONNECT | 第三方挂机 | CA_CALL_EVENT_FOURTH_PARTY_DISCONNECT | 第四方挂机 | CA_CALL_EVENT_HOLD | 保持 | CA_CALL_EVENT_HOLD_RETRIEVE | 保持接回 | CA_CALL_EVENT_CONSULT_CONNECTED_OP | 咨询对方接通 | CA_CALL_EVENT_CONSULT_RETRIEVE | 咨询接回 | CA_CALL_EVENT_CONFERENCE | 会议 | CA_CALL_EVENT_INTERNAL_ALERTING_TP | 内线本方振铃 | CA_CALL_EVENT_MONITOR | 监听 | CA_CALL_EVENT_INTRUDE | 强插 | CA_CALL_EVENT_TEARDOWN | 强拆 | CA_CALL_EVENT_MONITOR_ALERTING | 监听振铃 | CA_CALL_EVENT_INTERNAL_CONNECTED_TP | 内线本方接通 | CA_CALL_EVENT_CONSULT_ALERTING_TP | 咨询本方振铃 | CA_CALL_EVENT_CONSULT_CONNECTED_TP | 咨询本方应答 | CA_CALL_EVENT_OUTBOUND_ALERTING_TP | 外呼本方振铃 | CA_CALL_EVENT_OUTBOUND_CONNECTED_TP | 外呼本方接通 | CA_CALL_EVENT_CLEAR_CALL | 全拆 | CA_CALL_EVENT_OUTBOUND_ALERTING_OP | 外呼对方振铃 |
消息类型
| 类型 | 消息编码 | 消息说明 |
| 坐席状态 | Evt_AgentStatus_Login | 登录 | Evt_AgentStatus_Logout | 登出 | Evt_AgentStatus_Otherwork | 置忙 | Evt_AgentStatus_Ready | 置闲 | Evt_AgentStatus_ACW | 事后整理 |
| 设备话务状态 | Evt_AgentStatus_Alerting | 振铃 | Evt_AgentStatus_Connecting | 外呼对方振铃 | Evt_AgentStatus_Connected_Normal | 双方通话 | Evt_AgentStatus_Disconnected | 挂断 | Evt_AgentStatus_Suspended | 保持 | Evt_AgentStatus_Consulted | 咨询 | Evt_AgentStatus_Conferenced | 会议 | Evt_AgentStatus_Monitored | 监听 | Evt_AgentStatus_Inserted | 强插 |
呼叫类型
| 编码 | 说明 |
|---|---|
| 1 | 外部呼叫 |
呼叫方向
| 编码 | 说明 |
|---|---|
| INTERNAL | 呼入 |
| OUTBOUND | 呼出 |
咨询类型
| 编码 | 说明 |
|---|---|
| 1 | 内线 |
| 2 | 外线 |