呼叫数据
更新时间: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 |
JSON实例:
{
"sessionId": "7952655269589156120",
"timestamp":"20191026191919",
"startTime":"2021-01-03 19:19:19",
"endTime":"2021-01-28 19:19:19",
"endType":"1",
"callType":"1"
}
返回参数:
参数名 | 类型(长度) | 说明 |
---|---|---|
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实例:
{
"code":"200",
"msg":"请求成功",
"data": {
"sessionId": "7952655269589156120",
"startTime": "2019-09-18 14:57:02",
"endTime": "2019-09-18 14:57:12",
"calledStartTime": "2019-09-18 14:57:12",
"callerStartTime": "2019-09-18 14:57:12",
"custNum": "158xxxxxxxx",
"custManagerNum": "185xxxxxxxx",
"dialNum": "021xxxxxxxx",
“custRingTime”:”00:00:00”,
“managerRingTime”:”00:00:02”,
"talkLength": "00:00:10",
"endType": "252",
"agentId": "1020",
"callType": "1",
"recordStartTime": "2019-09-18 14:57:02",
"recordEndTime": "2019-09-18 14:57:12",
"recordPath": "/xx/xxx/xx/"
}
}
呼损明细查询
调用地址 : 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 |
JSON实例:
{
"sessionId":"7952655269589156120",
"timestamp":"20191026191919",
"startTime":"2021-01-03 19:19:19",
"endTime":"2021-01-02 19:19:19"
}
返回参数:
参数名 | 类型(长度) | 说明 |
---|---|---|
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) | 结束时间 |
JSON实例:
{
"code":"200",
"msg":"请求成功",
"data": {
"managerNum": "037xxxxxxxx",
"agentId": "agent001",
"custNum": "015522635760",
"startTime": "2021-02-03 12:41:27.0",
"managerRingTime": "15",
"sessionId": "7953385707328766030",
"endTime": "2021-02-03 12:41:42.0",
"callType": "0"
}
}
查询来电次数接口
调用地址 : https://bior.bce.baidu.com/report_consumer/report/{token}/getCallNumber
Http请求方式:POST
请求参数说明:
参数名称 | 参数说明 | 参数类型 |
---|---|---|
telephone | 电话号码 | String |
timestamp | 时间戳(yyyyMMddhhmmss) | String |
返回参数说明:
参数名称 | 参数说明 | 备注 |
---|---|---|
code | 返回状态码 | 200(成功) |
msg | 返回系统信息 | 请求成功 |
todayCount | 返回本日数量 | 整型,来电次数 |
yearCount | 返回本年数量 | 整型,来电次数 |
返回说明 示例: 成功:
{
"msg": "请求成功",
"code": 200,
"todayCount": 5,
"yearCount":20
}
失败:
{"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实例:
{
"sessionId": "7952655269589156120",
"timestamp":"20191026191919"
"startTime":"2021-01-03 19:19:19"
"endTime":"2021-05-25 19:19:19",
"endType":"1",
"callType":"1"
}
返回参数:
参数名 | 类型(长度) | 说明 |
---|---|---|
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实例:
{
"code":"200",
"msg":"请求成功",
"data": {
"sessionId": "7952655269589156120",
"startTime": "2019-09-18 14:57:02",
"endTime": "2019-09-18 14:57:12",
"calledStartTime": "2019-09-18 14:57:12",
"callerStartTime": "2019-09-18 14:57:12",
"custNum": "15835102037",
"custManagerNum": "185xxxxxxxx",
"dialNum": "021xxxxxxxx",
“custRingTime”:”00:00:00”,
“managerRingTime”:”00:00:02”,
"talkLength": "00:00:10",
"endType": "252",
"agentId": "1020",
"callType": "1",
"recordStartTime": "2019-09-18 14:57:02",
"recordEndTime": "2019-09-18 14:57:12",
"recordPath": "/xx/xxx/xx/",
"entId": "XXXX"
}
}
话务结果明细查询
调用地址 : 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实例:
{
"sessionId": "7952655269589156120",
"timestamp":"20231026191919",
"startTime":"2021-01-03 19:19:19",
"endTime":"2021-05-25 19:19:19"
}
返回参数:
参数名 | 类型(长度) | 说明 |
---|---|---|
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实例:
{
"msg": "请求成功",
"code": 200,
"data": {
"result": [
{
"queueNum": 1,
"endType": "未接通",
"ivrDuration": 8,
"sessionId": "7954177067065540636",
"callType": "呼入",
"userAppraise": null,
"localUrl": "15534042794",
"skillName": "测试组",
"skillId": "363",
"queueDuration": 1,
"alertDuration": 0,
"remoteUrl": "031xxxxxxxx",
"startTime": "2022-08-03 11:06:43",
"talkDuration": 0,
"endTime": "2022-08-03 11:06:52"
}
],
"count": 1
}
}
数据推送接口
通话事件回调接口
调用地址 : 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示例{
{
"CslDNIS": "",
"IVRData": "",
“CallStartTime”:” 2022-06-17 00:00:19”,
"EventType": " ",
"ResSkill": "",
"CallType": "OUTBOUND",
"OrgReqSkill": "",
"AgentMessage": "通话事件: 外部呼叫本方振铃(CALL_EVENT_OUTBOUND_ALERTING_TP)",
"EnterpriseId": "HUDD",
"Result": "0",
"bIsInfo": "False",
"CallDetailEvent": "CA_CALL_EVENT_OUTBOUND_ALERTING_TP",
"DNIS": " ",
"ServiceType": "NoService",
"OrgDNIS": " ",
"webSocketSessionId": "",
"CslANI": "",
"strDestAgentId": "",
"ANI": "",
"OrgANI": "",
"SessionID": "",
"MessageID": " "
}
}
常量属性
事件状态属性
类型 | 名称 | 说明 |
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 | 外线 |