文档

GetCallDetailRecord - 获取通话详情

更新时间:
一键部署

调用GetCallDetailRecord获取指定实例下指定通话ID对应的通话的详情。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
ContactIdstring

通话 ID。

job-10963442671187****
InstanceIdstring

实例 ID。

ccc-test

返回参数

名称类型描述示例值
object
Codestring

响应码。

OK
HttpStatusCodeinteger

HTTP 状态码。

200
Messagestring

响应信息。

RequestIdstring

请求 ID。

7BEEA660-A45A-45E3-98CC-AFC65E715C23
Dataobject

数据。

ReleaseInitiatorstring

挂断方。

枚举值:
  • agent 坐席
  • customer 客户
customer
ContactDispositionstring

电话结束原因,注意:语音邮箱、转人工失败、排队超时、排队溢出、IVR 异常的挂断原因需要客户配置挂断原因节点才能体现出来,如果没有配置且 IVR 中无转人工模块,这时候的挂断原因默认为 IVR 放弃。

枚举值:
  • AbandonedInQueue排队放弃
  • NoAnswer客户未接
  • QueuingTimeout排队超时
  • Voicemail转语音邮箱
  • QueuingFailed转人工失败
  • QueuingOverflow排队溢出
  • AbandonedInVoiceNavigator智能导航中放弃
  • Success正常结束
  • IVRExceptionIVR系统异常
  • AbandonedInRing振铃放弃
  • AbandonedInIVRIVR放弃
  • Reject客户拒接
  • ForwardToOutsideNumber转外线
Success
ContactTypestring

通话类型。

枚举值:
  • INBOUND呼入
  • CONFERENCE会议
  • INTERNAL内部呼叫
  • PRIVACY_DIAL加密通话
  • OUTBOUND呼出
  • BACK2BACK双呼
  • PREDICTIVE预测式外呼
OUTBOUND
AgentIdsstring

坐席 ID 列表,表示通话流经的坐席,多个值用逗号分隔。

agent1@ccc-test,agent2@ccc-test
CallDurationlong

通话时长,单位秒。

50
RecordingReadyboolean

录音是否已经生成,若通话还没有建立,返回 false。

true
EstablishedTimelong

通话建立的时间,如果通话没有建立,此值为空,格式为 Unix 时间戳,单位毫秒。

1532458000000
InstanceIdstring

实例 ID。

ccc-test
SatisfactionSurveyOfferedboolean

是否发送了满意度调查。

true
CalledNumberstring

被叫号码。

1332315****
AgentNamesstring

坐席名称列表,表示通话流经的坐席,多个值用逗号隔开。

agent1,agent2
Satisfactioninteger

满意度结果,满意度的取值及含义由客户自定义。

1
StartTimelong

通话开始时间,呼入从进入 IVR 开始,呼出从开始接通计算,格式为 Unix 时间戳,单位毫秒。

1532458000000
ContactIdstring

通话 ID。

job-10963442671187****
SatisfactionSurveyChannelstring

发起满意度调查的渠道。

枚举值:
  • IVR语音满意度
  • SMS短信满意度
IVR
ReleaseTimelong

通话结束时间,以参与通话的所有对象中最后一个挂断的时间为准,格式为 Unix 时间戳,单位毫秒。

1532458000000
CallingNumberstring

主叫号码。

0533128****
SkillGroupNamesstring

参与通话的座席所属的技能组名称,多个技能组以逗号分隔。

测试技能组
SkillGroupIdsstring

参与通话的座席所属的技能组 ID,多个技能组以逗号分隔。

skillgroup@ccc-test
AgentEventsobject []

坐席事件列表。

AgentNamestring

坐席名称。

坐席小王
AgentIdstring

坐席 ID。

agent@ccc-test
SkillGroupIdstring

技能组 ID。

skillgroup@ccc-test
EventSequenceobject []

事件序列。

Eventstring

事件类型。

枚举值:
  • Released挂机
  • BlindTransfer直接转接
  • Coaching辅导
  • Barging强插
  • Consulting咨询转接
  • Ringing振铃
  • StartConference开始会议
  • Established通话建立
  • Dialing拨号
  • Intercepting强拆
  • Monitoring监控
Dialing
EventTimelong

事件发生时间戳,格式为 Unix 时间戳,单位毫秒。

1604639129000
Durationlong

时间的持续时长,单位秒。

3
IvrEventsobject []

IVR 事件列表。

FlowIdstring

IVR 联系流 ID。

edaf2eaa-8f88-44ca-812e-41b3cd2b7a90
EventSequenceobject []

事件序列。

Eventstring

事件类型。

枚举值:
  • Route2IVR进入IVR
  • AbandonedIVR中放弃
Route2IVR
EventTimelong

事件发生时间戳,格式为 Unix 时间戳,单位毫秒。

1604639129000
FlowTypestring

联系流类型。

