帮你快速理解、总结文档立即下载
文档中心>云联络中心>语音通话服务端 API>电话服务记录相关接口>查询通话详情

查询通话详情

最近更新时间：2026-09-17 01:22:18
我的收藏

本页目录：

1. 接口描述

接口请求域名： ccc.tencentcloudapi.com 。

此接口用于在通话结束后，通过 session id 和时间戳，查询单一通话的通话详情。包括：主被叫信息、录音等。

默认接口请求频率限制：20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

参数名称 必选 类型 描述
Action 是 String 公共参数，本接口取值：DescribeSessionDetail。
Version 是 String 公共参数，本接口取值：2020-02-10。
Region 否 String 公共参数，此参数为可选参数。
SdkAppId 是 Integer

应用 ID（必填），可以查看 https://console.cloud.tencent.com/ccc


示例值：1400000000
SessionId 是 String

通话的 session id


示例值：6164325c-39aa-45dc-83e2-2ecbc9b37ad5
StartTimestamp 是 Integer

起始时间戳，Unix 秒级时间戳，最大支持近180天。


示例值：1756372067
EndTimestamp 是 Integer

结束时间戳，Unix 秒级时间戳，结束时间与开始时间的区间范围小于90天。


示例值：1756372167

3. 输出参数

参数名称 类型 描述
Caller String

主叫号码


示例值：0086130xxxxxxxx
Callee String

被叫号码


示例值：0086010xxxxxxxx
CallType Integer

通话类型 1 呼出 2 呼入 3 音频呼入 5 预测式外呼 6 内线呼叫


示例值：1
StartTimeStamp Integer

开始时间戳，Unix 秒级时间戳


示例值：1611631881
RingTimestamp Integer

振铃时间戳，UNIX 秒级时间戳


示例值：1611631885
AcceptTimestamp Integer

接听时间戳，UNIX 秒级时间戳


示例值：1611631891
EndedTimestamp Integer

结束时间戳，UNIX 秒级时间戳


示例值：1611631991
QueuedTimestamp Integer

进入排队时间，Unix 秒级时间戳


示例值：1611631889
StaffUserId String

座席账号


示例值：foo@tencent.com
EndStatus Integer

参考 DescribeTelCdr 接口 EndStatus 字段


示例值：1
QueuedSkillGroupId Integer

排队技能组 ID


示例值：203
QueuedSkillGroupName String

排队技能组名称


示例值：销售组
RecordURL String

录音链接，带鉴权和有效期，获取之后请在24 小时内拉取，不要持久化此链接。如此链接已过期，请重新调用此接口获取新的链接


示例值：https://xxxxx
CustomRecordURL String

录音转存第三方 COS 链接


示例值：https://xxxxx
AsrURL String

录音文本信息链接，带鉴权和有效期，获取之后请在24 小时拉取，不要持久化此链接。如此链接已过期，请重新调用此接口获取新的链接


示例值：https://xxxxx
VoicemailRecordURL Array of String

语音留言录音链接


示例值：["https://xxxxx"]
VoicemailAsrURL Array of String

语音留言录音文本信息链接，需在控制台购买离线语音识别套餐包并开启离线语音识别开关


示例值：["https://xxxxx"]
IVRKeyPressed Array of IVRKeyPressedElement

IVR 按键信息
PostIVRKeyPressed Array of IVRKeyPressedElement

满意度按键信息
HungUpSide String

挂机方 seat 座席 user 用户 system 系统


示例值：user
UUI String

客户自定义数据（User-to-User Interface）


示例值：foo-bar
Events Array of SessionEvent

通话中的事件列表
ServeParticipants Array of ServeParticipant

服务参与者列表
SysHangupReason Integer

接通后系统挂断原因状态码

详见


示例值：1010
SysHangupReasonString String

接通后系统挂断原因

详见


示例值：userHangupDuringAIAgent
EndStatusV2 Integer

通话结束状态V2（灰度中）


示例值：601
RequestId String 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 查询通话详情示例

查询通话详情示例

输入示例

POST / HTTP/1.1
Host: ccc.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeSessionDetail
<公共请求参数>

{
    "SdkAppId": 1400000000,
    "SessionId": "0f507d5d-e1e4-436e-a655-1d6c75a79b4f",
    "StartTimestamp": 1756372067,
    "EndTimestamp": 1756893037
}

输出示例

