实时音视频
实时音视频
文档指南
请输入
实时音视频
快速入门
场景方案
开发指南
Token 鉴权
音频管理
视频管理
屏幕共享
SDK 升级指南
客户端 API 参考
服务端 API 参考
房间管理
转推直播
输入在线媒体流
WTN 流（原公共流）
实时数据监控
历史数据查询
业务标识管理
实时消息通信
历史版本（文档停止维护）
2023-08-01
2023-06-01
转推直播
2022-06-01
2020-12-01
转推直播
输入在线媒体流
获取数据指标
常见问题
集成相关
质量相关
AI 音视频互动方案
开始使用
开发指南
API 参考
硬件对话智能体
用户指南
服务端 API
智能体
实时信令
互动白板
客户端 API 参考
服务端 API 参考
- 文档首页
实时音视频AI 音视频互动方案开发指南获取 AI 对话任务事件
复制全文
下载 pdf获取 AI 对话任务事件
文档反馈
问问助手调用 StartVoiceChat 接口启动任务后，你可以通过服务端回调，实时获取任务的状态变化（如任务开始、结束）、获取任务资源用量以及任务错误信息，从而实现精细化的任务监控或故障排查。
应用场景
- 监听任务状态
- 通过监听 AI 对话任务状态，捕获用户结束说话、AI 回答完毕等关键节点，以便添加自定义业务逻辑，例如记录任务时长、更新客户端 UI 状态或触发下游数据分析流程等。
- 分析服务端耗时
- 通过比对不同状态回调的时间戳，分析 ASR、LLM、TTS 各个核心处理阶段的耗时，为性能体验优化提供数据支持。
- 获取任务用量
- 获取对话任务的 TTS、LLM 等用量信息。
- 排查任务错误原因
- 当 AI 对话任务发生异常时，回调会提供错误码和错误信息，帮助你快速定位问题根源。
前提条件
配置事件回调前，请完成以下准备：
- 回调 URL：准备一个可通过公网访问的回调 URL。该 URL 必须支持 GET 和 POST 请求。具体要求，请参见回调 URL 要求。
- 回调密钥（建议）：生产环境建议配置回调密钥，并在业务服务端验证回调签名，以确认消息来源并防止消息被篡改。签名验证方法，请参见验证回调签名。
实现方式
- 配置事件回调：
- 前往配置页面：
- 若接口版本为 2025-06-01：前往 AI 音视频互动方案-功能配置，选择回调设置。
- 若接口版本为 2024-12-01（建议迁移至 2025-06-01 版本）：前往实时音视频-功能配置，选择回调设置。
- 单击 添加配置，将回调事件设置为 VoiceChat，并填写回调 URL 等参数。
说明
如无特殊需求，无需配置业务标识，否则可能无法正常收到回调消息。
- 验证并接收回调：首次配置或修改回调 URL 后，配置下发至全网节点通常需要 3～5 分钟。配置生效后，当 AI 对话任务状态发生变化或任务出现错误时，RTC 服务端会向回调 URL 发送 VoiceChat 事件。回调消息采用 JSON 格式，事件字段说明，请参见事件和错误码。
最近更新时间：2026.11.05 14:26:42
这个页面对您有帮助吗？
有用
有用
无用
无用