> 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 - **Log SIP**: i log di segnalazione SIP sono ora disponibili per le chiamate su trunk SIP nella cronologia delle conversazioni e nelle impostazioni dei numeri di telefono. I log includono l'ID della chiamata SIP, numeri di telefono, indirizzi, trasporto, direzione dei messaggi, messaggi non elaborati ed errori per aiutarti a eseguire il debug dei problemi di configurazione e instradamento delle chiamate. - **Aggiornamenti dei documenti della knowledge base**: nuova API per elencare i chunk indicizzati (RAG) di un documento. I documenti possono anche essere modificati sul posto: puoi rinominare l'elemento e, per i documenti basati su testo, aggiornare il body senza ricaricare il file. (I documenti basati su file usano ancora il flusso esistente di sostituzione del file, quando applicabile.) - **Metadati delle conversazioni SMS**: aggiunto il supporto SMS ai metadati delle conversazioni con `SMSConversationInfo`, `sms` come metodo di autorizzazione e `twilio_sms` come origine di avvio della conversazione. - **Aggiornamenti della configurazione dell'agente**: aggiunti gli schemi di configurazione della musica di sottofondo, la configurazione del monitoraggio degli avvisi, i campi di layout 2D, la configurazione di caricamento file del widget e le nuove opzioni LLM `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.4-mini-2026-03-17` e `gpt-5.4-nano-2026-03-17`. ### Workspace - **Analisi delle richieste API**: aggiunto un endpoint di analisi del workspace per interrogare le richieste API con controlli per intervallo di tempo, filtri, ricerca, ordinamento e limite. - **Allowlist IP per le chiavi API**: aggiunto `allowed_ips` agli schemi di creazione, modifica e risposta delle chiavi API degli account di servizio. Le richieste di creazione accettano un array di indirizzi IP o intervalli CIDR, oppure `null` per consentire tutti gli IP. Le richieste di modifica accettano anche `clear` e `no_update`. - **Autorizzazioni del workspace**: aggiunti `conversational_ai_read` e `voice_design` alle autorizzazioni dei gruppi del workspace. ### Progettazione della voce - **Migrazione dell'anteprima vocale**: deprecato `POST /v1/text-to-voice/create-previews`. Usa [Progetta una voce](/docs/it/api-reference/text-to-voice/design) per creare anteprime, quindi usa il valore `generated_voice_id` restituito quando crei una voce. ### Modificatore di Voce - **Formati di output WAV**: aggiunti `wav_8000`, `wav_16000`, `wav_22050`, `wav_24000`, `wav_32000`, `wav_44100` e `wav_48000` al parametro query `output_format` nella conversione da parlato a parlato. ### Rilasci SDK #### SDK Python - [v2.47.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.47.0) - SDK rigenerato per lo schema API del 12 maggio 2026. Il rilascio aggiunge supporto tipizzato per l'elenco dei chunk RAG, gli aggiornamenti dei documenti file, l'analisi delle richieste API del workspace, l'allowlist IP per le chiavi API degli account di servizio, i campi di configurazione dell'agente per i numeri di telefono, gli header delle richieste webhook, la moderazione dei metadati vocali, le nuove opzioni LLM e i formati di output aggiornati per la conversione da parlato a parlato. #### SDK JavaScript - [v2.47.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.47.0) - SDK rigenerato per lo schema API del 12 maggio 2026. Il rilascio aggiunge supporto tipizzato per l'elenco dei chunk RAG, gli aggiornamenti dei documenti file, l'analisi delle richieste API del workspace, l'allowlist IP per le chiavi API degli account di servizio, i campi di configurazione dell'agente per i numeri di telefono, gli header delle richieste webhook, la moderazione dei metadati vocali, le nuove opzioni LLM e i formati di output aggiornati per la conversione da parlato a parlato. #### Pacchetti - [@elevenlabs/client@1.7.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.7.0), [@elevenlabs/react@1.6.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.6.0), [@elevenlabs/react-native@1.2.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.0) e [@elevenlabs/types@0.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.13.0) - Aggiunto il supporto completo del payload dei risultati degli strumenti a `onAgentToolResponse`. Se abilitato nella configurazione dell'agente, il callback ora riceve eventi `agent_tool_response_full_payload` con la stringa `full_tool_result` non elaborata, limitata a 64 KB. - [@elevenlabs/client@1.6.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.6.0), [@elevenlabs/react@1.5.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.5.0), [@elevenlabs/react-native@1.1.6](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.1.6) e [@elevenlabs/types@0.12.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.12.0) - Aggiunto il supporto nativo per disattivare e riattivare l'audio alla STT in tempo reale di Scribe. `RealtimeConnection` ora espone `mute()`, `unmute()` e `isMuted`, mentre `useScribe` espone stato e callback corrispondenti. I rilasci aggiungono anche `onAgentResponseCorrection` per gli eventi di correzione della risposta dell'agente. - [@elevenlabs/client@1.5.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.5.0), [@elevenlabs/react@1.4.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.4.0), [@elevenlabs/react-native@1.1.5](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.1.5) e [@elevenlabs/types@0.11.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.11.0) - Aggiunto `contextId` facoltativo a `sendContextualUpdate` per deduplicare gli aggiornamenti contestuali e aggiunto `llm` all'override tipizzato del prompt dell'agente per le sessioni di conversazione. Il pacchetto React consente inoltre al `deviceId` del microfono di `useScribe` di usare vincoli completi `ConstrainDOMString`. - [@elevenlabs/convai-widget-core@0.12.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.12.0) e [@elevenlabs/convai-widget-embed@0.12.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.12.0) - Aggiunto il supporto per il caricamento di file al widget ElevenAgents incorporato. - [@elevenlabs/convai-widget-core@0.12.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.12.1) e [@elevenlabs/convai-widget-embed@0.12.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.12.1) - Corretto l'invio dell'input di testo per gli utenti IME ignorando la pressione di Invio mentre la composizione è attiva. - [@elevenlabs/convai-widget-core@0.12.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.12.2) e [@elevenlabs/convai-widget-embed@0.12.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.12.2) - Aggiornati i pacchetti del widget a `@elevenlabs/client@1.7.0`, incluso il supporto completo del payload dei risultati degli strumenti. - [@elevenlabs/convai-widget-core@0.12.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.12.3) e [@elevenlabs/convai-widget-embed@0.12.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.12.3) - Corretto l'ordinamento delle trascrizioni quando i messaggi dell'utente e dell'agente condividono lo stesso `event_id`, in modo che i turni vocali e DTMF mostrino la trascrizione dell'utente prima del messaggio dell'agente. - [@elevenlabs/convai-widget-core@0.12.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.12.4) e [@elevenlabs/convai-widget-embed@0.12.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.12.4) - Corrette le trascrizioni del widget vocale: le parti della risposta dell'agente trasmesse in streaming vengono ignorate per le sessioni vocali e le trascrizioni utente tardive vengono inserite prima della risposta dell'agente corrispondente. ### API ## Nuovi endpoint ### ElevenAgents - [Ottieni i messaggi SIP per una conversazione](/docs/it/api-reference/conversations/get-sip-messages) - `GET /v1/convai/conversations/{conversation_id}/sip-messages` - Aggiunto il parametro path obbligatorio `conversation_id` (stringa) - Aggiunti i parametri query facoltativi `page_size` (intero, predefinito `20`) e `cursor` - Restituisce `GetSIPLogMessagesResponse` con `sip_messages`, `next_cursor` nullable e `has_more` - [Ottieni i messaggi SIP per un numero di telefono](/docs/it/api-reference/phone-numbers/get-sip-messages) - `GET /v1/convai/phone-numbers/{phone_number_id}/sip-messages` - Aggiunto il parametro path obbligatorio `phone_number_id` (stringa) - Aggiunti i parametri query facoltativi `page_size` (intero, predefinito `20`) e `cursor` - Restituisce `GetSIPLogMessagesResponse` - [Ottieni i chunk RAG per un documento](/docs/it/api-reference/knowledge-base/get-chunks) - `GET /v1/convai/knowledge-base/{documentation_id}/chunks` - Aggiunto il parametro path obbligatorio `documentation_id` (stringa) - Aggiunto il parametro query obbligatorio `embedding_model` - Aggiunti i parametri query facoltativi `page_size` (intero, predefinito `30`) e `cursor` - Restituisce `KnowledgeBaseDocumentChunksResponseModel` con `chunks` e `next_cursor` nullable - [Aggiorna il file del documento](/docs/it/api-reference/knowledge-base/update-file) - `PATCH /v1/convai/knowledge-base/{documentation_id}/update-file` - Aggiunto il parametro path obbligatorio `documentation_id` (stringa) - Aggiunto un body del form multipart con `file` obbligatorio (stringa, binario) - Restituisce il modello del documento della knowledge base aggiornato ### Workspace - `POST /v1/workspace/analytics/requests` - Aggiunto body della richiesta con `start_time`, `end_time`, `limit` (intero, predefinito `100`, massimo `1000`), `sort`, `filters` e `search` facoltativi - Restituisce `WorkspaceAnalyticsQueryResponseModel` con `columns`, `column_types`, `rows` e `column_units` ## Endpoint e schemi aggiornati ### ElevenAgents - [Aggiorna documento della knowledge base](/docs/it/api-reference/knowledge-base/update) - `PATCH /v1/convai/knowledge-base/{documentation_id}` - Aggiunti i campi del body della richiesta JSON `name` (stringa nullable facoltativa) e `content` (stringa nullable facoltativa) - [Crea agente](/docs/it/api-reference/agents/create) - `POST /v1/convai/agents/create` - Modificato il valore predefinito di `enable_versioning` da `false` a `true` - [Aggiorna agente](/docs/it/api-reference/agents/update) - `PATCH /v1/convai/agents/{agent_id}` - Modificato il valore predefinito di `enable_versioning_if_not_enabled` da `false` a `true` - [Aggiorna numero di telefono](/docs/it/api-reference/phone-numbers/update) - `PATCH /v1/convai/phone-numbers/{phone_number_id}` - Aggiunti `environment` e `branch_id` alla configurazione dell'agente del numero di telefono - `store_sip_messages` ora ha come valore predefinito `true` - [Ottieni widget](/docs/it/api-reference/widget/get) - `GET /v1/convai/agents/{agent_id}/widget` - Aggiunto `file_input_config` per i caricamenti di file del widget - Enumerazione `LLM` - Aggiunti `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.4-mini-2026-03-17` e `gpt-5.4-nano-2026-03-17` - Enumerazione `AuthorizationMethod` - Aggiunto `sms` - Enumerazione `ConversationInitiationSource` - Aggiunto `twilio_sms` - `AgentTopicResponseModel` - Aggiunti `parent_topic_id`, `x_2d` e `y_2d` nullable facoltativi - `BackgroundMusicConfig` e `BackgroundMusicConfigWorkflowOverride` - Aggiunti `source_type`, `source_id`, `volume` e `crossfade_loop` - Aggiunti i valori dell'enumerazione `BackgroundMusicPresetId` `city`, `elevator1`, `elevator2`, `elevator3`, `elevator4`, `office1`, `office2`, `restaurant` e `typing` - `AgentPlatformSettingsResponseModel` - Aggiunto `alerting` con i valori dell'enumerazione `Monitor` `elevated_conversation_failure_rate` e `elevated_tool_failure_rate` - Enumerazione `ProcedureCompilerMode` - Rimosso `deterministic` ### Workspace - Schemi di creazione e modifica della chiave API dell'account di servizio - Aggiunto `allowed_ips` come array facoltativo di indirizzi IP o intervalli CIDR, con da 1 a 100 voci - Le richieste di creazione possono passare `null` per consentire tutti gli IP - Le richieste di modifica possono passare `clear` o `no_update`; il valore predefinito è `no_update` - `WorkspaceApiKeyResponseModel` - Aggiunto `allowed_ips` nullable - Enumerazione `WorkspaceGroupPermission` - Aggiunti `conversational_ai_read` e `voice_design` - Schemi di connessione per l'autenticazione - Aggiunto `ApiIntegrationOAuth2CustomAppResponse` per le connessioni ad app OAuth2 personalizzate di proprietà dell'utente ### Progettazione della voce - [Crea anteprime vocali](/docs/it/api-reference/legacy/voices/create-previews) - `POST /v1/text-to-voice/create-previews` - Contrassegnato come deprecato - Aggiornata la descrizione per indirizzare gli sviluppatori a [Progetta una voce](/docs/it/api-reference/text-to-voice/design) ### Modificatore di Voce - [Converti parlato in parlato](/docs/it/api-reference/speech-to-speech/convert) - `POST /v1/speech-to-speech/{voice_id}` - Aggiunti `wav_8000`, `wav_16000`, `wav_22050`, `wav_24000`, `wav_32000`, `wav_44100` e `wav_48000` all'enumerazione `output_format` - Aggiornata la descrizione per indicare che i formati PCM e WAV a 44,1 kHz richiedono il piano Pro o superiore