{
    "Response": {
        "AcceptTimestamp": 1756892204,
        "AsrURL": "https:****c*.*cloud.com/tcccadm*n/cdr/*et*sr**xt*key=PEbNJ4*Q**3*pLFHvMinns4n8P*q1n***YbmD**ljz***rb6****B*b*Q*Ag%3D%3D-k-fKVP3WIlGp************************************************************************************************************************************RlBKeW92NFcwV0ZvUklibFl1RExOdkFaSkFONm*q*Wxr*WlCMTFrNmNZWVgrQWdOb*J3OTZzTjJwTWk0UEZ2cS9tZXc*PSIsIm5v**NlIjoiMDd1aFNLRDFmST*4***zNyX9",
        "CallType": 1,
        "Callee": "0086158xxxxxxxx",
        "Caller": "00860755xxxxxxxx",
        "CustomRecordURL": "https://e*am**e.cos.ap-gu*ngzhou.tence**************************************31_f460fff5-0**d-84*4**90*e***76d2.mp3",
        "EndStatus": 1,
        "EndedTimestamp": 1756892230,
        "Events": [
            {
                "EventType": "StaffHold",
                "StaffEventDetail": {
                    "Staffs": [
                        {
                            "Mail": "foo@tencent.com",
                            "StaffNumber": "20012"
                        }
                    ]
                },
                "Timestamp": 1756892209
            },
            {
                "EventType": "StaffUnhold",
                "StaffEventDetail": {
                    "Staffs": [
                        {
                            "Mail": "foo@tencent.com",
                            "StaffNumber": "20012"
                        }
                    ]
                },
                "Timestamp": 1756892217
            },
            {
                "EventType": "StaffMute",
                "StaffEventDetail": {
                    "Staffs": [
                        {
                            "Mail": "foo@tencent.com",
                            "StaffNumber": "20012"
                        }
                    ]
                },
                "Timestamp": 1756892220
            },
            {
                "EventType": "StaffUnmute",
                "StaffEventDetail": {
                    "Staffs": [
                        {
                            "Mail": "foo@tencent.com",
                            "StaffNumber": "20012"
                        }
                    ]
                },
                "Timestamp": 1756892224
            }
        ],
        "HungUpSide": "user",
        "IVRKeyPressed": [],
        "PostIVRKeyPressed": [],
        "QueuedSkillGroupId": 0,
        "QueuedSkillGroupName": "",
        "QueuedTimestamp": 0,
        "RecordURL": "https://tccc.*****d.*o***cccadmin/get**cor**PE*******23VpLFHvMi**s*n8Pnq1nmySYb***tljzGXyrb6jDk+*%***6Mhh**tOB*brQBAg==*k-***P3WIlGp******W**EkQ==-k-n***d**4**************mvk********MPYpb9zwZc4bsUdV*=*ey*********************icG*yOG1Na******************************************************************************************************************************************************************************************************************************************TVj**VH*5**********ErL2ZHYXp***p****yc****VJ***R*STNQazJ**0*P****Z*****N******X*PU1hh*U*******VRTR******lTHowcmtTM***SVVRIiwibm9uY2U**iJvVlBmQW9y*****D*wWEZTIn0=/*00-25295337***1**6*-***9*****656498**2f**72d***f1954-*00-175689232*****",
        "RequestId": "d6053004-779e-4cea-bbff-aa689b5fb9ff",
        "RingTimestamp": 1756892201,
        "ServeParticipants": [
            {
                "AcceptTimestamp": 1756892204,
                "CustomRecordURL": "https://example******p*****gzhou.tencent****************************************a76adc6-e70c-459d-8**1*5*c8*d******.mp3",
                "EndStatusString": "ok",
                "EndedTimestamp": 1756892230,
                "Mail": "foo@tencent.com",
                "Phone": "",
                "RecordId": "8a76adc6-e70c-459d-8921-56c88d91f840",
                "RecordURL": "https://tccc.**loud.com/tcccadmin/getRecord/PE**J4mQ723VpLFHvMinns4n8Pnq1nmyS****7tljzG*********I**F*e*z*gZ******+Fd6MhhwvtOBG****Ag==-k-fKVP3WIlGpg8m9*****E*************24T8YIk*s*Uj*e*************MPYpb9z***********F**dVM****Kd1DLNvTC8************s4***eA*************************************************************************************************************************************************************************************************************************************************************SUsvcDZ0QmlLV08xLzFCOW9RNXZ*bk1*ZmpzYXViem1Zb05RengvL1VuMERX*m9***NLby9RYzdLejhjVEtqZGE5dGtSVlJ**1hGZU***************U**d****DNaQjMxMl****NaIiwibm9uY2UiOi****NxbU5teG1mcjVF***********0**9891***********************94582a61****2*************1756892101.mp3",
                "RingTimestamp": 1756892198,
                "Sequence": 0,
                "SkillGroupId": 2522,
                "SkillGroupName": "foo-tel",
                "StartTimestamp": 1756892198,
                "TransferFrom": "",
                "TransferFromType": "",
                "TransferTo": "",
                "TransferToType": "",
                "Type": "staffSeat"
            }
        ],
        "StaffUserId": "foo@tencent.com",
        "StartTimeStamp": 1756892198,
        "UUI": "",
        "VoicemailAsrURL": [],
        "VoicemailRecordURL": []
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。

错误码 描述
FailedOperation.SessionNotExists 会话不存在
InternalError 内部错误。
InternalError.DBError 内部数据库访问失败。
InvalidParameterValue 参数取值错误。
中国站