Data Push: Voice Call Records
Last updated: 2025-06-24 18:10:41
CDR records data based on the entire session. A complete customer inbound or outbound call corresponds to a record. The root-level data indicators of CDR represent the global information of the customer-dimensional session. The specific detail tracks in the session service are described through the ServeParticipants object array (such as: phone transfer information). Each piece of ServeParticipants data represents a service track.
Oubound call type data QueuedSkillGroupID field selection strategy:
Customer service belongs to only one phone skill group, then hit.
Customer service belongs to multiple phone skill groups, preferentially select the skill group bound to the outbound number (take the first skill group if multiple).
If failing to satisfy 1 and 2, take the first phone skill group of customer service.
URL:
https://{custom_url}?action=cdr&version=1
METHOD: POST
Content-Type: application/json;charset=utf8
REQUEST:Parameter | Type | Description |
SdkAppId | Long | The unique Cloud Contact Center application ID, you could find this info on Console. |
SessionId | String | Conversation ID |
Caller | String | caller |
Callee | String | callee |
Direction | Integer | Call Direction: inbound call Outgoing calls |
CallType | Integer | Call Type: 1. Voice outbound call 2. Voice Inbound call 3. Audio Inbound 5 Predictive Dialing Call 6. Internal Call between Staff Example value: 1 |
Duration | Integer | Session overall service time, unit: seconds; EndedTimestamp-AcceptTimestamp |
SeatUser | Object | Customer service information, format as follows (if transferred, the last customer service info) |
CallerLocation | String | Caller phone number location |
IVRDuration | Integer | IVR stage duration in seconds, QueuedTimestamp - StartTimestamp |
RingTimestamp | Integer | When the session direction is inbound, it means the agent side ring timestamp (UNIX second-level timestamp). When the session direction is outbound, it means the user-side ring timestamp (UNIX second-level timestamp). |
AcceptTimestamp | Integer | Timestamp of the start of the agent answering the call when the session direction is inbound (UNIX second-level timestamp) Timestamp of the start of the user answering the call when the session direction is outbound (UNIX second-level timestamp) |
EndedTimestamp | Integer | Session end timestamp (UNIX second-level timestamp) |
StartTimestamp | Integer | Entire session start timestamp (UNIX second-level timestamp) |
IVRKeyPressed | String array | IVR key information (e.g. ["1","2","3"]) |
IVRKeyPressedEx | Object array | IVR key information (e.g. [{"Key":"1","Label":"super satisfied"}]) |
HungUpSide | String | Hang Up Party (user - client hang up or seat - agent hang up) |
ServeParticipants | Object array | List of service participants. The format is shown in the table below. |
EndStatusString | String | The session end status. For details, see EndStatusString |
QueuedTimestamp | Integer | When the session direction is inbound, the time when the user enters the queue |
PostIVRKeyPressed | Object array | post IVR key information (e.g. [{"Key":"1","Label":"super satisfied"}]) |
QueuedSkillGroupName | String | When the session direction is inbound, the skill group name where the user enters the queue |
QueuedSkillGroupId | Integer | Session enters Queue Skill Group ID |
RecordId | String | Recording ID for user-side recording |
UserRemark | String | user remark |
Uui | String | Accompanied data (data entered by the customer via the telephone outbound interface) |
TelLocation | Json object | Number location information, format as below |
SeatUser data format:
Parameter | Type | Description |
Mail | String | agent email |
Name | String | Agent Name |
Nick | String | agent nickname |
Phone | String | agent telephone number |
UserId | String | User ID |
StaffNumber | String | Agent ID |
SkillGroupNameList | String array | Affiliated skill group list of the agent |
ServeParticipants data format:
Parameter | Type | Description |
Mail | String | agent email |
Phone | String | agent phone |
RingTimestamp | Long | Ring timestamp, Unix second-level timestamp |
AcceptTimestamp | Long | Answer timestamp, Unix second-level timestamp |
EndedTimestamp | Long | end timestamp, Unix second-level timestamp |
RecordId | String | Recording ID |
Type | String | participant type staffSeat outboundSeat staffPhoneSeat miniProgramSeat |
TransferFrom | String | transfer source agent information |
TransferFromType | String | transfer source agent type |
TransferTo | String | transfer destination agent information |
TransferToType | String | transfer destination participant type, consistent with Type value |
SkillGroupId | Integer | skill group ID |
EndStatusString | String | Session participant end status. For details, see EndStatusString |
Sequence | Integer | participant sequence number, starting from 0 |
StartTimestamp | Long | start timestamp, Unix second-level timestamp |
SkillGroupName | String | Group name |
SkillGroupPriority | Integer | Skill group assignment priority |
TelLocation data format:
Parameter | Type | Description |
TelNumber | String | number |
Country | String | Country |
Province | String | Province |
City | String | City |
Operator | String | Carrier |
RESPONSE:
Parameter | Type | Description |
ErrMsg | String | Error description |
ErrCode | Integer | Error code |
Sample data:
{"SessionId": "99a1c8f8-eb3d-4xxx-8401-5f6aa8761232","Caller": "0086400xxx6666","Callee": "0086184xxxx7605","Direction": 1,"Duration": 0,"SeatUser": {"Mail": "zhangsan@tencent.con","Name": "Zhang San""Nick": "Youyou","Phone": "","UserId": "zhangsan@tencent.com","StaffNumber": "8546","SkillGroupNameList": ["consultant outbound call"]},"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": "consultant outbound call","SkillGroupPriority": 0}],"EndStatusString": "numberNotExist","StartTimestamp": 1677140068,"QueuedTimestamp": 0,"PostIVRKeyPressed": null,"QueuedSkillGroupId": 2734,"QueuedSkillGroupName": "consultant outbound call","SdkAppId": 1400482256,"RecordId": "f65472d9-400a-4xxx-a51f-a49a55dab99a","UserRemark": "*******7605","Uui": "abc","TelLocation": {"TelNumber": "008618486147605","Country": "China","Province": "Guizhou","City": "Anshun","Operator": "mobile"}}
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No
Feedback