tencent cloud

云联络中心

产品公告
产品动态
关于云联络中心术语更新
产品简介
产品概述
功能列表
名词介绍
应对防火墙限制相关
AI 专区
购买指南
语音通话计费概述
在线会话计费概述
查看账单
退费指引
新用户手册
语音通话指引
在线会话指引
场景用例
客服热线(呼入)
电话营销(呼出)
语音提醒(自动外呼)
集成用例(SDK)
管理员操作手册
语音通话分册
在线会话分册
工作台操作手册
语音通话分册
在线会话分册
AI 智能体操作手册
语音智能体介绍
语音智能体实践教程
新建语音智能体
实现智能体通话
查看智能体通话
开发操作手册
SDK 开发指南
数据推送
语音通话 API 文档
History
Introduction
API Category
Making API Requests
Agent APIs
Skill Group APIs
Number APIs
Dual Call APIs
Predictive Outbound Call APIs
SIP Phone APIs
Call Service Record APIs
Billing APIs
Other APIs
Outbound Call APIs
Speech Intelligent Agent APIs
Data Types
Error Codes
在线会话 API 文档
服务端 API
回调配置
常见问题
数据删除指引
相关协议
隐私政策
数据隐私和安全协议
服务等级协议
云联络中心用户协议
词汇表
联系我们

电话 CDR 数据推送

PDF
聚焦模式
字号
最后更新时间: 2025-06-24 18:11:12
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:呼出
CallType
数值
通话类型: 1 电话呼出 2 电话呼入 3 音频呼入 5 预测式外呼 6 成员内线呼叫
示例值: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": "移动"
}
}



帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