Changelog

Recursos para desenvolvedores

• Canal do YouTube ElevenLabs Devs: Um novo canal do YouTube voltado para desenvolvedores já está disponível, com tutoriais, guias da API e análises técnicas aprofundadas para ajudar você a aproveitar ao máximo a plataforma ElevenLabs.

ElevenAgents

• Substituição do nó inicial do workflow: Agora, as conversas podem ser iniciadas em um nó específico do workflow ao passar starting_workflow_node_id nos dados do cliente para iniciar a conversa. Esse recurso é controlado por um campo opcional enable_starting_workflow_node_id_from_client nas configurações de substituição da plataforma do agente. Quando ativado, os clientes podem especificar em qual nó iniciar uma conversa, o que é útil para memória do agente e casos de uso de WebSocket de longo prazo. Se o nó especificado não existir, a conversa volta para o ponto de entrada padrão.

• Configuração de LLM para análise pós-chamada: As configurações da plataforma do agente agora incluem um campo analysis_llm (padrão: gemini-2.5-flash) que define o LLM padrão para análise pós-chamada, incluindo critérios de avaliação e coleta de dados. Propriedades individuais de coleta de dados podem substituir esse padrão com um campo llm por item por meio do novo esquema AnalysisProperty, oferecendo controle detalhado sobre qual modelo processa cada item de análise.

• Novas opções de LLM: Adicionado gpt-5.4 à lista de provedores de LLM disponíveis para configuração de agentes. Adicionado xhigh à enumeração LLMReasoningEffort para raciocínio estendido em modelos compatíveis.

• Literal nulo em expressões de workflow: As expressões condicionais de workflow agora aceitam comparações com nulo por meio do novo tipo ASTNullNode, permitindo ramificações como “se a variável for nula” na lógica do workflow.

• Obter segredo por ID: Um novo endpoint de obter segredo (GET /v1/convai/secrets/{secret_id}) recupera um único segredo do workspace pelo ID. O endpoint de listar segredos também agora aceita um parâmetro de consulta search para filtrar segredos pelo prefixo do nome.

• Números de telefone pesquisáveis em chamadas em lote: O formulário de chamadas em lote no painel agora inclui um seletor de números de telefone pesquisável, facilitando encontrar o número de saída correto ao configurar chamadas em lote.

Speech to Text

• Detecção de função do locutor: O endpoint de converter fala em texto agora aceita um parâmetro detect_speaker_roles (booleano, padrão false). Quando ativado junto com diarize=true, os rótulos dos locutores são retornados como agent e customer, em vez de speaker_0, speaker_1. Isso não pode ser usado com use_multi_channel=true. O uso gera uma cobrança adicional de 10% sobre o custo base da transcrição.

Texto para diálogo

• Orientação sobre limite de caracteres de entrada: Os endpoints de texto para diálogo agora documentam um limite recomendado de 2.000 caracteres em todos os valores inputs[].text por solicitação. Solicitações maiores podem ser encerradas antecipadamente nas respostas de streaming ou retornar um erro de validação.

Workspaces

• Endpoint de análise de uso: Um novo endpoint de uso por produto ao longo do tempo (POST /v1/workspace/analytics/query/usage-by-product-over-time) retorna o uso de créditos detalhado por tipo de produto ao longo do tempo. Os resultados são retornados em uma estrutura tabular com interval_seconds, dimensões group_by e filters configuráveis. O endpoint anterior GET /v1/usage/character-stats foi descontinuado em favor deste novo endpoint.

Lançamentos de SDK

Pacotes

• @elevenlabs/client@1.2.1 - Corrigida a prontidão na inicialização da conversa para que onConnect seja executado depois que a sessão for marcada como conectada e o React tiver sincronizado conversationRef. Também foram expostos e encaminhados onConversationCreated para consumidores que precisam da instância Conversation criada antes de onConnect.

• @elevenlabs/react@1.1.1 - Corrigida a prontidão na inicialização da conversa e exposto o callback onConversationCreated, em linha com as alterações de @elevenlabs/client@1.2.1.

• @elevenlabs/react-native@1.1.1, @elevenlabs/convai-widget-core@0.11.4, @elevenlabs/convai-widget-embed@0.11.4 - Atualizados para @elevenlabs/client@1.2.1 com correções na inicialização de conversas.

API