1. 接口说明

实时语音流推送是在通话进行中,把音频切成极小的数据包,通过WebSocket等协议持续推送给后端或者客户业务系统,客户业务系统支持AI语音助手实时对话、坐席实时辅助、实时质检、实时录音OSS 存储等场景。

本文主要介绍语音平台实时语音流ws/wss推送规范描述。接口用于接收 优音 语音平台推送的实时通话语音流。语音以二进制 PCM 形式通过 WebSocket 推送,服务端接收语音流进行业务处理。

  • 协议:WebSocket or WebSocket over SSL(WS/WSS)

  • 传输方式:二进制帧推送音频数据

  • 音频格式:PCM 8000Hz / 16bit / 双声道(左右声道区
    分客户和坐席)

    2.服务端和客户端交互

  • 如果ws/wss连接中途发生异常, 客户端不支持重连。

  • 客户端支持每次推送多长时间的语音(双声道最大支持128毫秒), 客户端配置。

  • 启动推流时间点:来电业务场景下转接的被叫号码接听时开始推流; 外呼业务场景下被叫号码(客户号码)接听时开始推流。

  • 推流方式:坐席侧推流方式。

3. 服务端ws/wss地址

wss://{服务域名}/{api_path}?authorization={鉴权Token}
ws://{服务域名/IP:port}/{api_path}?authorization={鉴权Token}

参数 类型 必填 说明
authorization String 是 鉴权 Token,由双方约定

采用固定 Token 鉴权:

  • 双方预先约定一个 Token 字符串
  • 对方在连接 URL 的 authorization 参数中传入该 Token
  • 服务端比对一致则放行,否则拒绝连接
    Token 值请向服务端接口负责人索取。

4. 客户端ws/wss规范

客户端负责传入鉴权 Token和写入通话相关信息到固定header头: x-earshot-meta, 其值包括通话相关信息,是一个JSON格式的字符串, 易于扩展。示例如下: x-earshot-meta: {“callid”:”4bb3d592-e8dd-41c7-c16f-fdf180aa5012”,”sessionid”:”92241e0c-b4ae-4bb6-cb10-368dcabd4375”}

Json字段 类型 必填 说明
callid String 是 与坐席相关的呼叫流水号, 用于区分:一通通话出现多个坐席.
sessionid String 是 通话编号,与通话记录的serviceSn字段值保持一致
文档更新时间: 2026-11-10 14:27   作者:admin