tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Cloud Contact Center
    Documentation
    Download PDF

    Phone CDR Data Push

    Last updated: 2024-04-02 10:06:26
    Download PDF
    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.
    Outbound call type data QueuedSkillGroupID field selection strategy:
    If the agent belongs to only one phone skill group, it hits.
    If the agent belongs to multiple phone skill groups, prioritize the skill group the outbound number is bound to (select the first skill group if there are multiple).
    If 1 and 2 are not satisfied, select the first phone skill group of the agent.
    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)
    Contact center instance ID
    SessionId
    String
    Session ID
    Caller
    String
    Caller
    Callee
    String
    Called party
    Direction
    Numerical value
    Overall direction of the session:
    0: Inbound
    1: Outbound
    Duration
    Numerical value
    Overall service time of the session, in seconds; EndedTimestamp-AcceptTimestamp
    SeatUser
    Object
    Agent information. See format below. (If transfer occurs, this will be the information of the last agent.)
    CallerLocation
    String
    The location of the caller's phone number
    IVRDuration
    Numerical value
    Duration of IVR stage, in seconds, QueuedTimestamp - StartTimestamp
    RingTimestamp
    Numerical value
    Timestamp of the start of the ringing on the agent side when the session direction is inbound (UNIX second-level timestamp)
    Timestamp of the start of the ringing on the user side when the session direction is outbound (UNIX second-level timestamp)
    AcceptTimestamp
    Numerical value
    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
    Numerical value
    End timestamp of the entire session (UNIX second-level timestamp)
    StartTimestamp
    Numerical value
    Start timestamp of the entire session (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":"Very satisfied"}])
    HungUpSide
    String
    Hang-up party (user: user hang-up or seat: agent hang-up)
    ServeParticipants
    Object array
    List of service participants. The format is shown in the table below.
    EndStatusString
    String
    End status of the entire session. For details, see EndStatusString.
    QueuedTimestamp
    Numerical value
    Time when the user enters the queue when the session is inbound
    PostIVRKeyPressed
    Object array
    Post-IVR key information (e.g. [{"Key":"1","Label":"Very satisfied"}])
    QueuedSkillGroupName
    String
    Name of the skill group where the user enters the queue when the session is inbound
    QueuedSkillGroupId
    Numerical value
    ID of the skill group where the session enters the queue
    RecordId
    String
    Recording ID for user-side recording
    UserRemark
    String
    Remarks on the user
    Uui
    String
    Data accompanied by the customer (data brought in by telephone outbound interface)
    TelLocation
    Json object
    Number location. The format is as below.
    SeatUser data format:
    Parameter
    Type
    Description
    Mail
    String
    Agent's email
    Name
    String
    Agent's name
    Nick
    String
    Agent's nickname
    Phone
    String
    Agent's phone number
    UserId
    String
    User ID
    StaffNumber
    String
    Agent ID
    SkillGroupNameList
    String array
    List of skill groups the agent belongs to
    ServeParticipants data format:
    Parameter
    Type
    Description
    Mail
    String
    Agent's email
    Phone
    String
    Agent's phone number
    RingTimestamp
    Numerical value (long integer)
    Ring 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:
    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, with the same value as Type
    SkillGroupId
    Numerical value
    Skill group ID
    EndStatusString
    String
    Participant end status of the session. For details, see EndStatusString.
    Sequence
    Numerical value
    Participant number, 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-2024 Tencent Cloud. All Rights Reserved.
    Privacy PolicyLegalCookie Policy