> 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.
# Registro delle modifiche
## October 5, 2026
### ElevenAgents
- **Le procedure strutturate vengono compilate al salvataggio e alla pubblicazione**: [Aggiorna agente](/docs/it/api-reference/agents/update) e [Crea bozza di agente](/docs/it/api-reference/agents/drafts/create) ora compilano e convalidano automaticamente le [procedure strutturate](/docs/it/eleven-agents/customization/procedures/structured-procedures). Le integrazioni non devono più chiamare l'endpoint di compilazione né aggiornare manualmente il workflow generato. Le procedure non valide restituiscono errori per singola procedura come `400 procedure_validation_failed`. Gli agenti senza procedure strutturate non sono interessati.
- **L'endpoint di compilazione delle procedure è legacy**: [Compila procedure](/docs/it/api-reference/agents/procedures/compile) è contrassegnato come legacy e non deve essere usato dalle nuove integrazioni. Rimane disponibile per i chiamanti esistenti.
- **Proposte di merge**: le proposte di merge sono disponibili in alpha. I team possono aprire una proposta per un branch di agente, esaminare le modifiche alla configurazione e i risultati dei test, lasciare commenti o decisioni di approvazione e unire le modifiche approvate in un branch di destinazione. Consulta [Proposte di merge](/docs/it/eleven-agents/operate/merge-proposals).
### Rilasci SDK
#### SDK JavaScript
- [v2.71.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.71.0) - Aggiunti client per le proposte di merge degli agenti, la cronologia dei deployment, l'annullamento delle invocazioni di test e la duplicazione di Speech Engine. La release aggiunge inoltre priorità e ordinamento dei ticket di triage, limiti di esportazione delle chiamate batch, `gpt-6.1-sol`, `claude-sonnet-5-5`, modelli vocali per agenti Eleven v4 e tipi di configurazione correnti degli agenti.
#### SDK Python
- [v2.71.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.71.0) - Aggiunti client per le proposte di merge degli agenti, la cronologia dei deployment, l'annullamento delle invocazioni di test e la duplicazione di Speech Engine. La release aggiunge inoltre priorità e ordinamento dei ticket di triage, limiti di esportazione delle chiamate batch, `gpt-6.1-sol`, `claude-sonnet-5-5`, modelli vocali per agenti Eleven v4 e tipi di configurazione correnti degli agenti.
#### SDK Swift
- [v3.4.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.4.0) - Le variabili dinamiche ora preservano i tipi JSON nativi quando vengono inviate nei dati di avvio della conversazione.
#### Pacchetti
- [@elevenlabs/client@1.26.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.26.0), [@elevenlabs/react@1.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.16.0), [@elevenlabs/react-native@1.2.28](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.28) e [@elevenlabs/types@0.24.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.24.0) - Aggiunta la modifica delle trascrizioni Speech to Text in tempo reale tramite `transcriptEdit`, l'evento `edited_transcript` e il callback React `onEditedTranscript`. React ora inoltra `filterBackgroundAudio` alle sessioni in tempo reale. Il client esporta inoltre `MessagePayload` e usa ID risposta stabili per evitare risposte duplicate degli agenti.
- [@elevenlabs/convai-widget-core@0.18.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.3) e [@elevenlabs/convai-widget-embed@0.18.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.3) - Aggiunte anteprime delle immagini e link per il download degli allegati ai messaggi degli agenti, incluse le risposte contenenti solo allegati. Gli ID risposta stabili evitano risposte duplicate e le conversazioni solo testuali ora usano un controllo di arresto con un tooltip **Termina chat**.
### API
## Nuovi endpoint
### ElevenAgents
- [Crea una proposta di merge](/docs/it/api-reference/agents/merge-proposals/create) - `POST /v1/convai/agents/{agent_id}/merge-proposals` - Crea una proposta con i campi obbligatori `source_branch_id`, `target_branch_id` e `title`, oltre a una descrizione facoltativa, ID revisori e ID ticket di triage.
- [Elenca proposte di merge](/docs/it/api-reference/agents/merge-proposals/list) - `GET /v1/convai/agents/{agent_id}/merge-proposals` - Elenca le proposte con filtri per stato, branch di origine, branch di destinazione e testo, oltre alla paginazione tramite cursore.
- [Ottieni una proposta di merge](/docs/it/api-reference/agents/merge-proposals/get) - `GET /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}` - Recupera una proposta e i dettagli relativi a revisione, commenti ed esito.
- [Aggiorna una proposta di merge](/docs/it/api-reference/agents/merge-proposals/update) - `PATCH /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}` - Aggiorna titolo, descrizione o revisori richiesti, oppure chiudila senza eseguire il merge.
- [Esamina una proposta di merge](/docs/it/api-reference/agents/merge-proposals/submit-review) - `POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/reviews` - Invia una decisione `approved` o `changes_requested` con un commento facoltativo.
- [Commenta una proposta di merge](/docs/it/api-reference/agents/merge-proposals/add-comment) - `POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/comments` - Aggiungi un commento Markdown fino a 4.096 caratteri.
- [Unisci una proposta di merge](/docs/it/api-reference/agents/merge-proposals/merge) - `POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/merge` - Unisci il branch di origine e controlla facoltativamente la risoluzione forzata dei conflitti e l'archiviazione del branch di origine.
- [Elenca deployment degli agenti](/docs/it/api-reference/agents/deployments/list) - `GET /v1/convai/agents/{agent_id}/deployments` - Elenca le suddivisioni del traffico correnti e cronologiche dei branch con paginazione basata sulle pagine.
- [Annulla un'invocazione di test](/docs/it/api-reference/tests/test-invocations/cancel) - `POST /v1/convai/test-invocations/{test_invocation_id}/cancel` - Annulla un'invocazione di test in esecuzione.
### Speech Engine
- [Duplica uno Speech Engine](/docs/it/api-reference/speech-engine/duplicate) - `POST /v1/speech-engine/{speech_engine_id}/duplicate` - Duplica uno Speech Engine e assegna facoltativamente alla copia un nuovo `name`.
## Endpoint aggiornati
### ElevenAgents
- [Crea agente](/docs/it/api-reference/agents/create), [Ottieni agente](/docs/it/api-reference/agents/get) e [Aggiorna agente](/docs/it/api-reference/agents/update)
- Aggiunti `gpt-6.1-sol` e `claude-sonnet-5-5` all'enum `LLM`.
- Aggiunti `eleven_v4` e `eleven_v4_turbo` alle opzioni del modello TTS conversazionale. Il valore predefinito è passato da `eleven_flash_v2` a `eleven_v4_turbo`.
- I trasferimenti degli agenti e i nodi degli agenti workflow autonomi aggiungono `preserve_voice_settings` facoltativo (booleano, valore predefinito `false`) per mantenere la voce di base, il modello TTS e le impostazioni vocali dopo un trasferimento.
- Le configurazioni dello strumento per saltare il turno aggiungono `wait_timeout_secs` facoltativo (numero, valore predefinito `-1`). Il valore `-1` mantiene l'agente in silenzio finché il chiamante non parla.
- Le configurazioni webhook post-chiamata aggiungono `exclude_transcript` facoltativo (booleano, valore predefinito `false`) per omettere le trascrizioni turno per turno dai webhook di trascrizione JSON.
- Le configurazioni di redazione della cronologia delle conversazioni aggiungono `excluded_data_collection_ids` facoltativo (array di stringhe, massimo 50) per mantenere i valori estratti selezionati mentre vengono oscurate le relative motivazioni.
- `response_timeout_secs` dello strumento client ora accetta `-1` per attendere indefinitamente quando `expects_response` è abilitato.
- [Elenca ticket](/docs/it/api-reference/triage-tickets/list)
- Aggiunto `priorities` facoltativo (array) con valori `low`, `medium`, `high` e `urgent`.
- Aggiunto `sort_by` con valori `created_at` e `priority`; il valore predefinito è `created_at`.
- Le risposte dei ticket ora richiedono `title`, `priority` nullable e un array `priority_changes`. Le richieste di creazione e aggiornamento dei ticket possono impostare `priority` e lo stato del ticket aggiunge `cancelled`.
- [Elenca strumenti](/docs/it/api-reference/tools/list) - Aggiunto `used_by_agent_id` facoltativo e nullable (stringa) per restituire gli strumenti a cui fa riferimento il branch principale di un agente.
- [Esporta risultati delle chiamate batch](/docs/it/api-reference/batch-calling/export) - Aggiunto `limit` facoltativo e nullable (intero, minimo `1`) per esportare solo i primi destinatari come anteprima di colonna.
- [Elenca invocazioni di test](/docs/it/api-reference/tests/test-invocations/list) e [Ottieni invocazione di test](/docs/it/api-reference/tests/test-invocations/get)
- I riepiloghi delle invocazioni di test aggiungono `cancelled_count` obbligatorio (intero) e `cancelled` facoltativo (booleano, valore predefinito `false`).
- Lo stato dell'esecuzione di test aggiunge `cancelled`.
- [Ottieni dettagli della conversazione](/docs/it/api-reference/conversations/get) - Le voci della trascrizione aggiungono `platform_event` facoltativo e nullable con valori `user_turn_timeout` e `skip_turn_wait_elapsed`.
- [Ottieni metadati della versione dell'agente](/docs/it/api-reference/agents/versions/get) - Aggiunto `merged_authors` facoltativo e nullable, un array che descrive le persone che hanno pubblicato modifiche unite nel branch principale.
- [Ottieni job di crawling](/docs/it/api-reference/knowledge-base/get-crawl-job) - Rimosso il campo di risposta deprecato `max_depth`.
## September 28, 2026
import { YoutubeEmbed } from "../../../components/YoutubeEmbed";
### Eleven v4 e Eleven v4 Turbo
[Eleven v4 e Eleven v4 Turbo](/docs/it/overview/capabilities/text-to-speech/eleven-v4) sono ora disponibili. Eleven v4 offre un parlato di qualità superiore e più espressivo, oltre a una clonazione vocale migliorata in oltre 90 lingue. Eleven v4 Turbo offre la stessa famiglia di modelli per applicazioni in tempo reale, con una latenza di inferenza mediana di circa 100 ms.
Usa `eleven_v4` tramite l'API Text to Dialogue per la creazione di contenuti e audio di lunga durata. Usa `eleven_v4_turbo` tramite il WebSocket Text to Dialogue per agenti e applicazioni interattive.
Confronta le due varianti del modello, il comportamento della clonazione vocale, le impostazioni e le lingue supportate.
Genera dialoghi di alta qualità con Eleven v4.
Trasmetti dialoghi di Eleven v4 Turbo tramite una connessione WebSocket.
### Speech to Text
- **Modifica della trascrizione**: la trascrizione batch e in tempo reale ora accettano un'istruzione di modifica in linguaggio naturale fino a 2.000 caratteri. Le risposte batch restituiscono il risultato in `edited_transcript`, mentre le sessioni in tempo reale emettono un evento `edited_transcript`. Consulta le guide [batch](/docs/it/eleven-api/guides/how-to/speech-to-text/batch/transcript-editing) e [in tempo reale](/docs/it/eleven-api/guides/how-to/speech-to-text/realtime/transcript-editing) per incompatibilità, gestione delle risposte e prezzi.
### ElevenAgents
- **Modelli degli agenti**: aggiunti `gpt-6-sol`, `gpt-6-luna`, `glm-52`, `deepseek-v41-flash`, `claude-opus-5` e `claude-opus-5-5` alle opzioni LLM supportate per gli agenti.
- **Utilizzo dei test degli agenti**: i riepiloghi delle invocazioni di test possono includere i crediti totali e il prezzo in USD. Le singole esecuzioni di test possono includere i crediti e un dettaglio degli addebiti.
### Flows
- **API dei template**: aggiunti endpoint per elencare e recuperare i template Flows pubblicati, avviare esecuzioni di template e recuperare i risultati delle esecuzioni. Le esecuzioni possono usare una versione pubblicata e inviare il risultato finale a un webhook configurato.
### Text to Dialogue
- **Continuità della generazione**: le richieste Text to Dialogue possono usare testo precedente o successivo e ID richiesta per mantenere la continuità tra generazioni.
- **Modalità voce professionale**: le richieste Text to Dialogue possono usare la versione Instant Voice Clone di una Professional Voice Clone per ridurre la latenza o migliorare l'espressività.
### Rilasci SDK
#### SDK JavaScript
- [v2.70.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.70.0) - Aggiunti tipi per la modifica delle trascrizioni Speech to Text batch e in tempo reale, il filtro `branchId` e campi di costo per i riepiloghi delle invocazioni di test, l'individuazione automatica della knowledge base, `usePvcAsIvc` per Text to Dialogue e il modello di agente `deepseek-v41-flash`.
#### SDK Python
- [v2.70.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.70.0) - Aggiunti tipi per la modifica delle trascrizioni Speech to Text batch e in tempo reale, il filtro `branch_id` e campi di costo per i riepiloghi delle invocazioni di test, l'individuazione automatica della knowledge base, `use_pvc_as_ivc` per Text to Dialogue e il modello di agente `deepseek-v41-flash`.
#### CLI ElevenLabs
- [v1.4.0](https://github.com/elevenlabs/cli/releases/tag/v1.4.0) - Corrette le richieste con una chiave API esplicita, che ora non inviano più anche le credenziali OAuth archiviate, causando errori di autenticazione. Aggiunte descrizioni per il gruppo di comandi di feedback e istruzioni per segnalare funzionalità mancanti alle competenze degli agenti generate. Rigenerato il client API con gli endpoint dei template Flows e i tipi di schema correnti.
### API
## Nuovi endpoint
### Flows
- [Elenca template](/docs/it/api-reference/flows/templates/list) - `GET /v1/flows/templates` - Elenca i template pubblicati e le relative versioni eseguibili.
- [Ottieni template](/docs/it/api-reference/flows/templates/get) - `GET /v1/flows/templates/{template_id}` - Recupera un template e le relative versioni eseguibili.
- [Crea esecuzione di un template](/docs/it/api-reference/flows/templates/runs/create) - `POST /v1/flows/templates/{template_id}/runs` - Avvia l'esecuzione di un template con valori di input, una versione facoltativa e un webhook facoltativo.
- [Elenca esecuzioni di template](/docs/it/api-reference/flows/templates/runs/list) - `GET /v1/flows/templates/{template_id}/runs` - Elenca le esecuzioni di template con paginazione tramite cursore e filtro di versione facoltativo.
- [Ottieni esecuzione di un template](/docs/it/api-reference/flows/templates/runs/get) - `GET /v1/flows/templates/{template_id}/runs/{run_id}` - Recupera l'esecuzione di un template e lo stato del relativo output.
## Endpoint aggiornati
### Speech to Text
- [Converti parlato in testo](/docs/it/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
- Aggiunto `transcript_edit` facoltativo e nullable (stringa), che accetta un'istruzione di modifica in linguaggio naturale fino a 2.000 caratteri.
- Le risposte aggiungono `edited_transcript` facoltativo e nullable. Una modifica riuscita contiene i campi obbligatori `kind: "transcript"` e `text`. Una modifica non riuscita contiene i campi obbligatori `kind: "error"`, `error_type: "edit_failed"` e `message`.
- [Speech to Text in tempo reale](/docs/it/api-reference/speech-to-text/v-1-speech-to-text-realtime) accetta `transcript_edit` (stringa) ed emette eventi `edited_transcript` con i campi obbligatori `text` e `edited_text`.
### ElevenAgents
- [Crea agente](/docs/it/api-reference/agents/create), [Ottieni agente](/docs/it/api-reference/agents/get) e [Aggiorna agente](/docs/it/api-reference/agents/update)
- Aggiunti `gpt-6-sol`, `gpt-6-luna`, `glm-52`, `deepseek-v41-flash`, `claude-opus-5` e `claude-opus-5-5` all'enum `LLM`.
- I monitor di avviso aggiungono `enabled` facoltativo e nullable (booleano) per controllare se un monitor può inviare notifiche.
- [Elenca conversazioni](/docs/it/api-reference/conversations/list) e [Ricerca testuale](/docs/it/api-reference/conversations/messages/text-search)
- `data_collection_params` e `dynamic_variable_params` aggiungono gli operatori `neq` e `in`. I valori di `in` usano un delimitatore pipe.
- `evaluation_params` accetta `success`, `failure` o `unknown` come valore del risultato.
- [Ricerca intelligente](/docs/it/api-reference/conversations/messages/search) - `GET /v1/convai/conversations/messages/smart-search`
- Aggiunto `branch_id` facoltativo e nullable (stringa).
- [Elenca invocazioni di test](/docs/it/api-reference/tests/test-invocations/list) - `GET /v1/convai/test-invocations`
- Aggiunto `branch_id` facoltativo e nullable (stringa).
- I riepiloghi delle invocazioni di test aggiungono `credits_used` facoltativo e nullable (intero) e `total_price` (numero).
- [Ottieni invocazione di test](/docs/it/api-reference/tests/test-invocations/get) - `GET /v1/convai/test-invocations/{test_invocation_id}`
- Le singole esecuzioni di test aggiungono `credits_used` facoltativo e nullable (intero) e `charging` (`ConversationChargingCommonModel`).
- [Simula conversazione](/docs/it/api-reference/agents/simulate-conversation) e [Simula stream di conversazione](/docs/it/api-reference/agents/simulate-conversation-stream)
- Modificato il valore predefinito facoltativo di `new_turns_limit` da `10,000` a `100` e impostato il valore massimo a `100`.
- [Crea job di crawling](/docs/it/api-reference/knowledge-base/create-crawl-job) e [Ottieni job di crawling](/docs/it/api-reference/knowledge-base/get-crawl-job)
- Aggiunto `auto_discover` facoltativo (booleano, valore predefinito `false`) per seguire i link e aggiungere le pagine appena individuate durante la sincronizzazione automatica. Richiede `enable_auto_sync: true`.
- [Aggiorna documento della knowledge base](/docs/it/api-reference/knowledge-base/refresh) - `POST /v1/convai/knowledge-base/{documentation_id}/refresh`
- `AutoSyncInfo` aggiunge `auto_discover` facoltativo (booleano, valore predefinito `false`) per indicare se gli aggiornamenti eseguono il crawling e aggiungono le pagine appena individuate.
- [Elenca strumenti del server MCP](/docs/it/api-reference/mcp/list-tools) - `GET /v1/convai/mcp-servers/{mcp_server_id}/tools`
- Le risposte aggiungono `tool_approval_statuses` facoltativo (array). Ogni elemento contiene `tool_id` obbligatorio (stringa) e `state` (`up_to_date`, `needs_review` o `not_approved`), con campi facoltativi relativi alla policy di approvazione e alla definizione approvata.
### Text to Dialogue
- [Converti testo in dialogo](/docs/it/api-reference/text-to-dialogue/convert), [Trasmetti testo in dialogo](/docs/it/api-reference/text-to-dialogue/stream), [Converti con timestamp](/docs/it/api-reference/text-to-dialogue/convert-with-timestamps) e [Trasmetti con timestamp](/docs/it/api-reference/text-to-dialogue/stream-with-timestamps)
- Aggiunto `use_pvc_as_ivc` facoltativo (booleano, valore predefinito `false`) per usare la versione Instant Voice Clone di una Professional Voice Clone.
- Aggiunti `previous_text` e `future_text` facoltativi e nullable (stringhe, massimo 100 caratteri) e `previous_request_ids` e `next_request_ids` (array di stringhe, massimo 3 ID) per la continuità della generazione.
- L'oggetto `settings` facoltativo aggiunge `similarity` nullable (numero, 0–1, valore predefinito `0.75`).
### Text to Speech
- [Converti testo in parlato](/docs/it/api-reference/text-to-speech/convert), [Trasmetti testo in parlato](/docs/it/api-reference/text-to-speech/stream), [Converti con timestamp](/docs/it/api-reference/text-to-speech/convert-with-timestamps) e [Trasmetti con timestamp](/docs/it/api-reference/text-to-speech/stream-with-timestamps)
- Il campo `use_pvc_as_ivc` esistente non è più deprecato.
### Flows
- [Crea generazione di immagini](/docs/it/api-reference/flows/image/create), [Crea generazione di video](/docs/it/api-reference/flows/video/create) e [Crea esecuzione di un template](/docs/it/api-reference/flows/templates/runs/create)
- Le destinazioni webhook ora richiedono un discriminatore `type` esplicito (`all` o `ids`). I valori predefiniti precedenti sono stati rimossi.
### Voice Design
- [Crea voce dall'anteprima](/docs/it/api-reference/text-to-voice/create), [Crea anteprime vocali](/docs/it/api-reference/legacy/voices/create-previews), [Progetta una voce](/docs/it/api-reference/text-to-voice/design) e [Remixa una voce](/docs/it/api-reference/text-to-voice/remix)
- Aggiunta una risposta `409` quando è già in corso una generazione per l'anteprima. Riprova la richiesta dopo aver ricevuto questa risposta.
### Workspace
- [Crea chiave API dell'account di servizio](/docs/it/api-reference/service-accounts/api-keys/create) - `POST /v1/service-accounts/{service_account_user_id}/api-keys`
- Aggiunti `tts_concurrency_limit`, `music_concurrency_limit` e `dubbing_concurrency_limit` facoltativi e nullable (interi) per le chiavi API degli account di servizio Enterprise.
- [Aggiorna chiave API dell'account di servizio](/docs/it/api-reference/service-accounts/api-keys/update) - `PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}`
- Aggiunti `tts_concurrency_limit`, `music_concurrency_limit` e `dubbing_concurrency_limit` facoltativi. Ogni campo accetta un intero, `clear`, `no_update` o `null` e il valore predefinito è `no_update`.
### Modelli
- [Elenca modelli](/docs/it/api-reference/models/list) - `GET /v1/models`
- Deprecati i campi obbligatori `max_characters_request_free_user` e `max_characters_request_subscribed_user`. Questi campi non vengono applicati; usa invece `maximum_text_length_per_request`.
## September 23, 2026
### Immagini e video
- **Sora 2 e Sora 2 Pro ritirati**: OpenAI interromperà la Sora API il 24 settembre 2026. Entrambi i modelli sono stati rimossi dal selettore dei modelli Immagini e Video e smetteranno di generare in quella data. Le generazioni esistenti restano disponibili nella tua cronologia. I Flows e i template che usano un nodo Sora devono passare a un altro modello video, come [Gemini Omni 1.1 Flash](/docs/it/overview/capabilities/image-video), prima di poter essere eseguiti nuovamente.
- **Seedance 1.5 Pro deprecato**: ByteDance ritirerà Seedance 1.5 Pro l'11 novembre 2026. Il modello non è più disponibile per nuove generazioni e smetterà di funzionare in quella data. Usa invece un [modello Seedance 2.0](/docs/it/overview/capabilities/image-video).
## September 21, 2026
### ElevenAgents
- **Chiamate parallele degli strumenti**: La configurazione del prompt dell'agente ora include `enable_parallel_tool_calls` (booleano, predefinito `true`). Se abilitato, i modelli supportati possono eseguire più strumenti in un unico turno.
- **Modelli degli agenti**: Aggiunto `gpt-6-astra` alle opzioni LLM dell'agente.
- **Avvisi**: Gli avvisi degli agenti ora supportano i canali Slack insieme ai notificatori PagerDuty e webhook.
- **Ricerca dei numeri di telefono**: Aggiunto un endpoint dei numeri di telefono con paginazione basata su cursore e filtri per provider, supporto in uscita, agente e ramo assegnati, etichetta e numero di telefono.
### Immagini e video
- **Modelli GPT Image 2.5**: La [generazione di immagini](/docs/it/api-reference/flows/image/create) ora supporta `gpt-image-2.5-flare` e `gpt-image-2.5-sunburst`. Entrambi i modelli accettano fino a 10 immagini di riferimento, livelli di qualità fino a `max`, 14 rapporti d'aspetto fissi più `auto` e output 1K, 2K o 4K.
### Speech Engine
- **Timeout a cascata**: Le richieste di creazione e aggiornamento di Speech Engine ora accettano `cascade_timeout_seconds` (numero, 2–15, predefinito `4`) per controllare quanto tempo ElevenLabs attende un motore vocale upstream prima di riprovare.
### Text to Speech
- **Confini di turno multi-contesto**: Il marcatore `is_final_audio_for_turn` ora viene emesso dopo ogni byte nel buffer per quel turno, inclusi gli output MP3 e Opus. I client possono usare il marcatore come confine esatto del turno senza passare a PCM.
### Rilasci SDK
#### SDK JavaScript
- [v2.69.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.69.0) - Aggiunto `transcriptEdit` al wrapper Speech to Text in tempo reale, con testo modificato fornito tramite eventi `edited_transcript`. Corretta la verifica JWT di Speech Engine per le chiavi API con suffissi di residenza dei dati. Aggiunti `phoneNumbers.listV2` e metodi per i template Flows per elencare e ottenere template, nonché elencare, creare e ottenere esecuzioni. Rigenerati client e tipi per GPT Image 2.5, avvisi degli agenti su Slack, chiamate parallele degli strumenti, `gpt-6-astra`, limiti di concorrenza delle chiavi API degli account di servizio, conservazione zero per Music, filtri delle conversazioni e stati di approvazione degli strumenti MCP.
#### SDK Python
- [v2.69.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.69.0) - Aggiunto `transcript_edit` al wrapper Speech to Text in tempo reale, con testo modificato fornito tramite eventi `edited_transcript`. Corretta la verifica JWT di Speech Engine per le chiavi API con suffissi di residenza dei dati e fatto in modo che `play` generi un errore quando `ffplay` non riesce. Aggiunti `phone_numbers.list_v2` e metodi per i template Flows per elencare e ottenere template, nonché elencare, creare e ottenere esecuzioni. Rigenerati client e tipi per GPT Image 2.5, avvisi degli agenti su Slack, chiamate parallele degli strumenti, `gpt-6-astra`, limiti di concorrenza delle chiavi API degli account di servizio, conservazione zero per Music, filtri delle conversazioni e stati di approvazione degli strumenti MCP.
#### CLI ElevenLabs
- [v1.3.2](https://github.com/elevenlabs/cli/releases/tag/v1.3.2) - Aggiunti metadati facoltativi `--intent` per raccogliere feedback sull'uso della CLI. Aggiunto `elevenlabs feedback missing-capability` per segnalare workflow non supportati dalla CLI.
### API
## Nuovi endpoint
### ElevenAgents
- [Elenca pagina dei numeri di telefono](/docs/it/api-reference/phone-numbers/list-v-2) - `GET /v1/convai/v2/phone-numbers`
- Aggiunti i parametri di paginazione `page_size` facoltativo (intero, 1–1.000, predefinito `100`) e `cursor` (stringa nullable).
- Aggiunti i filtri facoltativi `search`, `label`, `phone_number`, `provider`, `supports_outbound`, `agent_id`, `branch_id`, `sort_by` e `sort_direction`. `sort_by` accetta `label` o `phone_number`; `sort_direction` è predefinito su `asc`.
- La risposta contiene `phone_numbers` obbligatorio (array), `next_cursor` facoltativo e nullable (stringa) e `has_more` (booleano, predefinito `false`).
## Endpoint aggiornati
### ElevenAgents
- [Crea agente](/docs/it/api-reference/agents/create), [Ottieni agente](/docs/it/api-reference/agents/get) e [Aggiorna agente](/docs/it/api-reference/agents/update)
- La configurazione del prompt aggiunge `enable_parallel_tool_calls` (booleano, predefinito `true`). Gli override del workflow accettano un booleano nullable.
- L'enum `LLM` aggiunge `gpt-6-astra`, inclusi gli override per l'avvio della conversazione.
- I notificatori dell'integrazione di avvisi ora usano `integration_type` per selezionare `pagerduty` o `slack`. I notificatori Slack richiedono `connection_id` e `channel_id` (stringhe); `channel_id` accetta da 1 a 64 caratteri.
- [Elenca conversazioni](/docs/it/api-reference/conversations/list) e [Risolvi riferimento conversazione](/docs/it/api-reference/conversations/resolve)
- `data_collection_params` non accetta più l'operatore `missing`. Usa un valore vuoto per trovare le conversazioni in cui il campo non è stato raccolto.
- Un valore vuoto in `dynamic_variable_params` trova le conversazioni in cui la variabile non è stata impostata.
- [Crea Speech Engine](/docs/it/api-reference/speech-engine/create), [Ottieni Speech Engine](/docs/it/api-reference/speech-engine/get) e [Aggiorna Speech Engine](/docs/it/api-reference/speech-engine/update)
- Aggiunto `cascade_timeout_seconds` (numero, 2–15). Le richieste di creazione sono predefinite su `4`, quelle di aggiornamento accettano un valore nullable e le risposte richiedono il campo.
### Immagini e video
- [Crea generazione di immagini](/docs/it/api-reference/flows/image/create) - `POST /v1/flows/image`
- Aggiunte varianti della richiesta per `gpt-image-2.5-flare` e `gpt-image-2.5-sunburst`.
- Entrambe le varianti richiedono `prompt` e `model_id`, accettano fino a 10 `images` e aggiungono `resolution` (`1K`, `2K` o `4K`, predefinito `1K`).
- `quality` accetta `low`, `medium`, `high`, `xhigh` o `max` ed è predefinito su `high`. `aspect_ratio` accetta `auto` e 14 rapporti fissi ed è predefinito su `16:9`.
### Doppiaggio
- [Crea progetto di doppiaggio](/docs/it/api-reference/dubbing/create-project) - `POST /v1/dubbing/project`
- `keyterms` multipart accetta campi ripetuti o un singolo array JSON.
- `webhook_ids` multipart accetta campi ripetuti, un singolo array JSON o una stringa separata da virgole.
- [Ottieni risorsa del workspace](/docs/it/api-reference/workspace/resources/get), [Condividi risorsa del workspace](/docs/it/api-reference/workspace/resources/share) e [Annulla condivisione risorsa del workspace](/docs/it/api-reference/workspace/resources/unshare)
- `WorkspaceResourceType` aggiunge `dubbing_project`.
### Knowledge base
- [Crea job di crawling](/docs/it/api-reference/knowledge-base/create-crawl-job) - `POST /v1/convai/knowledge-base/crawl`
- Deprecato `max_depth` (intero, predefinito `3`). Il campo ora non ha effetto e non presenta più vincoli minimi o massimi.
- I metadati del job di crawling non richiedono più `max_depth`.
### Utente
- [Ottieni utente](/docs/it/api-reference/user/get) e [Ottieni abbonamento](/docs/it/api-reference/user/subscription/get)
- Gli enum delle valute aggiungono `gbp`.
## Modifiche allo schema
### Text to Speech
- I messaggi WebSocket `audio` e `final` multi-contesto ora definiscono `is_final_audio_for_turn` come emesso dopo che tutti i byte nel buffer del turno sono stati forniti.
## September 14, 2026
### ElevenAgents
- **Accodamento delle chiamate e audio di attesa**: Aggiunto l'[accodamento delle chiamate](/docs/it/eleven-agents/guides/call-queueing) per gli agenti al limite di concorrenza. I chiamanti in coda sentono l'audio di attesa e ricevono eventi `queue_status` finché non vengono ammessi o scade il tempo di attesa. Nuovi metodi API consentono di caricare o eliminare audio di attesa personalizzato.
- **Metadati delle versioni di test**: I risultati dei test degli agenti ora identificano la versione dell'agente su cui sono stati eseguiti e se includevano modifiche in bozza. I riepiloghi delle invocation indicano inoltre quando i reinvii parziali sono stati eseguiti su versioni diverse.
- **Metadati di modelli e account**: La configurazione LLM degli agenti ora accetta `gemini-3.8-flash`. Le risposte degli account WhatsApp identificano se l'account usa la Cloud API o il flusso di registrazione in coesistenza.
### Musica
- **Supporto API Music v2.5**: Gli endpoint e gli SDK Music ora accettano `music_v2_5`. I chunk di generazione dei piani di composizione supportano fino a 6.132 caratteri, con un massimo di 30 righe da 200 caratteri ciascuna.
### Rilasci SDK
#### SDK JavaScript
- [v2.68.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.68.0) - Aggiunti metodi per caricare ed eliminare l'audio di attesa degli agenti. Rigenerati i tipi per l'accodamento delle chiamate, i riferimenti alle procedure, la creazione di rami in bozza, i limiti delle query RAG, i metadati delle versioni di test, `gemini-3.8-flash` e `music_v2_5`.
#### SDK Python
- [v2.68.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.68.0) - Aggiunti metodi sincroni e asincroni per caricare ed eliminare l'audio di attesa degli agenti. Rigenerati i tipi per l'accodamento delle chiamate, le procedure, la creazione di rami in bozza, i limiti delle query RAG, i metadati delle versioni di test, `gemini-3.8-flash` e `music_v2_5`. Il wrapper `compose_detailed` ora accetta ogni ID di modello musicale generato e piani di composizione basati sia su prompt sia su chunk.
#### SDK iOS
- [v3.3.1](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.1) - Riconcilia i messaggi degli agenti in base a `response_id` anziché a `event_id`, preservando più risposte attorno alle chiamate degli strumenti ed evitando che parti in streaming o correzioni vengano associate al messaggio sbagliato.
#### CLI ElevenLabs
- [v1.3.0](https://github.com/elevenlabs/cli/releases/tag/v1.3.0) - Aggiunti metadati facoltativi `--intent` ai comandi API generati. Aggiunto `elevenlabs feedback missing-capability` per segnalare workflow non supportati dalla CLI.
#### Pacchetti
- [@elevenlabs/convai-widget-core@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.2) e [@elevenlabs/convai-widget-embed@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.2) - Corrette le risposte duplicate degli agenti dopo chiamate di strumenti e procedure. Le risposte testuali in streaming mantengono la formattazione Markdown e le conversazioni vocali non visualizzano più parti della chat in streaming non pronunciate. Il pacchetto embed limita inoltre gli eventi `user_activity` a uno al secondo e rimuove il limite al termine di una sessione.
### API
## Nuovi endpoint
### ElevenAgents
- [Carica audio di attesa dell'agente](/docs/it/api-reference/agents/hold-audio/create) - `POST /v1/convai/agents/{agent_id}/hold-audio`
- Accetta `hold_audio_file` obbligatorio (binario) come dati del form multipart. Il file deve essere MP3 o WAV, fino a 40 MB e 180 secondi.
- Restituisce `agent_id` obbligatorio (stringa) e `hold_audio` (`AgentHoldAudioConfig`). L'oggetto hold-audio richiede `audio_path`, `audio_url`, `original_filename` (stringhe), `duration_secs` (numero) e `size_bytes` (intero).
- [Elimina audio di attesa dell'agente](/docs/it/api-reference/agents/hold-audio/delete) - `DELETE /v1/convai/agents/{agent_id}/hold-audio`
- Rimuove la clip personalizzata, così i chiamanti in coda sentono il tono di attesa predefinito.
- Restituisce `agent_id` obbligatorio (stringa).
## Endpoint aggiornati
### ElevenAgents
- [Crea agente](/docs/it/api-reference/agents/create), [Ottieni agente](/docs/it/api-reference/agents/get) e [Aggiorna agente](/docs/it/api-reference/agents/update)
- Aggiunto `platform_settings.queueing_config` (`AgentQueueingConfig`) facoltativo con `enabled` (booleano, predefinito `false`) e `wait_timeout_seconds` (intero, 1–1.800, predefinito `180`).
- Le risposte di configurazione della coda includono `hold_audio` (`AgentHoldAudioConfig`) nullable di sola lettura. Le risposte dell'agente includono anche `default_hold_audio_url` facoltativo (stringa).
- [Ottieni conversazione](/docs/it/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}`
- I metadati aggiungono `queue_wait_secs` facoltativo e nullable (numero). Il tempo in coda è escluso da `call_duration_secs` e dal tempo fatturato.
- [Crea ramo dell'agente](/docs/it/api-reference/agents/branches/create) - `POST /v1/convai/agents/{agent_id}/branches`
- Aggiunto `include_draft` facoltativo (booleano, predefinito `false`). Quando è `true`, un ramo creato dalla punta del ramo include il set di procedure in bozza del chiamante.
- [Elenca procedure](/docs/it/api-reference/agents/procedures/list) e gli endpoint per creare, ottenere e gestire le bozze delle procedure
- Gli elementi dell'elenco aggiungono `referenced_tool_ids`, `referenced_kb_ids`, `referenced_procedure_ids` e `referenced_dynamic_variables` facoltativi (array di stringhe).
- Le risposte dell'agente e di anteprima del merge aggiungono `procedures` facoltativo, una mappa con chiave ID della procedura.
- [Elenca invocation di test](/docs/it/api-reference/tests/test-invocations/list) - `GET /v1/convai/test-invocations`
- Aggiunto `search` facoltativo e nullable (stringa) per filtrare test e cartelle per nome.
- [Esegui test sull'agente](/docs/it/api-reference/tests/run-tests) e [Ottieni invocation di test](/docs/it/api-reference/tests/test-invocations/get)
- Le risposte di invocation della suite di test e di esecuzione dei test unitari aggiungono `version_id` facoltativo e nullable (stringa) e `ran_against_draft` facoltativo (booleano, predefinito `false`).
- I riepiloghi delle invocation aggiungono anche `runs_diverged_from_version` facoltativo (booleano, predefinito `false`).
- `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query`
- Il body della richiesta aggiunge gli override specifici della query `max_documents_length` facoltativo e nullable (intero, 1–50.000) e `max_retrieved_rag_chunks_count` (intero, 1–20).
- [Ottieni account WhatsApp](/docs/it/api-reference/whats-app/accounts/get) - `GET /v1/convai/whatsapp-accounts/{phone_number_id}`
- Aggiunto `account_type` facoltativo (`WhatsAppAccountType`, predefinito `cloud_api`). I valori sono `cloud_api` e `coexistence`.
- [Calcola l'utilizzo LLM previsto](/docs/it/api-reference/agents/calculate) - `POST /v1/convai/agent/{agent_id}/llm-usage/calculate`
- `LLMUsageCalculatorLLMResponseModel` aggiunge `price_per_message` obbligatorio (numero).
### Musica
- `MusicModelID` aggiunge `music_v2_5` per `POST /v1/music/video-to-music`, `POST /v1/music/plan`, [Componi musica](/docs/it/api-reference/music/compose), `POST /v1/music/detailed`, `POST /v1/music/detailed/stream`, `POST /v1/music/stream`, `POST /v1/music/upload` e `POST /v1/music/finetunes`.
- `GenerationChunk.text` aumenta `maxLength` da 6.000 a 6.132 caratteri per `POST /v1/music/plan`, `POST /v1/music`, `POST /v1/music/detailed`, `POST /v1/music/detailed/stream`, `POST /v1/music/stream` e `POST /v1/music/upload`. I nomi delle sezioni possono contenere da 1 a 100 caratteri e i chunk possono contenere fino a 30 righe con 200 caratteri per riga.
## Modifiche allo schema
### ElevenAgents
- Gli eventi del server in tempo reale aggiungono `queue_status`. Il relativo `queue_status_event.status` obbligatorio accetta `waiting`, `admitted` o `timed_out`; `timed_out` precede il codice di chiusura WebSocket `4300`. L'audio di attesa continua ad arrivare come normali eventi `audio`.
- L'enum `LLM` aggiunge `gemini-3.8-flash`, inclusi gli override per l'avvio della conversazione.
- Le union dei risultati degli strumenti di sistema delle conversazioni aggiungono `start_procedure_success`, `start_procedure_error`, `end_procedure_success` e `end_procedure_error`.
- `FeaturesUsageCommonModel` aggiunge gli stati delle funzionalità facoltativi `freeform_procedure` e `structured_procedure`.
## September 11, 2026
### Scribe v2 Medical
[Scribe v2 Medical](/docs/it/overview/models#scribe-v2-medical) è ora generalmente disponibile. È un modello di riconoscimento vocale batch specializzato in audio medico e clinico, fatturato alla stessa tariffa di Scribe v2.
Passa `scribe_v2_medical` come `model_id` in [Crea trascrizione](/docs/it/api-reference/speech-to-text/convert). I prompt con termini chiave, il rilevamento delle entità, la diarizzazione dei parlanti e la modalità non letterale funzionano come in Scribe v2.
ID del modello, funzionalità e quando usare Scribe v2 Medical.
Trascrivi l'audio con `model_id` impostato su `scribe_v2_medical`.
## September 7, 2026
### ElevenAgents
- **Ticket delle conversazioni per tutto il workspace**: aggiunto [Elenca ticket del workspace](/docs/it/api-reference/triage-tickets/list-for-workspace) per recuperare i ticket di triage delle conversazioni dagli agenti accessibili. Filtra per stato o assegnatario e usa la paginazione con cursore per recuperare fino a 100 ticket per pagina.
- **Filtri delle conversazioni per variabili dinamiche**: [Elenca conversazioni](/docs/it/api-reference/conversations/list) e [Ricerca testuale nei messaggi delle conversazioni](/docs/it/api-reference/conversations/messages/text-search) ora accettano filtri ripetibili `dynamic_variable_params`. Usa `name:op:value` con `eq`, `gt`, `gte`, `lt` o `lte`; gli operatori di confronto richiedono valori numerici.
- **Rilevamento della segreteria telefonica Twilio**: le configurazioni per telefonia in uscita e chiamate batch ora supportano `twilio_machine_detection` facoltativo. Scegli `enable` per una valutazione tempestiva di persona o segreteria, oppure `detect_message_end` per attendere la fine del messaggio di saluto della segreteria. I risultati arrivano tramite il nuovo evento webhook `answering_machine_detection`.
- **Vincoli sui valori per la raccolta dati**: le proprietà di raccolta dati ora possono usare `allowed_values` per indicare una variabile dinamica contenente i valori consentiti. Il precedente campo `allowed_values_dynamic_variable` è deprecato.
- **Metadati dell'agente**: le risposte di [Elenca rami dell'agente](/docs/it/api-reference/agents/branches/list) ora indicano quando è stata creata una bozza e se precede il tip del ramo. I riepiloghi dell'agente e del motore vocale ora richiedono `voice_id`.
- **URL di origine della knowledge base**: i chunk delle query RAG dell'agente ora includono `source_url` obbligatorio e annullabile, contenente l'URL tracciato per i documenti URL.
- **Allegati nelle risposte dell'agente**: gli eventi WebSocket `agent_response` ora includono `attachments` facoltativo. Ogni allegato richiede `url` e `name` e può includere `mime_type`.
### Workspace
- **Limiti della piattaforma per le chiavi API**: le risposte delle chiavi API degli account di servizio ora possono includere `platform_limits` Enterprise per crediti, Clonazioni Vocali Professionali e concorrenza per TTS, Doppiaggio e Musica.
### Rilasci degli SDK
#### SDK JavaScript
- [v2.67.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.67.0) - Aggiunto `dynamicVariableParams` alle richieste di elenco e ricerca testuale delle conversazioni. Rigenerati i tipi per il rilevamento della segreteria telefonica Twilio, i vincoli sui valori per la raccolta dati, i limiti della piattaforma per le chiavi API, i metadati delle bozze dei rami dell'agente e gli URL di origine della knowledge base.
#### SDK Python
- [v2.67.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.67.0) - Aggiunto `dynamic_variable_params` ai metodi sincroni e asincroni di elenco e ricerca testuale delle conversazioni. Rigenerati i tipi per il rilevamento della segreteria telefonica Twilio, i vincoli sui valori per la raccolta dati, i limiti della piattaforma per le chiavi API, i metadati delle bozze dei rami dell'agente e gli URL di origine della knowledge base. Il client Text to Speech in tempo reale non passa più il sentinel interno di omissione alla connessione.
#### CLI ElevenLabs
- [v1.2.0](https://github.com/elevenlabs/cli/releases/tag/v1.2.0) - Aggiunto il comando `elevenlabs say` e la relativa skill dell'agente, rigenerati i binding dei comandi API e reso `eleven_v3` il modello TTS predefinito.
#### Pacchetti
- [@elevenlabs/client@1.25.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.25.0), [@elevenlabs/react@1.15.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.15.2), [@elevenlabs/react-native@1.2.27](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.27), [@elevenlabs/convai-widget-core@0.18.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.1) e [@elevenlabs/convai-widget-embed@0.18.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.1) - Riesportato `MessageAttachment` da `@elevenlabs/client` affinché i consumer possano importare direttamente il tipo.
- [@elevenlabs/client@1.24.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.24.0), [@elevenlabs/types@0.23.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.23.0), [@elevenlabs/react@1.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.15.1), [@elevenlabs/react-native@1.2.26](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.26), [@elevenlabs/convai-widget-core@0.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.0) e [@elevenlabs/convai-widget-embed@0.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.0) - Inoltrati gli allegati dei file nelle risposte dell'agente a `onMessage` e aggiunta l'impostazione di sessione facoltativa `webRtc.singlePeerConnection`. Il widget localizza inoltre i pulsanti di saluto e corregge le risposte della chat testuale perse o duplicate.
### API
## Nuovi endpoint
### ElevenAgents
- [Elenca ticket del workspace](/docs/it/api-reference/triage-tickets/list-for-workspace) - `GET /v1/convai/triage-tickets`
- Elenca i ticket di triage delle conversazioni per tutti gli agenti a cui il chiamante può accedere, ordinati prima per data di creazione più recente.
- Aggiunti i parametri query facoltativi `page_size` (numero intero, 1–100, valore predefinito `100`), `status` (`AgentConversationTicketStatus`), `assignee_user_id` (stringa o `unassigned`) e `cursor` (stringa).
- Restituisce `GetAgentConversationTicketsPageResponseModel`.
## Endpoint aggiornati
### ElevenAgents
- [Elenca conversazioni](/docs/it/api-reference/conversations/list) - `GET /v1/convai/conversations`
- Aggiunto `dynamic_variable_params` facoltativo e annullabile (array di stringhe ripetibile). Ogni valore usa `name:op:value`, dove `op` è `eq`, `gt`, `gte`, `lt` o `lte`.
- [Ricerca testuale nei messaggi delle conversazioni](/docs/it/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
- Aggiunto `dynamic_variable_params` facoltativo e annullabile (array di stringhe ripetibile) con la stessa sintassi.
- [Chiamata Twilio in uscita](/docs/it/api-reference/twilio/outbound-call), [Chiamata in uscita tramite trunk SIP](/docs/it/api-reference/sip-trunk/outbound-call), [Chiamata Exotel in uscita](/docs/it/api-reference/exotel/outbound-call) e [Invia chiamate batch](/docs/it/api-reference/batch-calling/submit)
- `telephony_call_config` ora usa schemi di input e output separati.
- Aggiunto `twilio_machine_detection` facoltativo e annullabile (`TwilioMachineDetectionConfig`). Il relativo `mode` accetta `enable` o `detect_message_end` e il valore predefinito è `enable`. L'impostazione viene ignorata per i provider non Twilio e le chiamate in entrata.
- [Importa numero di telefono](/docs/it/api-reference/phone-numbers/create) - `POST /v1/convai/phone-numbers`
- Aggiunto `account_auth_token` facoltativo e annullabile (stringa) per le importazioni di chiavi API Twilio, al fine di convalidare le firme dei webhook in entrata.
## Modifiche agli schemi
### ElevenAgents
- `WebhookEventType` aggiunge `answering_machine_detection`.
- `AgentBranchSummary` aggiunge `draft_created_at` facoltativo e annullabile (numero intero) e `draft_is_behind_tip` facoltativo (booleano, valore predefinito `false`).
- `AgentKnowledgeBaseRagChunkResponseModel` aggiunge `source_url` obbligatorio e annullabile (stringa).
- `AgentSummaryResponseModel` e `SpeechEngineSummaryResponse` aggiungono `voice_id` obbligatorio (stringa).
- `AnalysisProperty` aggiunge `name` facoltativo e annullabile (stringa) e `allowed_values` (`AllowedValues`). Anche `LiteralJsonSchemaProperty` aggiunge `allowed_values`. Entrambi deprecano `allowed_values_dynamic_variable`.
- `DataCollectionResultCommonModel` aggiunge `name` facoltativo e annullabile (stringa).
- `WorkspaceApiKeyResponseModel` aggiunge `platform_limits` facoltativo e annullabile (`PlatformLimits`).
- Lo strumento MCP `Icon` aggiunge `theme` facoltativo e annullabile (`light` o `dark`).
- `SMBToolConfig` aggiunge le varianti di parametri `send_custom_email`, `create_service_quote_request` e `create_product_quote_request`.
- Gli schemi dei parametri query dei webhook e la configurazione delle chiamate telefoniche ora usano modelli di input e output separati.
- Gli eventi WebSocket `agent_response` aggiungono `attachments` facoltativo (array). Ogni elemento richiede `url` e `name` (stringhe) e accetta `mime_type` facoltativo (stringa).
### ElevenCreative
- `ReferenceVideo.studio_clip` ora usa `StudioClipLocator` invece di `StudioClipReference`. I campi e il formato wire restano invariati.
## August 31, 2026
### 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/` 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
## 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`.
## August 24, 2026
import { YoutubeEmbed } from "../../../components/YoutubeEmbed";
### CLI di ElevenLabs
La [CLI di ElevenLabs v1.0.0](https://github.com/elevenlabs/cli/releases/tag/v1.0.0) è ora disponibile. Ogni operazione dell'API di ElevenLabs è disponibile come sottocomando, con output JSON, tabella, YAML e CSV, paginazione automatica e completamento della shell.
La CLI offre anche workflow di configurazione locale per ElevenAgents. Archivia le configurazioni di agenti, strumenti e test come file, sincronizzale con i comandi push e pull, gestisci i branch, esegui test, installa componenti dell'interfaccia utente di ElevenLabs e seleziona una regione di residenza dei dati.
Installa la CLI, autentica l'accesso e gestisci gli agenti come codice.
### Procedure
Le procedure sono ora generalmente disponibili in ElevenAgents. Una procedura contiene istruzioni specifiche per un'attività e un trigger che determina quando applicarle. Durante una conversazione, l'agente carica la procedura pertinente, consentendo a un unico agente di gestire attività distinte senza inserire ogni istruzione nel relativo system prompt.
Usa procedure in formato libero quando l'agente può adattare la formulazione o l'ordine delle istruzioni. Usa procedure strutturate quando i passaggi devono essere eseguiti in un ordine definito. Entrambi i tipi possono essere usati insieme ai workflow sullo stesso agente.
Scopri quando usare le procedure e come si confrontano con prompt e workflow.
Scrivi istruzioni in linguaggio naturale che l'agente può adattare alla conversazione.
Definisci passaggi tipizzati che l'agente segue in un ordine coerente.
### ElevenAgents
- **Ticket di triage delle conversazioni**: aggiunte API per creare ticket sul rendimento degli agenti, creare ticket manuali di follow-up, elencare i ticket, assegnare membri del workspace, aggiornare stato e assegnatario e aggiungere commenti a livello di ticket o di turno.
- **Osservabilità delle conversazioni**: i client realtime possono ricevere un evento `context_usage` dopo ogni turno dell'agente completato. L'evento riporta il modello, il numero di token del prompt e il limite di contesto del modello.
### Release degli SDK
#### SDK JavaScript
- [v2.65.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.65.0) - Aggiunti client e tipi per i ticket di triage delle conversazioni e i riepiloghi leggeri delle conversazioni. Le API delle conversazioni aggiungono filtri per procedura, chiamata di strumento non valida e ordinamento; le API delle procedure aggiungono la selezione della versione dell'agente; le API degli argomenti aggiungono controlli sui dettagli della valutazione e l'ordinamento per frustrazione. La release aggiunge anche la frequenza di aggiornamento della knowledge base, l'ambiente di test e i campi di integrazione degli avvisi, oltre ai tipi di messaggio per il doppiaggio realtime.
#### SDK Python
- [v2.65.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.65.0) - Aggiunti client e tipi per i ticket di triage delle conversazioni e i riepiloghi leggeri delle conversazioni. Le API delle conversazioni aggiungono filtri per procedura, chiamata di strumento non valida e ordinamento; le API delle procedure aggiungono la selezione della versione dell'agente; le API degli argomenti aggiungono controlli sui dettagli della valutazione e l'ordinamento per frustrazione. La release aggiunge anche la frequenza di aggiornamento della knowledge base, l'ambiente di test e i campi di integrazione degli avvisi, e preserva i campi multipart ripetuti per `keyterms` di Speech to Text e `webhook_ids` di Dubbing.
#### SDK Swift
- [v3.3.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.0) - Aggiunti il parsing tipizzato degli errori del client, la gestione di `expects_response` e risultati degli strumenti type-safe. L'avvio di WebRTC è ora pronto quando l'agente si unisce, invece di attendere la sottoscrizione della traccia audio. La release migliora inoltre la gestione degli URL, sopprime il rumore degli eventi sconosciuti e rimuove l'allocazione del thread realtime dall'elaborazione del silenziamento software.
#### Pacchetti
- [@elevenlabs/client@1.19.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.19.1), [@elevenlabs/react@1.12.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.3), [@elevenlabs/react-native@1.2.21](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.21), [@elevenlabs/convai-widget-core@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.2) e [@elevenlabs/convai-widget-embed@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.2) - L'acquisizione dell'output WebRTC usa ora path AudioWorklet self-hosted con policy di sicurezza dei contenuti rigorose. La cache dei worklet include la sorgente richiesta, impedendo che un precedente URL inline sostituisca un path self-hosted. Gli errori di configurazione di React Native ora rimandano a `@elevenlabs/react-native`.
- [@elevenlabs/client@1.20.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.20.0), [@elevenlabs/react@1.12.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.4), [@elevenlabs/react-native@1.2.22](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.22), [@elevenlabs/convai-widget-core@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.3) e [@elevenlabs/convai-widget-embed@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.3) - Aggiunto `webRtc.iceTransportPolicy` opzionale. Impostalo su `relay` per limitare i candidati ICE WebRTC ai relay TURN nelle reti che bloccano il traffico UDP diretto.
- [@elevenlabs/client@1.21.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.21.0), [@elevenlabs/react@1.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.13.0), [@elevenlabs/types@0.21.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.21.1), [@elevenlabs/react-native@1.2.23](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.23), [@elevenlabs/convai-widget-core@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.4) e [@elevenlabs/convai-widget-embed@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.4) - Aggiunti il callback `onContextUsage` e il tipo `ContextUsageEvent`. React espone il callback tramite `useConversation`. React Native ora effettua la risoluzione tramite la condizione di export del pacchetto anziché tramite il rilevamento delle variabili globali del browser.
- [@elevenlabs/client@1.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.22.0), [@elevenlabs/react@1.14.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.14.0), [@elevenlabs/types@0.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.22.0), [@elevenlabs/react-native@1.2.24](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.24), [@elevenlabs/convai-widget-core@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.17.0) e [@elevenlabs/convai-widget-embed@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.17.0) - Aggiunti contenuti avanzati nel primo messaggio con risposte ai pulsanti attribuite, `onExternalAgentDisconnected` e `onMCPToolApprovalRequest`. WebRTC ora usa il dispositivo di input selezionato, mantiene lo stato di silenziamento quando cambi microfono e non completa la configurazione se non è possibile inviare i dati di avvio. Il widget aggiunge lo stato della coda di concorrenza, la selezione opzionale della lingua nel trigger compresso e il rendering del primo messaggio per gli agenti che supportano sia testo sia voce.
### API
## Nuovi endpoint
### ElevenAgents
- Aggiunti nove endpoint per i ticket di triage delle conversazioni:
- [Crea ticket di conversazione](/docs/it/api-reference/triage-tickets/create-agent-conversation-ticket-route) - `POST /v1/convai/triage-tickets`. La richiesta richiede `conversation_id` (stringa) e accetta `qa_comment` (stringa nullable, 1–10.000 caratteri) e fino a 200 commenti sui turni.
- [Elenca ticket](/docs/it/api-reference/triage-tickets/list-agent-conversation-tickets-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets`, con paginazione tramite cursore.
- [Crea ticket manuale](/docs/it/api-reference/triage-tickets/create-manual-agent-ticket-route) - `POST /v1/convai/agents/{agent_id}/triage-tickets`. La richiesta richiede `qa_comment` (stringa, 1–10.000 caratteri).
- [Elenca utenti assegnabili](/docs/it/api-reference/triage-tickets/get-assignable-users-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users`. La risposta elenca i membri del workspace che non sono account di servizio e indica se ciascun membro ha accesso all'agente.
- [Ottieni ticket](/docs/it/api-reference/triage-tickets/get-agent-conversation-ticket-route) - `GET /v1/convai/triage-tickets/{agentqa_ticket_id}`.
- [Aggiorna ticket](/docs/it/api-reference/triage-tickets/update-agent-conversation-ticket-route) - `PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}`. La richiesta accetta `status` facoltativo e `assignee_user_id` nullable.
- [Elimina ticket](/docs/it/api-reference/triage-tickets/delete-agent-conversation-ticket-route) - `DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}`.
- [Aggiungi commento](/docs/it/api-reference/triage-tickets/add-ticket-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments`. La richiesta richiede `comment` (stringa, 1–10.000 caratteri).
- [Aggiungi commento al turno](/docs/it/api-reference/triage-tickets/add-turn-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments`. La richiesta richiede `turn_index` con indice a base zero (intero) e `comment` (stringa, 1–10.000 caratteri).
## Endpoint aggiornati
### ElevenAgents
- [Ottieni URL firmato](/docs/it/api-reference/conversations/get-signed-url) - `GET /v1/convai/conversation/get-signed-url`
- Aggiunto `debug_events_request` facoltativo (booleano, valore predefinito `false`). Gli eventi di debug richiedono l'accesso editor all'agente.
- [Ottieni token WebRTC](/docs/it/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token`
- Aggiunto `debug_events_request` facoltativo (booleano, valore predefinito `false`). Il percorso legacy `GET /v1/convai/conversation/get_signed_url` accetta lo stesso parametro.
- [Elenca conversazioni](/docs/it/api-reference/conversations/list) - `GET /v1/convai/conversations`
- Aggiunto `triggered_procedure_ids` facoltativo (array di stringhe nullable, massimo 50) per trovare le conversazioni in cui è stata eseguita una qualsiasi procedura specificata.
- Aggiunto `include_invalid_tool_calls` facoltativo (booleano, valore predefinito `false`) per includere le chiamate di strumenti che non sono state eseguite.
- Aggiunto `sort_direction` facoltativo (`asc` o `desc`, valore predefinito `desc`) per l'ora di inizio della chiamata.
- [Ricerca testuale nei messaggi delle conversazioni](/docs/it/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
- Aggiunto `triggered_procedure_ids` facoltativo (array di stringhe nullable, massimo 50).
- Aggiunto `include_invalid_tool_calls` facoltativo (booleano, valore predefinito `false`).
- [Ottieni argomenti delle conversazioni dell'agente](/docs/it/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
- Aggiunto `include_evaluation_criteria` facoltativo (booleano, valore predefinito `true`).
- Aggiunto `frustration` a `sort_by`.
- Le risposte degli argomenti aggiungono `success_rate` nullable (numero), mentre la risposta complessiva aggiunge `aggregated_run_count` (intero, valore predefinito `0`).
- `from_unix_secs` viene arrotondato per difetto all'inizio del relativo giorno UTC. Un intervallo delimitato aggrega le esecuzioni di rilevamento giornaliere completate; omettendo entrambi i limiti viene restituita l'esecuzione più recente.
- [Elenca procedure](/docs/it/api-reference/agents/procedures/list) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`) e [Ottieni procedura](/docs/it/api-reference/agents/procedures/get) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`)
- Aggiunto `agent_version_id` facoltativo nullable (stringa) per recuperare procedure da una versione specifica dell'agente.
- [Crea test](/docs/it/api-reference/tests/create) e [Aggiorna test](/docs/it/api-reference/tests/update)
- Aggiunto `environment` facoltativo nullable (stringa) agli schemi di test unitari di risposta, simulazione e chiamata di strumento. Il valore seleziona URL, header e connessioni di autenticazione specifici dell'ambiente; il valore predefinito è `production`.
- [Crea documento da URL](/docs/it/api-reference/knowledge-base/create-from-url), [Crea job di crawling](/docs/it/api-reference/knowledge-base/create-crawl-job) e [Crea cartella](/docs/it/api-reference/knowledge-base/create-folder)
- Aggiunto `minimum_frequency_days` facoltativo nullable (intero, 1–180) per la sincronizzazione automatica. Il valore predefinito è `7` e ha la precedenza una frequenza più rigorosa della cartella principale.
### Musica
- [Elenca Finetune musicali](/docs/it/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
- Aumentato il valore massimo di `page_size` da 100 a 150. Il valore predefinito rimane 50.
## Modifiche allo schema
### ElevenAgents
- Le richieste di aggiornamento degli agenti aggiungono `procedures` facoltativo nullable (`object`). Ogni valore richiede `procedure_id` e `version_id` (stringhe). Un oggetto vuoto rimuove tutte le procedure.
- La configurazione di avvio della conversazione aggiunge `enable_procedure_ids_from_client` (booleano, valore predefinito `false`). I dati di avvio aggiungono `procedure_ids` facoltativo nullable (array di stringhe); un array vuoto disabilita tutte le procedure per l'agente iniziale.
- `ClientEvent` aggiunge `context_usage`.
- Gli override del soft timeout aggiungono `additional_soft_timeout_messages` facoltativo nullable (array di stringhe).
- I valori costanti nei modelli di override dell'analisi e dello schema ora accettano `null`.
- I valori predefiniti della configurazione del widget per `mic_muting_enabled` e `transcript_enabled` sono cambiati da `false` a `true`. Impostali esplicitamente su `false` per mantenere il comportamento precedente.
### Workspace
- Le risposte di [Ottieni utente](/docs/it/api-reference/user/get) hanno rimosso `xi_api_key` da `UserResponseModel`.
- `ResourceMetadataResponseModel.role_to_group_ids` ora accetta ID di ruolo personalizzati come chiavi, anziché limitare le chiavi a `admin`, `editor`, `commenter` e `viewer`.
- Le risposte di pubblicazione diretta aggiungono `restricted_to_user_email_domains` facoltativo nullable (array di stringhe).
- Le risposte al cambio di abbonamento in attesa aggiungono `go` a `next_tier`.
## August 22, 2026
### Server MCP
- **Server MCP locale deprecato**: Il [server MCP di ElevenLabs](https://github.com/elevenlabs/elevenlabs-mcp) locale e l'[MCP player](https://github.com/elevenlabs/elevenlabs-mcp-player) sono deprecati a favore del [server MCP ospitato](/docs/it/eleven-agents/operate/hosted-mcp). Entrambi i repository sono archiviati e non riceveranno più aggiornamenti. Il server ospitato è disponibile all'indirizzo `https://api.elevenlabs.io/v1/mcp`, consente di accedere con il tuo account ElevenLabs tramite OAuth e non richiede installazione locale né chiave API. Consulta la [documentazione del server MCP ospitato](/docs/it/eleven-agents/operate/hosted-mcp) per le istruzioni di configurazione per Claude, Cursor e altri client MCP.
## August 17, 2026
### ElevenCreative
- **API di generazione di immagini, video e voce**: Le nuove API Flows asincrone creano, elencano e recuperano generazioni di video, immagini e voce. Le risposte di generazione espongono gli stati `pending`, `generating`, `completed` e `failed`, mentre le richieste possono includere una destinazione webhook per gli eventi di completamento.
- **Asset multimediali riutilizzabili**: Le nuove API degli asset caricano, elencano, recuperano ed eliminano contenuti multimediali del workspace. I riferimenti a immagini, video e audio possono utilizzare un asset caricato, una generazione precedente o dati base64 inline, consentendo di concatenare i job di generazione. Consulta [Riferimenti e asset](/docs/it/eleven-api/guides/how-to/image-and-video/references).
### ElevenAgents
- **Riepiloghi delle conversazioni leggeri**: [Ottieni il riepilogo della conversazione](/docs/it/api-reference/conversations/get-summary) restituisce il titolo generato, il riepilogo della trascrizione, l'esito della chiamata e semplici messaggi dell'utente o dell'agente senza caricare la trascrizione completa. Il parametro query facoltativo `max_messages` è un intero da 1 a 200 (predefinito `40`); nelle conversazioni più lunghe `messages_omitted` è impostato su `true`. Utile per gli agenti che devono preservare il contesto.
- **Paginazione e ordinamento degli argomenti delle conversazioni**: [Ottieni gli argomenti delle conversazioni dell'agente](/docs/it/api-reference/conversations/topics/get) aggiunge paginazione e ordinamento facoltativi tramite cursore. Usa `page_size` (intero, 1–100), `cursor` (stringa), `sort_by` (`conversations`, `sentiment` o `success_rate`) e `sort_direction` (`asc` o `desc`). Le risposte aggiungono `has_more` e `next_cursor` annullabile.
- **Code di attesa per la concorrenza**: Le impostazioni della piattaforma dell'agente aggiungono `queueing` facoltativo (`AgentQueueingConfig`). Imposta `enabled` su `true` per mettere in attesa i chiamanti quando l'agente raggiunge il limite di concorrenza; `wait_timeout_seconds` è un intero fino a 1.800 (predefinito `180`).
- **Controlli dei turni e dei workflow**: La configurazione dei turni aggiunge `merge_with_default_ignore_terms` (booleano, predefinito `false`) per combinare i termini personalizzati di ignoramento delle interruzioni con quelli predefiniti selezionati. I soft timeout aggiungono `disable_until_first_user_message` (booleano, predefinito `false`) e i locator degli strumenti workflow aggiungono `schema_overrides` facoltativo per gli override dei parametri per nodo.
- **Valori predefiniti dell'audio di sottofondo**: Il valore predefinito di `BackgroundSoundConfig.volume` ora è `0.15` anziché `0.6`, mentre quello di `crossfade_loop` ora è `true` anziché `false`. Imposta esplicitamente questi campi per mantenere il comportamento precedente.
### Rilasci SDK
#### SDK JavaScript
- [v2.64.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.64.0) - Aggiunto `client.assets` per caricare, elencare, recuperare ed eliminare asset, oltre a `client.flows` per la generazione asincrona di video, immagini e voce. La configurazione dei turni aggiunge `mergeWithDefaultIgnoreTerms`. Rimossi `CustomToolApiSchemaConfig` e `scimExternalId` da `WorkspaceGroupResponseModel`.
#### SDK Python
- [v2.64.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.64.0) - Aggiunti client per asset e Flows per la generazione asincrona di video, immagini e voce, oltre a `merge_with_default_ignore_terms` nella configurazione dei turni. La configurazione delle sessioni on-prem aggiunge `extra_setup_config` per passare campi aggiuntivi dei messaggi di configurazione.
#### Pacchetti
- [@elevenlabs/client@1.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.18.0), [@elevenlabs/react@1.12.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.1), [@elevenlabs/types@0.20.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.20.0), [@elevenlabs/react-native@1.2.19](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.19), [@elevenlabs/convai-widget-core@0.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.0) e [@elevenlabs/convai-widget-embed@0.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.0) - Aggiunte sessioni sperimentali di orchestratore self-hosted ed eventi di contenuti avanzati. Gli audio worklet di Scribe ora possono essere self-hosted per policy di sicurezza dei contenuti rigorose. La gestione delle disconnessioni ora raggiunge coerentemente `disconnected` e impedisce che callback tardivi cancellino una sessione più recente. Il widget visualizza risposte rapide e link inline, ripristina Markdown nelle trascrizioni vocali e corregge il posizionamento del menu della lingua nei layout con container query.
- [@elevenlabs/client@1.19.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.19.0), [@elevenlabs/react@1.12.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.2), [@elevenlabs/types@0.21.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.21.0), [@elevenlabs/react-native@1.2.20](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.20) e [@elevenlabs/convai-widget-core@0.16.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.1) - Aggiunte opzioni di Speech to Text in tempo reale per lingue secondarie, rilevamento delle entità e filtraggio dell'audio di sottofondo. Aggiunti eventi per trascrizione finale, entità rilevata e richiesta non valida; allineati i tipi delle parole con timestamp allo schema live; e corretti gli errori nelle autorizzazioni del microfono che impedivano la riconnessione di `useScribe`.
### API
## Nuovi endpoint
### ElevenCreative
- [Crea generazione video](/docs/it/api-reference/flows/video/create) - `POST /v1/flows/video`
- [Elenca generazioni video](/docs/it/api-reference/flows/video/list) - `GET /v1/flows/video`
- [Ottieni generazione video](/docs/it/api-reference/flows/video/get) - `GET /v1/flows/video/{generation_id}`
- [Crea generazione immagine](/docs/it/api-reference/flows/image/create) - `POST /v1/flows/image`
- [Elenca generazioni di immagini](/docs/it/api-reference/flows/image/list) - `GET /v1/flows/image`
- [Ottieni generazione immagine](/docs/it/api-reference/flows/image/get) - `GET /v1/flows/image/{generation_id}`
- [Crea generazione vocale](/docs/it/api-reference/flows/text-to-speech/create) - `POST /v1/flows/text-to-speech`
- [Elenca generazioni vocali](/docs/it/api-reference/flows/text-to-speech/list) - `GET /v1/flows/text-to-speech`
- [Ottieni generazione vocale](/docs/it/api-reference/flows/text-to-speech/get) - `GET /v1/flows/text-to-speech/{generation_id}`
- [Carica asset](/docs/it/api-reference/assets/create) - `POST /v1/assets`
- [Elenca asset](/docs/it/api-reference/assets/list) - `GET /v1/assets`
- [Ottieni asset](/docs/it/api-reference/assets/get) - `GET /v1/assets/{asset_id}`
- [Elimina asset](/docs/it/api-reference/assets/delete) - `DELETE /v1/assets/{asset_id}`
### ElevenAgents
- [Ottieni il riepilogo della conversazione](/docs/it/api-reference/conversations/get-summary) - `GET /v1/convai/conversations/{conversation_id}/summary`
- Accetta `max_messages` facoltativo (intero, 1–200, predefinito `40`)
- Restituisce `GetConversationSummaryResponseModel` con `conversation_id`, `agent_id`, `status`, `message_count` e `note` obbligatori
- I semplici `messages` contengono solo `role` (`user` o `agent`) e `message`; le conversazioni oltre il limite restituiscono `messages_omitted: true`
## Endpoint aggiornati
### ElevenAgents
- [Ottieni il conteggio live](/docs/it/api-reference/analytics/get) - `GET /v1/convai/analytics/live-count`
- Aggiunto `agent_ids` facoltativo (array di stringhe, massimo 25), che ha la precedenza su `agent_id`
- [Ottieni gli argomenti delle conversazioni dell'agente](/docs/it/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
- Aggiunti `page_size` facoltativo (intero, 1–100), `cursor` (stringa), `sort_by` (`conversations`, `sentiment` o `success_rate`) e `sort_direction` (`asc` o `desc`)
- Le risposte aggiungono `has_more` (booleano, predefinito `false`) e `next_cursor` annullabile (stringa)
## Modifiche agli schemi
### ElevenAgents
- Aggiunto `queueing` facoltativo (`AgentQueueingConfig`) alle impostazioni della piattaforma dell'agente. Contiene `enabled` (booleano, predefinito `false`) e `wait_timeout_seconds` (intero maggiore di 0 e al massimo 1.800, predefinito `180`)
- Aggiunto `schema_overrides` facoltativo a `WorkflowToolLocator`; gli override per nodo costanti, con variabili dinamiche, LLM o di omissione hanno la precedenza sugli override a livello di strumento
- Aggiunto `merge_with_default_ignore_terms` (booleano, predefinito `false`) alla configurazione dei turni e agli schemi di override correlati
- Aggiunto `disable_until_first_user_message` (booleano, predefinito `false`) alla configurazione dei soft timeout e agli schemi di override correlati
- Aggiunto `status` obbligatorio in sola lettura (`success`, `error`, `blocked` o `skipped`) agli eventi di risposta degli strumenti dell'agente in tempo reale
- Aggiunti `avaya` alle origini di avvio delle conversazioni e `avaya_api_key` ai metodi di autorizzazione
- Aggiunti `gemini-3.6-flash` e `gemini-3.7-flash` ai valori LLM dell'agente supportati
- Modificato il valore predefinito di `BackgroundSoundConfig.volume` da `0.6` a `0.15` e quello di `crossfade_loop` da `false` a `true`
- Rimosso `CustomToolApiSchemaConfig`; gli utenti degli SDK generati che importano questo tipo devono rimuovere l'importazione
- Rimosso `scim_external_id` da `WorkspaceGroupResponseModel`
## August 10, 2026
import { YoutubeEmbed } from "../../../components/YoutubeEmbed";
### API Dubbing v2
Dubbing v2 è ora disponibile tramite l'API. Traduce audio e video in oltre 90 lingue, preservando la voce, il tono e il ritmo di ogni speaker.
La nuova API basata sui progetti conserva le trascrizioni e le traduzioni di origine come JSON modificabile. Crea un progetto da un file o URL, aggiungi una o più lingue di destinazione, modifica singoli segmenti della trascrizione o traduzioni, quindi rigenera solo le regioni che sono cambiate. Segui la [guida rapida a Dubbing](/docs/it/eleven-api/guides/cookbooks/dubbing) per creare il tuo primo doppiaggio.
Crea il tuo primo progetto Dubbing v2 e genera una traccia audio tradotta.
Modifica le trascrizioni di origine e le traduzioni, quindi rigenera le regioni modificate.
Esplora gli endpoint dei progetti Dubbing, delle lingue e delle trascrizioni.
### ElevenAgents
- **Filtri di guardrail delle conversazioni**: [Elenca conversazioni](/docs/it/api-reference/conversations/list) aggiunge i parametri query facoltativi `guardrail_types` (`GuardrailType[]`) e `custom_guardrail_names` (array di stringhe). La gerarchia di conversazioni esistente può ora essere filtrata con il parametro facoltativo `parent_conversation_id` (stringa).
- **Stato delle divergenze dei branch**: [Elenca branch dell'agente](/docs/it/api-reference/agents/branches/list) aggiunge `include_commit_status` facoltativo (booleano, predefinito `false`). Quando è abilitato, i riepiloghi dei branch includono i campi annullabili `commits_ahead`, `commits_behind` e `merged_into_branch_id`.
- **Controlli di conversazioni e strumenti**: Gli override del client ora supportano `max_duration_seconds` e `pronunciation_dictionary_locators`. La configurazione del server MCP aggiunge `request_meta` per passare valori MCP `_meta` alle chiamate degli strumenti, mentre i timeout degli strumenti webhook ora supportano fino a 300 secondi.
- **Utilizzo dell'analisi post-chiamata**: La fatturazione delle conversazioni aggiunge una ripartizione `analysis` con totali progressivi per funzionalità e snapshot delle esecuzioni. I messaggi della trascrizione aggiungono `triggered_guardrails` e i turni di conversazione aggiungono `producing_llm` facoltativo.
### Voci
- **Filtri di ricerca delle voci**: [Ottieni tutte le voci v2](/docs/it/api-reference/voices/search) aggiunge i parametri query facoltativi `gender`, `age`, `language`, `accent`, `use_cases`, `min_notice_period_days`, `include_custom_rates`, `include_live_moderated` e `high_quality`.
### Rilasci SDK
#### SDK JavaScript
- [v2.63.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.63.0) - Aggiunte opzioni di Speech to Text in tempo reale per lingue secondarie, rilevamento della lingua e delle entità, filtraggio dell'audio di sottofondo, logging e autenticazione con token monouso. Aggiunti eventi per trascrizione finale, entità e richiesta non valida; corretti l'invio di termini non accettati, parametri `audio_format` duplicati e limiti VAD inclusivi.
- [v2.62.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.62.0) - Aggiunti metodi per l'aggiornamento in blocco delle trascrizioni Dubbing e `DubbingRegenerateResponse`; aggiunti filtri di guardrail delle conversazioni, stato dei commit dei branch dell'agente, avvisi dell'agente e supporto per MCP `requestMeta`. La creazione di lingue di destinazione non accetta più `modelId`.
- [v2.61.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.61.0) - Aggiunti filtro della gerarchia di conversazioni, fatturazione dell'analisi post-chiamata, metadati dei guardrail attivati, dettagli dei conflitti di merge dei branch, oscuramento dell'input DTMF e caricamenti di trascrizioni Dubbing. Rimossi i tipi di sessione realtime OpenAI esportati e le varianti di risultato degli strumenti `run_subagent_*`.
#### SDK Python
- [v2.63.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.63.0) - Aggiunte opzioni di Speech to Text in tempo reale per lingue secondarie, rilevamento della lingua e delle entità, filtraggio dell'audio di sottofondo, logging e autenticazione con token monouso. Aggiunti eventi per trascrizione finale, entità e richiesta non valida; corretto l'invio di termini non accettati e ora vengono rifiutate le connessioni senza chiave API o token.
- [v2.62.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.62.0) - Aggiunti metodi Dubbing `update_segments` e `DubbingRegenerateResponse`; aggiunto supporto per `guardrail_types`, `custom_guardrail_names`, `include_commit_status` e MCP `request_meta`. Gli aggiornamenti dei segmenti Dubbing ora utilizzano modelli per il body della richiesta e la creazione di lingue di destinazione non accetta più `model_id`.
- [v2.61.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.61.0) - Aggiunti `parent_conversation_id`, fatturazione dell'analisi, metadati dei guardrail attivati, conflitti di merge dei branch, oscuramento dell'input DTMF e caricamenti di trascrizioni Dubbing. Rimossi i tipi di sessione realtime OpenAI e i modelli di risultato `run_subagent_*`.
#### SDK Android
- [v0.12.1](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.12.1) - Corretto il problema per cui le disconnessioni intenzionali delle sessioni solo testo venivano segnalate come `ConversationStatus.ERROR`.
- [v0.12.0](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.12.0) - Aggiunto `ConversationConfig.useMediaStream` per instradare l'audio delle conversazioni attraverso lo stream multimediale Android. Le normali chiusure WebSocket remote ora segnalano `DisconnectionDetails.Agent`, mentre quelle avviate localmente segnalano `DisconnectionDetails.User`.
#### Server MCP
- [v0.12.2](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.12.2) - Corretto un problema di path traversal.
### API
## Nuovi endpoint
### Dubbing
- [Aggiorna in blocco i segmenti di origine](/docs/it/api-reference/dubbing/source-transcript/batch-update-source-segments) - `PATCH /v1/dubbing/project/{project_id}/transcript/segments`
- Richiede `DubbingBulkSegmentUpdateRequest`
- Aggiorna atomicamente il testo, lo speaker o i tempi dei segmenti di origine
- Restituisce `DubbingBulkSourceSegmentUpdateResponse` con `segments` e `revision` aggiornati
- [Aggiorna in blocco i segmenti di destinazione](/docs/it/api-reference/dubbing/target-transcript/batch-update-target-segments) - `PATCH /v1/dubbing/project/{project_id}/language/{language_id}/transcript/segments`
- Richiede `DubbingBulkTargetSegmentUpdateRequest`
- Aggiorna atomicamente le traduzioni di più segmenti di destinazione
- Restituisce `DubbingBulkTargetSegmentUpdateResponse` con `segments` e `revision` aggiornati
## Endpoint aggiornati
### ElevenAgents
- [Elenca conversazioni](/docs/it/api-reference/conversations/list) - `GET /v1/convai/conversations`
- Aggiunto `parent_conversation_id` facoltativo (stringa)
- Aggiunti `guardrail_types` ripetibile facoltativo (`GuardrailType[]`) e `custom_guardrail_names` facoltativo (array di stringhe)
- [Elenca branch dell'agente](/docs/it/api-reference/agents/branches/list) - `GET /v1/convai/agents/{agent_id}/branches`
- Aggiunto `include_commit_status` facoltativo (booleano, predefinito `false`)
- I riepiloghi dei branch aggiungono `commits_ahead` (intero), `commits_behind` (intero) e `merged_into_branch_id` (stringa) annullabili
### Voci
- [Ottieni tutte le voci v2](/docs/it/api-reference/voices/search) - `GET /v2/voices`
- Aggiunti filtri facoltativi `gender`, `age` e `accent` (stringa)
- Aggiunti filtri facoltativi `language` e `use_cases` (array di stringhe)
- Aggiunti filtri facoltativi `min_notice_period_days` (intero), `include_custom_rates`, `include_live_moderated` e `high_quality` (booleano)
## Modifiche agli schemi
### ElevenAgents
- Gli schemi di override del client aggiungono `max_duration_seconds` (intero) e `pronunciation_dictionary_locators` (array)
- Gli schemi di input e output del server MCP aggiungono mappe `request_meta`
- Le impostazioni della piattaforma dell'agente aggiungono `alerting`; il rilevamento della lingua aggiunge `only_at_conversation_start` (booleano)
- `AnalysisCharging.last_run` ora è obbligatorio e non annullabile; i totali progressivi aggiungono `runs` obbligatorio (intero)
- Le risposte dei chunk RAG ora richiedono `content_format` e `document_type`
## August 3, 2026
### ElevenAgents
- **Mock degli strumenti specifici per test**: le simulazioni degli agenti e i test unitari ora possono definire `tool_mock_overrides`, associati all'ID dello strumento, per sostituire i mock condivisi per un singolo test. `ToolResponseMockConfig` aggiunge anche `is_error` facoltativo (booleano, predefinito `false`) affinché un mock possa testare i percorsi di errore degli strumenti.
- **Messaggi del workflow tradotti**: i messaggi letterali del nodo Say aggiungono `text_translations`, una mappa di chiavi linguistiche a oggetti `TranslatedString`. Il campo è facoltativo in input e obbligatorio in output, quindi i validatori di risposta rigorosi devono accettarlo.
- **Filtri della versione delle conversazioni**: [Elenca conversazioni](/docs/it/api-reference/conversations/list) e [Ricerca testuale nei messaggi delle conversazioni](/docs/it/api-reference/conversations/messages/text-search) aggiungono il parametro query facoltativo `version_id` (stringa) per filtrare i risultati in base alla versione dell'agente.
- **Strumento di sistema della knowledge base**: la configurazione dell'agente aggiunge uno strumento di sistema `knowledge_base` con `enabled_strategies` configurabile (`SearchStrategy[]`). Le query RAG della knowledge base dell'agente aggiungono `use_agent_defaults` facoltativo (booleano, predefinito `true`); impostalo su `false` per usare impostazioni di recupero neutre mantenendo il modello di embedding dell'agente.
- **Rilevamento dell'attività vocale dell'agente**: gli schemi di creazione, aggiornamento, risposta e override del workflow dell'agente aggiungono la configurazione `vad`. `VADConfig` attualmente supporta `background_voice_detection` (booleano, predefinito `false`).
- **LLM personalizzati WebSocket**: `CustomLLMAPIType` aggiunge `websocket`.
- **Controlli della memoria dei file**: la configurazione dell'input file del widget aggiunge `max_files_in_memory` (intero, 1–30, predefinito `10`). I file oltre il limite vengono riepilogati e rimossi dalla memoria; `max_files_per_conversation` deve essere `-1` o almeno il limite di memoria.
- **Oscuramento dell'input DTMF**: `DTMFInputConfig` aggiunge `redact_input` facoltativo (booleano, predefinito `false`) per sostituire le cifre della tastiera del chiamante nelle trascrizioni, nei log delle conversazioni e nelle analisi. Le cifre ripetute dall'agente o passate agli strumenti rimangono invariate.
### Speech to Text
- **Rilevamento di entità in tempo reale**: Scribe v2 Realtime aggiunge l'opzione query `entity_detection`. Accetta `all`, un tipo o una categoria di entità, oppure un array di tipi e categorie, ed emette le entità rilevate negli eventi `committed_transcript_entities`. Consulta la [guida al rilevamento delle entità](/docs/it/eleven-api/guides/how-to/speech-to-text/batch/entity-detection) per le categorie supportate.
### Voci
- **Replica delle voci tra diverse residenze dei dati**: aggiunto `POST /v1/voices/{voice_id}/replicate-to-isolated-environment` per copiare una voce Instant Voice Clone o Voice Design in un workspace nello stesso gruppo di fatturazione consolidato. Le richieste richiedono `target_workspace_id` (stringa) e accettano `preserve_voice_id` (booleano, predefinito `true`); le risposte restituiscono il `voice_id` di destinazione.
- **Metadati dei personaggi**: le risposte dei personaggi aggiungono `recommended_voice_ids` (array di stringhe, predefinito `[]`), i metadati aggiungono `role` nullable (`CharacterRole`) e `CharacterAge` sostituisce `middle-aged` con `middle_aged`.
### Rilasci SDK
#### Pacchetti
- [@elevenlabs/client@1.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.16.0), [@elevenlabs/react@1.11.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.11.0), [@elevenlabs/types@0.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.18.0), [@elevenlabs/react-native@1.2.17](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.17) e [@elevenlabs/convai-widget-core@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.0) - Aggiunto `onAgentReasoningResponsePart`, che riceve eventi di ragionamento dell'agente in streaming con tipi `start`, `delta` e `stop`.
- [@elevenlabs/convai-widget-core@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.0) e [@elevenlabs/convai-widget-embed@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.15.0) - Aggiunti `show_resize_button` e l'attributo embed `show-resize-button`. Imposta uno dei due su `false` per nascondere il controllo di espansione e compressione nell'header del widget.
- [@elevenlabs/client@1.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.17.0), [@elevenlabs/react@1.12.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.0), [@elevenlabs/types@0.19.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.19.0), [@elevenlabs/react-native@1.2.18](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.18) e [@elevenlabs/convai-widget-core@0.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.1) - Aggiunta l'opzione `enableLogging` a `Scribe.connect` e `useScribe`. Impostarla su `false` avvia una sessione enterprise a conservazione zero. Il tipo Scribe `session_started` ora riporta `enable_logging`; il campo inutilizzato `disable_logging` è stato rimosso.
#### Server MCP
- [v0.12.1](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.12.1) - Include gli aggiornamenti degli strumenti v0.11 e un aggiornamento delle dipendenze che risolve 44 avvisi di sicurezza.
- [v0.11.0](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.11.0) - Aggiunto `simulate_conversation` con comportamento dell'utente simulato configurabile, criteri di valutazione, output della trascrizione e analisi di superamento/non superamento. Lo strumento `speech_to_text` ora usa `scribe_v2` per impostazione predefinita e `voice_clone` ora invia il contenuto dei file audio anziché stringhe di path.
### API
## Nuovi endpoint
### Voci
- `POST /v1/voices/{voice_id}/replicate-to-isolated-environment`
- Replica una voce Instant Voice Clone o Voice Design nell'ambiente isolato di un altro workspace
- Richiede `target_workspace_id` (stringa)
- Accetta `preserve_voice_id` facoltativo (booleano, predefinito `true`)
- Restituisce `voice_id` obbligatorio (stringa)
## Endpoint aggiornati
### ElevenAgents
- [Elenca conversazioni](/docs/it/api-reference/conversations/list) - `GET /v1/convai/conversations`
- Aggiunto il parametro query facoltativo `version_id` (stringa)
- [Ricerca testuale nei messaggi delle conversazioni](/docs/it/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
- Aggiunto il parametro query facoltativo `version_id` (stringa)
- `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query`
- Aggiunto il campo della richiesta facoltativo `use_agent_defaults` (booleano, predefinito `true`)
## Modifiche allo schema
### ElevenAgents
- I payload di simulazione e test unitari aggiungono mappe `tool_mock_overrides` facoltative; `ToolResponseMockConfig` aggiunge `is_error` facoltativo (booleano, predefinito `false`)
- `SayNodeLiteralMessage` aggiunge `text_translations` (mappa di `TranslatedString`); il campo è facoltativo in input e obbligatorio in output
- La configurazione dell'agente aggiunge `knowledge_base` (`KnowledgeBaseToolConfig`) e `vad` (`VADConfig`)
- `CustomLLMAPIType` aggiunge `websocket`
- `FileInputConfig` aggiunge `max_files_in_memory` (intero, 1–30, predefinito `10`)
- `DTMFInputConfig` aggiunge `redact_input` facoltativo (booleano, predefinito `false`)
- La configurazione dell'agente in tempo reale ora usa `eleven_realtime_v1_mini` per impostazione predefinita
### Voci
- Le risposte dei personaggi aggiungono `recommended_voice_ids` (array di stringhe, predefinito `[]`)
- I metadati dei personaggi aggiungono `role` nullable (`CharacterRole`)
- Modifica incompatibile: `CharacterAge` sostituisce `middle-aged` con `middle_aged`; i client che inviano il vecchio valore devono eseguire la migrazione
### Text to Speech
- Modifica incompatibile: rimossi `AudioFilterId` e `audio_filter` dagli schemi di configurazione Text to Speech di ElevenAgents
## July 27, 2026
### ElevenAgents
- **Override di branch e ambiente per WhatsApp**: i [messaggi WhatsApp in uscita](/docs/it/api-reference/whats-app/outbound-message) e le [chiamate in uscita](/docs/it/api-reference/whats-app/outbound-call) ora rispettano `branch_id` e `environment` passati in `conversation_initiation_client_data`. Gli override vengono convalidati prima di inviare qualsiasi cosa: un branch o ambiente sconosciuto viene rifiutato con un errore e gli override persistono per tutta la conversazione, quindi la risposta di un cliente riprende nel [branch](/docs/it/eleven-agents/operate/versioning) e nell'[ambiente](/docs/it/eleven-agents/integrate/environment-variables) richiesti. Consulta la [guida a WhatsApp](/docs/it/eleven-agents/whatsapp) per alcuni esempi.
- **API delle procedure**: aggiunte otto operazioni pubbliche con ambito di branch per gestire le [procedure](/docs/it/eleven-agents/customization/procedures). Puoi creare, elencare, recuperare e rimuovere procedure; creare, recuperare o scartare modifiche in bozza; e compilare bozze di procedure in un workflow dell'agente. La creazione di procedure accetta `name`, `content`, `type` e `trigger`. Un `trigger` vuoto crea una sottoprocedura, mentre un trigger omesso o `null` viene derivato dal contenuto della procedura.
- **Job di crawl della knowledge base**: aggiunte API per creare, elencare, ispezionare e annullare job di crawl. Le richieste di creazione richiedono `url` (stringa) e supportano profondità di crawl, limiti di pagine, pattern URL, URL delle sitemap, inserimento in cartelle, sincronizzazione automatica e rimozione dei documenti non disponibili.
- **Gestione in blocco della knowledge base**: aggiunti [controlli delle dipendenze in blocco](/docs/it/api-reference/knowledge-base/dependent-agents-multiple) e [eliminazione in blocco](/docs/it/api-reference/knowledge-base/bulk-delete) per 1–20 ID univoci di documenti o cartelle. I controlli delle dipendenze supportano la paginazione e `dependent_type`; l'eliminazione restituisce un risultato di successo o errore indipendente per ogni ID. Impostando `force: true` rimuovi anche le dipendenze ed elimini ricorsivamente le cartelle non vuote.
- **Esportazione dei risultati delle chiamate batch**: aggiunto [Esporta risultati delle chiamate batch](/docs/it/api-reference/batch-calling/export) per scaricare come CSV i destinatari e i risultati delle conversazioni di un batch terminato.
- **Filtri delle conversazioni e dati di analisi**: [Elenca conversazioni](/docs/it/api-reference/conversations/list) e [Ricerca testuale nei messaggi delle conversazioni](/docs/it/api-reference/conversations/messages/text-search) aggiungono i filtri facoltativi con array `visited_agent_ids` e `visited_agent_branch_ids`, ciascuno limitato a 50 valori. Le richieste di elenco accettano anche `data_collection_ids` e `evaluation_criteria_ids` per includere i risultati corrispondenti in ogni riepilogo della conversazione. I riepiloghi aggiungono `data_collection_results`, `evaluation_criteria_results` e `tag_ids` facoltativi.
- **Configurazione dell'analisi referenziata**: le impostazioni della piattaforma dell'agente aggiungono il campo facoltativo e nullable `analysis_items`, di tipo `AgentAnalysisItems`, per collegare elementi di valutazione e raccolta dati per riferimento. Un valore `null` indica che l'agente utilizza ancora i campi inline legacy; un valore vuoto indica un agente migrato senza elementi collegati.
- **Metadati delle dipendenze delle procedure**: i riferimenti alle procedure aggiungono `trigger` (stringa) e array per `referenced_tool_ids`, `referenced_kb_ids`, `referenced_procedure_ids` e `referenced_dynamic_variables`.
- **Risposta del token WebRTC**: le risposte di [Ottieni token WebRTC](/docs/it/api-reference/conversations/get-webrtc-token) ora richiedono `conversation_id` (stringa) oltre a `token`. Si tratta di una modifica incompatibile dello schema per i client che convalidano o deserializzano la struttura della risposta.
- **Risultati RAG della knowledge base**: `KnowledgeBaseRagToolResultModel` aggiunge `chunks` (`KnowledgeBaseRagChunkModel[]`) per la modalità risultato RAG nel risultato dello strumento.
### Studio
- **Stato del progetto in bozza**: `ProjectCreationMetaResponseModel.status` aggiunge `draft`. Il tipo di creazione del progetto ora utilizza l'enum condiviso `ProjectCreationMetaType` con gli stessi valori esistenti.
### Voci
- **Accenti vocali**: aggiunto `GET /v1/voices/accents` per elencare gli accenti disponibili nella libreria vocale condivisa. I risultati possono essere filtrati in base a `language` e `model_id`, e ogni accento restituisce `accent`, `language`, `code` e `name` leggibile. Il valore `accent` può essere passato al parametro query `accent` in [Ottieni voci condivise](/docs/it/api-reference/voices/voice-library/get-shared) per filtrare le voci condivise.
### Workspace
- **Report sull'utilizzo dei webhook**: `WebhookUsageType` aggiunge `Flows`.
### Rilasci SDK
#### SDK JavaScript
- [v2.60.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.60.0) - Aggiunto `voices.accents.get` per elencare gli accenti vocali nella libreria vocale condivisa, insieme alle API per procedure di ElevenAgents, job di crawl della knowledge base e gestione in blocco, nonché alla configurazione dell'analisi referenziata dello schema più recente.
#### SDK Python
- [v2.60.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.60.0) - Aggiunte le API per accenti vocali, procedure di ElevenAgents, job di crawl della knowledge base e gestione in blocco dello schema più recente. Corretto anche l'avvio di `AsyncConversation`, che non blocca più, e i campi multipart con elenchi di primitive, che ora vengono inviati come campi del form ripetuti.
#### Pacchetti
- [@elevenlabs/client@1.15.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.15.2) - Corretto `onAudioAlignment` sui trasporti WebRTC inoltrando i metadati di allineamento dai messaggi audio e mantenendo la riproduzione audio sulla traccia LiveKit.
- [@elevenlabs/react@1.10.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.10.2), [@elevenlabs/react-native@1.2.16](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.16), [@elevenlabs/convai-widget-core@0.14.12](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.12) e [@elevenlabs/convai-widget-embed@0.14.12](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.12) - Dipendenze aggiornate per includere la correzione dell'allineamento WebRTC da `@elevenlabs/client@1.15.2`.
### API
## Nuovi endpoint
### ElevenAgents
- `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`
- Crea una procedura e restituisce il relativo `procedure_id` (stringa)
- Accetta `name` facoltativo (stringa, massimo 200 caratteri), `content` (stringa), `type` (`ProcedureType`, predefinito `free_form`) e `trigger` (stringa nullable)
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`
- Elenca le procedure del branch con `procedure_id`, `version_id`, `name`, `type`, `trigger` e `has_draft`
- Esclude il contenuto delle procedure; recupera una singola procedura per leggerne il contenuto
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`
- Accetta `version_id` facoltativo (stringa); altrimenti restituisce la versione alla testa del branch
- Restituisce `name`, `content`, `type` e `trigger`
- `DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`
- Rimuove la procedura dal set di lavoro in bozza del branch
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft`
- Restituisce la bozza corrente della procedura
- `PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft`
- Crea o aggiorna una bozza
- Richiede `name` (stringa, massimo 200 caratteri), `content` (stringa, massimo 50.000 caratteri) e `type` (`ProcedureType`); accetta `trigger` facoltativo (stringa nullable)
- `DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft`
- Scarta le modifiche alla bozza e ripristina la procedura alla versione salvata
- `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/compile`
- Compila le bozze delle procedure in un `AgentWorkflowResponseModel`
- [Crea job di crawl](/docs/it/api-reference/knowledge-base/create-crawl-job) - `POST /v1/convai/knowledge-base/crawl`
- Richiede `url` (stringa)
- Accetta `max_depth` facoltativo (intero, 1–5, predefinito `3`), `max_pages` (intero, 1–10.000, predefinito `1000`), `pattern` (stringa), `sitemap_urls` (array di stringhe), `parent_folder_id` (stringa), `enable_auto_sync` (booleano, predefinito `false`) e `auto_remove` (booleano, predefinito `false`)
- [Elenca job di crawl](/docs/it/api-reference/knowledge-base/list-crawl-jobs) - `GET /v1/convai/knowledge-base/crawl`
- Accetta `include_job_ids` facoltativo (array di stringhe), `page_size` (intero, 1–100, predefinito `30`) e `cursor` (stringa)
- [Ottieni job di crawl](/docs/it/api-reference/knowledge-base/get-crawl-job) - `GET /v1/convai/knowledge-base/crawl/{crawl_job_id}`
- [Annulla job di crawl](/docs/it/api-reference/knowledge-base/cancel-crawl-job) - `POST /v1/convai/knowledge-base/crawl/{crawl_job_id}/cancel`
- [Ottieni agenti dipendenti per più documenti](/docs/it/api-reference/knowledge-base/dependent-agents-multiple) - `POST /v1/convai/knowledge-base/dependent-agents`
- Richiede `document_ids` (array di 1–20 stringhe univoche)
- Accetta `dependent_type` facoltativo (`KnowledgeBaseDependentType`, predefinito `all`), `page_size` (intero, 1–100, predefinito `30`) e `cursor` (stringa)
- [Elimina in blocco documenti della knowledge base](/docs/it/api-reference/knowledge-base/bulk-delete) - `POST /v1/convai/knowledge-base/bulk-delete`
- Richiede `document_ids` (array di 1–20 stringhe univoche)
- Accetta `force` facoltativo (booleano, predefinito `false`)
- Restituisce un risultato di successo o errore per ogni ID documento
- [Esporta risultati delle chiamate batch](/docs/it/api-reference/batch-calling/export) - `GET /v1/convai/batch-calling/{batch_id}/export`
- Restituisce come CSV i destinatari e i risultati delle conversazioni del batch terminato
### Voci
- `GET /v1/voices/accents`
- Elenca gli accenti disponibili nella libreria vocale condivisa
- Accetta parametri query facoltativi `language` (stringa) e `model_id` (stringa)
- Ogni accento restituisce `accent`, `language`, `code` e `name`
## Endpoint aggiornati
### ElevenAgents
- [Elenca conversazioni](/docs/it/api-reference/conversations/list) - `GET /v1/convai/conversations`
- Aggiunti i filtri facoltativi con array di stringhe `visited_agent_ids` e `visited_agent_branch_ids`, ciascuno limitato a 50 valori
- Aggiunti gli array di stringhe facoltativi `data_collection_ids` e `evaluation_criteria_ids` per selezionare i risultati di analisi per ogni riepilogo
- I riepiloghi delle risposte aggiungono i campi oggetto facoltativi `data_collection_results` e `evaluation_criteria_results`, oltre all'array di stringhe `tag_ids`
- [Ricerca testuale nei messaggi delle conversazioni](/docs/it/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
- Aggiunti i filtri facoltativi con array di stringhe `visited_agent_ids` e `visited_agent_branch_ids`, ciascuno limitato a 50 valori
- [Ottieni token WebRTC](/docs/it/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token`
- Le risposte ora richiedono `conversation_id` (stringa)
- Modifica incompatibile: i validatori e deserializzatori di risposta rigorosi devono accettare il nuovo campo obbligatorio
## Modifiche allo schema
### ElevenAgents
- Le impostazioni di richiesta e risposta della piattaforma dell'agente aggiungono il campo facoltativo e nullable `analysis_items`, di tipo `AgentAnalysisItems`, per la configurazione di valutazione e raccolta dati referenziata
- I riferimenti alle procedure aggiungono `trigger` (stringa), `referenced_tool_ids` (array di stringhe), `referenced_kb_ids` (array di stringhe), `referenced_procedure_ids` (array di stringhe) e `referenced_dynamic_variables` (array di stringhe)
- `KnowledgeBaseRagToolResultModel` aggiunge `chunks` (`KnowledgeBaseRagChunkModel[]`)
### Studio
- `ProjectCreationMetaResponseModel.status` aggiunge `draft`
- `ProjectCreationMetaResponseModel.type` ora fa riferimento all'enum condiviso `ProjectCreationMetaType`
### Workspace
- `WebhookUsageType` aggiunge `Flows`
## July 20, 2026
### Musica
- **API Music Finetunes**: aggiunto il supporto API per gestire i [Music Finetunes](/docs/it/eleven-creative/products/music/finetunes). Cinque endpoint consentono di creare un Finetune da audio caricato, elencare i Finetune accessibili, recuperare lo stato dell'addestramento, aggiornare metadati e visibilità oppure eliminare un Finetune. Tutti i metodi SDK di generazione musicale ora espongono `finetune_id`.
### ElevenAgents
- **Risolvi riferimenti esterni alle conversazioni**: aggiunto `GET /v1/convai/conversations/resolve` per risolvere l'URL di un messaggio Slack o di un ticket Zendesk in una conversazione. Le richieste richiedono i parametri query `agent_id` e `reference` (stringhe).
- **Interroga le knowledge base degli agenti**: aggiunto `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query` per query RAG in sola lettura sulla knowledge base di un agente. La richiesta richiede `query` (stringa), accetta `branch_id` (stringa) facoltativo e restituisce chunk classificati con metadati di documento, chunk, testo e distanza vettoriale. Questo endpoint è escluso dagli SDK generati.
- **Formati dei contenuti della knowledge base**: le risposte per file, testo e URL della knowledge base aggiungono `content_format` (`html` | `markdown`, valore predefinito `html`) facoltativo.
- **Configurazione vocale dell'agente**: gli schemi di override TTS aggiungono `model_id` (`TTSConversationalModel`) facoltativo e modificabile dal client. Il valore predefinito di `enable_phoneme_tags` passa da `false` a `true`.
- **Cascata LLM di backup più rapida**: il valore predefinito di `cascade_timeout_seconds` passa da 8 a 4 secondi. L'intervallo consentito rimane 2–15 secondi.
- **Origini dei valori dei parametri degli strumenti**: i parametri degli strumenti oggetto ora possono usare `dynamic_variable`, `constant_value` o `is_omitted`, in linea con i controlli scalari e degli array esistenti. Gli override dello schema delle costanti ora accettano array e oggetti arbitrari.
- **Guardrail per la risposta completa**: i guardrail personalizzati aggiungono `evaluate_full_response_only` (booleano, valore predefinito `false`) facoltativo per valutare una volta l'intera risposta non TTS. Questa opzione richiede la modalità di blocco.
- **Registrazione delle chiamate Twilio**: la configurazione delle chiamate di telefonia aggiunge `twilio_call_recording_enabled` (booleano, valore predefinito `false`) facoltativo. Le registrazioni vengono archiviate nell'account Twilio connesso e l'impostazione viene ignorata dagli altri provider.
- **Testo per il caricamento file nel widget**: la configurazione del testo del widget aggiunge etichette e messaggi di errore facoltativi per allegare e rimuovere file, errori di caricamento, tipi non supportati, file troppo grandi, limiti sul numero di file e l'indicatore di digitazione.
- **Stato di sincronizzazione della knowledge base**: le risposte dei file della knowledge base aggiungono `auto_sync_info` e `refresh_status` (`FileRefreshStatus`) facoltativi. Le risposte delle cartelle aggiungono `document_count` (intero) obbligatorio, un conteggio ricorsivo dei documenti non cartella limitato a 1000.
- **Filtri di ricerca testuale delle conversazioni**: [Ricerca testuale nei messaggi della conversazione](/docs/it/api-reference/conversations/messages/text-search) aggiunge i parametri query array `exclude_statuses` e `termination_reasons` facoltativi.
- **Opzioni LLM**: la configurazione LLM dell'agente aggiunge `gpt-5.6-sol`, `gpt-5.6-terra` e `gpt-5.6-luna`. `LLMReasoningEffort` aggiunge `max`.
- **Indicatori di digitazione WhatsApp**: gli schemi di richiesta e risposta dell'account WhatsApp aggiungono `enable_typing_indicator` (booleano) facoltativo.
### Speech to Text
- **Autenticazione batch monouso**: [Converti parlato in testo](/docs/it/api-reference/speech-to-text/convert) aggiunge `token` (stringa) facoltativo come alternativa all'autenticazione tramite chiave API o bearer. Crea il token monouso con `POST /v1/single-use-token/batch_scribe`; scade dopo 15 minuti.
- **Affidabilità del client realtime**: `@elevenlabs/client` ora segnala gli errori di configurazione del microfono e gli errori del server non validi tramite `RealtimeEvents.ERROR`, rilascia le risorse del microfono dopo gli errori di configurazione e la chiusura della connessione e scarta i frame del microfono tardivi dopo lo smantellamento del socket.
### Text to Speech
- **Dizionari di pronuncia archiviati**: [Elenca dizionari di pronuncia](/docs/it/api-reference/pronunciation-dictionaries/list) aggiunge `include_archived` (booleano, valore predefinito `true`) facoltativo.
### Workspace
- **Sottoscrizioni agli eventi webhook**: le richieste [Aggiorna webhook del workspace](/docs/it/api-reference/webhooks/update) aggiungono `events` (`WorkspaceWebhookEventType[]`) facoltativo con `voice_library_removal_notice`, `speech_to_text` e `agent_qa`. Le risposte webhook possono restituire l'elenco degli eventi sottoscritti.
- **Dimensioni delle analisi di utilizzo**: [Ottieni utilizzo del workspace](/docs/it/api-reference/analytics/workspace/usage) aggiunge `surface` e `actor` ai valori di `group_by`.
- **Cancella limiti dell'account di servizio**: [Aggiorna chiave API dell'account di servizio](/docs/it/api-reference/service-accounts/api-keys/update) accetta `character_limit: "clear"` per rimuovere un limite mensile di caratteri, oltre a `"no_update"` e ai valori interi.
- **Riferimenti webhook per gli avvisi**: gli schemi dei notificatori webhook di avviso ora identificano un webhook del workspace con `webhook_id` (stringa) obbligatorio invece di incorporare `url`, `method` e `headers`.
### Rilasci SDK
#### SDK JavaScript
- [v2.59.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.59.0) - Aggiunti metodi `music.finetunes` per elencare, creare, ottenere, aggiornare ed eliminare Music Finetunes. Aggiunte anche la risoluzione dei riferimenti alle conversazioni, il filtro dei dizionari di pronuncia archiviati e i token Speech to Text monouso.
#### SDK Python
- [v2.59.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.59.0) - Aggiunti Music Finetunes e la risoluzione dei riferimenti alle conversazioni dallo schema API più recente. `OnPremInitiationData` aggiunge inoltre configurazioni tipizzate `post_call_transcription_webhook` e `post_call_audio_webhook` con `hmac_secret` facoltativo per webhook post-chiamata firmati.
#### Pacchetti
- [@elevenlabs/client@1.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.15.1) - Migliorata la gestione degli errori di Scribe Realtime e la pulizia del microfono durante gli errori di configurazione, la chiusura da parte del client o del server e i frame audio tardivi.
- [@elevenlabs/react@1.10.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.10.1), [@elevenlabs/react-native@1.2.15](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.15), [@elevenlabs/convai-widget-core@0.14.11](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.11) e [@elevenlabs/convai-widget-embed@0.14.11](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.11) - Aggiornate le dipendenze per includere le correzioni di Scribe Realtime di `@elevenlabs/client@1.15.1`.
#### SDK Android
- [v0.11.1](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.11.1) - Impedito a R8 e ProGuard di offuscare i campi degli eventi WebSocket e WebRTC in uscita, come `text` e `type`.
#### CLI
- [@elevenlabs/cli@0.5.6](https://github.com/elevenlabs/cli/releases/tag/%40elevenlabs%2Fcli%400.5.6) - Aggiornati i template predefiniti degli agenti per usare `scribe_realtime` anziché il provider ASR `elevenlabs` rimosso. I template minimi continuano a usare il valore predefinito del server.
### API
## Nuovi endpoint
### Musica
- [Elenca Music Finetunes](/docs/it/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
- Supporta la paginazione tramite cursore, filtri per visibilità e creatore e l'ordinamento per data di creazione o nome
- [Crea Music Finetune](/docs/it/api-reference/music/finetunes/create) - `POST /v1/music/finetunes`
- Richiede `name` e `primary_genre`
- Accetta fino a 50 file audio, tag, visibilità e `model_id`
- [Ottieni Music Finetune](/docs/it/api-reference/music/finetunes/get) - `GET /v1/music/finetunes/{finetune_id}`
- [Aggiorna Music Finetune](/docs/it/api-reference/music/finetunes/update) - `PATCH /v1/music/finetunes/{finetune_id}`
- Aggiorna `name`, `tags`, `primary_genre` o `visibility`
- [Elimina Music Finetune](/docs/it/api-reference/music/finetunes/delete) - `DELETE /v1/music/finetunes/{finetune_id}`
### ElevenAgents
- `GET /v1/convai/conversations/resolve`
- Richiede i parametri query `agent_id` (stringa) e `reference` (stringa)
- Restituisce `GetConversationResponseModel`
- `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query`
- Richiede `query` (stringa) nel body della richiesta
- Accetta il parametro query `branch_id` (stringa) facoltativo
- Restituisce `AgentKnowledgeBaseRagQueryResponseModel`
- Escluso dagli SDK generati
## Endpoint aggiornati
### ElevenAgents
- [Ricerca testuale nei messaggi della conversazione](/docs/it/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
- Aggiunti i parametri query array `exclude_statuses` e `termination_reasons` facoltativi
### Speech to Text
- [Converti parlato in testo](/docs/it/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
- Aggiunto parametro query `token` (stringa) facoltativo per un token Scribe batch monouso
### Text to Speech
- [Elenca dizionari di pronuncia](/docs/it/api-reference/pronunciation-dictionaries/list) - `GET /v1/pronunciation-dictionaries`
- Aggiunto parametro query `include_archived` (booleano, valore predefinito `true`) facoltativo
### Workspace
- [Aggiorna webhook del workspace](/docs/it/api-reference/webhooks/update) - `PATCH /v1/workspace/webhooks/{webhook_id}`
- Aggiunto campo di richiesta `events` (`WorkspaceWebhookEventType[]`) facoltativo
- [Ottieni utilizzo del workspace](/docs/it/api-reference/analytics/workspace/usage) - `POST /v1/workspace/analytics/query/usage-by-product-over-time`
- Aggiunti `surface` e `actor` all'array `group_by` facoltativo
- [Aggiorna chiave API dell'account di servizio](/docs/it/api-reference/service-accounts/api-keys/update) - `PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}`
- Aggiunto `"clear"` al campo `character_limit` facoltativo
## Modifiche allo schema
### ElevenAgents
- Gli schemi di risposta della knowledge base di ElevenAgents aggiungono `content_format` (`html` | `markdown`, valore predefinito `html`) facoltativo
- Le risposte dei file della knowledge base aggiungono `auto_sync_info` e `refresh_status` (`FileRefreshStatus`) facoltativi
- Le risposte delle cartelle della knowledge base aggiungono `document_count` (intero) obbligatorio
- Gli schemi di override TTS dell'agente aggiungono `model_id` (`TTSConversationalModel`) facoltativo
- `enable_phoneme_tags` TTS dell'agente ora ha valore predefinito `true` anziché `false`
- `cascade_timeout_seconds` dell'LLM di backup ora ha valore predefinito 4 anziché 8 secondi
- La configurazione LLM dell'agente aggiunge `gpt-5.6-sol`, `gpt-5.6-terra` e `gpt-5.6-luna`; `LLMReasoningEffort` aggiunge `max`
- I guardrail personalizzati aggiungono `evaluate_full_response_only` (booleano, valore predefinito `false`) facoltativo
- La configurazione delle chiamate di telefonia aggiunge `twilio_call_recording_enabled` (booleano, valore predefinito `false`) facoltativo
- I parametri degli strumenti oggetto aggiungono `dynamic_variable`, `constant_value` e `is_omitted`; gli override delle costanti accettano valori di array e oggetti arbitrari
- La configurazione del testo del widget aggiunge etichette facoltative per caricamento file e indicatore di digitazione
- Gli schemi dell'account WhatsApp aggiungono `enable_typing_indicator` (booleano) facoltativo
- Gli schemi di simulazione e test aggiungono `AutoGenerationMetadata` e `SimulationLibrarySettings`
### Musica
- Aggiunti schemi di richiesta, risposta, paginazione, visibilità, creatore, stato e motivo dell'errore per Music Finetune
- Tutti gli schemi di richiesta per la generazione musicale espongono `finetune_id` agli SDK generati
### Workspace
- Gli schemi di richiesta e risposta dei webhook del workspace aggiungono `events` (`WorkspaceWebhookEventType[]`) facoltativo
- Gli schemi dei notificatori webhook di avviso usano `webhook_id` (stringa) obbligatorio anziché `url`, `method` e `headers`
## July 13, 2026
### ElevenAgents
- **Analisi del sentiment per agente**: le impostazioni della piattaforma aggiungono `sentiment_analysis` (`SentimentAnalysisSettings`) facoltativo per configurare il punteggio del sentiment post-chiamata per ciascun agente.
- **Traduzione automatica delle trascrizioni**: le impostazioni della piattaforma aggiungono `auto_translate_transcript_to_app_language` (booleano) facoltativo per tradurre nella cronologia le trascrizioni delle conversazioni nella lingua dell'app del visualizzatore.
- **Trasferimenti annidati tra agenti**: i workflow aggiungono operazioni push, pop e replace per i trasferimenti annidati tra agenti, con i controlli `enable_nesting` e `return_when_nested` per tornare a un workflow padre.
- **Rilevamento dei backchannel**: i modelli dei turni utente nelle trascrizioni aggiungono `ignored_as_backchannel` (booleano) facoltativo per contrassegnare gli enunciati filtrati come backchannel.
- **Audio ausiliario della conversazione**: le risposte di [Ottieni conversazione](/docs/it/api-reference/conversations/get) aggiungono il campo obbligatorio `has_auxiliary_audio` (booleano) insieme ai flag audio esistenti.
- **Ambito dell'ambiente MCP**: le route per server e strumenti MCP aggiungono il parametro query `environment` facoltativo (predefinito su production) negli endpoint per elencare strumenti, ottenere uno strumento, creare una configurazione dello strumento e aggiornarla.
- **Override del suono delle chiamate agli strumenti**: gli schemi di override per strumenti e MCP consentono `tool_call_sound: "off"` per disattivare i suoni delle chiamate per singolo strumento, ereditando le impostazioni predefinite del server se non configurato.
- **Instradamento SMS Twilio**: le richieste di importazione dei numeri di telefono Twilio aggiungono `enable_sms` (booleano, attivo per impostazione predefinita) facoltativo per controllare l'instradamento degli SMS in entrata durante la configurazione del numero.
- **Ordinamento per sentiment degli utenti**: [Elenca utenti](/docs/it/api-reference/users/list) aggiunge `sort_direction` facoltativo e supporta l'ordinamento per `average_sentiment_score`.
- **Sincronizzazione esterna della knowledge base**: gli schemi di sincronizzazione esterna rinominano `ExternalSyncType` in `ExternalSyncProvider`, aggiungono enum per trigger e tipo dei job di sincronizzazione con `KbExternalSyncJob`, e le risposte delle cartelle possono includere `active_sync_job` per lo stato di sincronizzazione in corso o finale.
- **Deprecazione dell'impostazione di latenza TTS**: `optimize_streaming_latency` nelle impostazioni TTS dell'agente è contrassegnato come deprecato e documentato come senza effetto.
### Workspace
- **Crea account di servizio**: aggiunto [Crea account di servizio](/docs/it/api-reference/service-accounts/create) (`POST /v1/service-accounts`) con `default_sharing_groups` (`DefaultSharingGroupConfig`) facoltativo per il provisioning programmatico degli account di servizio.
- **Elenca membri del workspace**: aggiunto [Ottieni membri del workspace](/docs/it/api-reference/workspace/members/list) (`GET /v1/workspace/members`), che restituisce voci `WorkspaceMemberResponseModel` con ID utente, email, stato del posto, flag di proprietario e blocco. Gli account di servizio sono esclusi.
- **Limiti di crediti per gli inviti**: i payload di invito al workspace (singoli e in blocco) aggiungono `usage_limit` facoltativo per un limite mensile di crediti per gli invitati.
### Rilasci SDK
#### SDK JavaScript
- [v2.57.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.57.0) - Rigenerato dallo schema OpenAPI più recente con tipi dello strumento di sistema `run_subagent`, impostazioni di analisi del sentiment per agente, modelli di workflow per trasferimenti annidati tra agenti, tipi di sincronizzazione esterna della knowledge base e parametri query MCP `environment`.
- [v2.58.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.58.0) - Rigenerato dallo schema OpenAPI più recente con creazione di account di servizio, elenco dei membri del workspace, `usage_limit` degli inviti, `has_auxiliary_audio` delle conversazioni e tipi di messaggi WebSocket text-to-dialogue multi-contesto.
#### SDK Python
- [v2.57.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.57.0) - Rigenerato dallo schema OpenAPI più recente con modelli dello strumento di sistema `run_subagent`, impostazioni di analisi del sentiment per agente, modelli di workflow per trasferimenti annidati tra agenti, tipi di sincronizzazione esterna della knowledge base e parametri query MCP `environment`.
- [v2.58.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.58.0) - Rigenerato dallo schema OpenAPI più recente con creazione di account di servizio, elenco dei membri del workspace, `usage_limit` degli inviti, `has_auxiliary_audio` delle conversazioni e tipi di messaggi WebSocket text-to-dialogue multi-contesto.
#### Pacchetti
- [@elevenlabs/client@1.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.15.0) - Aggiunto callback `onPing` che espone gli eventi `ping` e il valore stimato `ping_ms` per monitorare la latenza di connessione.
- [@elevenlabs/react@1.10.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.10.0) - Esposto il callback `onPing` di `@elevenlabs/client@1.15.0` negli hook React.
- [@elevenlabs/types@0.17.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.17.1), [@elevenlabs/convai-widget-core@0.14.10](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.10) e [@elevenlabs/convai-widget-embed@0.14.10](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.10) - Dipendenze allineate a `@elevenlabs/client@1.15.0`.
### API
## Nuovi endpoint
### Workspace
- [Crea account di servizio](/docs/it/api-reference/service-accounts/create) - `POST /v1/service-accounts`
- [Ottieni membri del workspace](/docs/it/api-reference/workspace/members/list) - `GET /v1/workspace/members`
## Endpoint aggiornati
### ElevenAgents
- [Ottieni conversazione](/docs/it/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}`
- Aggiunto `has_auxiliary_audio` (booleano) obbligatorio alla risposta
- [Elenca utenti](/docs/it/api-reference/users/list) - `GET /v1/convai/users`
- Aggiunto parametro query `sort_direction` facoltativo
- Aggiunto `average_sentiment_score` come opzione di ordinamento
- [Ottieni strumento](/docs/it/api-reference/tools/get) - `GET /v1/convai/tools/{tool_id}`
- Aggiunto parametro query `environment` facoltativo
- [Elenca strumenti del server MCP](/docs/it/api-reference/mcp/list-tools) - `GET /v1/convai/mcp-servers/{mcp_server_id}/tools`
- Aggiunto parametro query `environment` facoltativo
- [Crea configurazione dello strumento MCP](/docs/it/api-reference/mcp/tool-configuration/create) - `POST /v1/convai/mcp-servers/{mcp_server_id}/tool-configs`
- Aggiunto parametro query `environment` facoltativo
- [Aggiorna configurazione dello strumento MCP](/docs/it/api-reference/mcp/tool-configuration/update) - `PATCH /v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}`
- Aggiunto parametro query `environment` facoltativo
### Workspace
- [Invita utente](/docs/it/api-reference/workspace/invites/create) - `POST /v1/workspace/invites/add`
- Aggiunto `usage_limit` facoltativo per il limite mensile di crediti dell'invitato
- [Invita più utenti](/docs/it/api-reference/workspace/invites/create-batch) - `POST /v1/workspace/invites/add/bulk`
- Aggiunto `usage_limit` facoltativo per il limite mensile di crediti dell'invitato
## Modifiche allo schema
### ElevenAgents
- Strumenti di sistema
- Aggiunto `run_subagent` (`RunSubagentToolConfig`) con array `agents` obbligatorio
- Impostazioni della piattaforma
- Aggiunto `sentiment_analysis` (`SentimentAnalysisSettings`) facoltativo
- Aggiunto `auto_translate_transcript_to_app_language` (booleano) facoltativo
- Workflow
- Aggiunta modellazione `AgentTransfer` annidata con push, pop e replace di `AgentTransferOp`
- Aggiunti flag del workflow `enable_nesting` e `return_when_nested`
- Trascrizioni
- Aggiunto `ignored_as_backchannel` (booleano) facoltativo sui modelli dei turni utente
- Strumenti e MCP
- Aggiunto supporto per l'override `tool_call_sound: "off"` nei modelli di configurazione degli strumenti
- Deprecato `optimize_streaming_latency` nelle impostazioni dell'agente TTS (senza effetto)
- Telefonia
- Aggiunto `enable_sms` (booleano) facoltativo nelle richieste di importazione dei numeri di telefono Twilio
- Knowledge base
- Rinominato `ExternalSyncType` in `ExternalSyncProvider`
- Aggiunti `KbExternalSyncJob`, trigger del job di sincronizzazione ed enum dei tipi
- Aggiunto `active_sync_job` facoltativo nelle risposte delle cartelle
- Sentiment
- Esteso `SentimentAggregate` con conteggi delle finestre recenti e punteggi medi
### Workspace
- Account di servizio
- Aggiunto `WorkspaceCreateServiceAccountResponseModel` per le risposte di creazione
- Aggiunto `default_sharing_groups` facoltativo nelle richieste di creazione
- Membri
- Aggiunto `WorkspaceMemberResponseModel` per le risposte dell'elenco
- Inviti
- Aggiunto `usage_limit` facoltativo nei body delle richieste di invito singolo e in blocco
## July 6, 2026
### Musica
- **Streaming della musica con dettagli**: aggiunto [Stream music with details](/docs/it/api-reference/music/compose-detailed-stream) (`POST /v1/music/detailed/stream`) per lo streaming SSE dell'audio composto insieme a metadati dettagliati, inclusi piano di composizione, metadati del brano, blocchi audio base64 e timestamp delle parole facoltativi tramite `with_timestamps`.
### ElevenAgents
- **Deprecazione della simulazione di conversazioni**: [Simulate conversation](/docs/it/api-reference/agents/simulate-conversation) e [Stream simulate conversation](/docs/it/api-reference/agents/simulate-conversation-stream) sono deprecati a favore di [Create test](/docs/it/api-reference/tests/create) e [Run tests on the agent](/docs/it/api-reference/tests/run-tests).
- **Modalità di interruzione degli strumenti**: `disable_interruptions` è deprecato negli schemi degli strumenti degli agenti e dei server MCP. Usa invece `interruption_mode` (`ToolInterruptionMode`: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`), con override per singolo strumento tramite `interruption_mode` nei modelli di override degli strumenti.
- **Punteggio numerico delle valutazioni**: gli schemi dei criteri di valutazione aggiungono `scoring_mode` facoltativo (`binary` | `numeric_uniform`), `max_score` facoltativo (intero) e `score_instructions` facoltativo (stringa). I risultati delle valutazioni aggiungono `score` numerico facoltativo. I payload di analisi delle conversazioni aggiungono `call_success_score` e `success_score` facoltativi.
- **Ragionamento nelle conversazioni**: i modelli di trascrizione e cronologia aggiungono `reasoning` facoltativo (`ConversationReasoningModel`) e le risposte di trascrizione aggiungono `reasoned` facoltativo (booleano). Gli schemi di prompt dell'agente e LLM aggiungono `enable_reasoning_summary` facoltativo (booleano).
- **Fatturazione della piattaforma per le conversazioni**: i modelli relativi alle conversazioni aggiungono `platform_charge`, `platform_price` e `platform_usage` facoltativi con suddivisione per categoria tramite `PlatformCategory` e `PlatformCategoryUsage`.
- **Metadati dei costi delle conversazioni**: i metadati della cronologia delle conversazioni aggiungono `cost_fiat` obbligatorio in sola lettura (numero, USD).
- **Eventi webhook non oscurati**: `WebhookEventType` aggiunge `unredacted_transcript` e `unredacted_audio` per le sottoscrizioni webhook che richiedono payload non oscurati.
- **Limite UUI per i trasferimenti telefonici nei workflow**: la lunghezza massima di `UUITransferConfig.data` aumenta da 256 a 8192 caratteri per le informazioni User-to-User RFC 7433 nei trasferimenti SIP REFER.
### Motore vocale
- **Bypass dell'autenticazione facoltativo**: gli SDK JavaScript e Python v2.56.0 aggiungono `disableAuth` / `disable_auth` facoltativi nei client WebSocket del Motore vocale. Questa opzione è pensata per integrazioni che proteggono la connessione con altri mezzi, come allowlist IP o header di autenticazione personalizzati, anziché con l'autenticazione tramite chiave API.
### Workspace
- **Monitoraggio degli slot vocali professionali**: i modelli in stile abbonamento aggiungono `professional_voice_slots_used_in_workspace` facoltativo, insieme a `professional_voice_slots_used` chiarito per l'intero gruppo, per una visibilità consolidata della fatturazione.
### ElevenCreative Studio
- **Stile delle didascalie**: i modelli di stile delle didascalie aggiungono campi per sfocatura e raggio del bordo. Gli enum delle animazioni di entrata e uscita aggiungono `slam`, `scale_down` e `slide_in`.
### Rilasci SDK
#### SDK JavaScript
- [v2.56.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.56.0) - Aggiunto `disableAuth` facoltativo nei client WebSocket del Motore vocale. Rigenerato dallo schema OpenAPI più recente con streaming dettagliato della musica, `interruption_mode` degli strumenti, modalità di punteggio delle valutazioni, ragionamento nelle conversazioni e campi di fatturazione della piattaforma.
#### SDK Python
- [v2.56.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.56.0) - Aggiunto `disable_auth` facoltativo nei client WebSocket del Motore vocale. Rigenerato dallo schema OpenAPI più recente con streaming dettagliato della musica, `interruption_mode` degli strumenti, modalità di punteggio delle valutazioni, ragionamento nelle conversazioni e campi di fatturazione della piattaforma.
#### CLI
- [@elevenlabs/cli@0.5.5](https://github.com/elevenlabs/cli/releases/tag/@elevenlabs%2Fcli%400.5.5) - Le richieste di creazione e aggiornamento degli agenti vengono ora inviate come JSON raw per preservare la fedeltà del round-trip della configurazione.
### API
## Nuovi endpoint
### Musica
- [Stream music with details](/docs/it/api-reference/music/compose-detailed-stream) - `POST /v1/music/detailed/stream`
## Endpoint aggiornati
### ElevenAgents
- [Simulate conversation](/docs/it/api-reference/agents/simulate-conversation) - `POST /v1/convai/agents/{agent_id}/simulate-conversation`
- Contrassegnato come deprecato; usa invece [Create test](/docs/it/api-reference/tests/create) e [Run tests on the agent](/docs/it/api-reference/tests/run-tests)
- [Stream simulate conversation](/docs/it/api-reference/agents/simulate-conversation-stream) - `POST /v1/convai/agents/{agent_id}/simulate-conversation/stream`
- Contrassegnato come deprecato; usa invece [Create test](/docs/it/api-reference/tests/create) e [Run tests on the agent](/docs/it/api-reference/tests/run-tests)
## Modifiche agli schemi
### ElevenAgents
- Strumenti e MCP
- Deprecato `disable_interruptions` a favore di `interruption_mode` (`allow`, `disable_during_tool`, `disable_during_tool_and_turn`)
- Aggiunti override `interruption_mode` per singolo strumento nei modelli di override MCP e degli strumenti
- Valutazione e analisi
- Aggiunti `scoring_mode`, `max_score` e `score_instructions` facoltativi nei criteri di valutazione
- Aggiunto `score` numerico facoltativo nei risultati delle valutazioni
- Aggiunti `call_success_score` e `success_score` facoltativi nei payload di analisi delle conversazioni
- Trascrizioni e ragionamento
- Aggiunto `reasoning` facoltativo (`ConversationReasoningModel`) nei modelli di trascrizione e cronologia
- Aggiunto `reasoned` facoltativo (booleano) nelle risposte di trascrizione
- Aggiunto `enable_reasoning_summary` facoltativo (booleano) negli schemi di prompt dell'agente e LLM
- Fatturazione e metadati
- Aggiunti `platform_charge`, `platform_price` e `platform_usage` facoltativi nei modelli delle conversazioni
- Aggiunto `cost_fiat` obbligatorio in sola lettura (USD) nei metadati della cronologia delle conversazioni
- Webhook
- Aggiunti `unredacted_transcript` e `unredacted_audio` a `WebhookEventType`
- Workflow
- Aumentata la lunghezza massima di `UUITransferConfig.data` da 256 a 8192 caratteri
### Workspace
- Fatturazione
- Aggiunto `professional_voice_slots_used_in_workspace` facoltativo nei modelli in stile abbonamento
### ElevenCreative Studio
- Didascalie
- Aggiunti campi per sfocatura e raggio del bordo nei modelli di stile delle didascalie
- Aggiunti i tipi di animazione `slam`, `scale_down` e `slide_in`
## June 29, 2026
### ElevenAgents
- **Anteprime di merge e rebase dei branch**: aggiunti [Preview merged configuration](/docs/it/api-reference/agents/branches/preview) (`GET /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge-preview`) e l'anteprima della configurazione sottoposta a rebase (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase-preview`) per esaminare la configurazione dell'agente unita o sottoposta a rebase prima del commit. Entrambi restituiscono `MergePreviewResponseModel` con la configurazione risultante, `overridden_fields` e `source_identical_to_target`.
- **Metriche di utilizzo dei branch**: le risposte di riepilogo dei branch di [List agent branches](/docs/it/api-reference/agents/branches/list) aggiungono il campo facoltativo `calls_7d` (intero) con il volume di chiamate degli ultimi sette giorni per branch.
- **Stato della connessione di autenticazione**: i modelli di risposta delle connessioni di autenticazione del workspace sostituiscono `OAuthConnectionStatus`, solo OAuth, con `AuthConnectionStatus` condiviso (`active`, `refresh_failed`, `revoked`, `credential_invalid`). Le risposte di autenticazione Bearer, Basic, mTLS, header personalizzato, OAuth, OAuth2 JWT, Slack, URL secret e WhatsApp aggiungono i campi facoltativi `status`, `status_detail` e `status_updated_at`.
- **Filtraggio delle risposte degli strumenti**: gli schemi di configurazione degli strumenti HTTP e degli agenti aggiungono `response_filter` facoltativo per ridurre le risposte degli strumenti prima che raggiungano l'LLM, con `response_filter_mode` e `response_filters` nei modelli di override correlati.
- **Trasferimenti telefonici nei workflow**: i nodi di trasferimento del numero di telefono nei workflow aggiungono `uui` facoltativo (`UUITransferConfig`) per le informazioni User-to-User esadecimali RFC 7433 nei trasferimenti SIP REFER.
- **Assegnazione dell'agente per la telefonia**: gli schemi delle richieste di importazione dei numeri di telefono Twilio, Exotel e SIP trunk aggiungono `agent_id` facoltativo (stringa) per assegnare un agente durante la configurazione del numero.
- **Trascrizione del turno con interruzioni disabilitate**: gli schemi di configurazione dei turni aggiungono `transcribe_on_disabled_interruptions` facoltativo (booleano, valore predefinito `false`) per controllare se il parlato dell'utente viene trascritto quando le interruzioni sono disabilitate.
- **Sentiment delle conversazioni**: gli schemi di riepilogo delle conversazioni aggiungono `sentiment_analysis` facoltativo. I modelli utente delle conversazioni aggiungono `sentiment` facoltativo con riferimenti alle conversazioni frustrate.
### Speech to Text
- **Output multicanale combinato**: [Convert speech to text](/docs/it/api-reference/speech-to-text/convert) aggiunge `multichannel_output_style` facoltativo (`separate` predefinito | `combined`) quando `use_multi_channel` è abilitato. Imposta `combined` per ricevere una singola trascrizione con tutti i canali uniti e ordinati per ora, anziché trascrizioni per canale. Le risposte a livello di parola includono `channel_index` per ogni parola quando la modalità multicanale è attiva.
### Text to Speech
- **Comportamento di `language_code`**: gli schemi delle richieste TTS chiariscono che i valori `language_code` non supportati vengono ignorati anziché rifiutati e che `language_code` non è supportato nei modelli `multilingual_v2`.
### Workspace
- **Policy di disabilitazione delle chiavi API di terze parti**: aggiunto [Set workspace third-party disabling policy](/docs/it/api-reference/api-keys/set-third-party-disabling-policy) (`POST /v1/workspaces/api-keys/third-party-disabling`) per il controllo a livello di workspace della possibilità per i titolari di chiavi API di disabilitare autonomamente le chiavi tramite l'endpoint di disabilitazione di terze parti. I modelli per la creazione, la patch e la risposta delle chiavi API del workspace aggiungono `third_party_disable_allowed` facoltativo (booleano).
- **Aggiornamenti delle connessioni di autenticazione Bearer**: l'unione delle richieste di [Update workspace auth connection](/docs/it/api-reference/workspace/auth-connections/update) aggiunge `UpdateBearerAuthRequest` per gli aggiornamenti delle credenziali dei token Bearer.
- **Autorizzazioni del workspace**: gli enum delle autorizzazioni aggiungono `conversation_privacy_manage` e `synthid_detector`. I modelli dei gruppi del workspace aggiungono `scim_group` facoltativo (stringa).
### Rilasci SDK
#### SDK JavaScript
- [v2.55.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.55.0) - Rigenerato dallo schema OpenAPI più recente con client per le anteprime di merge e rebase dei branch, metriche del volume di chiamate dei branch, campi dello stato della connessione di autenticazione, tipi per il filtraggio delle risposte degli strumenti, output multicanale combinato per Speech to Text e policy di disabilitazione delle chiavi API di terze parti del workspace.
#### SDK Python
- [v2.55.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.55.0) - Rigenerato dallo schema OpenAPI più recente con client per le anteprime di merge e rebase dei branch, metriche del volume di chiamate dei branch, campi dello stato della connessione di autenticazione, modelli per il filtraggio delle risposte degli strumenti, output multicanale combinato per Speech to Text e policy di disabilitazione delle chiavi API di terze parti del workspace.
#### Pacchetti
- [@elevenlabs/client@1.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.13.0) - `sendFeedback(like, eventId?)` accetta un parametro `event_id` facoltativo per valutare un messaggio passato specifico. Ora `canSendFeedback` riflette lo stato della connessione, quindi è possibile inviare feedback per qualsiasi messaggio mentre la sessione è attiva.
- [@elevenlabs/client@1.14.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.14.0) - `sendFeedback` accetta `null` come primo argomento per cancellare il feedback su un evento (`score: null`).
- [@elevenlabs/react@1.8.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.8.0) e [@elevenlabs/react@1.9.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.9.0) - Esposte negli hook React le modifiche per `sendFeedback` per messaggio e per la cancellazione del feedback da `@elevenlabs/client@1.13.0` e `@elevenlabs/client@1.14.0`.
- [@elevenlabs/react-native@1.2.11](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.11) e [@elevenlabs/react-native@1.2.12](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.12) - Allineamento delle dipendenze a `@elevenlabs/client@1.13.0`–`1.14.0` e `@elevenlabs/react@1.8.0`–`1.9.0`.
- [@elevenlabs/types@0.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.16.0), [@elevenlabs/convai-widget-core@0.14.6](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.6)–[0.14.8](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.8) e [@elevenlabs/convai-widget-embed@0.14.6](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.6)–[0.14.8](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.8) - Allineamento delle dipendenze a `@elevenlabs/client@1.13.0`–`1.14.0`.
#### SDK Android
- [v0.10.0](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.10.0) - Esposta la trascrizione dei messaggi riconciliata come `StateFlow`. Deprecati i callback di testo e agente a favore delle varianti con ID evento.
- [v0.11.0](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.11.0) - Aggiunto un callback per i frame audio per l'ispezione audio frame per frame durante le conversazioni.
#### SDK iOS
- [v3.2.2](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.2.2) - Corretta l'implementazione del metodo delegate della stanza LiveKit per una gestione corretta degli eventi della stanza.
### API
## Nuovi endpoint
### ElevenAgents
- `GET /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge-preview` - Anteprima della configurazione unita prima del merge
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase-preview` - Anteprima della configurazione sottoposta a rebase prima del rebase
### Workspace
- `POST /v1/workspaces/api-keys/third-party-disabling` - Imposta la policy di disabilitazione delle chiavi API di terze parti del workspace
## Endpoint aggiornati
### ElevenAgents
- [List agent branches](/docs/it/api-reference/agents/branches/list) - `GET /v1/convai/agents/{agent_id}/branches`
- Le risposte di riepilogo dei branch aggiungono `calls_7d` facoltativo (intero)
- [Preview merged configuration](/docs/it/api-reference/agents/branches/preview) - `GET /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge-preview`
- Restituisce `MergePreviewResponseModel` con la configurazione unita, `overridden_fields` e `source_identical_to_target`
- Anteprima della configurazione sottoposta a rebase - `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase-preview`
- Restituisce `MergePreviewResponseModel` con l'anteprima della configurazione sottoposta a rebase
### Speech to Text
- [Convert speech to text](/docs/it/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
- Aggiunto `multichannel_output_style` facoltativo (`separate` | `combined`) quando `use_multi_channel` è abilitato
- Le risposte a livello di parola includono `channel_index` per parola in modalità multicanale
### Workspace
- [Set workspace third-party disabling policy](/docs/it/api-reference/api-keys/set-third-party-disabling-policy) - `POST /v1/workspaces/api-keys/third-party-disabling`
- Controlla se i titolari di chiavi API possono disabilitare autonomamente le chiavi tramite il flusso di disabilitazione di terze parti
- [Update workspace auth connection](/docs/it/api-reference/workspace/auth-connections/update) - `PATCH /v1/workspace/auth-connections/{auth_connection_id}`
- L'unione delle richieste aggiunge `UpdateBearerAuthRequest`
## Modifiche agli schemi
### ElevenAgents
- Connessioni di autenticazione
- Sostituito `OAuthConnectionStatus` con `AuthConnectionStatus` (`active`, `refresh_failed`, `revoked`, `credential_invalid`)
- Aggiunti `status`, `status_detail` e `status_updated_at` facoltativi nei modelli di risposta delle connessioni di autenticazione
- Strumenti e workflow
- Aggiunto `response_filter` facoltativo nelle configurazioni degli strumenti HTTP e degli agenti
- Aggiunto `uui` facoltativo (`UUITransferConfig`) nei modelli dei workflow relativi ai trasferimenti
- Configurazione dei turni
- Aggiunto `transcribe_on_disabled_interruptions` facoltativo (booleano, valore predefinito `false`)
- Importazioni di telefonia
- Aggiunto `agent_id` facoltativo negli schemi delle richieste di importazione Twilio, Exotel e SIP trunk
- Modelli delle conversazioni
- Aggiunto `sentiment_analysis` facoltativo nei tipi di riepilogo delle conversazioni
- Aggiunto `sentiment` facoltativo nei modelli utente delle conversazioni
### Text to Speech
- Chiarito che `language_code` viene ignorato se non supportato e non è supportato in `multilingual_v2`
### Workspace
- Chiavi API
- Aggiunto `third_party_disable_allowed` facoltativo (booleano) nei modelli di creazione, patch e risposta
- Autorizzazioni
- Aggiunti `conversation_privacy_manage` e `synthid_detector`
- Gruppi
- Aggiunto `scim_group` facoltativo (stringa) nei modelli dei gruppi del workspace
## June 22, 2026
### ElevenAgents
- **Rebase dei branch**: aggiunto `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase` per eseguire il rebase di un branch sull'ultima versione di main, mantenendo le modifiche specifiche del branch. I modelli parent delle versioni dell'agente aggiungono il campo facoltativo `rebased_from_version_id` (string) per tracciare la versione di origine dopo un rebase.
- **Filtraggio delle conversazioni per prodotto**: [Elenca le conversazioni](/docs/it/api-reference/conversations/list) e [Ricerca testuale nei messaggi delle conversazioni](/docs/it/api-reference/conversations/messages/text-search) aggiungono il parametro query facoltativo `conversation_product_type` (`agents` | `speech_engine`) per filtrare i risultati per prodotto. I modelli delle conversazioni introducono `ConversationProduct` per questa distinzione.
- **Filtraggio della terminazione delle conversazioni**: [Elenca le conversazioni](/docs/it/api-reference/conversations/list) aggiunge il parametro query facoltativo `termination_reasons` (array di stringhe) per filtrare le conversazioni in base a come sono terminate.
- **Rilevamento degli argomenti per agente**: le impostazioni della piattaforma di [Crea agente](/docs/it/api-reference/agents/create) e [Aggiorna agente](/docs/it/api-reference/agents/update) aggiungono `topic_discovery` (`TopicDiscoverySettings`) facoltativo per configurare il rilevamento degli argomenti per singolo agente.
- **Configurazione dell'audio di sottofondo**: i modelli di configurazione della piattaforma dell'agente e delle conversazioni aggiungono `background_sound` (`BackgroundSoundConfig`) facoltativo per l'audio ambientale durante le conversazioni.
- **Termini da ignorare per l'interruzione del turno**: gli schemi di configurazione dei turni aggiungono `interruption_ignore_terms` facoltativo (array di stringhe) per disattivare il rilevamento del turno per frasi specifiche.
- **Randomizzazione dei riempitivi per soft timeout**: la configurazione del soft timeout aggiunge `randomize_fillers` facoltativo (boolean) per mescolare i messaggi riempitivi tra i soft timeout. I campi di override del messaggio di soft timeout e del prompt LLM ora supportano le variabili dinamiche.
- **Identificatori utente nelle trascrizioni**: i modelli dei messaggi della trascrizione aggiungono `user_identifier` facoltativo (string) nei messaggi scritti dall'utente.
- **Condizioni di successo delle simulazioni**: gli schemi dei test di simulazione dell'agente aggiungono `success_conditions` facoltativo (array, fino a 30 elementi). Il campo legacy `success_condition` è deprecato a favore della forma array.
- **Limite di ripetizione dei test dell'agente**: [Esegui test sull'agente](/docs/it/api-reference/tests/run-tests) aumenta il valore massimo di `repeat_count` da 20 a 50.
- **Valori consentiti dinamici nello schema degli strumenti**: le proprietà dello schema JSON degli strumenti di ElevenAgents aggiungono `allowed_values_dynamic_variable` facoltativo (string) per le selezioni di valori LLM verificate dal server e provenienti da variabili dinamiche.
- **Documentazione URL firmato del widget**: [Ottieni widget](/docs/it/api-reference/widget/get) aggiorna la documentazione di `conversation_signature` con un riferimento a `/v1/convai/conversation/get_signed_url`.
### Musica
- **Formati di output di qualità superiore**: [Genera musica](/docs/it/api-reference/music/compose), [Genera musica dettagliata](/docs/it/api-reference/music/compose-detailed) e [Trasmetti musica in streaming](/docs/it/api-reference/music/stream) aggiungono `mp3_48000_240` e `mp3_48000_320` ai valori `output_format` supportati. Quando `output_format` è `auto`, i modelli v2 ora usano per impostazione predefinita `mp3_48000_192` anziché `mp3_48000_128`.
- **Chiarimento del flag sulla durata delle sezioni**: `respect_sections_durations` si applica solo con `composition_plan` su `music_v1`. Su `music_v2`, le durate delle sezioni vengono sempre applicate e questo flag viene ignorato.
- **Suddivisione dello schema del piano di composizione**: il campo `composition_plan` della richiesta musicale usa un'unione `oneOf` di `MusicPrompt` e `CompositionPlan`. Il primo viene usato per i piani di composizione `music_v1`, il secondo per `music_v2`.
### Doppiaggio
- **Filtri dell'elenco progetti**: [Elenca i doppiaggi](/docs/it/api-reference/dubbing/list) aggiunge i parametri query array facoltativi `dubbing_statuses`, `dubbing_models`, `target_language_codes` e `creation_sources` per elenchi filtrati. Il parametro `order_by` ora accetta `name` oltre a `created_at`.
### Workspace
- **Motivi di blocco e disattivazione**: i modelli del workspace e della chiave API aggiungono `LockReason` e i campi facoltativi `disable_reason`. Le impostazioni dei gruppi del workspace aggiungono `scim_frozen` facoltativo (boolean) per lo stato di blocco gestito da SCIM.
### ElevenCreative Studio
- **Animazioni delle didascalie**: le enum delle animazioni di entrata e uscita delle didascalie di Studio aggiungono `pop`, `slide_up` e `slide_down`.
### Rilasci SDK
#### SDK JavaScript
- [v2.54.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.54.0) - Rigenerato dallo schema OpenAPI più recente con supporto client per il rebase dei branch, filtri `conversation_product_type` e `termination_reasons` per l'elenco e la ricerca testuale delle conversazioni, filtri multivalore per l'elenco dei doppiaggi, tipi `output_format` specifici per la musica, impostazioni di rilevamento degli argomenti e rimozione dei tipi esportati relativi al coaching.
- [v2.53.1](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.53.1) - Ripristinati i valori facoltativi nei record `DynamicVariablesConfig` che erano stati erroneamente limitati in v2.53.0.
#### SDK Python
- [v2.54.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.54.0) - Rigenerato dallo schema OpenAPI più recente con supporto client per il rebase dei branch, filtri per l'elenco e la ricerca testuale delle conversazioni, filtri multivalore per l'elenco dei doppiaggi, aggiornamenti del formato di output musicale, impostazioni di rilevamento degli argomenti e rimozione dei tipi esportati relativi al coaching. `ElevenLabs` e `AsyncElevenLabs` ora accettano il pass-through di `headers` e `follow_redirects` al client di base.
#### Pacchetti
- [@elevenlabs/client@1.12.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.12.0) - Aggiunto il supporto per `overrides.asr.keywords` nel client del browser, così da poter inviare il biasing delle parole chiave ASR per singola conversazione tramite `conversation_initiation_client_data`.
- [@elevenlabs/react@1.7.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.7.0) - Esposto `includeLanguageDetection` per le sessioni Scribe in tempo reale, incluso il supporto di React `useScribe` per richiedere e leggere i metadati della lingua rilevata.
- [@elevenlabs/react-native@1.2.9](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.9), [@elevenlabs/types@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.15.0), [@elevenlabs/convai-widget-core@0.14.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.4) e [@elevenlabs/convai-widget-embed@0.14.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.4) - Allineamento delle dipendenze a `@elevenlabs/client@1.12.0` e `@elevenlabs/types@0.15.0`.
- [@elevenlabs/client@1.12.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.12.1) - Esposto l'helper per il caricamento dei file dall'entrypoint interno di Unity.
- [@elevenlabs/react@1.7.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.7.1), [@elevenlabs/react-native@1.2.10](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.10), [@elevenlabs/convai-widget-core@0.14.5](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.5) e [@elevenlabs/convai-widget-embed@0.14.5](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.5) - Allineamento delle dipendenze a `@elevenlabs/client@1.12.1`.
#### Server MCP
- [v0.10.0](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.10.0) - Aggiunti il modello e gli endpoint Music v2, annotazioni degli strumenti MCP per tutti i 24 strumenti, supporto per Python 3.14, residenza dei dati a Singapore, alias abbreviati per la residenza UE/IN, gestione della chiusura graduale per le disconnessioni del client e correzioni per la creazione delle anteprime vocali e la risoluzione del path della directory di output.
### API
## Nuovi endpoint
### ElevenAgents
- `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase` - Esegue il rebase di un branch sull'ultima versione di main, mantenendo le modifiche specifiche del branch
## Endpoint aggiornati
### ElevenAgents
- [Elenca le conversazioni](/docs/it/api-reference/conversations/list) - `GET /v1/convai/conversations`
- Aggiunto il parametro query facoltativo `conversation_product_type` (`agents` | `speech_engine`)
- Aggiunto il parametro query facoltativo `termination_reasons` (array di stringhe)
- [Ricerca testuale nei messaggi delle conversazioni](/docs/it/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
- Aggiunto il parametro query facoltativo `conversation_product_type` (`agents` | `speech_engine`)
- [Ottieni widget](/docs/it/api-reference/widget/get) - `GET /v1/convai/agents/{agent_id}/widget`
- Aggiornata la documentazione di `conversation_signature` con un riferimento a `/v1/convai/conversation/get_signed_url`
- [Esegui test sull'agente](/docs/it/api-reference/tests/run-tests) - `POST /v1/convai/agents/{agent_id}/run-tests`
- Aumentato il valore massimo di `repeat_count` da 20 a 50
### Doppiaggio
- [Elenca i doppiaggi](/docs/it/api-reference/dubbing/list) - `GET /v1/dubbing`
- Aggiunti i parametri query facoltativi `dubbing_statuses`, `dubbing_models`, `target_language_codes` e `creation_sources`
- `order_by` ora accetta `name` oltre a `created_at`
### Musica
- [Genera musica](/docs/it/api-reference/music/compose), [Genera musica dettagliata](/docs/it/api-reference/music/compose-detailed) e [Trasmetti musica in streaming](/docs/it/api-reference/music/stream)
- Aggiunti `mp3_48000_240` e `mp3_48000_320` ai valori `output_format` supportati
- Il formato di output `auto` seleziona `mp3_48000_192` per i modelli v2 (in precedenza `mp3_48000_128`)
## Modifiche agli schemi
### ElevenAgents
- Branch e versioni degli agenti
- Aggiunto `rebased_from_version_id` facoltativo nei modelli parent delle versioni dell'agente
- Configurazione della piattaforma e delle conversazioni
- Aggiunto `topic_discovery` facoltativo (`TopicDiscoverySettings`) nei modelli di richiesta e risposta delle impostazioni della piattaforma
- Aggiunto `background_sound` facoltativo (`BackgroundSoundConfig`)
- Configurazione di turni e timeout
- Aggiunto `interruption_ignore_terms` facoltativo (array di stringhe) negli schemi di configurazione dei turni
- Aggiunto `randomize_fillers` facoltativo (boolean) nella configurazione del soft timeout
- Trascrizioni e simulazioni
- Aggiunto `user_identifier` facoltativo (string) nei messaggi utente delle trascrizioni
- Aggiunto `success_conditions` facoltativo (array, massimo 30); `success_condition` deprecato
- Proprietà dello schema JSON degli strumenti
- Aggiunto `allowed_values_dynamic_variable` facoltativo (string)
### Musica
- Piani di composizione
- Il campo della richiesta `composition_plan` usa `oneOf` (`MusicPrompt` | `CompositionPlan`)
- Chiarito il comportamento di `respect_sections_durations` per `music_v1` rispetto a `music_v2`
### Workspace
- Aggiunta l'enum `LockReason` e i campi facoltativi `disable_reason`
- Aggiunto `scim_frozen` facoltativo (boolean) nelle impostazioni dei gruppi del workspace
### ElevenCreative Studio
- Le enum delle animazioni delle didascalie aggiungono `pop`, `slide_up` e `slide_down`
## Schemi rimossi
### ElevenAgents
- Rimossi gli schemi delle impostazioni relativi al coaching (`CoachedAgentSettings`, `CoachingAgentSettings`, `NoCoachingSettings`)
## June 15, 2026
### Presentazione di Music v2
Music v2 è ora disponibile tramite l'API ElevenLabs. Imposta `model_id` su `music_v2` in [Genera musica](/docs/it/api-reference/music/compose), [Trasmetti musica](/docs/it/api-reference/music/stream), [Genera musica dettagliata](/docs/it/api-reference/music/compose-detailed) e [Carica musica](/docs/it/api-reference/music/upload) per usare il nuovo modello. Music v2 introduce piani di composizione basati su chunk, creati da segmenti `GenerationChunk` e `AudioRefChunk`, offrendoti un controllo più preciso su struttura, ritmo e arrangiamento rispetto al flusso `music_v1` basato su prompt.
Usa i piani di composizione `music_v2` nelle richieste di generazione e caricamento, oppure genera prima un piano tramite l'endpoint dei piani di composizione. I body delle richieste e delle risposte accettano formati di piano v1 o v2, così puoi eseguire la migrazione endpoint per endpoint. `MusicPrompt` rimane disponibile solo per `music_v1`.
Genera la tua prima traccia con l'API Music in pochi minuti.
Crea piani di composizione basati su chunk per tracce strutturate con più sezioni.
Componi, trasmetti e carica musica con `music_v2` tramite l'API REST.
- **Timestamp di caricamento**: [Carica musica](/docs/it/api-reference/music/upload) accetta `with_timestamps` facoltativo; le risposte possono includere `words_timestamps`.
### ElevenAgents
- **Esegui valutazione della conversazione**: aggiunto l'endpoint [Esegui valutazione della conversazione](/docs/it/api-reference/conversations/analysis/run-evaluation) (`POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run`) per rieseguire un singolo criterio di valutazione su una conversazione completata usando `RunConversationEvaluationsRequest`.
- **Comportamento di ingresso nel workflow**: i nodi del workflow che sovrascrivono l'agente aggiungono `entry_behavior` facoltativo (`generate_immediately`, `wait_for_user`, `auto`) per controllare se il sottoagente parla per primo o attende l'input dell'utente.
- **Strumento di sistema per terminare la procedura**: aggiunta la configurazione dello strumento di sistema `end_procedure` con stati di errore corrispondenti. Lo strumento `start_procedure` aggiunge `already_active` ai propri stati di errore.
- **Override TTS per trasferimento**: `AgentTransfer`, i nodi agente autonomi del workflow e i risultati riusciti dello strumento `transfer_to_agent` aggiungono `preserve_client_tts_overrides` facoltativo (booleano) per mantenere gli override TTS lato client dopo un trasferimento.
- **Enum del budget di interazione**: `InteractionBudget` rimuove `async` e aggiunge `5_minutes`, `10_minutes` e `1_hour`. Aggiorna tutte le configurazioni o gli enum SDK che fanno ancora riferimento a `async`.
- **Selezione del modello di guardrail personalizzato**: la configurazione dei guardrail personalizzati aggiunge `model` facoltativo con varianti Gemini, Claude e GPT. La configurazione dei guardrail aggiunge anche `history_message_count` facoltativo (intero).
- **Filtri dell'elenco di numeri telefonici**: [Elenca numeri telefonici](/docs/it/api-reference/phone-numbers/list) aggiunge i parametri query facoltativi `provider`, `agent_id` e `branch_id` per filtrare i numeri importati.
- **Filtraggio degli account WhatsApp**: [Elenca account WhatsApp](/docs/it/api-reference/whats-app/accounts/list) aggiunge il parametro query facoltativo `agent_id` per filtrare gli account in base all'agente assegnato.
- **Filtri per intervallo temporale degli argomenti**: [Ottieni argomenti delle conversazioni dell'agente](/docs/it/api-reference/conversations/topics/get) aggiunge i parametri query facoltativi `from_unix_secs` e `to_unix_secs` per delimitare i risultati del rilevamento degli argomenti.
- **Configurazione dei codec SIP**: i modelli di richiesta e risposta dei trunk SIP in uscita aggiungono `enabled_codecs` facoltativo (enum `MediaCodec`).
- **Tipi di strumenti per la memoria**: aggiunti gli schemi `LoadableMemoryEntry` e `LoadMemoryEntryToolErrorStatus` per la gestione degli errori degli strumenti per la memoria.
- **Limiti per batch di test degli agenti**: gli schemi delle richieste di collegamento, esecuzione e reinvio dei test degli agenti aumentano il massimo di test collegati da 1000 a 5000.
- **Supporto dei tag fonema**: le impostazioni TTS degli agenti aggiungono `enable_phoneme_tags` facoltativo (booleano) per la gestione opzionale dei fonemi SSML V3.
- **Override di omissione dello schema degli array**: le proprietà dello schema JSON degli array aggiungono `is_omitted` facoltativo (mutuamente esclusivo con altre origini di valore). `ConstantSchemaOverride` può usare valori costanti di tipo array.
- **Contesto degli errori di trasferimento**: i payload di errore del trasferimento a un numero possono includere `agent_message` facoltativo (stringa).
### Workspace
- **Aggiornamenti delle chiavi API degli account di servizio**: [Aggiorna chiave API dell'account di servizio](/docs/it/api-reference/service-accounts/api-keys/update) non richiede più un body della richiesta. I campi modificabili supportano aggiornamenti parziali tramite `no_update` e `name` nullable, inclusi `permissions` e `character_limit`.
- **Raggruppamento per fuso orario dell'utilizzo**: le richieste di utilizzo del workspace per prodotto nel tempo aggiungono `time_zone` facoltativo (stringa di fuso orario IANA) con regole chiarite per i bucket `interval_seconds`.
- **Filtro dell'origine della cronologia**: i filtri `source` per l'elenco e i dettagli della cronologia aggiungono `Flows`.
### ElevenCreative Studio
- **Riferimenti vocali del progetto**: i modelli dei progetti, i nodi TTS dei capitoli, gli elenchi vocali e le statistiche vocali passano a `project_voice_ref_id` come campo vocale canonico. I precedenti campi `voice_id` restano nelle risposte come mirror di sola lettura deprecati per compatibilità.
### Speech to Text
- **Diarizzazione della libreria di speaker**: [Converti parlato in testo](/docs/it/api-reference/speech-to-text/convert) aggiunge `use_speaker_library` facoltativo (booleano, valore predefinito `false`) per la diarizzazione delle trascrizioni batch.
### Voci
- **Ordinamento delle voci condivise**: il parametro query `sort` di [Elenca voci condivise](/docs/it/api-reference/voices/voice-library/get-shared) ottiene un enum esplicito, il valore predefinito `created_date` e una descrizione aggiornata.
### Release SDK
#### SDK JavaScript
- [v2.53.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.53.0) - Rigenerato dallo schema OpenAPI più recente con supporto per la riesecuzione della valutazione delle conversazioni, union dei piani di composizione Music v2, `entry_behavior` del workflow, filtri per elenchi di numeri telefonici e WhatsApp, parametri per intervalli temporali degli argomenti, aggiornamenti dello schema di avviso, campi `project_voice_ref_id` di Studio e limiti ampliati per i batch di test degli agenti.
#### SDK Python
- [v2.53.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.53.0) - Rigenerato dallo schema OpenAPI più recente con supporto per la riesecuzione della valutazione delle conversazioni, piani di composizione Music v2, comportamento di ingresso del workflow e strumenti per terminare le procedure, parametri di filtro per la telefonia, modelli di aggiornamento parziale per avvisi e account di servizio e campi di riferimento vocale di Studio.
#### Pacchetti
- [@elevenlabs/client@1.11.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.11.0) - Aggiunta l'esportazione del sottopath `@elevenlabs/client/internal/unity` per il bridge WebGL dell'SDK Unity, che espone `MediaDeviceInput`, `MediaDeviceOutput`, helper per il collegamento delle connessioni e tipi di adattatore WebRTC.
- [@elevenlabs/client@1.11.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.11.1), [@elevenlabs/react@1.6.7](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.6.7), [@elevenlabs/react-native@1.2.7](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.7), [@elevenlabs/convai-widget-core@0.14.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.2) e [@elevenlabs/convai-widget-embed@0.14.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.2) - Allineamento delle dipendenze a `@elevenlabs/client@1.11.1` e `@elevenlabs/types@0.14.1`.
- [@elevenlabs/types@0.14.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.14.1) - Aggiunto `"license": "MIT"` a `package.json` per la compatibilità con license-checker.
#### SDK iOS
- [v3.2.1](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.2.1) - Aggiunto il supporto per la residenza dei dati a Singapore e abilitato `singlePeerConnection` per le sessioni WebRTC.
### API
## Nuovi endpoint
### ElevenAgents
- [Esegui valutazione della conversazione](/docs/it/api-reference/conversations/analysis/run-evaluation) - `POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run`
- Il body della richiesta usa `RunConversationEvaluationsRequest` per rieseguire un singolo criterio di valutazione
## Endpoint aggiornati
### ElevenAgents
- [Elenca numeri telefonici](/docs/it/api-reference/phone-numbers/list) - `GET /v1/convai/phone-numbers`
- Aggiunti i parametri query facoltativi `provider`, `agent_id` e `branch_id`
- [Ottieni argomenti delle conversazioni dell'agente](/docs/it/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
- Aggiunti i parametri query facoltativi `from_unix_secs` e `to_unix_secs`
- [Elenca account WhatsApp](/docs/it/api-reference/whats-app/accounts/list) - `GET /v1/convai/whatsapp-accounts`
- Aggiunto il parametro query facoltativo `agent_id`
### Musica
- [Genera musica](/docs/it/api-reference/music/compose), [Genera musica dettagliata](/docs/it/api-reference/music/compose-detailed), [Trasmetti musica](/docs/it/api-reference/music/stream) e [Carica musica](/docs/it/api-reference/music/upload)
- Aggiunto `music_v2` ai valori `model_id` supportati
- Il caricamento aggiunge `with_timestamps` facoltativo; le risposte possono includere `words_timestamps`
### Speech to Text
- [Converti parlato in testo](/docs/it/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
- Aggiunto il parametro query facoltativo `use_speaker_library` (booleano, valore predefinito `false`)
### Voci
- [Elenca voci condivise](/docs/it/api-reference/voices/voice-library/get-shared) - `GET /v1/shared-voices`
- Il parametro query `sort` ora usa un enum esplicito con valore predefinito `created_date`
## Modifiche agli schemi
### ElevenAgents
- Nodi del workflow che sovrascrivono l'agente
- Aggiunto enum `entry_behavior` facoltativo (`generate_immediately`, `wait_for_user`, `auto`)
- Strumenti di sistema
- Aggiunta configurazione dello strumento `end_procedure` e relativi stati di errore
- Schemi di trasferimento e interazione
- Aggiunto `preserve_client_tts_overrides` facoltativo nei trasferimenti e nei risultati degli strumenti di trasferimento
- `InteractionBudget` rimuove `async`; aggiunge `5_minutes`, `10_minutes`, `1_hour`
- Guardrail e TTS
- I guardrail personalizzati aggiungono `model` e `history_message_count` facoltativi
- Le impostazioni TTS degli agenti aggiungono `enable_phoneme_tags` facoltativo
- Telefonia
- I modelli dei trunk SIP aggiungono `enabled_codecs` facoltativo (enum `MediaCodec`)
- Strumenti per memoria e codice
- Aggiunti `LoadableMemoryEntry` e `LoadMemoryEntryToolErrorStatus`
- Test degli agenti
- Aumentati i limiti dei test collegati da 1000 a 5000 nelle richieste di esecuzione e reinvio
- Proprietà dello schema JSON degli strumenti
- Le proprietà degli array aggiungono `is_omitted` facoltativo
### Workspace
- Account di servizio
- PATCH della chiave API supporta aggiornamenti parziali con sentinelle `no_update`
- Utilizzo e cronologia
- L'utilizzo per prodotto nel tempo aggiunge `time_zone` facoltativo
- I filtri `source` della cronologia aggiungono `Flows`
### Musica
- Piani di composizione
- Aggiunti `CompositionPlan`, `GenerationChunk` e `AudioRefChunk` basati su chunk per `music_v2`
- I body delle richieste e delle risposte accettano formati di piano v1 o v2 con `anyOf`
### ElevenCreative Studio
- Modelli vocali del progetto
- Aggiunto `project_voice_ref_id` come riferimento vocale canonico
- I mirror `voice_id` deprecati di sola lettura vengono mantenuti nelle risposte
_Showing the 20 most recent of 99 entries. Append `/llms.txt` to the changelog URL for the complete index._