> 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

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

<Accordion title="Visualizza modifiche 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`

</Accordion>