> 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 - **Logs SIP**: Os logs de sinalização SIP agora estão disponíveis para chamadas de tronco SIP no histórico de conversas e nas configurações de números de telefone. Os logs incluem o ID da chamada SIP, números de telefone, endereços, transporte, direção da mensagem, mensagens brutas e erros para ajudar a depurar problemas de configuração e roteamento de chamadas. - **Atualizações de documentos da base de conhecimento**: Nova API para listar chunks indexados (RAG) de um documento. Os documentos também podem ser editados diretamente: renomeie o item e, para documentos baseados em texto, atualize o conteúdo sem reenviar o arquivo. (Os documentos baseados em arquivo continuam usando o fluxo existente de substituição de arquivo, quando aplicável.) - **Metadados de conversas por SMS**: Adicionado suporte a SMS aos metadados de conversas com `SMSConversationInfo`, `sms` como método de autorização e `twilio_sms` como origem de início da conversa. - **Atualizações na configuração de agentes**: Adicionados esquemas de configuração de música de fundo, configuração de monitoramento de alertas, campos de layout 2D, configuração de envio de arquivos pelo widget e novas opções de LLM `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.4-mini-2026-03-17` e `gpt-5.4-nano-2026-03-17`. ### Espaços de trabalho - **Análises de solicitações da API**: Adicionado um endpoint de análises do espaço de trabalho para consultar solicitações da API com controles de intervalo de tempo, filtragem, pesquisa, ordenação e limite. - **Lista de permissões de IP para chaves de API**: Adicionado `allowed_ips` aos esquemas de criação, edição e resposta de chaves de API de contas de serviço. As solicitações de criação aceitam uma matriz de endereços IP ou intervalos CIDR, ou `null` para permitir todos os IPs. As solicitações de edição também aceitam `clear` e `no_update`. - **Permissões do espaço de trabalho**: Adicionados `conversational_ai_read` e `voice_design` às permissões de grupos do espaço de trabalho. ### Design de voz - **Migração das prévias de voz**: `POST /v1/text-to-voice/create-previews` foi descontinuado. Use [Design a voice](/docs/pt/api-reference/text-to-voice/design) para criar prévias e, em seguida, use o `generated_voice_id` retornado ao criar uma voz. ### Modificador de Voz IA - **Formatos de saída WAV**: Adicionados `wav_8000`, `wav_16000`, `wav_22050`, `wav_24000`, `wav_32000`, `wav_44100` e `wav_48000` ao parâmetro de consulta `output_format` na conversão de fala para fala. ### Lançamentos de SDKs #### SDK Python - [v2.47.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.47.0) - SDK regenerado para o esquema da API de 12 de maio de 2026. A versão adiciona suporte tipado para listagem de chunks RAG, atualizações de documentos de arquivo, análises de solicitações da API do espaço de trabalho, lista de permissões de IP para chaves de API de contas de serviço, campos de configuração de agentes de números de telefone, cabeçalhos de solicitações de webhook, moderação de metadados de voz, novas opções de LLM e formatos atualizados de saída de fala para fala. #### SDK JavaScript - [v2.47.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.47.0) - SDK regenerado para o esquema da API de 12 de maio de 2026. A versão adiciona suporte tipado para listagem de chunks RAG, atualizações de documentos de arquivo, análises de solicitações da API do espaço de trabalho, lista de permissões de IP para chaves de API de contas de serviço, campos de configuração de agentes de números de telefone, cabeçalhos de solicitações de webhook, moderação de metadados de voz, novas opções de LLM e formatos atualizados de saída de fala para fala. #### Pacotes - [@elevenlabs/client@1.7.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.7.0), [@elevenlabs/react@1.6.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.6.0), [@elevenlabs/react-native@1.2.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.0) e [@elevenlabs/types@0.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.13.0) - Adicionado suporte completo à carga de resultados de ferramentas em `onAgentToolResponse`. O callback agora recebe eventos `agent_tool_response_full_payload` com a string bruta `full_tool_result`, limitada a 64 KB, quando ativada na configuração do agente. - [@elevenlabs/client@1.6.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.6.0), [@elevenlabs/react@1.5.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.5.0), [@elevenlabs/react-native@1.1.6](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.1.6) e [@elevenlabs/types@0.12.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.12.0) - Adicionado suporte nativo para silenciar e reativar o áudio ao STT em tempo real do Scribe. `RealtimeConnection` agora expõe `mute()`, `unmute()` e `isMuted`, e `useScribe` expõe o estado e os callbacks correspondentes. As versões também adicionam `onAgentResponseCorrection` para eventos de correção de respostas do agente. - [@elevenlabs/client@1.5.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.5.0), [@elevenlabs/react@1.4.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.4.0), [@elevenlabs/react-native@1.1.5](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.1.5) e [@elevenlabs/types@0.11.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.11.0) - Adicionado `contextId` opcional a `sendContextualUpdate` para eliminar duplicações em atualizações contextuais e adicionado `llm` à substituição tipada de prompt do agente para sessões de conversa. O pacote React também permite que o `deviceId` do microfone em `useScribe` use restrições completas de `ConstrainDOMString`. - [@elevenlabs/convai-widget-core@0.12.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.12.0) e [@elevenlabs/convai-widget-embed@0.12.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.12.0) - Adicionado suporte ao envio de arquivos no widget incorporado do ElevenAgents. - [@elevenlabs/convai-widget-core@0.12.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.12.1) e [@elevenlabs/convai-widget-embed@0.12.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.12.1) - Corrigido o envio de entrada de texto para usuários de IME ao ignorar pressionamentos da tecla Enter enquanto a composição estiver ativa. - [@elevenlabs/convai-widget-core@0.12.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.12.2) e [@elevenlabs/convai-widget-embed@0.12.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.12.2) - Pacotes de widget atualizados para `@elevenlabs/client@1.7.0`, incluindo suporte completo à carga de resultados de ferramentas. - [@elevenlabs/convai-widget-core@0.12.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.12.3) e [@elevenlabs/convai-widget-embed@0.12.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.12.3) - Corrigida a ordenação da transcrição quando mensagens do usuário e do agente compartilham o mesmo `event_id`, para que os turnos de voz e DTMF exibam a transcrição do usuário antes da mensagem do agente. - [@elevenlabs/convai-widget-core@0.12.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.12.4) e [@elevenlabs/convai-widget-embed@0.12.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.12.4) - Corrigidas as transcrições do widget de voz para que partes transmitidas da resposta do agente sejam ignoradas em sessões de voz e transcrições tardias do usuário sejam inseridas antes da resposta correspondente do agente. ### API ## Novos endpoints ### ElevenAgents - [Obter mensagens SIP de uma conversa](/docs/pt/api-reference/conversations/get-sip-messages) - `GET /v1/convai/conversations/{conversation_id}/sip-messages` - Adicionado o parâmetro de caminho obrigatório `conversation_id` (string) - Adicionados os parâmetros de consulta opcionais `page_size` (inteiro, padrão `20`) e `cursor` - Retorna `GetSIPLogMessagesResponse` com `sip_messages`, `next_cursor` anulável e `has_more` - [Obter mensagens SIP de um número de telefone](/docs/pt/api-reference/phone-numbers/get-sip-messages) - `GET /v1/convai/phone-numbers/{phone_number_id}/sip-messages` - Adicionado o parâmetro de caminho obrigatório `phone_number_id` (string) - Adicionados os parâmetros de consulta opcionais `page_size` (inteiro, padrão `20`) e `cursor` - Retorna `GetSIPLogMessagesResponse` - [Obter chunks RAG de um documento](/docs/pt/api-reference/knowledge-base/get-chunks) - `GET /v1/convai/knowledge-base/{documentation_id}/chunks` - Adicionado o parâmetro de caminho obrigatório `documentation_id` (string) - Adicionado o parâmetro de consulta obrigatório `embedding_model` - Adicionados os parâmetros de consulta opcionais `page_size` (inteiro, padrão `30`) e `cursor` - Retorna `KnowledgeBaseDocumentChunksResponseModel` com `chunks` e `next_cursor` anulável - [Atualizar arquivo de documento](/docs/pt/api-reference/knowledge-base/update-file) - `PATCH /v1/convai/knowledge-base/{documentation_id}/update-file` - Adicionado o parâmetro de caminho obrigatório `documentation_id` (string) - Adicionado corpo de formulário multipart com `file` obrigatório (string, binário) - Retorna o modelo de documento da base de conhecimento atualizado ### Espaços de trabalho - `POST /v1/workspace/analytics/requests` - Adicionado corpo da solicitação com `start_time`, `end_time`, `limit` (inteiro, padrão `100`, máximo `1000`), `sort`, `filters` e `search` opcionais - Retorna `WorkspaceAnalyticsQueryResponseModel` com `columns`, `column_types`, `rows` e `column_units` ## Endpoints e esquemas atualizados ### ElevenAgents - [Atualizar documento da base de conhecimento](/docs/pt/api-reference/knowledge-base/update) - `PATCH /v1/convai/knowledge-base/{documentation_id}` - Adicionados os campos de corpo da solicitação JSON `name` (string anulável opcional) e `content` (string anulável opcional) - [Criar agente](/docs/pt/api-reference/agents/create) - `POST /v1/convai/agents/create` - O padrão de `enable_versioning` mudou de `false` para `true` - [Atualizar agente](/docs/pt/api-reference/agents/update) - `PATCH /v1/convai/agents/{agent_id}` - O padrão de `enable_versioning_if_not_enabled` mudou de `false` para `true` - [Atualizar número de telefone](/docs/pt/api-reference/phone-numbers/update) - `PATCH /v1/convai/phone-numbers/{phone_number_id}` - Adicionados `environment` e `branch_id` à configuração de agente do número de telefone - `store_sip_messages` agora tem `true` como padrão - [Obter widget](/docs/pt/api-reference/widget/get) - `GET /v1/convai/agents/{agent_id}/widget` - Adicionado `file_input_config` para envio de arquivos pelo widget - Enum `LLM` - Adicionados `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.4-mini-2026-03-17` e `gpt-5.4-nano-2026-03-17` - Enum `AuthorizationMethod` - Adicionado `sms` - Enum `ConversationInitiationSource` - Adicionado `twilio_sms` - `AgentTopicResponseModel` - Adicionados `parent_topic_id`, `x_2d` e `y_2d` opcionais e anuláveis - `BackgroundMusicConfig` e `BackgroundMusicConfigWorkflowOverride` - Adicionados `source_type`, `source_id`, `volume` e `crossfade_loop` - Adicionados os valores do enum `BackgroundMusicPresetId`: `city`, `elevator1`, `elevator2`, `elevator3`, `elevator4`, `office1`, `office2`, `restaurant` e `typing` - `AgentPlatformSettingsResponseModel` - Adicionado `alerting` com os valores do enum `Monitor` `elevated_conversation_failure_rate` e `elevated_tool_failure_rate` - Enum `ProcedureCompilerMode` - Removido `deterministic` ### Espaços de trabalho - Esquemas de criação e edição de chaves de API de contas de serviço - Adicionado `allowed_ips` como uma matriz opcional de endereços IP ou intervalos CIDR, com 1 a 100 entradas - Solicitações de criação podem transmitir `null` para permitir todos os IPs - Solicitações de edição podem transmitir `clear` ou `no_update`; o padrão é `no_update` - `WorkspaceApiKeyResponseModel` - Adicionado `allowed_ips` anulável - Enum `WorkspaceGroupPermission` - Adicionados `conversational_ai_read` e `voice_design` - Esquemas de conexão de autenticação - Adicionado `ApiIntegrationOAuth2CustomAppResponse` para conexões de apps personalizados OAuth2 pertencentes ao usuário ### Design de voz - [Criar prévias de voz](/docs/pt/api-reference/legacy/voices/create-previews) - `POST /v1/text-to-voice/create-previews` - Marcado como descontinuado - Descrição atualizada para direcionar desenvolvedores a [Design a voice](/docs/pt/api-reference/text-to-voice/design) ### Modificador de Voz IA - [Converter fala em fala](/docs/pt/api-reference/speech-to-speech/convert) - `POST /v1/speech-to-speech/{voice_id}` - Adicionados `wav_8000`, `wav_16000`, `wav_22050`, `wav_24000`, `wav_32000`, `wav_44100` e `wav_48000` ao enum `output_format` - Descrição atualizada para informar que os formatos PCM e WAV de 44,1 kHz exigem o plano Pro ou superior