> 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

- **Entrada pelo teclado do telefone**: A configuração de conversa do agente agora oferece suporte a `dtmf_input_settings` opcional para [entrada DTMF](/docs/pt/eleven-agents/customization/multimodal-input#dtmf-input). Configure o tempo limite dos dígitos, use `#` como terminador e oculte as entradas do teclado em transcrições, logs e análises.
- **Histórico de anexos da conversa**: As entradas de transcrição de [Obter conversa](/docs/pt/api-reference/conversations/get) agora incluem `file_inputs`, um array que contém o ID, o nome, o tipo MIME e a URL de cada arquivo anexado.
- **Filtragem por tags de agentes**: [Listar agentes](/docs/pt/api-reference/agents/list) agora aceita um parâmetro de consulta `tags` opcional. Repita o parâmetro para encontrar agentes com qualquer uma das tags fornecidas.
- **Contexto de campanha em lote**: [Obter conversa](/docs/pt/api-reference/conversations/get) agora identifica chamadas em lote com metadados `campaign` anuláveis contendo os obrigatórios `campaign_id` e `campaign_lead_id`.

### Música

- **Dados visuais de forma de onda**: [Gerar música detalhada](/docs/pt/api-reference/music/compose-detailed), [Transmitir música com detalhes](/docs/pt/api-reference/music/compose-detailed-stream) e [Enviar música](/docs/pt/api-reference/music/upload) agora aceitam `with_waveform_visual` opcional (booleano, padrão `false`). As respostas com essa opção ativada retornam um array de inteiros `waveform_visual` de baixa resolução, com quatro amostras por segundo.

### Dublagem

- **Comportamento de paginação de projetos**: [Listar projetos de Dubbing](/docs/pt/api-reference/dubbing/list-projects) e [Listar idiomas de destino](/docs/pt/api-reference/dubbing/language-targets/list-language-targets) agora limitam `page_size` a 1–100. A filtragem de status do projeto inclui `queued`, e ambos os endpoints documentam o uso de `next_cursor` para buscar a próxima página.

### Lançamentos de SDKs

#### SDK JavaScript

- [v2.66.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.66.0) - Adicionado `fileIds` a `sendMultimodalMessage`, permitindo que uma mensagem inclua vários anexos de arquivo.

#### SDK Python

- [v2.66.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.66.0) - Adicionado `file_ids` a `send_multimodal_message`, permitindo que uma mensagem inclua vários anexos de arquivo.

#### SDK Android

- [v0.12.2](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.12.2) - Preservado o callback `onUnhandledClientToolCall` ao conectar eventos de sessão. Chamadas não tratadas de ferramentas do cliente que esperam uma resposta agora recebem a resposta automática de erro, em vez de permanecerem sem resolução.

#### CLI da ElevenLabs

- [v1.1.0](https://github.com/elevenlabs/cli/releases/tag/v1.1.0) - Regenerados os bindings de comandos da API e adicionada atribuição de solicitações por comando para workflows do ElevenAgents. Esses comandos acrescentam `cmd/<command>` ao `User-Agent` da CLI, permitindo distinguir solicitações de workflows como `agents push` e `agents create`.

#### Pacotes

- [@elevenlabs/client@1.23.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.23.0), [@elevenlabs/react@1.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.15.0), [@elevenlabs/types@0.22.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.22.1), [@elevenlabs/react-native@1.2.25](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.25), [@elevenlabs/convai-widget-core@0.17.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.17.1) e [@elevenlabs/convai-widget-embed@0.17.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.17.1) - Adicionado `fileIds` a `sendMultimodalMessage`. O cliente envia os campos `file` e `files` para compatibilidade, e o React expõe a API de cliente atualizada.

### API

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

## Endpoints atualizados

### ElevenAgents

- [Listar agentes](/docs/pt/api-reference/agents/list) - `GET /v1/convai/agents`
  - Adicionado `tags` opcional e anulável (array de strings). Repita o parâmetro de consulta para encontrar qualquer tag fornecida.
- [Criar agente](/docs/pt/api-reference/agents/create), [Obter agente](/docs/pt/api-reference/agents/get) e [Atualizar agente](/docs/pt/api-reference/agents/update)
  - Adicionado `conversation_config.conversation.dtmf_input_settings` opcional e anulável (`DTMFInputConfig`). Ele oferece suporte a `dtmf_input_timeout` (número, 0,5–10 segundos, padrão `2`), `hash_terminator` (booleano, padrão `true`) e `redact_input` (booleano, padrão `false`).
  - Adicionado `sip_refer_play_dialtone` opcional (booleano, padrão `true`) à configuração de transferência de número de telefone. Defina como `false` para manter a etapa original da chamada silenciosa enquanto uma transferência SIP REFER é concluída.
  - As ferramentas de sistema de procedimento inicial e final agora aceitam um `ProcedureVersionRef` ou um `ProcedureDraftRef`. Referências de rascunho exigem `procedure_id` (string) e definem `version_id` como `null`.
- [Obter conversa](/docs/pt/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}`
  - Adicionado `file_inputs` (array de `ConversationHistoryTranscriptFileInputResponseModel`) às entradas de transcrição. Cada item exige `file_id`, `original_filename`, `mime_type` e `file_url` (strings).
  - Adicionado `campaign` opcional e anulável (`BatchCallingCampaignInformation`) aos metadados de chamadas em lote. O objeto exige `campaign_id` e `campaign_lead_id` (strings).
  - Adicionado `dtmf` a `ChatSourceMedium`.
- Os tipos de problema dos tickets de triagem de conversas adicionam `incorrect_information`, `documentation_gap`, `platform_bug` e `wrong_action`.

### Música

- [Gerar música detalhada](/docs/pt/api-reference/music/compose-detailed) (`POST /v1/music/detailed`) e [Transmitir música com detalhes](/docs/pt/api-reference/music/compose-detailed-stream) (`POST /v1/music/detailed/stream`)
  - Adicionado `with_waveform_visual` opcional (booleano, padrão `false`).
  - As respostas detalhadas adicionam `waveform_visual` anulável (array de inteiros), amostrado quatro vezes por segundo de `-1000` a `1000`.
- [Enviar música](/docs/pt/api-reference/music/upload) - `POST /v1/music/upload`
  - Adicionados `with_waveform_visual` opcional (booleano, padrão `false`) e `waveform_visual` anulável (array de inteiros) na resposta.

### ElevenCreative

- [Criar projeto no Estúdio](/docs/pt/api-reference/studio/add-project) e [Criar podcast](/docs/pt/api-reference/studio/create-podcast)
  - `quality_preset` agora aceita `null`, e o padrão do esquema `standard` foi removido.

### Dublagem

- [Listar projetos de Dubbing](/docs/pt/api-reference/dubbing/list-projects) - `GET /v1/dubbing/project`
  - `page_size` continua sendo um inteiro opcional com padrão `20`, mas os valores agora são limitados a 1–100 em vez de rejeitados.
  - O filtro `status` agora documenta `queued`, `preparing`, `ready` e `failed`.
  - Passe o `next_cursor` da resposta anterior em `cursor`; omita-o na primeira página.
- [Listar idiomas de destino](/docs/pt/api-reference/dubbing/language-targets/list-language-targets) - `GET /v1/dubbing/project/{project_id}/language`
  - `page_size` continua sendo um inteiro opcional com padrão `20`, mas os valores agora são limitados a 1–100 em vez de rejeitados.
  - O filtro `status` oferece suporte a `queued`, `processing`, `completed`, `stale` e `failed`.
  - Passe o `next_cursor` da resposta anterior em `cursor`; omita-o na primeira página.

## Alterações de esquema

### Espaço de trabalho

- `PendingSubscriptionSwitchResponseModel.next_tier` adiciona `grant`.

</Accordion>