> 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 - **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.