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

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 字符串 参与者类型:staffSeatoutboundSeatstaffPhoneSeatminiProgramSeat
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": "移动" }}

赞 (0)
上一篇 4天前
下一篇 4天前