文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>云联络中心>数据推送>电话 CDR 数据推送

电话 CDR 数据推送

最近更新时间：2026-03-10 10:09:42

我的收藏
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
字符串
如果是智能体相关通话，这里是智能体名称。
SysHangupReason
数值
接通后系统挂断原因状态码，具体示例请参见 状态码。
SysHangupReasonString
字符串
接通后系统挂断原因，具体示例请参见 endReasonDetail。

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": "移动"
  }
}
中国站
目录