枚举值:
  • SURVEY_FLOW满意度流程
  • MAIN_FLOW主流程
MAIN_FLOW
QueueEventsobject []

队列事件列表。

QueueIdstring

队列 ID,如果是技能组队列,则为技能组 ID,如果是坐席个人队列,则为坐席 ID。

skillgroup@ccc-test
QueueNamestring

队列名称。

测试技能组
FlowIdstring

联系流 ID。

edaf2eaa-8f88-44ca-812e-41b3cd2b7a90
QueueTypeinteger

队列类型。

枚举值:
  • 1技能组
  • 2坐席
1
EventSequenceobject []

事件序列。

Eventstring

事件类型。

枚举值:
  • AssignAgent分配坐席
  • GiveUp振铃放弃
  • Enqueue进队列
  • QueueingOverflow排队溢出
  • Abandoned队列放弃
  • QueueingTimeout排队超时
Enqueue
EventTimelong

事件发生时间戳,格式为 Unix 时间戳,单位毫秒。

1604639129000
CustomerEventsobject []

客户事件列表。

CustomerIdstring

客户 ID,通常为客户号码。

1332315****
EventSequenceobject []

事件序列。

Eventstring

事件类型。

枚举值:
  • established通话建立
  • ringing振铃
  • released挂机
Released
EventTimelong

事件发生时间戳,格式为 Unix 时间戳,单位毫秒。

1532458000000
CallerLocationstring

主叫号码的归属地信息。

山东省-淄博
CalleeLocationstring

被叫号码的归属地信息。

河北省-唐山
EarlyMediaStatestring

早媒体状态,指通话在早媒体阶段发生异常,此时通常是呼叫客户的阶段,发生异常会导致呼叫客户失败,因此该状态是根据早媒体的状态分析出来的可能的未接通原因。

枚举值:
  • NoAnswer无人接听
  • OutOfService停机
  • NotExist空号
  • Restricted呼叫受限
  • Busy占线
  • NotConnected无法接通
  • PowerOff关机
NotConnected
ReleaseReasonstring

通话结束原因,一般是 SipCode 加文字描述格式.

200 - OK

示例

正常返回示例

JSON格式

{
  "Code": "OK",
  "HttpStatusCode": 200,
  "Message": "无",
  "RequestId": "7BEEA660-A45A-45E3-98CC-AFC65E715C23",
  "Data": {
    "ReleaseInitiator": "customer",
    "ContactDisposition": "Success",
    "ContactType": "OUTBOUND",
    "AgentIds": "agent1@ccc-test,agent2@ccc-test",
    "CallDuration": 50,
    "RecordingReady": true,
    "EstablishedTime": 1532458000000,
    "InstanceId": "ccc-test",
    "SatisfactionSurveyOffered": true,
    "CalledNumber": "1332315****",
    "AgentNames": "agent1,agent2",
    "Satisfaction": 1,
    "StartTime": 1532458000000,
    "ContactId": "job-10963442671187****",
    "SatisfactionSurveyChannel": "IVR",
    "ReleaseTime": 1532458000000,
    "CallingNumber": "0533128****",
    "SkillGroupNames": "测试技能组",
    "SkillGroupIds": "skillgroup@ccc-test",
    "AgentEvents": [
      {
        "AgentName": "坐席小王",
        "AgentId": "agent@ccc-test",
        "SkillGroupId": "skillgroup@ccc-test",
        "EventSequence": [
          {
            "Event": "Dialing",
            "EventTime": 1604639129000,
            "Duration": 3
          }
        ]
      }
    ],
    "IvrEvents": [
      {
        "FlowId": "edaf2eaa-8f88-44ca-812e-41b3cd2b7a90",
        "EventSequence": [
          {
            "Event": "Route2IVR",
            "EventTime": 1604639129000
          }
        ],
        "FlowType": "MAIN_FLOW"
      }
    ],
    "QueueEvents": [
      {
        "QueueId": "skillgroup@ccc-test",
        "QueueName": "测试技能组",
        "FlowId": "edaf2eaa-8f88-44ca-812e-41b3cd2b7a90",
        "QueueType": 1,
        "EventSequence": [
          {
            "Event": "Enqueue",
            "EventTime": 1604639129000
          }
        ]
      }
    ],
    "CustomerEvents": [
      {
        "CustomerId": "1332315****",
        "EventSequence": [
          {
            "Event": "Released",
            "EventTime": 1532458000000
          }
        ]
      }
    ],
    "CallerLocation": " 山东省-淄博",
    "CalleeLocation": "河北省-唐山",
    "EarlyMediaState": "NotConnected",
    "ReleaseReason": "200 - OK"
  }
}

错误码

HTTP status code错误码错误信息描述
400Parameter.BlankThe parameter %s may not be null or blank.该参数不能为null或含有空白符的字符串。

访问错误中心查看更多错误码。

  • 本页导读 (0)
文档反馈