调用ListCallEventDetailByContactId根据通话ID获取通话的详细操作日志。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String ListCallEventDetailByContactId

系统规定参数。取值:ListCallEventDetailByContactId

ContactId String 1096645650

通过指定的contactId来查询某一通电话的记录,contactId可以通过软电话SDK发生通话时获取到。

InstanceId String 9cfad875-6260-4a53-ab6e-b13e3fb3****

呼叫中心实例ID

返回数据

名称 类型 示例值 描述
Code String OK

响应码

Data Struct

获取到的通话详单

CallType String Outbound

呼叫类型

Callee String 1350121****

被叫号码

Caller String 8031****

主叫号码

Events Array of CallEventDetail

对象列表

CallEventDetail
AgentName String cloudcallcenter

坐席名

CallMode String Outbound

通话类型

DetailData Struct

动态添加所需的详细信息

EventType String agent

事件类型 包括:ivr、queue、agent。

HangUper String byeSystem

被求助者,求助内部坐席,对应坐席名称;求助外部的话,记录外部号码。

Helper String xme

挂机者

SatisfactionalResearch String 不满意

满意度调查

SkillGroup String 测试

技能组

Duration Integer 9

持续时间

Event String Dial

事件描述。

包括:

  • IVR事件:EnterIVR (进入IVR);
  • 队列事件:EnterQueue(进入队列)、ACDOverflow(队列溢出)、AbandonedRing(振铃放弃)、NormalEnd(队列中正常结束)、AbandonedInQueue(进入放弃队列)、WaitingInQueue(进入等待队列);
  • 坐席事件:Ring(振铃)、Talk(通话)、GiveUp(放弃)、End(结束)、Handle(挂断)、CallForHelp(发起求助)、CallForHelpSuccess(求助成功)、SetUpMeeting(会议建立)、Dial(拨号)、LaunchTransfer(转接)。
Status String Dialing

状态

TimeStamp String 1555492246000

事件发生时间

PrivacyNumber String 1234****

虚拟号码

ReleaseAgent String agent

挂断方,customer:用户挂机;agent:坐席挂机,同时提醒,目前有部分数据为兼容,如出现特殊数据请反馈给云呼技术值班同学进行挂断方的定位。

ReleaseReason String 487-Request Terminated

挂断原因

StartTime String 1555492246000

呼叫时间

HttpStatusCode Integer 200

HTTP状态码

Message String

响应信息

RequestId String 7BEEA660-A45A-45E3-98CC-AFC65E715C23

请求ID

Success Boolean true

是否成功

示例

请求示例

http(s)://[Endpoint]/?Action=ListCallEventDetailByContactId
&ContactId=1096645650
&InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb3****
&<公共请求参数>

正常返回示例

XML格式

<Message>无</Message>
<RequestId>7BEEA660-A45A-45E3-98CC-AFC65E715C23</RequestId>
<HttpStatusCode>200</HttpStatusCode>
<Data>
    <Callee>1350121****</Callee>
    <ReleaseReason>487-Request Terminated</ReleaseReason>
    <Caller>8031****</Caller>
    <PrivacyNumber>1234****</PrivacyNumber>
    <ReleaseAgent>agent</ReleaseAgent>
    <StartTime>1555492246000</StartTime>
    <CallType>Outbound</CallType>
    <Events>
        <CallEventDetail>
            <Status>Dialing</Status>
            <Event>Dial</Event>
            <Duration>9</Duration>
            <AgentName>cloudcallcenter</AgentName>
            <CallMode>Outbound</CallMode>
            <TimeStamp>1555492246000</TimeStamp>
            <DetailData>
                <Helper>xme</Helper>
                <SkillGroup>测试</SkillGroup>
                <HangUper>byeSystem</HangUper>
                <EventType>agent</EventType>
                <SatisfactionalResearch>不满意</SatisfactionalResearch>
            </DetailData>
        </CallEventDetail>
    </Events>
</Data>
<Code>OK</Code>
<Success>true</Success>

JSON格式

{
    "Message": "无",
    "RequestId": "7BEEA660-A45A-45E3-98CC-AFC65E715C23",
    "HttpStatusCode": 200,
    "Data": {
        "Callee": "1350121****",
        "ReleaseReason": "487-Request Terminated",
        "Caller": "8031****",
        "PrivacyNumber": "1234****",
        "ReleaseAgent": "agent",
        "StartTime": 1555492246000,
        "CallType": "Outbound",
        "Events": {
            "CallEventDetail": {
                "Status": "Dialing",
                "Event": "Dial",
                "Duration": 9,
                "AgentName": "cloudcallcenter",
                "CallMode": "Outbound",
                "TimeStamp": 1555492246000,
                "DetailData": {
                    "Helper": "xme",
                    "SkillGroup": "测试",
                    "HangUper": "byeSystem",
                    "EventType": "agent",
                    "SatisfactionalResearch": "不满意"
                }
            }
        }
    },
    "Code": "OK",
    "Success": true
}

错误码

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