逻辑节点：WebSocket

快速阅读

WebSocket 节点在 IVR 里把客户语音按实时连接交给外部服务，并按交互结果继续后面的流程。它不是事件推送，也不是通话结束后的录音投递。

• 推送地址以 ws:// 或 wss:// 开头。
• 关闭高级配置时，沿用企业级默认配置。开启后，本节点使用自己的地址、鉴权、采样率和连接策略。
• 鉴权字段保持原文：AppId、AccessKeyId、通道密码。
• 上行采样率是平台发给对方的音频，下行采样率是平台接收的音频。现稿中的可选值包括 8000、16000、24000，要和对方服务一致。
• 连接模式分阻塞和异步。连接超时时间通常以毫秒计，连接丢失超时通常以秒计。

阅读地图

• 看配置从哪一层来：读「二」。
• 对字段：读「三」。
• 连上但流程没有往下走：读「四」。

一、文档说明

本文说明 WebSocket 节点的连接参数。智能体节点的对话配置不在本页。只播固定音或只收按键时，用播放、选择或收号，不用这条连接。

二、产品总览

进入 WebSocket 节点
→ 读取企业级默认配置；若开启高级配置，改用节点上的地址和鉴权
→ 按推送地址建立连接
→ 按上行采样率发送客户语音，按下行采样率接收返回音频
→ 在等待时长内按结果进入后续节点
→ 连接失败、超时或没有结果时走兜底

wss:// 要能校验证书。通道密码属于敏感配置。Debug 和全链路追踪策略用于联调，正式运行时按日志量控制。

对方服务返回的是呼入侧的实时交互结果。这和呼入机器人使用智能体节点不是同一条配置。外呼机器人也不由这个节点的地址字段定义。

三、字段

关闭高级配置时，企业级默认配置要已经可用。开启时，地址、鉴权、采样率和连接策略在本节点配全。多个节点不要共用一套参数却又指向不同服务。

四、FAQ

和 HTTP 交互怎么分？
HTTP 交互发请求并取返回结果。本节点在通话过程中收发音频。

和事件推送怎么分？
事件推送把通话事件发给客户系统。本节点要的是实时音频连接。

高级配置关掉后改了节点上的采样率，为什么不生效？
关掉时用企业级默认配置。采样率要生效，开启高级配置，或去改企业级默认配置。

连接成功但很快离开节点？
看等待时长是否过短，以及连接丢失超时。没有后续结果时，应走到预先接好的兜底节点。

五、总结

WebSocket 节点用推送地址建立实时音频连接。默认走企业级配置，只有这个节点要单独的鉴权或采样率时才开高级配置。失败和超时要有后续节点。