tencent cloud

Cloud Contact Center

Announcement
What's New
Cloud Contact Center Terminology Update
What is Tencent Cloud Contact Center
Overview
Feature List
Terms Introduction
Handling Firewall Restrictions
AI Voicebot
Billing Guide
Voice Call Billing Overview
Desk Billing Overview
View Billing
Refund Policy
New User Guide
Voice Guide
Desk Guide
Use Case
Inbound: Customer Experience
Outbound: Telemarketing
Auto Dialer: Voice Notification
Integration Use Case (SDK)
Administrator Guide
Voice Guide
Desk Guide
Member Guide
Voice Guide
Desk Guide
AI Voice Agent Guide
Introducing AI Voice Agent
AI Voice Agent Practical Tutorial
Set Up Your AI Voice Agent
Activate AI Voice Agent Call
AI Voice Agent Call Logs
Developer Guide
SDK Development Guide
Data Push
Voice API Reference
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
Desk API Reference
API Reference
Callback Configuration
FAQs
Data Deletion Guide
Legal
Privacy Policy
Data Processing And Security Agreement
Service Level Agreements
TENCENT CLOUD CONTACT CENTRE TERMS OF USE
Glossary
Contact Us

Data Push: Voice Call Records

PDF
Modo Foco
Tamanho da Fonte
Última atualização: 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"
}
}



Ajuda e Suporte

Esta página foi útil?

comentários