> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

### ElevenAgents

- **Tag delle conversazioni**: aggiunti tag delle conversazioni di prima classe per organizzare e filtrare le conversazioni. Ora puoi creare, aggiornare, elencare ed eliminare i tag, assegnarli alle conversazioni e filtrare la [cronologia delle conversazioni](/docs/it/api-reference/conversations/list) in base a `tag_ids`.
- **Filtri dell'elenco delle conversazioni**: aggiunto `exclude_statuses` a [elenca conversazioni](/docs/it/api-reference/conversations/list), consentendo ai client di nascondere le conversazioni con stati come `initiated`, `in-progress`, `processing`, `done` o `failed`.
- **Opzioni del modello**: aggiunti `claude-opus-4-7`, `gpt-5.4`, `gpt-5.5`, `gpt-5.4-2026-03-05`, `gpt-5.5-2026-04-23` e `qwen36-35b-a3b` all'enum `LLM`.
- **Metadati degli aggiornamenti contestuali**: aggiunto `contextual_update_info` agli elementi di risposta della trascrizione delle conversazioni. Il campo fa riferimento a `ContextualUpdateInfo`, che include `context_id` e `is_superseded`, così i client possono identificare gli aggiornamenti contestuali e verificare se sono stati sostituiti da un contesto successivo.
- **Filtro per chiamate batch**: aggiunto un parametro query `agent_id` facoltativo a [elenca i job di chiamate batch del workspace](/docs/it/api-reference/batch-calling/list), consentendo ai client di restituire i job per un singolo agente.
- **Elenco delle invocazioni di test**: il parametro query `agent_id` è ora facoltativo e nullable in [elenca invocazioni di test](/docs/it/api-reference/tests/test-invocations/list), consentendo ai client di elencare le invocazioni di test senza filtrare per un agente.
- **Timeout della risposta MCP**: aumentato il valore massimo di `response_timeout_secs` da `120` a `300` secondi nella configurazione del server MCP e negli override della configurazione degli strumenti MCP.

### Workspace

- **Superamento dell'abbonamento**: aggiunto `current_overage` a `SubscriptionResponseModel` e `ExtendedSubscriptionResponseModel`.
- **Raccolte di risorse**: aggiunto `resource_collection` all'enum `WorkspaceResourceType`.

### ElevenCreative Studio

- **Stato dell'immagine del progetto**: aggiunti `error` e `pending_task` a `ProjectImageResponseModel`; gli URL firmati delle immagini sono ora nullable quando un'immagine è ancora in elaborazione o non è stata elaborata correttamente.
- **Campi dei contenuti multimediali in attesa**: rimossi i campi legacy `pending_block_ids` e `pending_external_audio_ids` dai modelli di risposta per audio esterno e video dei progetti.

### Rilasci SDK

#### SDK Python

- [v2.46.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.46.0) - Aggiunto il supporto per `keyterms` e `no_verbatim` all'API realtime di Scribe, rifattorizzata la costruzione dell'URL WebSocket e rigenerato l'SDK per lo schema API del 7 maggio 2026, inclusi tag delle conversazioni, filtri dell'elenco delle conversazioni, filtro `agent_id` per chiamate batch, `agent_id` facoltativo per le invocazioni di test, metadati degli aggiornamenti contestuali e aggiornamenti del timeout delle risposte MCP.

#### SDK JavaScript

- [v2.46.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.46.0) - Rigenerazione Fern per lo schema API del 7 maggio 2026, inclusi tag delle conversazioni, filtri dell'elenco delle conversazioni, filtro `agent_id` per chiamate batch, `agent_id` facoltativo per le invocazioni di test, metadati degli aggiornamenti contestuali e aggiornamenti del timeout delle risposte MCP.

#### Pacchetti

- [@elevenlabs/client@1.4.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.4.0) - Aggiunte le opzioni `keyterms` (`string[]`) e `noVerbatim` (`boolean`) all'API realtime di Scribe. I `keyterms` vengono inviati come parametri query WebSocket ripetuti e possono includere fino a 50 termini, ciascuno di massimo 20 caratteri. `noVerbatim` rimuove parole di riempimento, false partenze e disfluenze dalle trascrizioni. Corretto inoltre un caso in cui le interruzioni potevano troncare l'audio dell'agente ricevuto meno di 2 secondi dopo l'interruzione.
- [@elevenlabs/types@0.10.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.10.0) - Aggiunti tipi condivisi per `keyterms` e `noVerbatim` di Scribe realtime.
- [@elevenlabs/react@1.3.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.3.0), [@elevenlabs/react-native@1.1.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.1.4), [@elevenlabs/convai-widget-core@0.11.7](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.11.7) e [@elevenlabs/convai-widget-embed@0.11.7](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.11.7) - Aggiornati all'ultima versione del pacchetto client, incluse le opzioni realtime di Scribe e la correzione dell'interruzione dell'audio dell'agente.
- [@elevenlabs/react@1.2.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.2.2) - Patch che include le opzioni realtime di Scribe, la correzione dell'interruzione dell'audio dell'agente e un ID utente casuale automatico quando non ne è impostato alcuno.

