全部产品
阿里云办公

获取通话详单

更新时间:2018-12-14 14:44:20

(ListCallDetailRecords)

描述

获取呼叫中心中的通话详单数据。从系统可靠性角度考虑,目前查询日期区间限制为最大7天。如果业务需要做大量数据的处理,建议您导出数据到自己的系统,做进一步的数据使用。另外页面中的下载报表功能,可以导出1个月的数据。

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数,ListCallDetailRecords
InstanceId String 呼叫中心实例ID
PhoneNumber String 待获取数据的呼叫中心的电话号码
StartTime Long 获取的历史数据的起始时间。缺省为0,代表从当天的0时开始。
StopTime Long 获取的历史数据的终止时间。缺省为0,代表截止到目前的时间。
Criteria String 搜索条件,可以根据 客户电话、坐席姓名、技能组名称 来搜索
ContactId String 通过指定的 contactId 来查询某一通电话的记录,contactId可以通过软电话SDK发生通话时获取到,详见 软电话SDK
ContactType String 按呼叫类型筛选,Inbound(呼入),Outbound(呼出),Back2Back(双呼) 多个条件以逗号隔开,如Inbound,Outbound
ContactDisposition String 按挂断类型筛选,Success(正常),NoAnswer(未接通),AbandonedInContactFlow(IVR中放弃),AbandonedInQueue(排队放弃),AbandonedRing(振铃放弃),QueueOverflow(排队超时),OneStepTransfer(转外线),多个条件以逗号隔开,如AbandonedInContactFlow, AbandonedInQueue
PageNumber Integer 分页序号
PageSize Integer 分页大小
WithRecording Boolean 是否需要录音,默认需要;显式的指明不需要可以加快查询速度
OrderBy String 按时间升降序排列,默认升序,取值: ASC/DESC

返回参数

名称 类型 是否必须 描述
CallDetailRecords Page\ 获取到的通话详单。
      TotalCount int 对象总数
      PageNumber int 分页序号
      PageSize int 分页大小
      List List\ 对象列表
            ContactId String 话务ID,全局唯一,对应于 ACC的ACID
            StartTime Long 电话开始时间,内呼从进入IVR开始,外呼从开始接通计算。the number of milliseconds since January 1, 1970, 00:00:00 GMT
            Duration Integer 通话持续时间,单位为秒。
            ContactType String 通话类型, 参考枚举类型 ContactType, Inbound(0) 内呼, Outbound(1) 外呼, Internal(2) 内部通话;
            ContactDisposition String 电话结束原因,参考枚举类型 ContactDisposition, Success(0) 正常,  NoAnswer(1) 无应答,  Rejected(2)拒绝, Busy(3)忙, AbandonedInContactFlow(4) IVR呼损, AbandonedInQueue(5)队列呼损, AbandonedRing(6) 久振不接,  QueueOverflow(7) 等待超时被挂断
            CallingNumber String 主叫号码
            CalledNumber String 被叫号码
            AgentNames String 参与通话的座席,多个座席之间以逗号分隔。
            SkillGroupNames String 参与通话的座席所述的技能组,多个技能组以逗号分隔
            InstanceId String 呼叫中心实例ID
            Recordings List\
                  AgentId String 座席ID,坐席ID等同于该座席的RAM子账户ID
                  AgentName String 座席名称
                  StartTime Long 通话开始时间
                  FileName String 录音文件名
                  FilePath String 录音文件在OSS中的保存位置

请求示例

  1. https://ccc.cn-shanghai.aliyuncs.com/?
  2. &Action=ListCallDetailRecords
  3. &InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb31f7d
  4. &StartTime=1532448000000
  5. &StopTime=1532707199000
  6. &Criteria=客服组
  7. &PageNumber=1
  8. &PageSize=10
  9. &ContactType=Outbound,Inbound
  10. &ContactDisposition=NoAnswer,AbandonedInContactFlow,AbandonedRing
  11. &OrderBy=DESC
  12. &WithRecording=true
  13. &<公共请求参数>

