呼出类型数据 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 数据格式:
| 参数 | 类型 | 说明 |
| 字符串 | 座席邮箱。 | |
| Name | 字符串 | 座席名称。 |
| Nick | 字符串 | 座席昵称。 |
| Phone | 字符串 | 座席电话号码。 |
| UserId | 字符串 | 用户 ID。 |
| StaffNumber | 字符串 | 座席工号。 |
| SkillGroupNameList | 字符串数组 | 座席所属技能组列表。 |
ServeParticipants 数据格式:
| 参数 | 类型 | 说明 |
| 字符串 | 座席邮箱。 | |
| 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": "移动" }}