获取录音内容详情

最后更新：2026/10/22

请求方式： POST（HTTPS）

请求地址： https://open.wshoto.com/openapi/ai_recording/detail?access_token=ACCESS_TOKEN

Query参数：

参数	类型	必填	说明
access_token	string	是	调用接口凭证

Body参数：

{ "recording_id": "123456789" }

参数	类型	必填	说明
recording_id	string	是	平台录音 ID

返回结果：

{
  "code": 0,
  "sub_code": "OK",
  "msg": "请求成功",
  "data": {
    "recording_id": "123456789",
    "external_recording_id": "client-recording-001",
    "title": "客户咨询录音",
    "source_type": 1,
    "userid": "zhangsan",
    "user_name": "张三",
    "recording_start_time": 1780000000000,
    "recording_end_time": 1780000060000,
    "duration": 60000,
    "recording_status": 2,
    "media": { "play_url": "https://...", "file_name": "merged.mp3", "mime_type": "audio/mpeg", "file_size": 102400 },
    "speakers": [{ "speaker_id": 1, "speaker_name": "张三", "role": "employee" }],
    "transcript_segments": [{ "segment_index": 1, "speaker_id": 1, "start_ms": 0, "end_ms": 1200, "text": "您好" }],
    "result_detail": { "provider": "example" },
    "quick_look": "AI 速览内容",
    "summary": "AI 总结内容",
    "relation": { "relation_type": 1, "external_userid": "wo123", "relation_name": "客户A" },
    "completed_time": 1780000070000,
    "created_time": 1780000000000,
    "modified_time": 1780000070000
  }
}

参数说明：

参数	类型	说明
code	int	返回码，`0` 表示成功
msg	str	对返回码的文本描述内容
data	object	返回数据
recording_id	str	平台录音 ID
external_recording_id	str	来源应用的外部录音 ID；仅来源应用可见
title	str	录音标题
source_type	int	`1` 表示开放接口创建
userid	str	所属员工 ID
user_name	str	所属员工展示名称
recording_start_time	long	录音开始时间，毫秒时间戳
recording_end_time	long	录音结束时间，毫秒时间戳
duration	long	录音时长，毫秒
recording_status	int	`1` 处理中、`2` 完成、`3` 失败
media	object/null	合并后的可播放媒体；处理中或失败时可为空
play_url	str	媒体播放地址
file_name	str	媒体文件名
mime_type	str	媒体 MIME 类型
file_size	long	媒体文件大小，单位字节
speakers	object[]	发言人及最终角色识别结果
speaker_id	int	发言人 ID
speaker_name	str	发言人名称
role	str	发言人角色：`employee`、`customer`、`unknown`
transcript_segments	object[]	按时间排序的转写片段
segment_index	int	片段序号
speaker_id	int	发言人 ID
start_ms	long	片段开始时间，毫秒
end_ms	long	片段结束时间，毫秒
text	str	转写文本
result_detail	object/null	调用方上传或 ASR 生成的原始转写详情
quick_look	str/null	AI 速览
summary	str/null	AI 总结
relation	object/null	当前客户关联
relation_type	int	`1` 企微客户，`2` CRM 联系人
external_userid	str	企微客户 ID；仅企微客户关联返回
contact_id	long	CRM 联系人 ID；仅 CRM 联系人关联返回
relation_name	str	关联对象名称
completed_time	long/null	完成时间，仅完成后存在
failed_time	long/null	失败时间，仅失败后存在
failure_code	str/null	失败码，仅失败后存在
failure_reason	str/null	失败原因，仅失败后存在
created_time	long	创建时间，毫秒时间戳
modified_time	long	最近修改时间，毫秒时间戳
sub_code	str	业务异常返回码；成功时为 `OK`

获取录音内容详情

获取录音内容详情

results matching ""

No results matching ""