Changelog

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 para ver os detalhes de configuração.
• Mensagens proativas pelo WhatsApp: adicionado o endpoint Enviar mensagem proativa (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 (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 - 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 - 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 - Corrigido o estabelecimento de conversas somente de texto
• @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 - 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 - Adicionados tipos para suporte a dados de alinhamento de áudio

API