September 7, 2026 | ElevenLabs Documentation

工作区范围的对话工单：新增列出工作区工单，可获取有访问权限的智能体中的对话分诊工单。可按状态或负责人筛选，并使用游标分页，每页最多获取 100 个工单。
动态变量对话筛选：列出对话和文本搜索对话消息现接受可重复的 dynamic_variable_params 筛选条件。使用 name:op:value 格式，op 可为 eq、gt、gte、lt 或 lte；比较运算符要求值为数值。
Twilio 答录机检测：外呼电话和批量呼叫配置现支持可选的 twilio_machine_detection。选择 enable 可尽早判断是人工还是机器，选择 detect_message_end 则等待语音信箱问候语结束。结果将通过新的 answering_machine_detection webhook 事件送达。
数据收集值约束：数据收集属性现可使用 allowed_values 指定一个包含允许值的动态变量。此前的 allowed_values_dynamic_variable 字段已弃用。
智能体元数据：列出智能体分支响应现会指明草稿的创建时间，以及它是否早于分支最新提交。智能体和语音引擎摘要现在要求提供 voice_id。
知识库源 URL：智能体 RAG 查询分块现包含必需且可为 null 的 source_url，其中包含 URL 文档的追踪 URL。
智能体响应附件：agent_response WebSocket 事件现包含可选的 attachments。每个附件都需要 url 和 name，并可包含 mime_type。

API 密钥平台限制：服务账号 API 密钥响应现可包含企业版 platform_limits，涵盖额度、专业语音克隆，以及 TTS、配音和音乐的并发限制。

v2.67.0 - 在对话列表和文本搜索请求中添加 dynamicVariableParams。重新生成 Twilio 答录机检测、数据收集值约束、API 密钥平台限制、智能体分支草稿元数据和知识库源 URL 的类型。

v2.67.0 - 在同步和异步对话列表及文本搜索方法中添加 dynamic_variable_params。重新生成 Twilio 答录机检测、数据收集值约束、API 密钥平台限制、智能体分支草稿元数据和知识库源 URL 的类型。实时文本转语音客户端不再将内部 omit sentinel 传递给连接。

v1.2.0 - 添加 elevenlabs say 命令及其智能体技能，重新生成 API 命令绑定，并将 eleven_v3 设为默认 TTS 模型。

@elevenlabs/client@1.25.0、@elevenlabs/react@1.15.2、@elevenlabs/react-native@1.2.27、@elevenlabs/convai-widget-core@0.18.1 和 @elevenlabs/convai-widget-embed@0.18.1 - 从 @elevenlabs/client 重新导出 MessageAttachment，以便使用者直接导入该类型。
@elevenlabs/client@1.24.0、@elevenlabs/types@0.23.0、@elevenlabs/react@1.15.1、@elevenlabs/react-native@1.2.26、@elevenlabs/convai-widget-core@0.18.0 和 @elevenlabs/convai-widget-embed@0.18.0 - 将智能体响应文件附件转发至 onMessage，并新增可选的 webRtc.singlePeerConnection 会话设置。组件还对问候按钮进行了本地化，并修复了文本聊天响应丢失或重复的问题。

新增端点

列出工作区工单 - GET /v1/convai/triage-tickets
- 列出调用方有权访问的所有智能体中的对话分诊工单，按创建时间从近到远排序。
- 添加可选的 page_size（整数，1–100，默认 100）、status（AgentConversationTicketStatus）、assignee_user_id（字符串或 unassigned）和 cursor（字符串）查询参数。
- 返回 GetAgentConversationTicketsPageResponseModel。

列出对话 - GET /v1/convai/conversations
- 添加可选且可为 null 的 dynamic_variable_params（可重复字符串数组）。每个值使用 name:op:value 格式，其中 op 为 eq、gt、gte、lt 或 lte。
文本搜索对话消息 - GET /v1/convai/conversations/messages/text-search
- 添加具有相同语法的可选且可为 null 的 dynamic_variable_params（可重复字符串数组）。
Twilio 外呼、SIP 中继外呼、Exotel 外呼和提交批量呼叫
- telephony_call_config 现使用独立的输入和输出 schema。
- 添加可选且可为 null 的 twilio_machine_detection（TwilioMachineDetectionConfig）。其 mode 接受 enable 或 detect_message_end，默认值为 enable。非 Twilio 服务商和呼入电话会忽略此设置。
导入电话号码 - POST /v1/convai/phone-numbers
- 为 Twilio API 密钥导入添加可选且可为 null 的 account_auth_token（字符串），用于验证呼入 webhook 签名。

WebhookEventType 新增 answering_machine_detection。
AgentBranchSummary 新增可选且可为 null 的 draft_created_at（整数）和可选的 draft_is_behind_tip（布尔值，默认 false）。
AgentKnowledgeBaseRagChunkResponseModel 新增必需且可为 null 的 source_url（字符串）。
AgentSummaryResponseModel 和 SpeechEngineSummaryResponse 新增必需的 voice_id（字符串）。
AnalysisProperty 新增可选且可为 null 的 name（字符串）和 allowed_values（AllowedValues）。LiteralJsonSchemaProperty 也新增 allowed_values。两者均弃用 allowed_values_dynamic_variable。
DataCollectionResultCommonModel 新增可选且可为 null 的 name（字符串）。
WorkspaceApiKeyResponseModel 新增可选且可为 null 的 platform_limits（PlatformLimits）。
MCP 工具 Icon 新增可选且可为 null 的 theme（light 或 dark）。
SMBToolConfig 新增 send_custom_email、create_service_quote_request 和 create_product_quote_request 参数变体。
Webhook 查询参数 schema 和电话呼叫配置现使用独立的输入和输出模型。
agent_response WebSocket 事件新增可选的 attachments（数组）。每项都需要 url 和 name（字符串），并接受可选的 mime_type（字符串）。

ReferenceVideo.studio_clip 现使用 StudioClipLocator 替代 StudioClipReference。字段和线缆格式保持不变。