#### SDK Android

- [v0.9.0](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.9.0) - Aggiunto il supporto per rilevare l'audio dell'utente quando il suo microfono è disattivato.

### API

<Accordion title="Visualizza le modifiche API">

## Nuovi endpoint

### ElevenAgents

- [Elenca tag](/docs/it/api-reference/conversations/tags/list) - `GET /v1/convai/tags`
  - Aggiunti parametri query `page_size` e `cursor` facoltativi
  - Restituisce `GetConversationTagsPageResponseModel` con `conversation_tags`, `next_cursor` e `has_more`
- [Crea tag](/docs/it/api-reference/conversations/tags/create) - `POST /v1/convai/tags`
  - Aggiunto il body della richiesta `CreateConversationTagRequestModel` con `title` obbligatorio (stringa) e `description` facoltativo nullable (stringa, massimo 1000 caratteri)
  - Restituisce `ConversationTagResponseModel`
- [Ottieni tag](/docs/it/api-reference/conversations/tags/get) - `GET /v1/convai/tags/{tag_id}`
  - Restituisce `ConversationTagResponseModel`
- [Aggiorna tag](/docs/it/api-reference/conversations/tags/update) - `PATCH /v1/convai/tags/{tag_id}`
  - Aggiunto il body della richiesta `PatchConversationTagRequestModel` con `title` facoltativo nullable (stringa, 1-120 caratteri) e `description` facoltativo nullable (stringa, massimo 1000 caratteri)
  - Restituisce `ConversationTagResponseModel`
- [Elimina tag](/docs/it/api-reference/conversations/tags/delete) - `DELETE /v1/convai/tags/{tag_id}`
- [Aggiungi tag alla conversazione](/docs/it/api-reference/conversations/tags/assign) - `POST /v1/convai/conversations/{conversation_id}/tags`
  - Aggiunto il body della richiesta `AssignConversationTagsRequestModel` con `tag_ids` obbligatorio (array)
- [Rimuovi tag dalla conversazione](/docs/it/api-reference/conversations/tags/unassign) - `DELETE /v1/convai/conversations/{conversation_id}/tags/{tag_id}`

## Endpoint aggiornati

### ElevenAgents

- [Elenca conversazioni](/docs/it/api-reference/conversations/list) - `GET /v1/convai/conversations`
  - Aggiunto il parametro query `exclude_statuses` facoltativo nullable (array di `initiated`, `in-progress`, `processing`, `done`, `failed`)
  - Aggiunto il parametro query `tag_ids` facoltativo nullable (array di stringhe)
- [Ottieni dettagli della conversazione](/docs/it/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}`
  - Aggiunto `tag_ids` a `GetConversationResponseModel`
  - Aggiunto `contextual_update_info` a `ConversationHistoryTranscriptResponseModel`, con riferimento a `ContextualUpdateInfo`
- [Elenca job di chiamate batch del workspace](/docs/it/api-reference/batch-calling/list) - `GET /v1/convai/batch-calling/workspace`
  - Aggiunto il parametro query `agent_id` facoltativo nullable (stringa)
- [Elenca invocazioni di test](/docs/it/api-reference/tests/test-invocations/list) - `GET /v1/convai/test-invocations`
  - Modificato `agent_id` da stringa obbligatoria a stringa facoltativa nullable
- Schemi di configurazione del server e degli strumenti MCP
  - Aumentato il massimo di `response_timeout_secs` da `120` a `300` secondi in `MCPToolConfigOverride-Input` e `MCPToolConfigOverride-Output`
- Enum `LLM`
  - Aggiunti `claude-opus-4-7`, `gpt-5.4`, `gpt-5.5`, `gpt-5.4-2026-03-05`, `gpt-5.5-2026-04-23` e `qwen36-35b-a3b`
- `ConvAIWebhooks`
  - Aggiunto `transcript_format`
- `ConversationHistoryMetadataCommonModel`
  - Aggiunto `voice_rewards`
- `ConversationChargingCommonModel`
  - Aggiunti `asr_usage` e `tts_usage`

### Workspace

- `SubscriptionResponseModel` e `ExtendedSubscriptionResponseModel`
  - Aggiunto `current_overage`
- Enum `WorkspaceResourceType`
  - Aggiunto `resource_collection`

### ElevenCreative Studio

- `ProjectImageResponseModel`
  - Aggiunti `error` e `pending_task`
- `ProjectExternalAudioResponseModel` e `ProjectVideoResponseModel`
  - Rimossi `pending_block_ids` e `pending_external_audio_ids`

</Accordion>