> ## Documentation Index > Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt > Use this file to discover all available pages before exploring further. # Connessioni API > Trasforma qualsiasi API HTTP in una funzione che il tuo agente può chiamare durante la conversazione — incolla un comando cURL e lascia che la procedura guidata faccia il resto. Le connessioni API sono funzioni HTTP personalizzate che i tuoi agenti vocali possono chiamare durante una conversazione: cercare un ordine, creare un ticket, recuperare lo stato di un account dal tuo backend. Definisci l'endpoint una volta in **Connessioni → API** (`/dashboard/api-connections`); gli agenti vocali a cui è associata la connessione potranno quindi richiamarla ogni volta che la conversazione lo richiede. Esistono due modi per crearne una: incollare qualcosa che la procedura guidata può analizzare oppure configurare la connessione manualmente. ## Il percorso rapido: incolla e analizza Si apre la finestra di dialogo della procedura guidata. Incolla nella casella un **comando cURL** di esempio, una **specifica OpenAPI/Swagger**, un'**esportazione Postman**, un'**interfaccia TypeScript** o uno **schema Zod**. ThunderPhone deduce l'intera connessione da ciò che incolli: URL, metodo, intestazioni e uno schema dei parametri derivato dai parametri di query e dal corpo della richiesta individuati. Le intestazioni incollate, incluse quelle di autenticazione, vengono riportate nella configurazione dell'endpoint. La configurazione dedotta si apre con i campi stimati evidenziati per la revisione. Modifica nomi, descrizioni e tipi di parametro affinché l'agente vocale capisca quando e come chiamare la funzione: la descrizione è ciò che legge il modello. Il salvataggio esegue prima una richiesta di test in tempo reale verso il tuo endpoint. Se la richiesta non riesce, la connessione non viene salvata: correggi l'URL, le intestazioni di autenticazione o il corpo e riprova. In caso di successo, la connessione viene archiviata con il badge **Convalidata**. Se la procedura guidata non trova un URL della richiesta in ciò che incolli, te lo segnalerà: includi un endpoint `http(s)` completo e riprova. ## Configurazione manuale Fai clic su **Configura manualmente →** nella procedura guidata, oppure su **Vuoi che l'AI lo deduca? Prova la procedura guidata →** per tornare indietro. Il generatore manuale dispone di due editor: * **Visuale** — campi modulo per il nome visualizzato, il nome della funzione, l'**URL** della richiesta, il **metodo** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), le **intestazioni** personalizzate e lo schema dei parametri (**Aggiungi proprietà** per ogni argomento che l'agente vocale può fornire). * **JSON** — la stessa definizione in JSON non elaborato, per incollare o perfezionare direttamente una specifica dello strumento. Un pannello **Richiesta di test** facoltativo consente di inviare la richiesta configurata prima di salvare e mostra stato, latenza e un'anteprima della risposta. **Convalida e salva** esegue sempre questo test e salva solo in caso di successo. Fornisci ai parametri descrizioni in linguaggio semplice ("Indirizzo email del cliente, ad esempio [jane@example.com](mailto:jane@example.com)"). L'agente vocale sceglie gli argomenti in base a queste descrizioni in tempo reale, durante la chiamata. ## Gestisci le tue connessioni Ogni riga della connessione mostra il relativo stato di convalida — **Convalidata**, **Non testata** o **Errore** — il nome della funzione e gli agenti vocali che la utilizzano. Dal menu delle azioni della riga puoi: * **Modificare** — riaprire la configurazione. * **Clonare** — duplicarla come punto di partenza (la copia inizia come Non testata). * **Cronologia delle revisioni** — visualizzare le versioni precedenti e ripristinarne una nell'editor. * **Trasferire** — copiare o spostare la connessione in un'altra organizzazione di cui fai parte. Lo spostamento la rimuove da qui; gli agenti vocali che la utilizzavano potrebbero richiedere una riconfigurazione. * **Eliminare** — operazione permanente; gli agenti vocali che utilizzano la connessione dovranno essere riconfigurati. ## Associala a un agente vocale Aggiungi la connessione a un agente vocale nella sezione Connessioni API del generatore ([Crea un agente vocale](/it/guides/build-an-agent)). L'elenco mostra quali agenti vocali utilizzano ciascuna connessione, così puoi capire a colpo d'occhio cosa influenza una modifica. ## Passaggi successivi Crea e gestisci le stesse connessioni a livello programmatico. Connessioni preconfigurate per Google, Slack, HubSpot, Salesforce e Cal.com. Esponi un intero server di strumenti ai tuoi agenti. Ogni campo della risorsa di integrazione.