> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. ### ElevenAgents - **Fila de chamadas e áudio de espera**: Adicionamos [fila de chamadas](/docs/pt/eleven-agents/guides/call-queueing) 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](https://github.com/elevenlabs/elevenlabs-js/releases/tag/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](https://github.com/elevenlabs/elevenlabs-python/releases/tag/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](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/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](https://github.com/elevenlabs/cli/releases/tag/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](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.2) e [@elevenlabs/convai-widget-embed@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.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. ### API ## Novos endpoints ### ElevenAgents - [Enviar áudio de espera do agente](/docs/pt/api-reference/agents/hold-audio/create) - `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) 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). - [Excluir áudio de espera do agente](/docs/pt/api-reference/agents/hold-audio/delete) - `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](/docs/pt/api-reference/agents/create), [Obter agente](/docs/pt/api-reference/agents/get) e [Atualizar agente](/docs/pt/api-reference/agents/update) - 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](/docs/pt/api-reference/conversations/get) - `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. - [Criar ramificação do agente](/docs/pt/api-reference/agents/branches/create) - `POST /v1/convai/agents/{agent_id}/branches` - 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](/docs/pt/api-reference/agents/procedures/list) 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. - [Listar invocações de teste](/docs/pt/api-reference/tests/test-invocations/list) - `GET /v1/convai/test-invocations` - Adicionado `search` (string) anulável e opcional para filtrar testes e pastas por nome. - [Executar testes no agente](/docs/pt/api-reference/tests/run-tests) e [Obter invocação de teste](/docs/pt/api-reference/tests/test-invocations/get) - 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. - [Obter conta do WhatsApp](/docs/pt/api-reference/whats-app/accounts/get) - `GET /v1/convai/whatsapp-accounts/{phone_number_id}` - Adicionado `account_type` (`WhatsAppAccountType`, padrão `cloud_api`) opcional. Os valores são `cloud_api` e `coexistence`. - [Calcular uso esperado de LLM](/docs/pt/api-reference/agents/calculate) - `POST /v1/convai/agent/{agent_id}/llm-usage/calculate` - `LLMUsageCalculatorLLMResponseModel` adiciona `price_per_message` (número) obrigatório. ### Música - `MusicModelID` adiciona `music_v2_5` para `POST /v1/music/video-to-music`, `POST /v1/music/plan`, [Compor música](/docs/pt/api-reference/music/compose), `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`.