> 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, ElevenCreative e ElevenAPI

Estamos passando da percepção de um único produto (“ElevenLabs”) para uma estrutura baseada em plataforma, com famílias de produtos claramente definidas:

- ElevenAgents (anteriormente Plataforma de agentes)
- ElevenCreative (anteriormente Plataforma criativa)
- ElevenAPI (novo, a Plataforma de desenvolvedores)

Você já verá isso refletido na documentação e nos readmes dos SDKs.

### Servidores globais fora da versão beta

O roteamento global agora é o padrão, em vez de opcional.

Anteriormente, o servidor de API padrão da ElevenLabs ficava nos Estados Unidos, com uma versão beta opcional para rotear o tráfego pelos servidores localizados nos Países Baixos ou em Singapura. Agora, o roteamento global é o padrão, o que significa que o servidor será escolhido automaticamente com base na proximidade geográfica para otimizar a latência.

A URL base opcional `api-global-preview.elevenlabs.io` foi descontinuada. Use a URL base padrão `api.elevenlabs.io`. Se você usa os SDKs, ela já é a opção padrão.

### Text to Speech

- **Normalizador de TTS v3.1**: o normalizador de texto foi atualizado para a versão 3.1, que oferece mais precisão e menor latência na conversão de texto em voz.

### Plataforma de agentes

