ElevenAgents
- Merge and search triage tickets: Merge tickets folds up to 50 open tickets from the same agent into one target ticket. Merged tickets keep the status
mergedand reference the target throughmerged_into_ticket_id. List tickets and List workspace tickets add a case-insensitivesearchparameter that matches ticket titles, descriptions, comments and turn comments, and each result includes asearch_matchexcerpt showing where the query matched. - Workflow End node outcomes: Workflow End nodes accept an
outcomeofsuccess(default) orfailure, so a workflow can record whether a conversation ended successfully. The conversation error type addsworkflow_end_failure. - Call queueing enabled for new agents: New agents are created with call queueing enabled unless
platform_settings.queueing_config.enabledis set explicitly. Existing agents keep their current setting. - Post-call audio webhook retries: When Enable retries is on,
post_call_audiowebhooks are retried on the same schedule as transcription webhooks. Audio payloads over 50 MiB are not retried, and queued audio retries are capped at 400 MiB per webhook. - Strict tool overrides: The conversation override
tool_ids_strictmakes an overriddentool_idslist the complete set of tools available in the conversation, including tools on workflow nodes. It is ignored when set on the agent itself. - Widget end confirmation: The widget can ask users to confirm before ending a chat or call. Enable it with
end_confirmation_enabledin the widget configuration or theend-confirmationattribute.
Text to Speech
- Audio effects: Text to Speech and Text to Dialogue requests accept an optional
audio_effectsobject. It applies a filter preset, perceived distance, a reverb environment, a looped background noise bed and stereo panning to the generated audio. List valid preset, environment and background noise IDs withGET /v1/audio-effects/catalog. Reverb and non-zero panning produce stereo audio and are rejected forulaw_*,alaw_*andpcm_*output formats. Effects do not change the cost of a request.
Speech to Text
- Turn prediction commit strategy: The realtime Speech to Text WebSocket adds
turn_predictionas acommit_strategyvalue. In addition to silence-based segmentation, it commits a segment as soon as the model predicts the speaker has finished their turn. It is the default for models that predict turns, and partial transcripts from those models includeturn_probability. See transcripts and commit strategies.
Voices
- Voice collections API: Voice collections can now be managed through the API. Create, list, update and delete collections, and add or remove voices. See List voice collections.
Workspaces
- Basic seat fallback: Update member accepts
allow_downgrade_to_basic_seat. When unlocking a user whose original seat type has no seats available, the user is moved to a basic seat instead of the request failing. - Workspace ID on user: Get user returns the
workspace_idof the workspace the API key belongs to.
SDK releases
JavaScript SDK
- v2.72.0 - Added clients for voice collections, the audio effects catalog and triage ticket merging. Text to Speech and Text to Dialogue methods accept
audio_effects, triage ticket list methods add search and filters, and the realtime Speech to Text client adds theturn_predictioncommit strategy.
Python SDK
- v2.72.0 - Added clients for voice collections, the audio effects catalog and triage ticket merging. Text to Speech and Text to Dialogue methods accept
audio_effects, triage ticket list methods add search and filters, and the realtime Speech to Text client adds theturn_predictioncommit strategy.play()andsave()now accept any iterable of audio chunks, such as a list or tuple.RealtimeEvents.CLOSEhandlers receive a dictionary with the WebSocket closecodeandreason; handlers without parameters continue to work.
ElevenLabs CLI
- v1.5.0 - Regenerated API commands, adding voice collections, the audio effects catalog, triage ticket merging and agent merge proposals.
Packages
- @elevenlabs/client@1.27.0 and @elevenlabs/react@1.17.0 - Added a
previousTextoption toScribe.connect()anduseScribe()in microphone mode. The text is sent with the first audio chunk to give the model context, such as existing document text, for casing, punctuation and sentence continuation.MediaDeviceOutputnow receiveslibsampleratePath, so output resampling uses the same custom libsamplerate bundle path asMediaDeviceInput. - @elevenlabs/react-native@1.2.29 - Updated to
@elevenlabs/client@1.27.0and@elevenlabs/react@1.17.0. - @elevenlabs/convai-widget-core@0.19.0 and @elevenlabs/convai-widget-embed@0.19.0 - Added an optional confirmation dialog before ending a chat or call, enabled with the
end-confirmationattribute orend_confirmation_enabledconfig, with customizable text. Added carousel rich content with scrollable item cards that can include an image, subtitle, description and actions. Carousels remain in the transcript after a reply, without their actions. Rich content is now shown during voice calls when the transcript is visible.
API
View API changes
New endpoints
ElevenAgents
- Merge tickets -
POST /v1/convai/triage-tickets/{agentqa_ticket_id}/merge- Merge open tickets into the target ticket. Requiressource_ticket_ids(string array, 1–50 items) and returns the target ticket.
Voices
- List voice collections -
GET /v1/voices/collections- List the voice collections the caller can access, sorted by title. - Create voice collection -
POST /v1/voices/collections- Create a collection with requiredtitleandicon(string, maximum 1,000 characters each). - Get voice collection -
GET /v1/voices/collections/{collection_id}- Retrieve a collection with itstitle,iconand the caller’spermission_on_resource(admin,editor,commenterorviewer). - Update voice collection -
PATCH /v1/voices/collections/{collection_id}- Update the optionaltitleoricon. - Delete voice collection -
DELETE /v1/voices/collections/{collection_id} - Add voice to collection -
POST /v1/voices/collections/{collection_id}/voice/{voice_id} - Remove voice from collection -
DELETE /v1/voices/collections/{collection_id}/voice/{voice_id}
Audio effects
GET /v1/audio-effects/catalog- List the availablefilter_presets,environmentsandbackground_noises. Each entry has an ID, anameand a nullabledescription.
Updated endpoints
ElevenAgents
- Create agent, Get agent and Update agent
- Workflow End nodes add
outcome(successorfailure, defaultsuccess). The field is required in responses. - Standalone workflow agent nodes and agent transfer configurations add nullable
branch_id(string) to target a specific branch of the destination agent. When unset, the transfer follows the target agent’s traffic deployment. Transfer tool results add aconfiguredbranch reason. - Prompt override configurations add
tool_ids_strict(boolean, defaultfalse). - TTS configuration
effectsaddpan(number, -1 to 1, default0). Theseedfield is deprecated and has no effect.
- Workflow End nodes add
- Get widget config - Added
end_confirmation_enabled(boolean, defaultfalse). - List tickets
- Added optional
search(string, maximum 200 characters) andmerged_into_ticket_id(string) query parameters. - Ticket responses add nullable
merged_into_ticket_idand nullablesearch_matchwithfield(title,description,commentorturn_comment),snippet,highlight_start,highlight_endand nullableturn_index.
- Added optional
- List workspace tickets - Added optional
agent_id,sources,priorities,sort_by(created_atorpriority, defaultcreated_at),owner_user_id,issue_type,label,merged_into_ticket_idandsearchquery parameters. - List tests - Added optional
created_by_user_id(string). Use@mefor the authenticated user. - List test invocations - Added optional
test_id(string),version_id(string),start_timeandend_time(integer, Unix seconds, inclusive) query parameters. - Update agent branch - Added optional
auto_rebase(boolean). Branch responses addauto_rebase(boolean, defaultfalse). - Get conversation details
- Twilio, SIP trunk and Exotel phone call metadata add nullable
call_resultwithanswered,voicemail,busy,no_answerandfailedvalues. - Batch call metadata adds nullable
cold_attempt(integer) and nullableconversation_type(initial,retry,callbackorredirect). - The conversation error type adds
workflow_end_failure.
- Twilio, SIP trunk and Exotel phone call metadata add nullable
- Knowledge base auto-sync
auto_discoveris deprecated and no longer has any effect.
Text to Speech
- Create speech, Stream speech, Create speech with timing and Stream speech with timing
- Added optional nullable
audio_effectswithfilter_preset_id(string),distance(number, 0–1, default0),environment_id(string),background_noise_id(string),send_level(number, 0–1, default1) andpan(number, -1 to 1, default0). - Unknown effect IDs return
404. Stereo effects return400forulaw_*,alaw_*andpcm_*output formats.
- Added optional nullable
Text to Dialogue
- Create dialogue, Stream dialogue, Create dialogue with timestamps and Stream dialogue with timestamps - Added optional nullable
audio_effects, matching the Text to Speech endpoints.
Speech to Text
- Realtime Speech to Text
- The
commit_strategyquery parameter addsturn_prediction, alongsidemanualandvad. partial_transcriptmessages add optionalturn_probability(number), sent only for models that predict turns.
- The
Music
POST /v1/music/video-to-music- Responses add asong-idheader with the ID of the generated song.
History
- List generated items - The history item
sourceenum addsVoicePreview.
Workspace and user
- Update member - Added optional
allow_downgrade_to_basic_seat(boolean, defaultfalse). - Get user - Added required
workspace_id(string). - Service account API key permissions add
voice_collections_readandvoice_collections_write.
ElevenAgents
- Structured procedures compile on save and publish: Update agent and Create agent draft now compile and validate structured procedures automatically. Integrations no longer need to call the compile endpoint or manually update the generated workflow. Invalid procedures return per-procedure errors as
400 procedure_validation_failed. Agents without structured procedures are unaffected. - Compile procedures endpoint is legacy: Compile procedures is marked legacy and should not be used by new integrations. It remains available for existing callers.
- Merge proposals: Merge proposals are available in alpha. Teams can open a proposal for an agent branch, review configuration changes and test results, leave comments or approval decisions, and merge approved changes into a target branch. See Merge proposals.
SDK releases
JavaScript SDK
- v2.71.0 - Added clients for agent merge proposals, deployment history, test invocation cancellation and Speech Engine duplication. The release also adds triage ticket priorities and sorting, batch call export limits,
gpt-6.1-sol,claude-sonnet-5-5, Eleven v4 agent voice models and current agent configuration types.
Python SDK
- v2.71.0 - Added clients for agent merge proposals, deployment history, test invocation cancellation and Speech Engine duplication. The release also adds triage ticket priorities and sorting, batch call export limits,
gpt-6.1-sol,claude-sonnet-5-5, Eleven v4 agent voice models and current agent configuration types.
Swift SDK
- v3.4.0 - Dynamic variables now preserve native JSON types when sent in conversation initiation data.
Packages
- @elevenlabs/client@1.26.0, @elevenlabs/react@1.16.0, @elevenlabs/react-native@1.2.28 and @elevenlabs/types@0.24.0 - Added realtime Speech to Text transcript editing through
transcriptEdit, theedited_transcriptevent and React’sonEditedTranscriptcallback. React now forwardsfilterBackgroundAudioto realtime sessions. The client also exportsMessagePayloadand uses stable response IDs to prevent duplicate agent replies. - @elevenlabs/convai-widget-core@0.18.3 and @elevenlabs/convai-widget-embed@0.18.3 - Added image previews and download links for agent message attachments, including attachment-only replies. Stable response IDs prevent duplicate replies, and text-only conversations now use a stop control with an End chat tooltip.
API
View API changes
New endpoints
ElevenAgents
- Create a merge proposal -
POST /v1/convai/agents/{agent_id}/merge-proposals- Create a proposal with requiredsource_branch_id,target_branch_idandtitlefields, plus an optional description, reviewer IDs and triage ticket ID. - List merge proposals -
GET /v1/convai/agents/{agent_id}/merge-proposals- List proposals with status, source branch, target branch and text filters, plus cursor pagination. - Get a merge proposal -
GET /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}- Retrieve a proposal and its review, comment and outcome details. - Update a merge proposal -
PATCH /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}- Update its title, description or requested reviewers, or close it without merging. - Review a merge proposal -
POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/reviews- Submit anapprovedorchanges_requesteddecision with an optional comment. - Comment on a merge proposal -
POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/comments- Add a Markdown comment of up to 4,096 characters. - Merge a merge proposal -
POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/merge- Merge the source branch and optionally control forced conflict resolution and source branch archival. - List agent deployments -
GET /v1/convai/agents/{agent_id}/deployments- List current and historical branch traffic splits with page-based pagination. - Cancel a test invocation -
POST /v1/convai/test-invocations/{test_invocation_id}/cancel- Cancel a running test invocation.
Speech Engine
- Duplicate a Speech Engine -
POST /v1/speech-engine/{speech_engine_id}/duplicate- Duplicate a Speech Engine and optionally assign the copy a newname.
Updated endpoints
ElevenAgents
- Create agent, Get agent and Update agent
- Added
gpt-6.1-solandclaude-sonnet-5-5to theLLMenum. - Added
eleven_v4andeleven_v4_turboto the conversational TTS model options. The default changed fromeleven_flash_v2toeleven_v4_turbo. - Agent transfers and standalone workflow agent nodes add optional
preserve_voice_settings(boolean, defaultfalse) to retain the base voice, TTS model and voice settings after a transfer. - Skip-turn tool configurations add optional
wait_timeout_secs(number, default-1). A value of-1keeps the agent silent until the caller speaks. - Post-call webhook configurations add optional
exclude_transcript(boolean, defaultfalse) to omit turn-by-turn transcripts from JSON transcription webhooks. - Conversation history redaction configurations add optional
excluded_data_collection_ids(string array, maximum 50) to preserve selected extracted values while redacting their rationales. - Client tool
response_timeout_secsnow accepts-1to wait indefinitely whenexpects_responseis enabled.
- Added
- List tickets
- Added optional
priorities(array) withlow,medium,highandurgentvalues. - Added
sort_bywithcreated_atandpriorityvalues; the default iscreated_at. - Ticket responses now require
title, nullablepriority, and apriority_changesarray. Ticket creation and update requests can setpriority, and ticket status addscancelled.
- Added optional
- List tools - Added optional nullable
used_by_agent_id(string) to return tools referenced by an agent’s main branch. - Export batch call results - Added optional nullable
limit(integer, minimum1) to export only the first recipients as a column preview. - List test invocations and Get test invocation
- Test invocation summaries add required
cancelled_count(integer) and optionalcancelled(boolean, defaultfalse). - Test run status adds
cancelled.
- Test invocation summaries add required
- Get conversation details - Transcript entries add optional nullable
platform_eventwithuser_turn_timeoutandskip_turn_wait_elapsedvalues. - Get agent version metadata - Added optional nullable
merged_authors, an array describing the people who published changes merged into the main branch. - Get crawl job - Removed the deprecated
max_depthresponse field.
Eleven v4 and Eleven v4 Turbo
Eleven v4 and Eleven v4 Turbo are now available. Eleven v4 provides higher-quality, more expressive speech and improved voice cloning across more than 90 languages. Eleven v4 Turbo provides the same model family for real-time applications, with median inference latency of approximately 100 ms.
Use eleven_v4 through the Text to Dialogue API for content creation and long-form audio. Use eleven_v4_turbo through the Text to Dialogue WebSocket for agents and interactive applications.
Speech to Text
- Transcript editing: Batch and realtime transcription now accept a natural-language edit instruction of up to 2,000 characters. Batch responses return the result in
edited_transcript, while realtime sessions emit anedited_transcriptevent. See the batch and realtime guides for incompatibilities, response handling and pricing.
ElevenAgents
- Agent models: Added
gpt-6-sol,gpt-6-luna,glm-52,deepseek-v41-flash,claude-opus-5andclaude-opus-5-5to the supported agent LLM options. - Agent test usage: Test invocation summaries can include total credits and USD price. Individual test runs can include credits and a charging breakdown.
Flows
- Template API: Added endpoints to list and retrieve published Flows templates, start template runs and retrieve run results. Runs can target a published version and send their terminal result to a configured webhook.
Text to Dialogue
- Generation continuity: Text to Dialogue requests can use preceding or following text and request IDs to maintain continuity across generations.
- Professional voice mode: Text to Dialogue requests can use the Instant Voice Clone version of a Professional Voice Clone to reduce latency or improve expressiveness.
SDK releases
JavaScript SDK
- v2.70.0 - Added batch and realtime Speech to Text transcript editing types,
branchIdfiltering and cost fields for test invocation summaries, knowledge base auto-discovery, Text to DialogueusePvcAsIvcand thedeepseek-v41-flashagent model.
Python SDK
- v2.70.0 - Added batch and realtime Speech to Text transcript editing types,
branch_idfiltering and cost fields for test invocation summaries, knowledge base auto-discovery, Text to Dialogueuse_pvc_as_ivcand thedeepseek-v41-flashagent model.
ElevenLabs CLI
- v1.4.0 - Fixed requests with an explicit API key so they no longer also send stored OAuth credentials, which caused authentication failures. Added descriptions for the feedback command group and instructions for reporting missing capabilities to generated agent skills. Regenerated the API client with Flows template endpoints and current schema types.
API
View API changes
New endpoints
Flows
- List templates -
GET /v1/flows/templates- List published templates and their runnable versions. - Get template -
GET /v1/flows/templates/{template_id}- Retrieve a template and its runnable versions. - Create template run -
POST /v1/flows/templates/{template_id}/runs- Start a template run with input values, an optional version and an optional webhook. - List template runs -
GET /v1/flows/templates/{template_id}/runs- List template runs with cursor pagination and optional version filtering. - Get template run -
GET /v1/flows/templates/{template_id}/runs/{run_id}- Retrieve a template run and its output status.
Updated endpoints
Speech to Text
- Convert speech to text -
POST /v1/speech-to-text- Added optional nullable
transcript_edit(string), which accepts a natural-language edit instruction of up to 2,000 characters. - Responses add optional nullable
edited_transcript. A successful edit contains requiredkind: "transcript"andtextfields. A failed edit contains requiredkind: "error",error_type: "edit_failed"andmessagefields.
- Added optional nullable
- Realtime Speech to Text accepts
transcript_edit(string) and emitsedited_transcriptevents with requiredtextandedited_textfields.
ElevenAgents
- Create agent, Get agent and Update agent
- Added
gpt-6-sol,gpt-6-luna,glm-52,deepseek-v41-flash,claude-opus-5andclaude-opus-5-5to theLLMenum. - Alerting monitors add optional nullable
enabled(boolean) to control whether a monitor can send notifications.
- Added
- List conversations and Text search
data_collection_paramsanddynamic_variable_paramsaddneqandinoperators. Values forinuse a pipe delimiter.evaluation_paramsacceptssuccess,failureorunknownas the result value.
- Smart search -
GET /v1/convai/conversations/messages/smart-search- Added optional nullable
branch_id(string).
- Added optional nullable
- List test invocations -
GET /v1/convai/test-invocations- Added optional nullable
branch_id(string). - Test invocation summaries add optional nullable
credits_used(integer) andtotal_price(number).
- Added optional nullable
- Get test invocation -
GET /v1/convai/test-invocations/{test_invocation_id}- Individual test runs add optional nullable
credits_used(integer) andcharging(ConversationChargingCommonModel).
- Individual test runs add optional nullable
- Simulate conversation and Simulate conversation stream
- Changed the optional
new_turns_limitdefault from10,000to100and set its maximum to100.
- Changed the optional
- Create crawl job and Get crawl job
- Added optional
auto_discover(boolean, defaultfalse) to follow links and add newly discovered pages during auto-sync. This requiresenable_auto_sync: true.
- Added optional
- Refresh knowledge base document -
POST /v1/convai/knowledge-base/{documentation_id}/refreshAutoSyncInfoadds optionalauto_discover(boolean, defaultfalse) to indicate whether refreshes crawl and add newly discovered pages.
- List MCP server tools -
GET /v1/convai/mcp-servers/{mcp_server_id}/tools- Responses add optional
tool_approval_statuses(array). Each item contains requiredtool_id(string) andstate(up_to_date,needs_reviewornot_approved), with optional approval policy and approved-definition fields.
- Responses add optional
Text to Dialogue
- Convert text to dialogue, Stream text to dialogue, Convert with timestamps and Stream with timestamps
- Added optional
use_pvc_as_ivc(boolean, defaultfalse) to use the Instant Voice Clone version of a Professional Voice Clone. - Added optional nullable
previous_textandfuture_text(strings, maximum 100 characters) andprevious_request_idsandnext_request_ids(string arrays, maximum 3 IDs) for generation continuity. - The optional
settingsobject adds nullablesimilarity(number, 0–1, default0.75).
- Added optional
Text to Speech
- Convert text to speech, Stream text to speech, Convert with timestamps and Stream with timestamps
- The existing
use_pvc_as_ivcfield is no longer deprecated.
- The existing
Flows
- Create image generation, Create video generation and Create template run
- Webhook targets now require an explicit
typediscriminator (allorids). The previous defaults were removed.
- Webhook targets now require an explicit
Voice Design
- Create voice from preview, Create voice previews, Design a voice and Remix a voice
- Added a
409response when a generation for the preview is already in progress. Retry the request after receiving this response.
- Added a
Workspaces
- Create service account API key -
POST /v1/service-accounts/{service_account_user_id}/api-keys- Added optional nullable
tts_concurrency_limit,music_concurrency_limitanddubbing_concurrency_limit(integers) for enterprise service account API keys.
- Added optional nullable
- Update service account API key -
PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}- Added optional
tts_concurrency_limit,music_concurrency_limitanddubbing_concurrency_limit. Each field accepts an integer,clear,no_updateornulland defaults tono_update.
- Added optional
Models
- List models -
GET /v1/models- Deprecated required
max_characters_request_free_userandmax_characters_request_subscribed_user. These fields are not enforced; usemaximum_text_length_per_requestinstead.
- Deprecated required
Imagem e Vídeo
- Sora 2 e Sora 2 Pro descontinuados: A OpenAI descontinuará a API Sora em 24 de setembro de 2026. Ambos os modelos foram removidos do seletor de modelos de Imagem e Vídeo e deixarão de gerar nessa data. As gerações existentes continuarão disponíveis no seu histórico. Flows e modelos que usam um nó do Sora precisam ser alterados para outro modelo de vídeo, como o Gemini Omni 1.1 Flash, antes de poderem ser executados novamente.
- Seedance 1.5 Pro descontinuado: A ByteDance descontinuará o Seedance 1.5 Pro em 11 de novembro de 2026. O modelo não é mais oferecido para novas gerações e deixará de funcionar nessa data. Use um modelo Seedance 2.0 em vez disso.
ElevenAgents
- Chamadas paralelas de ferramentas: A configuração de prompt do agente agora inclui
enable_parallel_tool_calls(booleano, padrãotrue). Quando ativado, os modelos compatíveis podem executar várias ferramentas em um turno. - Modelos de agente: Adicionado
gpt-6-astraàs opções de LLM do agente. - Alertas: Os alertas do agente agora oferecem suporte a canais do Slack, além de notificadores do PagerDuty e webhooks.
- Busca de números de telefone: Adicionado um endpoint de números de telefone com paginação por cursor e filtros de provedor, suporte a chamadas de saída, agente e ramificação atribuídos, rótulo e número de telefone.
Imagem e vídeo
- Modelos GPT Image 2.5: A geração de imagens agora oferece suporte a
gpt-image-2.5-flareegpt-image-2.5-sunburst. Ambos os modelos aceitam até 10 imagens de referência, níveis de qualidade atémax, 14 proporções fixas maisautoe saída em 1K, 2K ou 4K.
Speech Engine
- Tempo limite de cascata: As solicitações de criação e atualização do Speech Engine agora aceitam
cascade_timeout_seconds(número, 2–15, padrão4) para controlar por quanto tempo a ElevenLabs aguarda um mecanismo de voz upstream antes de tentar novamente.
Text to Speech
- Limites de turno em múltiplos contextos: O marcador
is_final_audio_for_turnagora é emitido após cada byte armazenado em buffer para aquele turno, incluindo saídas MP3 e Opus. Os clientes podem usar o marcador como um limite exato de turno sem precisar mudar para PCM.
Lançamentos de SDKs
SDK JavaScript
- v2.69.0 - Adicionado
transcriptEditao wrapper de Speech to Text em tempo real, com texto editado entregue por eventosedited_transcript. Corrigida a verificação de JWT do Speech Engine para chaves de API com sufixos de residência de dados. AdicionadosphoneNumbers.listV2e métodos de modelos do Flows para listar e obter modelos, além de listar, criar e obter execuções. Clientes e tipos regenerados para GPT Image 2.5, alertas de agente no Slack, chamadas paralelas de ferramentas,gpt-6-astra, limites de simultaneidade de chaves de API de contas de serviço, retenção zero de Música, filtros de conversa e status de aprovação de ferramentas MCP.
SDK Python
- v2.69.0 - Adicionado
transcript_editao wrapper de Speech to Text em tempo real, com texto editado entregue por eventosedited_transcript. Corrigida a verificação de JWT do Speech Engine para chaves de API com sufixos de residência de dados, eplayagora gera um erro quandoffplayfalha. Adicionadosphone_numbers.list_v2e métodos de modelos do Flows para listar e obter modelos, além de listar, criar e obter execuções. Clientes e tipos regenerados para GPT Image 2.5, alertas de agente no Slack, chamadas paralelas de ferramentas,gpt-6-astra, limites de simultaneidade de chaves de API de contas de serviço, retenção zero de Música, filtros de conversa e status de aprovação de ferramentas MCP.
CLI da ElevenLabs
- v1.3.2 - Adicionados metadados opcionais
--intentpara coletar feedback sobre o uso da CLI. Adicionadoelevenlabs feedback missing-capabilitypara relatar workflows que a CLI não oferece suporte.
API
Ver alterações da API
Novos endpoints
ElevenAgents
- Listar página de números de telefone -
GET /v1/convai/v2/phone-numbers- Adicionados parâmetros de paginação
page_size(inteiro, 1–1.000, padrão100) ecursor(string anulável) opcionais. - Adicionados filtros opcionais
search,label,phone_number,provider,supports_outbound,agent_id,branch_id,sort_byesort_direction.sort_byaceitalabelouphone_number;sort_directiontem como padrãoasc. - A resposta contém
phone_numbers(array) obrigatório,next_cursor(string) anulável e opcional, ehas_more(booleano, padrãofalse).
- Adicionados parâmetros de paginação
Endpoints atualizados
ElevenAgents
- Criar agente, Obter agente e Atualizar agente
- A configuração de prompt adiciona
enable_parallel_tool_calls(booleano, padrãotrue). As substituições de workflow aceitam um booleano anulável. - A enumeração
LLMadicionagpt-6-astra, incluindo substituições de início de conversa. - Os notificadores de integração de alertas agora usam
integration_typepara selecionarpagerdutyouslack. Os notificadores do Slack exigemconnection_idechannel_id(strings);channel_idaceita de 1 a 64 caracteres.
- A configuração de prompt adiciona
- Listar conversas e Resolver referência de conversa
data_collection_paramsnão aceita mais o operadormissing. Use um valor vazio para encontrar conversas nas quais o campo não foi coletado.- Um valor vazio em
dynamic_variable_paramsencontra conversas em que a variável não foi definida.
- Criar Speech Engine, Obter Speech Engine e Atualizar Speech Engine
- Adicionado
cascade_timeout_seconds(número, 2–15). As solicitações de criação usam4como padrão, as solicitações de atualização aceitam um valor anulável e as respostas exigem o campo.
- Adicionado
Imagem e vídeo
- Criar geração de imagem -
POST /v1/flows/image- Adicionadas variantes de solicitação para
gpt-image-2.5-flareegpt-image-2.5-sunburst. - Ambas as variantes exigem
promptemodel_id, aceitam até 10imagese adicionamresolution(1K,2Kou4K, padrão1K). qualityaceitalow,medium,high,xhighoumaxe tem como padrãohigh.aspect_ratioaceitaautoe 14 proporções fixas, e tem como padrão16:9.
- Adicionadas variantes de solicitação para
Dublagem
- Criar projeto de dublagem -
POST /v1/dubbing/project- O
keytermsmultipart aceita campos repetidos ou um único array JSON. - O
webhook_idsmultipart aceita campos repetidos, um único array JSON ou uma string separada por vírgulas.
- O
- Obter recurso do workspace, Compartilhar recurso do workspace e Remover compartilhamento de recurso do workspace
WorkspaceResourceTypeadicionadubbing_project.
Base de conhecimento
- Criar tarefa de rastreamento -
POST /v1/convai/knowledge-base/crawlmax_depth(inteiro, padrão3) foi descontinuado. O campo agora não tem efeito e não possui mais restrições mínimas ou máximas.- Os metadados da tarefa de rastreamento não exigem mais
max_depth.
Usuário
- Obter usuário e Obter assinatura
- As enumerações de moeda adicionam
gbp.
- As enumerações de moeda adicionam
Alterações de esquema
Text to Speech
- As mensagens WebSocket
audioefinalde múltiplos contextos agora definemis_final_audio_for_turncomo ocorrendo após a entrega de todos os bytes armazenados em buffer para o turno.
ElevenAgents
- Fila de chamadas e áudio de espera: Adicionamos fila de chamadas para agentes que atingiram o limite de simultaneidade. Quem liga e entra na fila ouve áudio de espera e recebe eventos
queue_statusaté ser atendido ou o tempo se esgotar. Novos métodos da API permitem enviar ou excluir áudio de espera personalizado. - Metadados de versão de teste: Os resultados de teste do agente agora identificam a versão do agente usada e se incluíam alterações de rascunho. Os resumos de invocação também indicam quando reenvios parciais foram executados em versões diferentes.
- Metadados de modelo e conta: A configuração de LLM do agente agora aceita
gemini-3.8-flash. As respostas de contas do WhatsApp identificam se a conta usa a Cloud API ou o fluxo de cadastro coexistente.
Música
- Suporte à API Music v2.5: Os endpoints e SDKs de Música agora aceitam
music_v2_5. Os blocos de geração de planos de composição suportam até 6.132 caracteres, com até 30 linhas de 200 caracteres cada.
Lançamentos de SDKs
SDK JavaScript
- v2.68.0 - Adicionados métodos para enviar e excluir áudio de espera do agente. Tipos regenerados para fila de chamadas, referências de procedimentos, criação de ramificação de rascunho, limites de consultas RAG, metadados de versão de teste,
gemini-3.8-flashemusic_v2_5.
SDK Python
- v2.68.0 - Adicionados métodos síncronos e assíncronos para enviar e excluir áudio de espera do agente. Tipos regenerados para fila de chamadas, procedimentos, criação de ramificação de rascunho, limites de consultas RAG, metadados de versão de teste,
gemini-3.8-flashemusic_v2_5. O wrappercompose_detailedagora aceita todos os IDs de modelo de música gerados e planos de composição baseados em prompt e em blocos.
SDK iOS
- v3.3.1 - Reconcilia mensagens do agente por
response_idem vez deevent_id, preservando várias respostas durante chamadas de ferramentas e evitando que partes transmitidas ou correções sejam associadas à mensagem errada.
CLI da ElevenLabs
- v1.3.0 - Adicionados metadados opcionais
--intentaos comandos de API gerados. Adicionadoelevenlabs feedback missing-capabilitypara relatar workflows que a CLI não oferece suporte.
Pacotes
- @elevenlabs/convai-widget-core@0.18.2 e @elevenlabs/convai-widget-embed@0.18.2 - Corrigidas respostas duplicadas do agente após chamadas de ferramentas e procedimentos. As respostas de texto transmitidas mantêm a formatação Markdown, e conversas por voz não exibem mais partes de chat transmitidas que não foram faladas. O pacote embed também limita os eventos
user_activitya uma vez por segundo e remove o limite quando uma sessão termina.
API
Ver alterações da API
Novos endpoints
ElevenAgents
- Enviar áudio de espera do agente -
POST /v1/convai/agents/{agent_id}/hold-audio- Aceita o campo obrigatório
hold_audio_file(binário) como dados de formulário multipart. O arquivo deve ser MP3 ou WAV, de até 40 MB e 180 segundos. - Retorna
agent_id(string) ehold_audio(AgentHoldAudioConfig) obrigatórios. O objeto de áudio de espera exigeaudio_path,audio_url,original_filename(strings),duration_secs(número) esize_bytes(inteiro).
- Aceita o campo obrigatório
- Excluir áudio de espera do agente -
DELETE /v1/convai/agents/{agent_id}/hold-audio- Remove o clipe personalizado para que quem está na fila ouça o tom de espera padrão.
- Retorna
agent_id(string) obrigatório.
Endpoints atualizados
ElevenAgents
- Criar agente, Obter agente e Atualizar agente
- Adicionado
platform_settings.queueing_config(AgentQueueingConfig) opcional comenabled(booleano, padrãofalse) ewait_timeout_seconds(inteiro, 1–1.800, padrão180). - As respostas de configuração de fila incluem
hold_audio(AgentHoldAudioConfig) anulável e somente leitura. As respostas do agente também incluemdefault_hold_audio_url(string) opcional.
- Adicionado
- Obter conversa -
GET /v1/convai/conversations/{conversation_id}- Os metadados adicionam
queue_wait_secs(número) anulável e opcional. O tempo na fila não é incluído emcall_duration_secsnem no tempo cobrado.
- Os metadados adicionam
- Criar ramificação do agente -
POST /v1/convai/agents/{agent_id}/branches- Adicionado
include_draft(booleano, padrãofalse) opcional. Quandotrue, uma ramificação criada a partir da ponta da ramificação inclui o conjunto de procedimentos em rascunho de quem fez a chamada.
- Adicionado
- Listar procedimentos e endpoints de criação, obtenção e rascunho de procedimentos
- Os itens da lista adicionam
referenced_tool_ids,referenced_kb_ids,referenced_procedure_idsereferenced_dynamic_variables(arrays de strings) opcionais. - As respostas do agente e da prévia de mesclagem adicionam
proceduresopcional, um mapa indexado por ID de procedimento.
- Os itens da lista adicionam
- Listar invocações de teste -
GET /v1/convai/test-invocations- Adicionado
search(string) anulável e opcional para filtrar testes e pastas por nome.
- Adicionado
- Executar testes no agente e Obter invocação de teste
- As respostas de invocação de conjunto de testes e execução de teste unitário adicionam
version_id(string) anulável e opcional, além deran_against_draft(booleano, padrãofalse) opcional. - Os resumos de invocação também adicionam
runs_diverged_from_version(booleano, padrãofalse) opcional.
- As respostas de invocação de conjunto de testes e execução de teste unitário adicionam
POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query- O corpo da solicitação adiciona as substituições específicas da consulta
max_documents_length(inteiro, 1–50.000) emax_retrieved_rag_chunks_count(inteiro, 1–20), opcionais e anuláveis.
- O corpo da solicitação adiciona as substituições específicas da consulta
- Obter conta do WhatsApp -
GET /v1/convai/whatsapp-accounts/{phone_number_id}- Adicionado
account_type(WhatsAppAccountType, padrãocloud_api) opcional. Os valores sãocloud_apiecoexistence.
- Adicionado
- Calcular uso esperado de LLM -
POST /v1/convai/agent/{agent_id}/llm-usage/calculateLLMUsageCalculatorLLMResponseModeladicionaprice_per_message(número) obrigatório.
Música
MusicModelIDadicionamusic_v2_5paraPOST /v1/music/video-to-music,POST /v1/music/plan, Compor música,POST /v1/music/detailed,POST /v1/music/detailed/stream,POST /v1/music/stream,POST /v1/music/uploadePOST /v1/music/finetunes.GenerationChunk.textaumentamaxLengthde 6.000 para 6.132 caracteres paraPOST /v1/music/plan,POST /v1/music,POST /v1/music/detailed,POST /v1/music/detailed/stream,POST /v1/music/streamePOST /v1/music/upload. Os nomes das seções podem conter de 1 a 100 caracteres, e os blocos podem conter até 30 linhas com 200 caracteres por linha.
Alterações de esquema
ElevenAgents
- Os eventos do servidor em tempo real adicionam
queue_status. Oqueue_status_event.statusobrigatório aceitawaiting,admittedoutimed_out;timed_outprecede o código de encerramento WebSocket4300. O áudio de espera continua chegando como eventos regulares deaudio. - A enumeração
LLMadicionagemini-3.8-flash, incluindo substituições de início de conversa. - As uniões de resultados das ferramentas do sistema de conversa adicionam
start_procedure_success,start_procedure_error,end_procedure_successeend_procedure_error. FeaturesUsageCommonModeladiciona status de recurso opcionaisfreeform_procedureestructured_procedure.
Scribe v2 Medical
O Scribe v2 Medical agora está disponível para todos. É um modelo de reconhecimento de fala em lote especializado em áudio médico e clínico, cobrado na mesma tarifa do Scribe v2.
Passe scribe_v2_medical como model_id em Criar transcrição. Prompting de termos-chave, detecção de entidades, diarização de locutores e modo sem transcrição literal funcionam da mesma forma que no Scribe v2.
ElevenAgents
- Tickets de conversa em todo o espaço de trabalho: Adicionado Listar tickets do espaço de trabalho para recuperar tickets de triagem de conversas entre os agentes acessíveis. Filtre por status ou responsável e use paginação por cursor para recuperar até 100 tickets por página.
- Filtros de conversa por variáveis dinâmicas: Listar conversas e Pesquisar mensagens de conversa por texto agora aceitam filtros
dynamic_variable_paramsrepetíveis. Usename:op:valuecomeq,gt,gte,ltoulte; os operadores de comparação exigem valores numéricos. - Detecção de secretária eletrônica da Twilio: As configurações de telefonia de saída e de chamadas em lote agora oferecem suporte a
twilio_machine_detectionopcional. Escolhaenablepara uma identificação antecipada de pessoa ou máquina, oudetect_message_endpara aguardar a conclusão da saudação da caixa postal. Os resultados chegam pelo novo evento de webhookanswering_machine_detection. - Restrições de valores na coleta de dados: As propriedades de coleta de dados agora podem usar
allowed_valuespara nomear uma variável dinâmica que contém os valores permitidos. O campo anteriorallowed_values_dynamic_variableestá obsoleto. - Metadados do agente: As respostas de Listar ramificações de agentes agora indicam quando um rascunho foi criado e se ele é anterior à ponta da ramificação. Os resumos de Agente e Speech Engine agora exigem
voice_id. - URLs de origem da base de conhecimento: Os trechos de consulta RAG do agente agora incluem
source_urlanulável e obrigatório, contendo a URL rastreada para documentos de URL. - Anexos de resposta do agente: Os eventos WebSocket
agent_responseagora incluemattachmentsopcional. Cada anexo exigeurlenamee pode incluirmime_type.
Espaços de trabalho
- Limites de plataforma para chaves de API: As respostas de chave de API da conta de serviço agora podem incluir
platform_limitsempresariais para créditos, Clones de Voz Profissionais e simultaneidade de TTS, Dublagem e Música.
Lançamentos de SDKs
SDK JavaScript
- v2.67.0 - Adicionado
dynamicVariableParamsàs solicitações de listagem e pesquisa de texto de conversas. Tipos regenerados para detecção de secretária eletrônica da Twilio, restrições de valores na coleta de dados, limites de plataforma de chaves de API, metadados de rascunho de ramificações de agentes e URLs de origem da base de conhecimento.
SDK Python
- v2.67.0 - Adicionado
dynamic_variable_paramsaos métodos síncronos e assíncronos de listagem de conversas e pesquisa de texto. Tipos regenerados para detecção de secretária eletrônica da Twilio, restrições de valores na coleta de dados, limites de plataforma de chaves de API, metadados de rascunho de ramificações de agentes e URLs de origem da base de conhecimento. O cliente de conversão de texto em fala em tempo real não envia mais o sentinela interno de omissão para a conexão.
CLI da ElevenLabs
- v1.2.0 - Adicionado o comando
elevenlabs saye sua habilidade de agente, regenerados os bindings de comandos da API e definidoeleven_v3como o modelo TTS padrão.
Pacotes
- @elevenlabs/client@1.25.0, @elevenlabs/react@1.15.2, @elevenlabs/react-native@1.2.27, @elevenlabs/convai-widget-core@0.18.1 e @elevenlabs/convai-widget-embed@0.18.1 -
MessageAttachmentfoi reexportado de@elevenlabs/clientpara que os consumidores possam importar o tipo diretamente. - @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 e @elevenlabs/convai-widget-embed@0.18.0 - Encaminhados anexos de arquivos de respostas do agente para
onMessagee adicionada a configuração de sessão opcionalwebRtc.singlePeerConnection. O widget também localiza botões de saudação e corrige respostas de chat de texto perdidas ou duplicadas.
API
Ver alterações da API
Novos endpoints
ElevenAgents
- Listar tickets do espaço de trabalho -
GET /v1/convai/triage-tickets- Lista tickets de triagem de conversas em todos os agentes aos quais o solicitante tem acesso, ordenados do mais recentemente criado para o mais antigo.
- Adicionados os parâmetros de consulta opcionais
page_size(inteiro, 1–100, padrão100),status(AgentConversationTicketStatus),assignee_user_id(string ouunassigned) ecursor(string). - Retorna
GetAgentConversationTicketsPageResponseModel.
Endpoints atualizados
ElevenAgents
- Listar conversas -
GET /v1/convai/conversations- Adicionado
dynamic_variable_paramsopcional e anulável (array de strings repetível). Cada valor usaname:op:value, em queopéeq,gt,gte,ltoulte.
- Adicionado
- Pesquisar mensagens de conversa por texto -
GET /v1/convai/conversations/messages/text-search- Adicionado
dynamic_variable_paramsopcional e anulável (array de strings repetível) com a mesma sintaxe.
- Adicionado
- Chamada de saída da Twilio, Chamada de saída via tronco SIP, Chamada de saída da Exotel e Enviar chamadas em lote
telephony_call_configagora usa esquemas separados de entrada e saída.- Adicionado
twilio_machine_detectionopcional e anulável (TwilioMachineDetectionConfig). Seumodeaceitaenableoudetect_message_ende o padrão éenable. A configuração é ignorada para provedores que não são Twilio e chamadas recebidas.
- Importar número de telefone -
POST /v1/convai/phone-numbers- Adicionado
account_auth_tokenopcional e anulável (string) para importações de chaves de API da Twilio validarem assinaturas de webhooks recebidos.
- Adicionado
Alterações de esquema
ElevenAgents
WebhookEventTypeadicionaanswering_machine_detection.AgentBranchSummaryadicionadraft_created_atopcional e anulável (inteiro) edraft_is_behind_tipopcional (booleano, padrãofalse).AgentKnowledgeBaseRagChunkResponseModeladicionasource_urlobrigatório e anulável (string).AgentSummaryResponseModeleSpeechEngineSummaryResponseadicionamvoice_idobrigatório (string).AnalysisPropertyadicionanameopcional e anulável (string) eallowed_values(AllowedValues).LiteralJsonSchemaPropertytambém adicionaallowed_values. Ambos tornamallowed_values_dynamic_variableobsoleto.DataCollectionResultCommonModeladicionanameopcional e anulável (string).WorkspaceApiKeyResponseModeladicionaplatform_limitsopcional e anulável (PlatformLimits).- A ferramenta MCP
Iconadicionathemeopcional e anulável (lightoudark). SMBToolConfigadiciona as variantes de parâmetrosend_custom_email,create_service_quote_requestecreate_product_quote_request.- Os esquemas de parâmetros de consulta de webhook e a configuração de chamadas de telefonia agora usam modelos separados de entrada e saída.
- Os eventos WebSocket
agent_responseadicionamattachmentsopcional (array). Cada item exigeurlename(strings) e aceitamime_typeopcional (string).
ElevenCreative
ReferenceVideo.studio_clipagora usaStudioClipLocatorem vez deStudioClipReference. Os campos e o formato de transmissão permanecem inalterados.
ElevenAgents
- Entrada pelo teclado do telefone: A configuração de conversa do agente agora oferece suporte a
dtmf_input_settingsopcional para entrada DTMF. Configure o tempo limite dos dígitos, use#como terminador e oculte as entradas do teclado em transcrições, logs e análises. - Histórico de anexos da conversa: As entradas de transcrição de Obter conversa agora incluem
file_inputs, um array que contém o ID, o nome, o tipo MIME e a URL de cada arquivo anexado. - Filtragem por tags de agentes: Listar agentes agora aceita um parâmetro de consulta
tagsopcional. Repita o parâmetro para encontrar agentes com qualquer uma das tags fornecidas. - Contexto de campanha em lote: Obter conversa agora identifica chamadas em lote com metadados
campaignanuláveis contendo os obrigatórioscampaign_idecampaign_lead_id.
Música
- Dados visuais de forma de onda: Gerar música detalhada, Transmitir música com detalhes e Enviar música agora aceitam
with_waveform_visualopcional (booleano, padrãofalse). As respostas com essa opção ativada retornam um array de inteiroswaveform_visualde baixa resolução, com quatro amostras por segundo.
Dublagem
- Comportamento de paginação de projetos: Listar projetos de Dubbing e Listar idiomas de destino agora limitam
page_sizea 1–100. A filtragem de status do projeto incluiqueued, e ambos os endpoints documentam o uso denext_cursorpara buscar a próxima página.
Lançamentos de SDKs
SDK JavaScript
- v2.66.0 - Adicionado
fileIdsasendMultimodalMessage, permitindo que uma mensagem inclua vários anexos de arquivo.
SDK Python
- v2.66.0 - Adicionado
file_idsasend_multimodal_message, permitindo que uma mensagem inclua vários anexos de arquivo.
SDK Android
- v0.12.2 - Preservado o callback
onUnhandledClientToolCallao conectar eventos de sessão. Chamadas não tratadas de ferramentas do cliente que esperam uma resposta agora recebem a resposta automática de erro, em vez de permanecerem sem resolução.
CLI da ElevenLabs
- v1.1.0 - Regenerados os bindings de comandos da API e adicionada atribuição de solicitações por comando para workflows do ElevenAgents. Esses comandos acrescentam
cmd/<command>aoUser-Agentda CLI, permitindo distinguir solicitações de workflows comoagents pusheagents create.
Pacotes
- @elevenlabs/client@1.23.0, @elevenlabs/react@1.15.0, @elevenlabs/types@0.22.1, @elevenlabs/react-native@1.2.25, @elevenlabs/convai-widget-core@0.17.1 e @elevenlabs/convai-widget-embed@0.17.1 - Adicionado
fileIdsasendMultimodalMessage. O cliente envia os camposfileefilespara compatibilidade, e o React expõe a API de cliente atualizada.
API
Ver alterações da API
Endpoints atualizados
ElevenAgents
- Listar agentes -
GET /v1/convai/agents- Adicionado
tagsopcional e anulável (array de strings). Repita o parâmetro de consulta para encontrar qualquer tag fornecida.
- Adicionado
- Criar agente, Obter agente e Atualizar agente
- Adicionado
conversation_config.conversation.dtmf_input_settingsopcional e anulável (DTMFInputConfig). Ele oferece suporte adtmf_input_timeout(número, 0,5–10 segundos, padrão2),hash_terminator(booleano, padrãotrue) eredact_input(booleano, padrãofalse). - Adicionado
sip_refer_play_dialtoneopcional (booleano, padrãotrue) à configuração de transferência de número de telefone. Defina comofalsepara manter a etapa original da chamada silenciosa enquanto uma transferência SIP REFER é concluída. - As ferramentas de sistema de procedimento inicial e final agora aceitam um
ProcedureVersionRefou umProcedureDraftRef. Referências de rascunho exigemprocedure_id(string) e definemversion_idcomonull.
- Adicionado
- Obter conversa -
GET /v1/convai/conversations/{conversation_id}- Adicionado
file_inputs(array deConversationHistoryTranscriptFileInputResponseModel) às entradas de transcrição. Cada item exigefile_id,original_filename,mime_typeefile_url(strings). - Adicionado
campaignopcional e anulável (BatchCallingCampaignInformation) aos metadados de chamadas em lote. O objeto exigecampaign_idecampaign_lead_id(strings). - Adicionado
dtmfaChatSourceMedium.
- Adicionado
- Os tipos de problema dos tickets de triagem de conversas adicionam
incorrect_information,documentation_gap,platform_bugewrong_action.
Música
- Gerar música detalhada (
POST /v1/music/detailed) e Transmitir música com detalhes (POST /v1/music/detailed/stream)- Adicionado
with_waveform_visualopcional (booleano, padrãofalse). - As respostas detalhadas adicionam
waveform_visualanulável (array de inteiros), amostrado quatro vezes por segundo de-1000a1000.
- Adicionado
- Enviar música -
POST /v1/music/upload- Adicionados
with_waveform_visualopcional (booleano, padrãofalse) ewaveform_visualanulável (array de inteiros) na resposta.
- Adicionados
ElevenCreative
- Criar projeto no Estúdio e Criar podcast
quality_presetagora aceitanull, e o padrão do esquemastandardfoi removido.
Dublagem
- Listar projetos de Dubbing -
GET /v1/dubbing/projectpage_sizecontinua sendo um inteiro opcional com padrão20, mas os valores agora são limitados a 1–100 em vez de rejeitados.- O filtro
statusagora documentaqueued,preparing,readyefailed. - Passe o
next_cursorda resposta anterior emcursor; omita-o na primeira página.
- Listar idiomas de destino -
GET /v1/dubbing/project/{project_id}/languagepage_sizecontinua sendo um inteiro opcional com padrão20, mas os valores agora são limitados a 1–100 em vez de rejeitados.- O filtro
statusoferece suporte aqueued,processing,completed,staleefailed. - Passe o
next_cursorda resposta anterior emcursor; omita-o na primeira página.
Alterações de esquema
Espaço de trabalho
PendingSubscriptionSwitchResponseModel.next_tieradicionagrant.
CLI da ElevenLabs
A CLI da ElevenLabs v1.0.0 já está disponível. Todas as operações da API da ElevenLabs estão disponíveis como subcomandos, com saída em JSON, tabela, YAML e CSV, paginação automática e preenchimento de comandos no shell.
A CLI também oferece workflows de configuração local para o ElevenAgents. Armazene configurações de agentes, ferramentas e testes como arquivos, sincronize-as com comandos push e pull, gerencie branches, execute testes, instale componentes de interface da ElevenLabs e selecione uma região de residência de dados.
Procedimentos
Os procedimentos agora estão disponíveis de forma geral no ElevenAgents. Um procedimento contém instruções específicas para uma tarefa e um gatilho que determina quando elas se aplicam. Durante uma conversa, o agente carrega o procedimento relevante, permitindo que um agente execute tarefas distintas sem incluir todas as instruções no prompt de sistema.
Use procedimentos de formato livre quando o agente puder adaptar a redação ou a ordem das instruções. Use procedimentos estruturados quando as etapas precisarem ser executadas em uma ordem definida. Os dois tipos podem ser usados junto com workflows no mesmo agente.
ElevenAgents
- Tickets de triagem de conversas: adicionamos APIs para criar tickets sobre o desempenho de agentes, criar tickets manuais de acompanhamento, listar tickets, atribuir membros do workspace, atualizar status e responsável, além de adicionar comentários no nível do ticket ou do turno.
- Observabilidade de conversas: os clientes em tempo real podem receber um evento
context_usageapós cada turno concluído do agente. O evento informa o modelo, a contagem de tokens do prompt e o limite de contexto do modelo.
Lançamentos de SDKs
SDK JavaScript
- v2.65.0 - Adicionados clientes e tipos para tickets de triagem de conversas e resumos leves de conversas. As APIs de conversa adicionam filtros de procedimento, chamada de ferramenta inválida e ordenação; as APIs de procedimento adicionam seleção de versão do agente; as APIs de tópicos adicionam controles de detalhes de avaliação e ordenação por frustração. O lançamento também adiciona campos de frequência de atualização da base de conhecimento, ambiente de teste e integração de alertas, além de tipos de mensagens de Dubbing em tempo real.
SDK Python
- v2.65.0 - Adicionados clientes e tipos para tickets de triagem de conversas e resumos leves de conversas. As APIs de conversa adicionam filtros de procedimento, chamada de ferramenta inválida e ordenação; as APIs de procedimento adicionam seleção de versão do agente; as APIs de tópicos adicionam controles de detalhes de avaliação e ordenação por frustração. O lançamento também adiciona campos de frequência de atualização da base de conhecimento, ambiente de teste e integração de alertas, além de preservar campos multipart repetidos para
keytermsdo Speech to Text ewebhook_idsdo Dubbing.
SDK Swift
- v3.3.0 - Adicionados parsing tipado de erros do cliente, tratamento de
expects_responsee resultados de ferramentas com segurança de tipos. A inicialização do WebRTC agora fica pronta quando o agente entra, em vez de aguardar a assinatura da faixa de áudio. O lançamento também reforça o tratamento de URLs, elimina o ruído de eventos desconhecidos e remove a alocação de threads em tempo real do processamento de silenciamento por software.
Pacotes
- @elevenlabs/client@1.19.1, @elevenlabs/react@1.12.3, @elevenlabs/react-native@1.2.21, @elevenlabs/convai-widget-core@0.16.2 e @elevenlabs/convai-widget-embed@0.16.2 - A captura de saída do WebRTC agora usa caminhos AudioWorklet auto-hospedados sob políticas rígidas de segurança de conteúdo. O cache de worklets inclui a fonte solicitada, impedindo que uma URL inline anterior substitua um caminho auto-hospedado. Os erros de configuração do React Native agora apontam para
@elevenlabs/react-native. - @elevenlabs/client@1.20.0, @elevenlabs/react@1.12.4, @elevenlabs/react-native@1.2.22, @elevenlabs/convai-widget-core@0.16.3 e @elevenlabs/convai-widget-embed@0.16.3 - Adicionada a opção
webRtc.iceTransportPolicy. Defina-a comorelaypara restringir os candidatos ICE do WebRTC a retransmissores TURN em redes que bloqueiam tráfego UDP direto. - @elevenlabs/client@1.21.0, @elevenlabs/react@1.13.0, @elevenlabs/types@0.21.1, @elevenlabs/react-native@1.2.23, @elevenlabs/convai-widget-core@0.16.4 e @elevenlabs/convai-widget-embed@0.16.4 - Adicionados o callback
onContextUsagee o tipoContextUsageEvent. O React expõe o callback por meio deuseConversation. O React Native agora é resolvido pela condição de exportação do pacote, em vez da detecção de variáveis globais do navegador. - @elevenlabs/client@1.22.0, @elevenlabs/react@1.14.0, @elevenlabs/types@0.22.0, @elevenlabs/react-native@1.2.24, @elevenlabs/convai-widget-core@0.17.0 e @elevenlabs/convai-widget-embed@0.17.0 - Adicionado conteúdo avançado na primeira mensagem com respostas de botões atribuídas,
onExternalAgentDisconnectedeonMCPToolApprovalRequest. O WebRTC agora usa o dispositivo de entrada selecionado, preserva o estado de silenciamento ao trocar de microfone e falha na configuração caso os dados de inicialização não possam ser enviados. O widget adiciona o status da fila de concorrência, seleção opcional de idioma no acionador recolhido e renderização da primeira mensagem para agentes compatíveis com texto e voz.
API
Ver alterações na API
Novos endpoints
ElevenAgents
- Adicionados nove endpoints de tickets de triagem de conversas:
- Criar ticket de conversa -
POST /v1/convai/triage-tickets. A solicitação requerconversation_id(string) e aceitaqa_comment(string anulável, de 1 a 10.000 caracteres) e até 200 comentários de turno. - Listar tickets -
GET /v1/convai/agents/{agent_id}/triage-tickets, com paginação por cursor. - Criar ticket manual -
POST /v1/convai/agents/{agent_id}/triage-tickets. A solicitação requerqa_comment(string, de 1 a 10.000 caracteres). - Listar usuários atribuíveis -
GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users. A resposta lista membros do workspace que não são contas de serviço e indica se cada membro tem acesso ao agente. - Obter ticket -
GET /v1/convai/triage-tickets/{agentqa_ticket_id}. - Atualizar ticket -
PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}. A solicitação aceitastatusopcional eassignee_user_idanulável. - Excluir ticket -
DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}. - Adicionar comentário -
POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments. A solicitação requercomment(string, de 1 a 10.000 caracteres). - Adicionar comentário de turno -
POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments. A solicitação requerturn_indexcom base zero (inteiro) ecomment(string, de 1 a 10.000 caracteres).
- Criar ticket de conversa -
Endpoints atualizados
ElevenAgents
- Obter URL assinada -
GET /v1/convai/conversation/get-signed-url- Adicionado
debug_events_requestopcional (booleano, padrãofalse). Eventos de depuração exigem acesso de editor ao agente.
- Adicionado
- Obter token WebRTC -
GET /v1/convai/conversation/token- Adicionado
debug_events_requestopcional (booleano, padrãofalse). A rota legadaGET /v1/convai/conversation/get_signed_urlaceita o mesmo parâmetro.
- Adicionado
- Listar conversas -
GET /v1/convai/conversations- Adicionado
triggered_procedure_idsopcional (array de strings anulável, máximo de 50) para corresponder a conversas em que qualquer procedimento especificado foi executado. - Adicionado
include_invalid_tool_callsopcional (booleano, padrãofalse) para incluir chamadas de ferramentas que não foram executadas. - Adicionado
sort_directionopcional (ascoudesc, padrãodesc) para o horário de início da chamada.
- Adicionado
- Pesquisar mensagens de conversa por texto -
GET /v1/convai/conversations/messages/text-search- Adicionado
triggered_procedure_idsopcional (array de strings anulável, máximo de 50). - Adicionado
include_invalid_tool_callsopcional (booleano, padrãofalse).
- Adicionado
- Obter tópicos de conversa do agente -
GET /v1/convai/agents/{agent_id}/topics- Adicionado
include_evaluation_criteriaopcional (booleano, padrãotrue). - Adicionado
frustrationasort_by. - As respostas de tópicos adicionam
success_rateanulável (número), enquanto a resposta geral adicionaaggregated_run_count(inteiro, padrão0). from_unix_secsé arredondado para baixo até o início do dia UTC correspondente. Um intervalo limitado agrega execuções diárias de descoberta concluídas; omitir ambos os limites retorna a execução mais recente.
- Adicionado
- Listar procedimentos (
GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures) e Obter procedimento (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id})- Adicionado
agent_version_idopcional anulável (string) para recuperar procedimentos de uma versão específica do agente.
- Adicionado
- Criar teste e Atualizar teste
- Adicionado
environmentopcional anulável (string) aos esquemas de teste unitário de resposta, simulação e chamada de ferramenta. O valor seleciona URLs, cabeçalhos e conexões de autenticação específicos do ambiente; o padrão éproduction.
- Adicionado
- Criar documento a partir de URL, Criar tarefa de rastreamento e Criar pasta
- Adicionado
minimum_frequency_daysopcional anulável (inteiro, de 1 a 180) para sincronização automática. O padrão é7, e uma frequência mais restritiva da pasta pai tem precedência.
- Adicionado
Música
- Listar Finetunes de música -
GET /v1/music/finetunes- Aumentado o máximo de
page_sizede 100 para 150. O padrão permanece 50.
- Aumentado o máximo de
Alterações no esquema
ElevenAgents
- As solicitações de atualização de agente adicionam
proceduresopcional anulável (object<string, ProcedureVersionRef>). Cada valor requerprocedure_ideversion_id(strings). Um objeto vazio remove todos os procedimentos. - A configuração de inicialização de conversa adiciona
enable_procedure_ids_from_client(booleano, padrãofalse). Os dados de inicialização adicionamprocedure_idsopcional anulável (array de strings); um array vazio desativa todos os procedimentos para o agente inicial. ClientEventadicionacontext_usage.- As substituições de tempo limite flexível adicionam
additional_soft_timeout_messagesopcional anulável (array de strings). - Valores constantes nos modelos de análise e substituição de esquema agora aceitam
null. - Os padrões da configuração do widget para
mic_muting_enabledetranscript_enabledforam alterados defalseparatrue. Defina-os explicitamente comofalsepara preservar o comportamento anterior.
Workspace
- As respostas de Obter usuário removeram
xi_api_keydeUserResponseModel. ResourceMetadataResponseModel.role_to_group_idsagora aceita IDs de função personalizados como chaves, em vez de restringir as chaves aadmin,editor,commentereviewer.- As respostas de publicação direta adicionam
restricted_to_user_email_domainsopcional anulável (array de strings). - As respostas de alteração de assinatura pendente adicionam
goanext_tier.