有奖捉虫:云通信与企业服务文档专题,速来> HOT
CDR 以整体会话为维度记录数据,一次客户的整体呼入或者呼出对应一条数据。CDR 的 root 层数据指标表示的是以客户为维度的会话全局信息。 会话服务中的具体细节轨迹通过 ServeParticipants 对象数组描述(例如:电话转接等信息),ServeParticipants 每一条数据代表了一次服务轨迹。
呼出类型数据 QueuedSkillGroupID 字段选取策略:
客服只属于一个电话技能组,则命中。
客服属于多个电话技能组,优先选择外呼号码绑定的技能组(多个取第一个技能组)。
不满足1、2,则取客服第一个电话技能组。
URL:https://{custom_url}?action=cdr&version=1 METHOD: POST Content-Type: application/json;charset=utf8 REQUEST:
参数
类型
说明
SdkAppId
数值(长整型)
联络中心实例 ID
SessionId
字符串
会话 ID
Caller
字符串
主叫方
Callee
字符串
被叫方
Direction
数值
会话整体方向:
0:呼入
1:呼出
Duration
数值
会话整体服务时间,单位:秒;EndedTimestamp-AcceptTimestamp
SeatUser
对象
客服信息,格式见下(如果发生转接则是最后一个客服信息)
CallerLocation
字符串
主叫电话号码归属地
IVRDuration
数值
IVR 阶段持续时长,单位秒,QueuedTimestamp - StartTimestamp
RingTimestamp
数值
会话方向为呼入时,表示座席侧开始振铃时间戳(UNIX秒级时间戳)
会话方向为呼出时,表示用户侧开始振铃时间戳(UNIX秒级时间戳)
AcceptTimestamp
数值
会话方向为呼入时,表示座席侧开始接听时间戳(UNIX秒级时间戳)
会话方向为呼出时,表示用户侧开始接听时间戳(UNIX秒级时间戳)
EndedTimestamp
数值
会话整体结束时间戳(UNIX 秒级时间戳)
StartTimestamp
数值
整个会话开始时间戳(UNIX 秒级时间戳)
IVRKeyPressed
字符串数组
IVR 按键信息(e.g. ["1","2","3"])
IVRKeyPressedEx
对象数组
IVR 按键信息(e.g. [{"Key":"1","Label":"非常满意"}])
HungUpSide
字符串
挂断方(user - 用户挂断 或 seat - 座席挂断)
ServeParticipants
对象数组
服务参与者列表,格式见下表
EndStatusString
字符串
会话整体结束状态,详情请参见 EndStatusString
QueuedTimestamp
数值
会话方向为呼入时,用户进入排队的时间
PostIVRKeyPressed
对象数组
后置 IVR 按键信息(e.g. [{"Key":"1","Label":"非常满意"}])
QueuedSkillGroupName
字符串
会话方向为呼入时,用户进入排队的技能组名称
QueuedSkillGroupId
数值
会话进入排队技能组 ID
RecordId
字符串
录音 ID,用户侧录音。
UserRemark
字符串
用户备注
Uui
字符串
随入数据(电话外呼接口客户带入的数据)
TelLocation
Json 对象
号码归属地相关信息,格式见下
SeatUser 数据格式:
参数
类型
说明
Mail
字符串
座席邮箱
Name
字符串
座席名称
Nick
字符串
座席昵称
Phone
字符串
座席电话号码
UserId
字符串
用户 ID
StaffNumber
字符串
座席工号
SkillGroupNameList
字符串数组
座席所属技能组列表
ServeParticipants 数据格式:
参数
类型
说明
Mail
字符串
座席邮箱
Phone
字符串
座席电话
RingTimestamp
数值(长整型)
振铃时间戳,Unix 秒级时间戳
AcceptTimestamp
数值(长整型)
接听时间戳,Unix 秒级时间戳
EndedTimestamp
数值(长整型)
结束时间戳,Unix 秒级时间戳
RecordId
字符串
录音 ID
Type
字符串
参与者类型:
staffSeat
outboundSeat
staffPhoneSeat
miniProgramSeat
TransferFrom
字符串
转接来源座席信息
TransferFromType
字符串
转接来源座席类型
TransferTo
字符串
转接去向座席信息
TransferToType
字符串
转接去向参与者类型,取值与 Type 一致
SkillGroupId
数值
技能组 ID
EndStatusString
字符串
会话参与者结束状态,详情请参见 EndStatusString
Sequence
数值
参与者序号,从 0 开始
StartTimestamp
数值(长整型)
开始时间戳,Unix 秒级时间戳
SkillGroupName
字符串
技能组名称
SkillGroupPriority
数值
技能组分配优先级
TelLocation 数据格式:
参数
类型
说明
TelNumber
字符串
号码
Country
字符串
国家
Province
字符串
省份
City
字符串
城市
Operator
字符串
运营商
RESPONSE:
参数
类型
说明
ErrMsg
字符串
错误说明
ErrCode
数值
错误码
数据样例:
{
"SessionId": "99a1c8f8-eb3d-4xxx-8401-5f6aa8761232",
"Caller": "0086400xxx6666",
"Callee": "0086184xxxx7605",
"Direction": 1,
"Duration": 0,
"SeatUser": {
"Mail": "zhangsan@tencent.con",
"Name": "张三",
"Nick": "优优",
"Phone": "",
"UserId": "zhangsan@tencent.com",
"StaffNumber": "8546",
"SkillGroupNameList": [
"顾问外呼"
]
},
"CallerLocation": "",
"IVRDuration": 0,
"RingTimestamp": 1677140072,
"AcceptTimestamp": 0,
"EndedTimestamp": 1677140081,
"IVRKeyPressed": null,
"IVRKeyPressedEx": null,
"HungUpSide": "seat",
"ServeParticipants": [
{
"Mail": "zhangsan@tencent.com",
"Phone": "",
"RingTimestamp": 1677140068,
"AcceptTimestamp": 1677140069,
"EndedTimestamp": 1677140081,
"RecordId": "dbe87035-019c-4xxx-bf4f-c29701ad315d",
"Type": "miniProgramSeat",
"TransferFrom": "",
"TransferFromType": "",
"TransferTo": "",
"TransferToType": "",
"SkillGroupId": 2734,
"EndStatusString": "ok",
"Sequence": 0,
"StartTimestamp": 1677140068,
"SkillGroupName": "顾问外呼",
"SkillGroupPriority": 0
}
],
"EndStatusString": "numberNotExist",
"StartTimestamp": 1677140068,
"QueuedTimestamp": 0,
"PostIVRKeyPressed": null,
"QueuedSkillGroupId": 2734,
"QueuedSkillGroupName": "顾问外呼",
"SdkAppId": 1400482256,
"RecordId": "f65472d9-400a-4xxx-a51f-a49a55dab99a",
"UserRemark": "*******7605",
"Uui": "abc",
"TelLocation": {
"TelNumber": "008618486147605",
"Country": "中国",
"Province": "贵州",
"City": "安顺",
"Operator": "移动"
}
}