tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Cloud Contact Center
    Documentation
    Download PDF

    Data Push: Voice Call Records

    Last updated: 2025-01-15 11:08:11
    Download PDF
    CDR logs one entry for each full user session (inbound or outbound). The root-level data shows overall session details. Detailed service traces within the session, such as call transfers, are described in the ServeParticipants array, where each entry represents a single service trace.
    - Outbound Call Type data filed QueuedSkillGroupID selection strategy
    If agent belongs to only one voice group, it is selected.
    If agent belongs to multiple groups, the group linked to the outbound number is prioritized (if multiple, the first one will be chosen).
    If neither condition is met, the agent's first skill group is used.
    URL:https://{custom_url}?action=cdr&version=1 METHOD: POST Content-Type: application/json;charset=utf8 REQUEST:
    Parameter
    Type
    Description
    SdkAppId
    Numerical value (long integer)
    The unique Cloud Contact Center application ID, you could find this info on Console
    SessionId
    String
    Session ID, unique ID of a call session
    Caller
    String
    Caller
    Callee
    String
    Callee
    Direction
    Numerical value
    Call Direction:
    0: Inbound
    1: Outbound
    Duration
    Numerical value
    Call Duration, in seconds (EndedTimestamp-AcceptTimestamp).
    SeatUser
    Object
    Agent information. See format below. (If call transfer occurs, this will be displayed by last agent)
    CallerLocation
    String
    Caller number location
    IVRDuration
    Numerical value
    Total duration of IVR flow, in seconds (QueuedTimestamp - StartTimestamp).
    RingTimestamp
    Numerical value
    For inbound session, this indicates the timestamp when the agent's side starts ringing (in UNIX second).
    For outbound sessions, this indicates the timestamp when the user side starts ringing (in UNIX second).
    AcceptTimestamp
    Numerical value
    For inbound sessions, this represents the timestamp (in UNIX seconds) when the agent starts answering. For outbound sessions, this represents the timestamp (in UNIX seconds) when the user starts answering.
    EndedTimestamp
    Numerical value
    End timestamp of the entire session (in UNIX second)
    StartTimestamp
    Numerical value
    Start timestamp of the entire session (in UNIX second)
    IVRKeyPressed
    String array
    IVR key pressed information (e.g., ["1","2","3"]
    IVRKeyPressedEx
    Object array
    IVR key information with value (e.g., [{"Key":"1","Label":"Very satisfied"}])
    HungUpSide
    String
    The party who hung up the call (user: user hang-up or seat: agent hang-up)
    ServeParticipants
    Object array
    A list of agents involved in a call session (including multiple participants if a call transfer occurred). The format is shown in the table below.
    EndStatusString
    String
    End status/reason of the call session. For details, see EndStatusString.
    QueuedTimestamp
    Numerical value
    For inbound call sessions, the timestamp when the user entered the queue.
    PostIVRKeyPressed
    Object array
    Post-IVR key information (e.g., [{"Key":"1","Label":"Very satisfied"}])
    QueuedSkillGroupName
    String
    For inbound call sessions, Name of the skill group the user queued for.
    QueuedSkillGroupId
    Numerical value
    ID of the skill group the user queued for.
    RecordId
    String
    Recording ID for user-side recording
    UserRemark
    String
    User Remark
    Uui
    String
    Incoming Data (Data Brought in by the Outbound Call Interface)
    TelLocation
    Json object
    Number location. The format is as below.
    SeatUser (Agent) data format:
    Parameter
    Type
    Description
    Mail
    String
    Agent's email
    Name
    String
    Agent's name
    Nick
    String
    Agent's nickname
    Phone
    String
    Agent's mobile number
    UserId
    String
    User ID
    StaffNumber
    String
    Agent's Staff ID
    SkillGroupNameList
    String array
    List of groups to which the agent belongs
    ServeParticipants data format:
    Parameter
    Type
    Description
    Mail
    String
    Agent's email
    Phone
    String
    Agent's phone number
    RingTimestamp
    Numerical value (long integer)
    Call Ringing timestamp, Unix second-level timestamp
    AcceptTimestamp
    Numerical value (long integer)
    Answer timestamp, Unix second-level timestamp
    EndedTimestamp
    Numerical value (long integer)
    End timestamp, Unix second-level timestamp
    RecordId
    String
    Recording ID
    Type
    String
    Participant type refer to the type of device the agent uses to handle the call.
    staffSeat - Web agent
    outboundSeat - Outbound Agent
    staffPhoneSeat - Mobile agent
    miniProgramSeat - Mini program agent
    TransferFrom
    String
    Information about the agent who transferred the call.
    TransferFromType
    String
    The type of agent who transfers the call (web, mobile etc.).
    TransferTo
    String
    Transfer destination agent information
    TransferToType
    String
    Transfer destination participant type, with the same value as Type
    SkillGroupId
    Numerical value
    Group ID
    EndStatusString
    String
    call participant end status of the session. For details, see EndStatusString.
    Sequence
    Numerical value
    Call participant sequence, starting from 0
    StartTimestamp
    Numerical value (long integer)
    Start timestamp, Unix second-level timestamp
    SkillGroupName
    String
    Skill group name
    SkillGroupPriority
    Numerical value
    Skill group assignment priority
    TelLocation data format:
    Parameter
    Type
    Description
    TelNumber
    String
    Number
    Country
    String
    Country
    Province
    String
    Province
    City
    String
    City
    Operator
    String
    ISP
    RESPONSE:
    Parameter
    Type
    Description
    ErrMsg
    String
    Error description
    ErrCode
    Numerical value
    Error code
    Data sample:
    {
      "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": [
          "Outbound Consultant",
        ]
      },
      "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": "Outgoing Consultant",
          "SkillGroupPriority": 0
        }
      ],
      "EndStatusString": "numberNotExist",
      "StartTimestamp": 1677140068,
      "QueuedTimestamp": 0,
      "PostIVRKeyPressed": null,
      "QueuedSkillGroupId": 2734,
      "QueuedSkillGroupName": "Outbound Consultant",
      "SdkAppId": 1400482256,
      "RecordId": "f65472d9-400a-4xxx-a51f-a49a55dab99a",
      "UserRemark": "*******7605",
      "Uui": "abc",
      "TelLocation": {
        "TelNumber": "008618486147605",
        "Country": "China",
        "Province": "Guizhou",
        "City": "Anshun",
        "Operator": "Mobile"
      }
    }
    
    
    Contact Us

    Contact our sales team or business advisors to help your business.

    Contact Us
    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    Submit a Ticket
    7x24 Phone Support
    Copyright © 2013-2025 Tencent Cloud. All Rights Reserved.
    Privacy PolicyLegalCookie Policy