> 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.

### Text to Speech

- **Remoção dos modelos v1**: Os modelos `eleven_monolingual_v1` e `eleven_multilingual_v1` estão obsoletos e serão removidos em 9 de julho de 2026. Migre para `eleven_multilingual_v2` ou outro modelo atual antes da remoção. Veja [modelos obsoletos](/docs/pt/overview/models#deprecated-models) para sugestões de substituição.

### Speech to Text

- **Remoção do Scribe v1**: O modelo `scribe_v1` está obsoleto e será removido em 9 de julho de 2026. Migre para `scribe_v2` ou `scribe_v2_realtime` antes da remoção. Veja [modelos obsoletos](/docs/pt/overview/models#deprecated-models) para sugestões de substituição.

### ElevenAgents

- **Configuração do modelo de turno**: `TurnConfig` e `TurnConfigWorkflowOverride` adicionam o `turn_model` opcional (`turn_v2` ou `turn_v3`, padrão `turn_v3`) para selecionar a versão do modelo de detecção de turno por agente ou nó do workflow.
- **Mensagens de preenchimento para timeout suave**: `SoftTimeoutConfig` e `SoftTimeoutConfigWorkflowOverride` adicionam `additional_soft_timeout_messages` opcional (array de strings, até 7) e `max_soft_timeouts_per_generation` opcional (inteiro, 1–8, padrão `1`). A `message` principal se aplica ao primeiro timeout; os timeouts seguintes usam as mensagens adicionais ou um preenchimento integrado.
- **Padrão do provedor ASR**: O valor padrão de `ASRConversationalConfig.provider` muda de `elevenlabs` para `scribe_realtime`. O valor `elevenlabs` permanece no enum, mas está obsoleto.
- **Campo de produto da conversa**: A resposta de [Obter detalhes da conversa](/docs/pt/api-reference/conversations/get) adiciona `conversation_product` opcional (string, padrão `agent`) para identificar o produto que conduziu a conversa.
- **Sincronização externa da base de conhecimento**: Os modelos de resposta de arquivos e pastas da base de conhecimento adicionam `external_sync_info` opcional (metadados de sincronização do Google Drive via `ExternalFileSyncInfo` / `ExternalFolderSyncInfo`) e `is_frozen` opcional (booleano) para indicar se o conteúdo sincronizado pode ser editado.
- **Substituições de omissão no esquema de ferramentas**: As propriedades do esquema JSON de ferramentas do ConvAI adicionam `is_omitted` opcional (booleano) e `OmitSchemaOverride` com `source: omit`, permitindo omitir explicitamente campos das cargas úteis de ferramentas.
- **Guardrails de procedimentos**: Os esquemas de versão de procedimento adicionam `guardrails` opcional.

### Workspaces

- **Conexões de autenticação com segredo de URL**: As uniões de criação, listagem e resposta de conexões de autenticação do workspace adicionam `url_secret` (`UrlSecretAuthResponse`) como tipo de conexão de autenticação compatível para ferramentas que buscam segredos em uma URL.
- **Webhooks de Avaliações de QA de Agentes**: `WebhookUsageType` adiciona `Agent QA Evaluations` como categoria de uso de webhook para entrega de eventos de garantia de qualidade de agentes.

### Text to Dialogue

- **Modo de retenção zero**: [Converter texto em diálogo](/docs/pt/api-reference/text-to-dialogue/convert), [Transmitir texto em diálogo](/docs/pt/api-reference/text-to-dialogue/stream), [Converter texto em diálogo com timestamps](/docs/pt/api-reference/text-to-dialogue/convert-with-timestamps) e [Transmitir texto em diálogo com timestamps](/docs/pt/api-reference/text-to-dialogue/stream-with-timestamps) adicionam o parâmetro de consulta `enable_logging` opcional (booleano, padrão `true`). Defina `enable_logging=false` para usar o modo de retenção zero, sem histórico ou vinculação de solicitações. O modo de retenção zero está disponível apenas para clientes enterprise.

### ElevenCreative Studio

- **Metadados adultos do Safesearch**: As respostas `publishing_read` de [Obter projeto](/docs/pt/api-reference/studio/get-project) adicionam `safesearch_adult` opcional (booleano que aceita nulo) em `DirectPublishingReadResponseModel` para classificação de conteúdo de publicação direta.

### Lançamentos de SDKs

#### SDK JavaScript

- [v2.52.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.52.0) - Regenerado a partir do schema OpenAPI mais recente, com campos de `turn_model` e preenchimento de timeout suave nas configurações de turno, tipos de sincronização externa da base de conhecimento, `OmitSchemaOverride` para esquemas de ferramentas, `UrlSecretAuthResponse`, `conversation_product` nas respostas de conversa, suporte a `enable_logging` para texto em diálogo e padrões atualizados de `AsrProvider`.
- [v2.51.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.51.0) - Adicionado cliente para revogar chave de API do workspace, tipos `ConversationSentimentAnalysis` e `SystemEvaluationCriteria`, `CustomLlmAuthConnection` para autenticação de ferramentas HTTP, tipos de configuração de ferramentas de procedimento, `ResourceAccessInfoAccessSource` e filtros de listagem/pesquisa de conversas para `workflow_node_entered_id` e `topic_ids`.

#### SDK Python

- [v2.52.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.52.0) - Regenerado a partir do schema OpenAPI mais recente, com atualizações de configuração do modelo de turno e timeout suave, modelos de sincronização externa da base de conhecimento, substituições de omissão no esquema de ferramentas, conexões de autenticação com segredo de URL, `conversation_product` de conversa, suporte a `enable_logging` para texto em diálogo e padrões atualizados do provedor ASR.
- [v2.51.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.51.0) - Regenerado a partir do schema OpenAPI mais recente, com revogação de chave de API do workspace, tipos de sentimento de conversa e avaliação do sistema, modelos de configuração de ferramentas de procedimento e parâmetros atualizados de filtragem de conversas.

#### Pacotes

- [@elevenlabs/convai-widget-core@0.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.13.0) e [@elevenlabs/convai-widget-embed@0.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.13.0) - Adicionados pontos de entrada de chamada e mensagem ao iniciador do widget. Agentes multimodais mostram ambos; agentes somente de voz mostram chamada; agentes somente de texto mostram mensagem.
- [@elevenlabs/convai-widget-core@0.13.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.13.1) e [@elevenlabs/convai-widget-embed@0.13.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.13.1) - Corrigido o alinhamento dos controles de acionamento compacto e completo.

### API

<Accordion title="Ver alterações da API">

## Endpoints atualizados

### ElevenAgents

- [Obter detalhes da conversa](/docs/pt/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}`
  - A resposta adiciona `conversation_product` opcional (string, padrão `agent`)
- [Obter documento da base de conhecimento](/docs/pt/api-reference/knowledge-base/get-document) - `GET /v1/convai/knowledge-base/{documentation_id}`
  - A resposta adiciona `external_sync_info` e `is_frozen` opcionais nos modelos de arquivo

### Text to Dialogue

- [Converter texto em diálogo](/docs/pt/api-reference/text-to-dialogue/convert) - `POST /v1/text-to-dialogue`
  - Adicionado o parâmetro de consulta `enable_logging` opcional (booleano, padrão `true`)
- [Transmitir texto em diálogo](/docs/pt/api-reference/text-to-dialogue/stream) - `POST /v1/text-to-dialogue/stream`
  - Adicionado o parâmetro de consulta `enable_logging` opcional (booleano, padrão `true`)
- [Converter texto em diálogo com timestamps](/docs/pt/api-reference/text-to-dialogue/convert-with-timestamps) - `POST /v1/text-to-dialogue/with-timestamps`
  - Adicionado o parâmetro de consulta `enable_logging` opcional (booleano, padrão `true`)
- [Transmitir texto em diálogo com timestamps](/docs/pt/api-reference/text-to-dialogue/stream-with-timestamps) - `POST /v1/text-to-dialogue/stream/with-timestamps`
  - Adicionado o parâmetro de consulta `enable_logging` opcional (booleano, padrão `true`)

## Alterações no schema

### ElevenAgents

- `TurnConfig` e `TurnConfigWorkflowOverride`
  - Adicionado enum `turn_model` opcional (`turn_v2`, `turn_v3`, padrão `turn_v3`)
- `SoftTimeoutConfig` e `SoftTimeoutConfigWorkflowOverride`
  - Adicionado `additional_soft_timeout_messages` opcional (array de strings, máx. 7)
  - Adicionado `max_soft_timeouts_per_generation` opcional (inteiro, 1–8, padrão `1`)
- `ASRConversationalConfig`
  - O `provider` padrão mudou de `elevenlabs` para `scribe_realtime`
  - Valor do provedor `elevenlabs` obsoleto
- Esquemas de versão de procedimento
  - Adicionado `guardrails` opcional
- Modelos de resposta de arquivos e pastas da base de conhecimento
  - Adicionados `external_sync_info` e `is_frozen` opcionais
- Propriedades do esquema JSON de ferramentas
  - Adicionados `is_omitted` e `OmitSchemaOverride` opcionais (`source: omit`)

### Workspaces

- Uniões de conexão de autenticação
  - Adicionado `url_secret` (`UrlSecretAuthResponse`)
- Enum `WebhookUsageType`
  - Adicionado `Agent QA Evaluations`

### ElevenCreative Studio

- `DirectPublishingReadResponseModel`
  - Adicionado `safesearch_adult` opcional (booleano que aceita nulo)

</Accordion>