> 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. ### Recursos para desenvolvedores - **Canal do YouTube ElevenLabs Devs**: Um novo [canal do YouTube](https://www.youtube.com/@elevenlabsdevs) 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](/docs/pt/api-reference/agents/create). 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](/docs/pt/api-reference/workspace/secrets/get) (`GET /v1/convai/secrets/{secret_id}`) recupera um único segredo do workspace pelo ID. O endpoint de [listar segredos](/docs/pt/api-reference/workspace/secrets/list) 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](/docs/pt/api-reference/speech-to-text/convert) 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](/docs/pt/api-reference/text-to-dialogue/convert) 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](/docs/pt/api-reference/workspace/usage/get-usage-by-product-over-time) (`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](https://github.com/elevenlabs/packages/releases/tag/@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](https://github.com/elevenlabs/packages/releases/tag/@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](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@1.1.1), [@elevenlabs/convai-widget-core@0.11.4](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.11.4), [@elevenlabs/convai-widget-embed@0.11.4](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.11.4) - Atualizados para `@elevenlabs/client@1.2.1` com correções na inicialização de conversas. ### API ## Novos endpoints - [Obter segredo](/docs/pt/api-reference/workspace/secrets/get) - `GET /v1/convai/secrets/{secret_id}` - `POST /v1/workspace/analytics/query/usage-by-product-over-time` - Obter uso de créditos do workspace por produto ao longo do tempo ## Endpoints descontinuados - `GET /v1/usage/character-stats` - Descontinuado em favor de `POST /v1/workspace/analytics/query/usage-by-product-over-time` - Todos os endpoints de edição de recursos de dublagem (`POST /v1/dubbing/resource/{dubbing_id}/language`, `POST /v1/dubbing/resource/{dubbing_id}/speaker/{speaker_id}/segment`, `PATCH /v1/dubbing/resource/{dubbing_id}/segment/{segment_id}/{language}` e outros) foram descontinuados ## Endpoints atualizados ### ElevenAgents - [Criar agente](/docs/pt/api-reference/agents/create), [Obter agente](/docs/pt/api-reference/agents/get), [Atualizar agente](/docs/pt/api-reference/agents/update) - Adicionado o campo `analysis_llm` (enumeração LLM, padrão: `gemini-2.5-flash`) a `AgentPlatformSettings` para configurar o modelo padrão de análise pós-chamada - As propriedades de coleta de dados agora usam o esquema `AnalysisProperty` com um campo de substituição `llm` opcional por item - [Simular conversa](/docs/pt/api-reference/agents/simulate-conversation) - Adicionado o campo `starting_workflow_node_id` (string, anulável) aos dados do cliente para iniciar a conversa - Adicionado o campo `enable_starting_workflow_node_id_from_client` (booleano, padrão `false`) a `ConversationInitiationClientDataConfig` - [Enviar chamadas em lote](/docs/pt/api-reference/batch-calling/create) - Adicionado o campo `external_link` (string, anulável) aos registros de chamadas em lote - [Listar segredos](/docs/pt/api-reference/workspace/secrets/list) - Adicionado o parâmetro de consulta opcional `search` (string) para filtrar segredos pelo prefixo do nome - Enumeração `LLM` - Adicionados `gpt-5.4`, `gpt-5.4-2026-03-05` - Enumeração `LLMReasoningEffort` - Adicionado `xhigh` - Expressões de workflow (`ASTNode`) - Adicionados o valor discriminador `null_literal` e o esquema `ASTNullNode` para comparações com nulo - Parâmetros de ferramenta de array (`ArrayJsonSchemaProperty`) - Adicionado o campo `dynamic_variable` (string, opcional) para preencher arrays a partir de variáveis dinâmicas em tempo de execução - Adicionado o campo `constant_value` (array, anulável) para definir valores constantes de array - O campo `items` não é mais obrigatório (tem um esquema padrão) - Substituições de configuração da ferramenta MCP - A resposta agora usa o esquema `MCPToolConfigOverride-Output` (separação entre entrada e saída) ### Speech to Text - [Converter fala em texto](/docs/pt/api-reference/speech-to-text/convert) - Adicionado o campo `detect_speaker_roles` (booleano, padrão `false`) para detecção da função de locutor de agente/cliente ### Texto para diálogo - [Converter texto em diálogo](/docs/pt/api-reference/text-to-dialogue/convert), [Transmitir texto para diálogo](/docs/pt/api-reference/text-to-dialogue/stream) - Atualizada a descrição de `inputs` com a recomendação de 2.000 caracteres por solicitação - Removido o campo `avatar_context` do corpo da solicitação ### Text to Speech - Os campos de predefinição de qualidade nos endpoints de TTS e diálogo agora fazem referência ao esquema de enumeração `QualityPresetType`. O valor `highest` foi removido das predefinições de qualidade de diálogo; use `ultra`. ### Outros - `AudioNativeResponse` - Removido o campo `transcription` da resposta - `UserResponseModel` - Atualização de esquema compatível com versões anteriores