For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
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_status até 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-flash e music_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-flash e music_v2_5. O wrapper compose_detailed agora 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_id em vez de event_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 --intent aos comandos de API gerados. Adicionado elevenlabs feedback missing-capability para 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_activity a uma vez por segundo e remove o limite quando uma sessão termina.
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) e hold_audio (AgentHoldAudioConfig) obrigatórios. O objeto de áudio de espera exige audio_path, audio_url, original_filename (strings), duration_secs (número) e size_bytes (inteiro).
Adicionado platform_settings.queueing_config (AgentQueueingConfig) opcional com enabled (booleano, padrão false) e wait_timeout_seconds (inteiro, 1–1.800, padrão 180).
As respostas de configuração de fila incluem hold_audio (AgentHoldAudioConfig) anulável e somente leitura. As respostas do agente também incluem default_hold_audio_url (string) opcional.
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 em call_duration_secs nem no tempo cobrado.
Adicionado include_draft (booleano, padrão false) opcional. Quando true, uma ramificação criada a partir da ponta da ramificação inclui o conjunto de procedimentos em rascunho de quem fez a chamada.
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_ids e referenced_dynamic_variables (arrays de strings) opcionais.
As respostas do agente e da prévia de mesclagem adicionam procedures opcional, um mapa indexado por ID de procedimento.
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 de ran_against_draft (booleano, padrão false) opcional.
Os resumos de invocação também adicionam runs_diverged_from_version (booleano, padrão false) opcional.
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) e max_retrieved_rag_chunks_count (inteiro, 1–20), opcionais e anuláveis.
MusicModelID adiciona music_v2_5 para POST /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/upload e POST /v1/music/finetunes.
GenerationChunk.text aumenta maxLength de 6.000 para 6.132 caracteres para POST /v1/music/plan, POST /v1/music, POST /v1/music/detailed, POST /v1/music/detailed/stream, POST /v1/music/stream e POST /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. O queue_status_event.status obrigatório aceita waiting, admitted ou timed_out; timed_out precede o código de encerramento WebSocket 4300. O áudio de espera continua chegando como eventos regulares de audio.
A enumeração LLM adiciona gemini-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_success e end_procedure_error.
FeaturesUsageCommonModel adiciona status de recurso opcionais freeform_procedure e structured_procedure.