> 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

- **Input da tastierino telefonico**: la configurazione delle conversazioni degli agenti ora supporta `dtmf_input_settings` facoltativo per l'[input DTMF](/docs/it/eleven-agents/customization/multimodal-input#dtmf-input). Configura il timeout delle cifre, usa `#` come terminatore e oscura le voci del tastierino nelle trascrizioni, nei log e nelle analisi.
- **Cronologia degli allegati della conversazione**: le voci della trascrizione di [Recupera conversazione](/docs/it/api-reference/conversations/get) ora includono `file_inputs`, un array che contiene ID, nome, tipo MIME e URL di ogni file allegato.
- **Filtro per tag degli agenti**: [Elenca agenti](/docs/it/api-reference/agents/list) ora accetta un parametro query `tags` facoltativo. Ripeti il parametro per trovare gli agenti con uno qualsiasi dei tag forniti.
- **Contesto delle campagne batch**: [Recupera conversazione](/docs/it/api-reference/conversations/get) ora identifica le chiamate batch con metadati `campaign` annullabili contenenti i campi obbligatori `campaign_id` e `campaign_lead_id`.

### Musica

- **Dati visivi della forma d'onda**: [Genera musica dettagliata](/docs/it/api-reference/music/compose-detailed), [Trasmetti musica con dettagli](/docs/it/api-reference/music/compose-detailed-stream) e [Carica musica](/docs/it/api-reference/music/upload) ora accettano `with_waveform_visual` facoltativo (booleano, valore predefinito `false`). Le risposte con l'opzione attivata restituiscono un array di numeri interi `waveform_visual` a bassa risoluzione con quattro campioni al secondo.

### Doppiaggio

- **Comportamento della paginazione dei progetti**: [Elenca progetti di Doppiaggio](/docs/it/api-reference/dubbing/list-projects) e [Elenca lingue di destinazione](/docs/it/api-reference/dubbing/language-targets/list-language-targets) ora limitano `page_size` a 1–100. Il filtro per stato dei progetti include `queued` ed entrambi gli endpoint documentano l'uso di `next_cursor` per recuperare la pagina successiva.

### Rilasci degli SDK

#### SDK JavaScript

- [v2.66.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.66.0) - Aggiunto `fileIds` a `sendMultimodalMessage`, consentendo a un messaggio di includere più allegati di file.

#### SDK Python

- [v2.66.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.66.0) - Aggiunto `file_ids` a `send_multimodal_message`, consentendo a un messaggio di includere più allegati di file.

#### SDK Android

- [v0.12.2](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.12.2) - Preservato il callback `onUnhandledClientToolCall` durante il collegamento degli eventi di sessione. Le chiamate non gestite agli strumenti client che richiedono una risposta ora ricevono la risposta di errore automatica invece di rimanere irrisolte.

#### CLI ElevenLabs

