文档中心>云联络中心>数据推送>电话 CDR 数据推送

电话 CDR 数据推送

最近更新时间:2026-02-06 21:37:32

我的收藏
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
对象数组
服务参与者列表,格式参见表格 ServeParticipants
EndStatusString
字符串
会话整体结束状态,详情请参见 EndStatusString
QueuedTimestamp
数值
会话方向为呼入时,用户进入排队的时间
PostIVRKeyPressed
对象数组
后置 IVR 按键信息(e.g. [{"Key":"1","Label":"非常满意"}])
QueuedSkillGroupName
字符串
会话方向为呼入时,用户进入排队的技能组名称
QueuedSkillGroupId
数值
会话进入排队技能组 ID
RecordId
字符串
录音 ID,用户侧录音。
UserRemark
字符串
用户备注
Uui
字符串
随入数据(电话外呼接口客户带入的数据)
TelLocation
JSON 对象
号码归属地相关信息,格式参见表格 TelLocation
AIAgentId
数值
如果是智能体相关通话,这里是智能体 ID
AIAgentName
字符串
如果是智能体相关通话,这里是智能体名称
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": "移动"
}
}