下载 AI 通话转写数据

从通话记录中下载包含所需 AI 通话转写数据的 JSON 文件，包括通话转写原文和通话总结。

注： 该接口仅适用于 API 2.0 版本。

下载 AI 通话转写数据的步骤

  1. 获取下载 URL。
  2. 下载 JSON 文件。

请求 URL

GET {base_url}/{api_path}/cdr/aidownload?access_token={access_token}

请求参数

提示： 按需使用以下请求参数筛选转写数据。
参数 是否必填 类型 说明
call_from 否 String 主叫号码。
call_to 否 String 被叫号码。
call_type 否 String 通话类型。
取值范围：
  • Internal：内部通话。
  • Inbound：外线呼入。
  • Outbound：外线呼出。
start_time 否 String 查询周期的起始时间。
注： 填写的时间格式取决于 PBX 的日期和时间显示格式 (在 PBX 上的 系统 > 日期和时间 > 显示格式 中设置)。
示例：
  • PBX 的 日期显示格式 为 月/日/年，时间显示格式 为 24 小时制，则此参数的有效时间填写格式为 MM/DD/YYYY HH:mm:ss。
  • PBX 的 日期显示格式 为 年/月/日，时间显示格式 为 12 小时制，则此参数的有效时间填写格式为 YYYY/MM/DD HH:mm:ss AM/PM。
end_time 否 String 查询周期的结束时间。
注： 填写的时间格式取决于 PBX 的日期和时间显示格式 (在 PBX 上的 系统 > 日期和时间 > 显示格式 中设置)。
示例：
  • PBX 的 日期显示格式 为 月/日/年，时间显示格式 为 24 小时制，则此参数的有效时间填写格式为 MM/DD/YYYY HH:mm:ss。
  • PBX 的 日期显示格式 为 年/月/日，时间显示格式 为 12 小时制，则此参数的有效时间填写格式为 YYYY/MM/DD HH:mm:ss AM/PM。
last_status 否 String 通话的最终状态。
取值范围：
  • ANSWERED：已接。
  • NO ANSWER：未接。
  • ABANDONED：主叫放弃。
  • BUSY：忙。
  • FAILED：失败。
  • VOICEMAIL：语音留言。

响应参数

参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
file String AI 通话转写数据 JSON 文件的名称。
download_resource_url String AI 通话转写数据 JSON 文件的下载 URL。
注： 下载 URL 的有效时长为 30 分钟。

示例

请求示例

获取 AI 通话转写数据的下载 URL。

GET /openapi/v2.0/cdr/aidownload?access_token=vtqkVFQcIfbDuWGjSScZk6RGzO0Zdfic HTTP/1.1

Host: yeastardocs.example.yeastarcloud.com

响应示例

{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "file": "PBX-AI_Transcription-X.23.0.70-download-20260514104731-PXFbRkarEjkQzHFL.json",
    "download_resource_url": "/api/download/PBX-AI_Transcription-X.23.0.70-download-20260514104731-PXFbRkarEjkQzHFL.json"
}

下载 AI 通话转写数据

在获取 JSON 文件的下载 URL 后，你需要将其与 {base_url} 结合，并添加 {access_token} 参数，然后使用此完整的下载链接获取所需文件。

下载链接格式

{base_url}/{download_resource_url}?access_token={access_token}

下载链接示例

https://yeastardocs.example.yeastarcloud.com/api/download/PBX-AI_Transcription-X.23.0.70-download-20260514104731-PXFbRkarEjkQzHFL.json?access_token=vtqkVFQcIfbDuWGjSScZk6RGzO0Zdfic

下载文件内容

下载的 JSON 文件内容详情如下。

JSON 示例
 [
    {
        "uid": "20260509214921EFE9A",
        "leg_id": "20260509214921-8AA6D",
        "leg": 1,
        "time": "2026/05/09 21:49:21",
        "call_type": "Internal",
        "call_from": "3200",
        "call_to": "7000",
        "status": "ANSWERED",
        "call_duration": 13,
        "ring_duration": 3,
        "talk_duration": 10,
        "hold_duration": 0,
        "ai_transcription": [
            {
                "source_number": "7000",
                "content": "Hi",
                "timestamp": 1778334561705,
                "duration": 0
            }
        ],
        "ai_summary": "The conversation began with the agent initiating contact with a simple greeting."
    },
    ....
]

参数说明

参数 类型 说明
uid String 通话阶段所属通话记录的唯一 ID。
leg_id String 通话阶段的 ID。
leg Integer 下载记录中通话阶段的编号。
time String 通话发起或接听的时间。
call_type String 通话类型。
  • Internal：内部通话。
  • Inbound：外线呼入。
  • Outbound：外线呼出。
call_from String 主叫号码。
call_to String 被叫号码。
status String 通话阶段的最终状态。
  • ANSWERED：已接。
  • NO ANSWER：未接。
  • ABANDONED：主叫放弃。
  • BUSY：忙。
  • FAILED：失败。
  • VOICEMAIL：语音留言。
call_duration Integer 从通话开始到通话结束的时长 (单位：秒)。
ring_duration Integer 从通话开始到通话接听的时长 (单位：秒)。
talk_duration Integer 从通话接听到通话结束的时长 (单位：秒)。
注： 不包含被保持的时长。
hold_duration Integer 通话被保持的总时长 (单位：秒)。
ai_transcription Array<Context> AI 生成的通话转写内容。
ai_summary String AI 生成的通话总结内容。
Context
参数 类型 说明
source_number string 说话人的号码。
content String 转写后的文本内容。
timestamp integer 原始事件 (即用户说话的时刻) 发生的时间戳 (单位：毫秒)。
duration integer 该转写记录对应的原始语音的时长 (单位：秒)。