- [v1.1.0](https://github.com/elevenlabs/cli/releases/tag/v1.1.0) - Rigenerati i binding dei comandi API e aggiunta l'attribuzione delle richieste basata sul comando per i workflow di ElevenAgents. Questi comandi aggiungono `cmd/<command>` allo `User-Agent` della CLI, consentendo di distinguere le richieste provenienti da workflow come `agents push` e `agents create`.

#### Pacchetti

- [@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) - Aggiunto `fileIds` a `sendMultimodalMessage`. Il client invia entrambi i campi `file` e `files` per compatibilità, e React espone l'API client aggiornata.

### API

<Accordion title="Visualizza modifiche API">

## Endpoint aggiornati

### ElevenAgents

- [Elenca agenti](/docs/it/api-reference/agents/list) - `GET /v1/convai/agents`
  - Aggiunto `tags` facoltativo e annullabile (array di stringhe). Ripeti il parametro query per trovare qualsiasi tag fornito.
- [Crea agente](/docs/it/api-reference/agents/create), [Recupera agente](/docs/it/api-reference/agents/get) e [Aggiorna agente](/docs/it/api-reference/agents/update)
  - Aggiunto `conversation_config.conversation.dtmf_input_settings` facoltativo e annullabile (`DTMFInputConfig`). Supporta `dtmf_input_timeout` (numero, 0,5–10 secondi, valore predefinito `2`), `hash_terminator` (booleano, valore predefinito `true`) e `redact_input` (booleano, valore predefinito `false`).
  - Aggiunto `sip_refer_play_dialtone` facoltativo (booleano, valore predefinito `true`) alla configurazione del trasferimento del numero di telefono. Impostalo su `false` per mantenere silenziosa la tratta di chiamata originale mentre viene completato un trasferimento SIP REFER.
  - Gli strumenti di sistema per le procedure di avvio e fine ora accettano `ProcedureVersionRef` o `ProcedureDraftRef`. I riferimenti alle bozze richiedono `procedure_id` (stringa) e impostano `version_id` su `null`.
- [Recupera conversazione](/docs/it/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}`
  - Aggiunto `file_inputs` (array di `ConversationHistoryTranscriptFileInputResponseModel`) alle voci della trascrizione. Ogni elemento richiede `file_id`, `original_filename`, `mime_type` e `file_url` (stringhe).
  - Aggiunto `campaign` facoltativo e annullabile (`BatchCallingCampaignInformation`) ai metadati delle chiamate batch. L'oggetto richiede `campaign_id` e `campaign_lead_id` (stringhe).
  - Aggiunto `dtmf` a `ChatSourceMedium`.
- I tipi di problemi nei ticket di triage delle conversazioni aggiungono `incorrect_information`, `documentation_gap`, `platform_bug` e `wrong_action`.

### Musica

- [Genera musica dettagliata](/docs/it/api-reference/music/compose-detailed) (`POST /v1/music/detailed`) e [Trasmetti musica con dettagli](/docs/it/api-reference/music/compose-detailed-stream) (`POST /v1/music/detailed/stream`)
  - Aggiunto `with_waveform_visual` facoltativo (booleano, valore predefinito `false`).
  - Le risposte dettagliate aggiungono `waveform_visual` annullabile (array di numeri interi), campionato quattro volte al secondo da `-1000` a `1000`.
- [Carica musica](/docs/it/api-reference/music/upload) - `POST /v1/music/upload`
  - Aggiunti `with_waveform_visual` facoltativo (booleano, valore predefinito `false`) e `waveform_visual` annullabile (array di numeri interi) nella risposta.

### ElevenCreative

- [Crea progetto Studio](/docs/it/api-reference/studio/add-project) e [Crea podcast](/docs/it/api-reference/studio/create-podcast)
  - `quality_preset` ora accetta `null` ed è stato rimosso il valore predefinito `standard` dello schema.

### Doppiaggio

- [Elenca progetti di Doppiaggio](/docs/it/api-reference/dubbing/list-projects) - `GET /v1/dubbing/project`
  - `page_size` rimane un numero intero facoltativo con valore predefinito `20`, ma i valori ora sono limitati a 1–100 invece di essere rifiutati.
  - Il filtro `status` ora documenta `queued`, `preparing`, `ready` e `failed`.
  - Passa `next_cursor` della risposta precedente in `cursor`; omettilo per la prima pagina.
- [Elenca lingue di destinazione](/docs/it/api-reference/dubbing/language-targets/list-language-targets) - `GET /v1/dubbing/project/{project_id}/language`
  - `page_size` rimane un numero intero facoltativo con valore predefinito `20`, ma i valori ora sono limitati a 1–100 invece di essere rifiutati.
  - Il filtro `status` supporta `queued`, `processing`, `completed`, `stale` e `failed`.
  - Passa `next_cursor` della risposta precedente in `cursor`; omettilo per la prima pagina.

## Modifiche agli schemi

### Workspace

- `PendingSubscriptionSwitchResponseModel.next_tier` aggiunge `grant`.

</Accordion>