- **Proteções personalizadas**: adicionado suporte a proteções de saída definidas pelo usuário, que permitem criar regras personalizadas de filtragem de conteúdo além da moderação padrão. Configure as proteções com um nome, uma instrução de prompt (até 10.000 caracteres) e a escolha do modelo de avaliação (`gemini-2.5-flash-lite` ou `gemini-2.0-flash`). Quando acionada, a proteção encerra a conversa. Consulte a [referência da API Criar agente](/docs/pt/api-reference/agents/create#request.body.conversation_config.safety.guardrails.custom) para ver os detalhes de configuração.
- **Mensagens proativas pelo WhatsApp**: adicionado o endpoint [Enviar mensagem proativa](/docs/pt/api-reference/whats-app/outbound-message) (`POST /v1/convai/whatsapp/outbound-message`) para iniciar conversas pelo WhatsApp usando modelos de mensagem. Os campos obrigatórios incluem `whatsapp_phone_number_id`, `whatsapp_user_id`, `template_name`, `template_language_code`, `template_params` e `agent_id`.
- **Modelo conversacional Eleven v3**: adicionado `eleven_v3_conversational` aos modelos de TTS disponíveis para agentes, oferecendo melhor qualidade de voz e expressividade nas conversas de agentes.
- **Tags de áudio sugeridas**: adicionado o campo `suggested_audio_tags` à configuração de TTS para agentes que usam modelos v3. Defina até 20 tags (por exemplo, "happy", "excited") para orientar a geração de fala expressiva, com descrições opcionais de quando cada tag deve ser usada.
- **Tratamento de erros de ferramentas**: adicionado o campo `tool_error_handling_mode` às configurações de ferramentas de webhook com as opções: `auto` (padrão, determina o tratamento com base no tipo de ferramenta), `summarized` (envia um resumo gerado por LLM), `passthrough` (envia o erro bruto) ou `hide` (não compartilha o erro com o agente).
- **Sanitização de variáveis dinâmicas**: adicionado o campo `sanitize` (booleano, padrão `false`) a `DynamicVariableAssignment`. Quando ativado, o valor da atribuição é removido das respostas de ferramentas e das transcrições, mas ainda é processado para a atribuição de variáveis.
- **Seleção de modelo de turno**: adicionado o enum `TurnModel` com as opções `turn_v2` e `turn_v3` para selecionar a versão do modelo de detecção de turno.
- **Transferências de nós de workflow**: adicionado o campo `is_workflow_node_transfer` (booleano, padrão `false`) ao esquema `AgentTransfer` para identificar transferências dentro de nós de workflow.
- **Metadados de ramificações de transferência**: adicionados os esquemas `TransferBranchInfoTrafficSplit` e `TransferBranchInfoDefaultingToMain` para monitorar informações de roteamento de ramificações em transferências de agentes.
- **Teste de transição de nós de workflow**: adicionado o tipo de asserção `workflow_node_transition` para testes unitários com o esquema `UnitTestWorkflowNodeTransitionEvaluationNodeId` para validar transições de workflow de agentes.

### ElevenCreative Studio

- **Endpoint de faixas silenciadas**: adicionado o endpoint [Obter faixas silenciadas do projeto](/docs/pt/api-reference/studio/get-muted-tracks) (`GET /v1/studio/projects/{project_id}/muted-tracks`), que retorna uma lista de IDs de capítulos com faixas silenciadas em um projeto.

### Workspaces

- **Tipo de assento de membro Lite**: adicionado `workspace_lite_member` ao enum `SeatType` para workspaces com permissões de acesso limitadas.
- **Recurso de modelos de conteúdo**: adicionado `content_templates` ao enum `WorkspaceResourceType` para compartilhar modelos de conteúdo em workspaces.

### Interface do usuário

- **Rolagem da coleção de vozes**: corrigido um problema que impedia a rolagem com a roda do mouse e por toque no seletor de ícones da coleção de vozes no macOS.

### Lançamentos de SDK

#### SDK Python

- [v2.35.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.35.0) - Adicionadas proteções personalizadas, mensagens proativas pelo WhatsApp, modo de tratamento de erros de ferramentas, sanitização de variáveis dinâmicas, seleção de modelo de turno e suporte ao modelo conversacional Eleven v3

#### SDK JavaScript

- [v2.35.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.35.0) - Adicionadas proteções personalizadas, mensagens proativas pelo WhatsApp, modo de tratamento de erros de ferramentas, sanitização de variáveis dinâmicas, seleção de modelo de turno e suporte ao modelo conversacional Eleven v3

#### SDKs React e Client

- [@elevenlabs/react-native@0.5.10](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@0.5.10) - Corrigido o estabelecimento de conversas somente de texto
- [@elevenlabs/react@0.14.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@0.14.0) - Reduzido o tamanho dos blocos de áudio de 250 ms para 100 ms para menor latência em conversas de agentes
- [@elevenlabs/client@0.14.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@0.14.0) - Reduzido o tamanho dos blocos de áudio de 250 ms para 100 ms para menor latência; normalizado o tratamento da opção `textOnly` entre o nível superior e o objeto de substituições
- [@elevenlabs/types@0.5.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/types@0.5.0) - Adicionados tipos para suporte a dados de alinhamento de áudio

### API

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

## Novos endpoints

- [Enviar mensagem proativa pelo WhatsApp](/docs/pt/api-reference/whats-app/outbound-message) - `POST /v1/convai/whatsapp/outbound-message` - Envie uma mensagem proativa pelo WhatsApp usando modelos de mensagem
- [Obter faixas silenciadas do projeto](/docs/pt/api-reference/studio/get-muted-tracks) - `GET /v1/studio/projects/{project_id}/muted-tracks` - Retorna IDs de capítulos com faixas silenciadas

## Endpoints atualizados

### Plataforma de agentes

- [Criar agente](/docs/pt/api-reference/agents/create), [Atualizar agente](/docs/pt/api-reference/agents/update), [Obter agente](/docs/pt/api-reference/agents/get)
  - Adicionado o campo `custom` ao esquema `GuardrailsV1` para configuração de proteções personalizadas
  - Adicionado o campo `alignment` ao esquema `GuardrailsV1` para proteções de alinhamento
  - Adicionado o campo `suggested_audio_tags` à configuração conversacional de TTS (array de `SuggestedAudioTag`, máx. 20 itens)
  - Adicionado `eleven_v3_conversational` ao enum `TTSConversationalModel`
- [Criar ferramenta](/docs/pt/api-reference/tools/create), [Atualizar ferramenta](/docs/pt/api-reference/tools/update)
  - Adicionado o campo `tool_error_handling_mode` a `ApiIntegrationWebhookToolConfig` (enum: `auto`, `summarized`, `passthrough`, `hide`, padrão `auto`)
  - Adicionado o campo `sanitize` a `DynamicVariableAssignment` (booleano, padrão `false`)

### Workspaces

- [Obter recurso](/docs/pt/api-reference/workspace/resources/get)
  - Adicionado `content_templates` ao enum `WorkspaceResourceType`
- [Adicionar convite ao workspace](/docs/pt/api-reference/workspace/invites/create), [Adicionar membro ao workspace](/docs/pt/api-reference/workspace/invites/create)
  - Adicionado `workspace_lite_member` ao enum `SeatType`

## Alterações nos esquemas

### Novos esquemas

- `CustomGuardrail-Input`, `CustomGuardrail-Output` - Contêiner para configuração de proteções personalizadas
- `CustomGuardrailsConfig` - Contêiner de configuração para a lista de proteções personalizadas
- `CustomGuardrailConfig` - Proteção personalizada individual com `name` (string, obrigatório), `prompt` (string, obrigatório, máx. 10.000 caracteres), `model` (enum: `gemini-2.5-flash-lite`, `gemini-2.0-flash`, obrigatório) e `is_enabled` (booleano, padrão `false`)
- `ToolErrorHandlingMode` - Enum para tratamento de erros de ferramentas: `auto`, `summarized`, `passthrough`, `hide`
- `TurnModel` - Enum para versão do modelo de detecção de turno: `turn_v2`, `turn_v3`
- `SuggestedAudioTag` - Configuração de tag de áudio com `tag` (string, obrigatório, máx. 30 caracteres) e `description` (string, opcional, máx. 200 caracteres)
- `TransferBranchInfoTrafficSplit` - Informações de ramificação para transferências com divisão de tráfego, com `branch_id` e `traffic_percentage`
- `TransferBranchInfoDefaultingToMain` - Informações de ramificação para transferências com padrão para a principal, com `branch_id`
- `UnitTestWorkflowNodeTransitionEvaluationNodeId` - Configuração de teste de transição de nó de workflow com `agent_id` e `target_node_id`
- `ProjectMutedTracksResponseModel` - Modelo de resposta com array `chapter_ids`
- `WhatsAppOutboundMessageResponse` - Resposta para o endpoint de mensagens proativas do WhatsApp
- `WhatsAppTemplateHeaderComponentParams`, `WhatsAppTemplateBodyComponentParams`, `WhatsAppTemplateButtonComponentParams` - Esquemas de parâmetros de modelo para mensagens do WhatsApp
- `ConversationHistoryTranscriptSystemToolResultCommonModel-Input`, `ConversationHistoryTranscriptSystemToolResultCommonModel-Output` - Modelos de resultados de ferramentas de sistema separados para variantes de entrada/saída

### Esquemas modificados

- `GuardrailsV1-Input`, `GuardrailsV1-Output` - Adicionados os campos `custom` (CustomGuardrail) e `alignment` (AlignmentGuardrail)
- `TTSConversationalConfig-Input`, `TTSConversationalConfig-Output` - Adicionado o campo `suggested_audio_tags`
- `TTSConversationalModel` - Adicionado o valor de enum `eleven_v3_conversational`
- `ApiIntegrationWebhookToolConfig-Input`, `ApiIntegrationWebhookToolConfig-Output` - Adicionado o campo `tool_error_handling_mode` (obrigatório)
- `DynamicVariableAssignment` - Adicionado o campo `sanitize` (booleano, padrão `false`)
- `AgentTransfer` - Adicionado o campo `is_workflow_node_transfer` (booleano, padrão `false`)
- `SeatType` - Adicionado o valor de enum `workspace_lite_member`
- `WorkspaceResourceType` - Adicionado o valor de enum `content_templates`

### Esquemas removidos

- `AgentBan` - Esquema não utilizado removido
- `BanReasonType` - Enum não utilizado removido
- `DubbingReleaseChannel` - Enum não utilizado removido

</Accordion>