云蝠智能 AI知识中心
所有文章
完整版
完整版
客户端
API文档
升级日志
合作伙伴
基础知识
产品介绍
帮助中心
API文档
数字人
AI客户联络
开发指引
API接口
【新】云节点列表
用户
子账户
2.0 外呼 任务 && 新线路
任务
线路
话术分组
客户公海
合同管理
号码
呼叫时间
用户凭证
回调黑名单
对话接口
系统账单
其他
iFrame嵌套
回调
AI语音质检
白标接口及地址
AI客户联络中心 升级日志
数字人升级日志
线索挖掘 升级日志
业务常见问题QA
其他文档
行业案例
【更新】下载通话录音
最后更新于 2024/03/01   阅读数 532

下载通话录音

  • URL/agent-api/user/{user_id}/task/{task_id}/record/{record_id}/download-full-voice

  • MethodGET

  • 需要鉴权

💡 注意:

  1. 原请求地址为GET /agent-api/task/{task_id}/record/{record_id}/download-full-voice,新增参数用户id,且为必填

  2. 如果仍使用老版本的接口,将使用系统默认的云节点ID,无法操作其他云节点的数据

  3. 老版接口将于2023年2月1日下线,请尽快进行更换

    路由参数

    参数

    类型

    描述

    user_id

    string

    账号ID(主账户)

    task_id

    string

    任务ID

    record_id

    string

    通话记录ID

    请求参数

    参数

    类型

    描述

    sub_user_id

    string

    子账户ID

    请求示例

    GET /agent-api/user/4d99d91c-f5d9-49da-88da-758977cc58a9/task/287e19c4-1966-49d6-8f02-b53ef11c0a55/record/50971322-2e84-4701-836c-fd1181306885/download-full-voice

    成功响应

    条件:任务存在、账号存在、通话记录存在。

    状态码:200 OK

    响应示例

    {
        "code": 200,
        "status": "success",
        "message": "返回录音下载地址成功",
        "data": {
            "voice_url": "hw.test-saas.our.top/api/agent-api/download-voice?key=N0dJNlFVTFU1WHlsNkoyY1lLZnQwTnNiR2NGQTFva1FGK1pvWURGZmhTTkxqbzBqMHhqMXFEWXQrTWN0ZFZFcTNuMGd5dW9CUm9ycjUyUk9Eam1iTTBsQ0JLQ3BSanVRZGNRVUVuRGMrRHBYYndmc3VVY0lscjlubXhUTmZGSkJ3L0J5RVNnYldFSkZWSmlnV3VqRHJEQWkyWlNrcDhjUTljSVQxNmpQNzRNSTJtYWc3YkJaSmNqa1g3WlR6MTdyQTNXVFJMa2FmcStYWU9wR1h2MDdNdz09"
        }
    }
    
    1
    2
    3
    4
    5
    6
    7
    8
    plaintext

    参数

    类型

    描述

    voice_url

    string

    可以试听的音频地址

    错误响应

    错误1

    条件:任务ID不存在。

    状态码200 OK

    响应示例:

    {
        "code": 5002,
        "status": "error",
        "message": "任务不存在",
        "data": []
    }
    
    1
    2
    3
    4
    5
    6
    plaintext

    错误2

    条件:账号ID错误,云节点不存在。

    状态码200 OK

    响应示例:

    {
        "code": 1002,
        "status": "error",
        "message": "【user】参数错误,未找到对应云节点",
        "data": []
    }
    
    1
    2
    3
    4
    5
    6
    plaintext

    错误3

    条件:通话记录ID不存在。

    状态码200 OK

    响应示例:

    {
        "code": 5005,
        "status": "error",
        "message": "该任务下的该通通话记录不存在",
        "data": []
    }
    
    1
    2
    3
    4
    5
    6
    plaintext

未能解决您的问题?请联系
本篇目录

下载通话录音

路由参数

请求参数

请求示例

成功响应

错误响应

错误1

错误2

错误3