August 31, 2026 | ElevenLabs Documentation

电话按键输入：智能体对话配置现支持可选的 dtmf_input_settings，用于 DTMF 输入。可配置数字输入超时、使用 # 作为结束符，并从转录文本、日志和分析中隐藏按键输入内容。
对话附件历史记录：获取对话的转录条目现包含 file_inputs，这是一个数组，包含每个附件文件的 ID、名称、MIME 类型和 URL。
智能体标签筛选：列出智能体现接受可选的 tags 查询参数。重复该参数可匹配带有任一指定标签的智能体。
批量活动上下文：获取对话现可通过可为 null 的 campaign 元数据识别批量呼叫，其中包含必需的 campaign_id 和 campaign_lead_id。

波形可视化数据：详细生成音乐、流式生成音乐及详情和上传音乐现接受可选的 with_waveform_visual（布尔值，默认 false）。选择启用后，响应会返回低分辨率的 waveform_visual 整数数组，每秒包含 4 个采样点。

项目分页行为：列出配音项目和列出语言目标现会将 page_size 限制在 1–100。项目状态筛选新增 queued，且两个端点均说明如何使用 next_cursor 获取下一页。

v0.12.2 - 连接会话事件时保留 onUnhandledClientToolCall 回调。需要响应的未处理客户端工具调用现在会收到自动错误响应，而不再处于未解决状态。

v1.1.0 - 重新生成 API 命令绑定，并为 ElevenAgents workflow 添加命令级请求归因。这些命令会将 cmd/<command> 追加到 CLI 的 User-Agent，从而区分 agents push 和 agents create 等 workflow 发出的请求。

已更新端点

列出智能体 - GET /v1/convai/agents
- 添加可选且可为 null 的 tags（字符串数组）。重复该查询参数可匹配任一指定标签。
创建智能体、获取智能体和更新智能体
- 添加可选且可为 null 的 conversation_config.conversation.dtmf_input_settings（DTMFInputConfig）。支持 dtmf_input_timeout（数值，0.5–10 秒，默认 2）、hash_terminator（布尔值，默认 true）和 redact_input（布尔值，默认 false）。
- 在电话号码转接配置中添加可选的 sip_refer_play_dialtone（布尔值，默认 true）。将其设为 false，可在 SIP REFER 转接完成期间保持原始通话线路静音。
- 开始和结束流程系统工具现可接受 ProcedureVersionRef 或 ProcedureDraftRef。草稿引用需要 procedure_id（字符串），并将 version_id 设为 null。
获取对话 - GET /v1/convai/conversations/{conversation_id}
- 在转录条目中添加 file_inputs（ConversationHistoryTranscriptFileInputResponseModel 数组）。每项都需要 file_id、original_filename、mime_type 和 file_url（字符串）。
- 在批量呼叫元数据中添加可选且可为 null 的 campaign（BatchCallingCampaignInformation）。该对象需要 campaign_id 和 campaign_lead_id（字符串）。
- 向 ChatSourceMedium 添加 dtmf。
对话分诊工单问题类型新增 incorrect_information、documentation_gap、platform_bug 和 wrong_action。

详细生成音乐（POST /v1/music/detailed）和流式生成音乐及详情（POST /v1/music/detailed/stream）
- 添加可选的 with_waveform_visual（布尔值，默认 false）。
- 详情响应新增可为 null 的 waveform_visual（整数数组），每秒采样 4 次，取值范围为 -1000 到 1000。
上传音乐 - POST /v1/music/upload
- 在响应中添加可选的 with_waveform_visual（布尔值，默认 false）和可为 null 的 waveform_visual（整数数组）。

列出配音项目 - GET /v1/dubbing/project
- page_size 仍为可选整数，默认值为 20，但现在会将值限制在 1–100，而非拒绝请求。
- status 筛选器现说明 queued、preparing、ready 和 failed。
- 将上一响应的 next_cursor 传入 cursor；获取第一页时省略该参数。
列出语言目标 - GET /v1/dubbing/project/{project_id}/language
- page_size 仍为可选整数，默认值为 20，但现在会将值限制在 1–100，而非拒绝请求。
- status 筛选器支持 queued、processing、completed、stale 和 failed。
- 将上一响应的 next_cursor 传入 cursor；获取第一页时省略该参数。