返回示例

  1. {
  2. "CallDetailRecords":{
  3. "PageNumber":1,
  4. "TotalCount":9,
  5. "PageSize":3,
  6. "List":{
  7. "CallDetailRecord":[
  8. {
  9. "Agents":{
  10. "CallDetailAgent":[
  11. {
  12. "AgentName":"离线坐席",
  13. "RingTime":32,
  14. "SkillGroupName":"离线技能组,
  15. Default",
  16. "ContactId":"2021372960",
  17. "AgentId":"249353919874654122"
  18. }
  19. ]
  20. },
  21. "SkillGroupNames":"离线技能组,
  22. Default",
  23. "AgentNames":"离线坐席",
  24. "CalledNumber":"17600668806",
  25. "CallingNumber":"80326034",
  26. "Recordings":{
  27. "Recording":[
  28. ]
  29. },
  30. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
  31. "Duration":32,
  32. "ContactId":"2021372960",
  33. "StartTime":1531451669000,
  34. "ContactType":"Outbound",
  35. "ContactDisposition":"NoAnswer"
  36. },
  37. {
  38. "CalledNumber":"18801341452",
  39. "Recordings":{
  40. "Recording":[
  41. {
  42. "FileDescription":"20180713170334-云呼坐席",
  43. "AgentName":"云呼坐席",
  44. "FileName":"153147261468800080327683.wav",
  45. "Duration":0,
  46. "ContactId":"2021509368",
  47. "StartTime":1531472614000,
  48. "AgentId":"293939422320312215"
  49. }
  50. ]
  51. },
  52. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
  53. "ExtraAttr":"
  54. {
  55. \"qualityTestTaskId\":\"BCEC9AD8-5EA6-4601-B340-2B36CBE29840\",
  56. \"qualityTestRequestId\":\"8a159a86-254c-4f0b-b30e-282d9f620d92\"
  57. }
  58. ",
  59. "Agents":{
  60. "CallDetailAgent":[
  61. {
  62. "AgentName":"云呼在线坐席",
  63. "RingTime":12,
  64. "TalkTime":5,
  65. "SkillGroupName":"在线坐席技能组,
  66. Default",
  67. "ContactId":"2021509368",
  68. "StartTime":1531472614000,
  69. "AgentId":"293939422320312215"
  70. }
  71. ]
  72. },
  73. "AgentNames":"云呼在线坐席",
  74. "SkillGroupNames":"在线坐席技能组,
  75. Default",
  76. "CallingNumber":"80327683",
  77. "Duration":17,
  78. "ContactId":"2021509368",
  79. "StartTime":1531472602000,
  80. "ContactType":"Outbound",
  81. "ContactDisposition":"Success"
  82. },
  83. {
  84. "CalledNumber":"18801341452",
  85. "Recordings":{
  86. "Recording":[
  87. {
  88. "FileDescription":"20180713170458",
  89. "AgentName":"云呼在线坐席",
  90. "FileName":"153147269809000080327683.wav",
  91. "Duration":0,
  92. "ContactId":"2021508646",
  93. "StartTime":1531472698000,
  94. "AgentId":"293939422320312215"
  95. }
  96. ]
  97. },
  98. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
  99. "ExtraAttr":"
  100. {
  101. \"qualityTestTaskId\":\"FB72BCB4-2085-464D-A8D1-4E012FE00D87\",
  102. \"qualityTestRequestId\":\"dec72ec3-fd3d-4326-a7a9-8ec77949135e\"
  103. }
  104. ",
  105. "Agents":{
  106. "CallDetailAgent":[
  107. {
  108. "AgentName":"云呼在线坐席",
  109. "RingTime":11,
  110. "TalkTime":1,
  111. "SkillGroupName":"在线坐席技能组,
  112. Default",
  113. "ContactId":"2021508646",
  114. "StartTime":1531472698000,
  115. "AgentId":"293939422320312215"
  116. }
  117. ]
  118. },
  119. "AgentNames":"云呼在线坐席",
  120. "SkillGroupNames":"在线坐席技能组,
  121. Default",
  122. "CallingNumber":"80327683",
  123. "Duration":12,
  124. "ContactId":"2021508646",
  125. "StartTime":1531472687000,
  126. "ContactType":"Outbound",
  127. "ContactDisposition":"Success"
  128. }
  129. ]
  130. }
  131. },
  132. "HttpStatusCode":200,
  133. "RequestId":"680B54DA-4EF6-411D-B123-B948C732115A",
  134. "Success":true,
  135. "Code":"OK"
  136. }

错误码

错误代码 描述 Http状态码 语义
ParameterNull “Parameter ‘%1’ can not be null” 400 参数不能为空。
InstanceNotExist “Call center instance ‘%1’ does not exist” 404 呼叫中心实例不存在。
PhoneNumberNotExist “Phone number ‘%s’ does not exist” 404 号码存在。
UserPermission “User ‘%1’ has no permission to ‘%2’ (User = ‘%3’)” 403 当前用户没有权限进行用户相关的操作。
ParameterOutOfRange “The value ‘%1’ of parameter ‘%2’ is out of range” 400 参数的值超出允许范围。
DatabaseService “Database service issue, table: %s, operation: %s, reason: %s” 500 数据库操作发生异常。