> 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. ### Interface - **Notificações aprimoradas**: Atualizamos o sistema de notificações para exibir notificações relevantes para a plataforma ativa que você está visualizando, proporcionando uma experiência mais focada e contextual. ### Plataforma de Agentes - **Destinos de transferência com variáveis dinâmicas**: As transferências de agentes agora oferecem suporte a variáveis dinâmicas para números de telefone e URIs SIP, permitindo definir destinos de transferência em tempo de execução com base no contexto da conversa. - **Substituições de configuração de ferramentas MCP**: Adicionada a capacidade de criar, atualizar, recuperar e excluir substituições de configuração personalizadas para ferramentas específicas de servidores MCP, permitindo controle detalhado sobre o comportamento e os parâmetros das ferramentas. ### Text to Dialogue - **Timestamps e segmentos de voz**: O Text to Dialogue agora oferece suporte a saídas com timestamps, alinhamento em nível de caractere e acompanhamento de segmentos de voz, facilitando a sincronização de diálogos com animações ou legendas. ### API de Música - **Separação de stems**: Adicionado um novo endpoint de separação de stems para isolar diferentes componentes de áudio (vocais, bateria, baixo, instrumentos) de faixas de música existentes. - **Aumento do tamanho do prompt**: A geração de música agora oferece suporte a prompts de até 4.100 caracteres, com linhas individuais de letras de até 200 caracteres. ### Segurança - **Tokens de uso único**: Introduzida a geração de tokens de uso único com prazo de validade para operações seguras, oferecendo mais segurança para operações sensíveis da API. ### Lançamentos de SDKs #### SDK JavaScript - [v2.22.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.22.0) - Atualizado com as mudanças mais recentes no esquema da API, incluindo aprovações de modelos do espaço de trabalho e endpoints de configuração de ferramentas MCP. - [v2.21.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.21.0) - Adicionado suporte para interceptar mensagens WebSocket brutas por meio de um manipulador `message` geral, permitindo que desenvolvedores acessem todas as mensagens além dos callbacks padrão, incluindo tipos de mensagem não documentados, como `agent_tool_response`. #### SDK Python - [v2.22.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.22.0) - Atualizado com as mudanças mais recentes no esquema da API, incluindo aprovações de modelos do espaço de trabalho e endpoints de configuração de ferramentas MCP. - [v2.21.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.21.0) - Substituídas as instruções print por logs adequados para oferecer melhor suporte à depuração e a casos de uso em produção. #### Pacotes de Agentes - [@elevenlabs/agents-cli@0.6.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs/agents-cli%400.6.1) - Pacote descontinuado em favor da [CLI unificada da ElevenLabs](https://www.npmjs.com/package/@elevenlabs/cli). - [@elevenlabs/react@0.9.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs/react%400.9.1) - Corrigido um problema em que a ferramenta `end_call` não encerrava as conversas corretamente e aprimorada a lógica de reconexão do React Native após desconexão manual. - [@elevenlabs/react-native@0.5.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs/react-native%400.5.2) - Corrigido um problema em que a ferramenta `end_call` não encerrava as conversas corretamente e aprimorada a lógica de reconexão após desconexão manual. - [@elevenlabs/client@0.9.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs/client%400.9.1) - Corrigido um problema em que a ferramenta `end_call` não encerrava as conversas corretamente e aprimorada a lógica de reconexão do React Native. #### SDK Android - [v0.4.0](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.4.0) - Melhorada a segurança de tipos com o uso de enums `ConversationMode` em vez de strings, migração de LiveData para StateFlow com suporte à compatibilidade retroativa e correção de um bug que impedia agentes de encerrar chamadas quando solicitado. #### SDK iOS - [v2.0.16](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v2.0.16) - Corrigido um problema em que a ferramenta `end_call` não encerrava as conversas corretamente, garantindo que os agentes possam finalizar chamadas de forma adequada. #### CLI - [@elevenlabs/cli@0.2.0](https://github.com/elevenlabs/cli/releases/tag/%40elevenlabs/cli%400.2.0) - Removido o suporte à flag `--env` para isolamento de ambiente virtual. Esse recurso será reintroduzido quando houver suporte adequado ao isolamento de ambiente no produto. ### API #### TLS Nossos endpoints TLS não permitem mais alguns modos de cifra antigos e inseguros. A maioria dos clientes não deve ser afetada, pois já negocia um modo de cifra moderno. ## Novos endpoints ### Plataforma de Agentes #### Configuração de ferramentas MCP - [POST /v1/convai/mcp-servers/{mcp_server_id}/tool-configs](/docs/pt/api-reference/mcp/tool-configuration/create) - Crie substituições de configuração para uma ferramenta MCP específica. - [GET /v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}](/docs/pt/api-reference/mcp/tool-configuration/get) - Recupere substituições de configuração para uma ferramenta MCP específica. - [PATCH /v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}](/docs/pt/api-reference/mcp/tool-configuration/update) - Atualize substituições de configuração para uma ferramenta MCP específica. - [DELETE /v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}](/docs/pt/api-reference/mcp/tool-configuration/delete) - Remova substituições de configuração para uma ferramenta MCP específica. ### Text to Dialogue - [POST /v1/text-to-dialogue/with-timestamps](/docs/pt/api-reference/text-to-dialogue/convert-with-timestamps) - Gere diálogos com alinhamento em nível de caractere e informações de segmentos de voz. - [POST /v1/text-to-dialogue/stream/with-timestamps](/docs/pt/api-reference/text-to-dialogue/stream-with-timestamps) - Transmita a geração de diálogos com alinhamento em nível de caractere e informações de segmentos de voz. ### Tokens - [POST /v1/single-use-token/{token_type}](/docs/pt/api-reference/tokens/create) - Gere tokens de uso único com prazo de validade para operações seguras. ### API de Música - [POST /v1/music/stem-separation](/docs/pt/api-reference/music/separate-stems) - Separe o áudio em stems individuais (vocais, bateria, baixo, instrumentos). Aceita upload de arquivos multipart e retorna um arquivo ZIP. ## Endpoints atualizados ### Text to Dialogue - [Text to dialogue com timestamps](/docs/pt/api-reference/text-to-dialogue/convert-with-timestamps) - Adicionado o array `voice_segments` com o campo obrigatório `dialogue_input_index` para rastrear a qual entrada de diálogo cada segmento corresponde - Esquema de resposta aprimorado com dados de alinhamento em nível de caractere - [Transmitir text to dialogue com timestamps](/docs/pt/api-reference/text-to-dialogue/stream-with-timestamps) - Adicionado suporte a streaming para `voice_segments` com alinhamento em nível de caractere - Inclui `dialogue_input_index` nos blocos de segmentos de voz ### Música - Endpoints de prompt de música atualizados: - Tamanho máximo do prompt aumentado do limite anterior para 4.100 caracteres - As linhas das letras agora oferecem suporte a até 200 caracteres por linha ### Espaço de trabalho - [Obter recurso do espaço de trabalho](/docs/pt/api-reference/workspace/resources/get) - Adicionados `dashboard` e `dashboard_configuration` ao enum `WorkspaceResourceType` - Alterações no esquema de resposta (quebra de compatibilidade — consulte as notas de migração abaixo) ### Faturamento - [Obter assinatura](/docs/pt/api-reference/user/subscription/get) - Adicionado o campo `next_billing_period` (obrigatório) a `PendingSubscriptionSwitchResponseModel` - Adicionados `subtotal_cents` e `tax_cents` (anuláveis) a `InvoiceResponseModel` para uma melhor discriminação da fatura ### Plataforma de Agentes #### Chamadas em lote - [Enviar chamadas em lote](/docs/pt/api-reference/batch-calling/create) - Tornado `agent_phone_number_id` anulável e opcional - Tornado `phone_number` anulável e opcional nos modelos de destinatário - Alterações no esquema de resposta (quebra de compatibilidade — consulte as notas de migração abaixo) - [Obter status de chamadas em lote](/docs/pt/api-reference/batch-calling/get) - Tornados `phone_number_id` e `phone_provider` anuláveis - [Cancelar chamadas em lote](/docs/pt/api-reference/batch-calling/cancel) & [Tentar novamente chamadas em lote](/docs/pt/api-reference/batch-calling/retry) - Tornados os campos relacionados ao telefone anuláveis - Alterações no esquema de resposta (quebra de compatibilidade — consulte as notas de migração abaixo) #### Destinos de transferência - Endpoints relacionados a transferência agora oferecem suporte a destinos de transferência com variáveis dinâmicas: - Adicionado o tipo `PhoneNumberDynamicVariableTransferDestination` para transferências de número de telefone usando variáveis dinâmicas - Adicionado o tipo `SIPUriDynamicVariableTransferDestination` para transferências de URI SIP usando variáveis dinâmicas - Atualizados os discriminadores de `PhoneNumberTransfer` para incluir tipos de variáveis dinâmicas #### Servidores MCP - [Criar servidor MCP](/docs/pt/api-reference/mcp/create), [Obter servidor MCP](/docs/pt/api-reference/mcp/get), [Atualizar servidor MCP](/docs/pt/api-reference/mcp/update) - Adicionado o campo `tool_config_overrides` para personalização da configuração por ferramenta - Adicionado suporte a `request_headers` em `MCPServerConfigUpdateRequestModel` - Adicionadas as opções de configuração `tool_call_sound` e `tool_call_sound_behavior` #### Ferramentas - Melhorias no esquema de ferramentas: - `LiteralJsonSchemaProperty` agora inclui a flag `is_system_provided` - Os cabeçalhos das ferramentas de agentes agora oferecem suporte a `ConvAIDynamicVariable` para valores de cabeçalho dinâmicos #### Integração com Twilio - Endpoints de número de telefone atualizados: - Adicionado o campo opcional `region_config` para números de telefone Twilio - Adicionado o enum `TwilioRegionId` para seleção de região - Adicionado o enum `TwilioEdgeLocation` para configuração de localização de borda #### Agentes - [Obter agente](/docs/pt/api-reference/agents/get) & [Atualizar agente](/docs/pt/api-reference/agents/update) - Alterações no esquema de resposta (quebra de compatibilidade — consulte as notas de migração abaixo)