--- title: "Connessioni API" description: "Trasforma qualsiasi API HTTP in una funzione che il tuo agente può chiamare durante una conversazione: incolla un comando cURL e la procedura guidata crea la definizione dello strumento, i parametri e l'autenticazione." --- Le connessioni API sono funzioni HTTP personalizzate che i tuoi agenti vocali possono chiamare durante una conversazione — per cercare un ordine, creare un ticket o recuperare lo stato di un account dal tuo backend. Definisci l'endpoint una sola volta in **Connessioni → API** (`/dashboard/api-connections`); gli agenti a cui è collegata la connessione possono quindi richiamarla ogni volta che la conversazione lo richiede. Ci sono due modi per crearne una: incolla qualcosa che la procedura guidata possa analizzare, oppure configura la connessione manualmente. ## Il modo più rapido: incolla e analizza La finestra di dialogo si apre sulla procedura guidata. Incolla un esempio di **comando cURL**, **specifica OpenAPI/Swagger**, **esportazione Postman**, **interfaccia TypeScript** o **schema Zod** nella casella. ThunderPhone deduce l'intera connessione da ciò che hai incollato — URL, metodo, intestazioni e uno schema dei parametri derivato dai parametri di query e dal corpo della richiesta trovati. 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 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 al tuo endpoint. Se la richiesta non riesce, la connessione non viene salvata — correggi l'URL, le intestazioni di autenticazione o il corpo e riprova. Se riesce, la connessione viene archiviata con il badge **Convalidata**. Se la procedura guidata non trova un URL di richiesta in ciò che hai incollato, 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 del modulo per il nome visualizzato, il nome della funzione, l' **URL**, il **metodo** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), le **intestazioni** personalizzate e lo schema dei parametri (**Aggiungi proprietà** per ogni argomento che l'agente può fornire). - **JSON** — la stessa definizione come JSON non elaborato, per incollare o perfezionare direttamente una specifica dello strumento. Un pannello **Test della richiesta** (facoltativo) ti consente di inviare la richiesta configurata prima del salvataggio e mostra lo stato, la latenza e un'anteprima della risposta. **Convalida e salva** esegue sempre questo test e salva solo in caso di successo. I valori delle intestazioni sono di sola scrittura. Una volta salvati, vengono crittografati e non vengono più mostrati, né nella dashboard né nell'API. Quando modifichi una connessione, un'intestazione salvata mostra il proprio nome con punti al posto del valore e l'indicazione **Salvato**: lasciala invariata per mantenere il valore salvato oppure inseriscine uno nuovo per sostituirlo. Le richieste di test e le chiamate attive usano il valore salvato. **Clona** copia i valori salvati nella nuova connessione. Fornisci ai parametri descrizioni in linguaggio semplice ("Indirizzo email del cliente, ad es. jane@example.com"). L'agente 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 che la utilizzano. Dal menu azioni della riga puoi: - **Modificare** — riaprire la configurazione. - **Clonare** — duplicarla come punto di partenza (la copia inizia come Non testata). - **Cronologia revisioni** — visualizzare le versioni precedenti e ripristinarne una nell' editor. - **Trasferire** — copiare o spostare la connessione in un'altra organizzazione a cui appartieni. Lo spostamento la rimuove da qui; gli agenti che la usavano potrebbero richiedere una riconfigurazione. - **Eliminare** — operazione permanente; gli agenti che utilizzano la connessione dovranno essere riconfigurati. ## Collegala a un agente Aggiungi la connessione a un agente nella sezione delle connessioni API del generatore ([Crea un agente](/it/guides/build-an-agent)). L'elenco mostra quali agenti utilizzano ciascuna connessione, così puoi capire a colpo d'occhio quale impatto avrà una modifica. ## Passaggi successivi Crea e gestisci le stesse connessioni in modo 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.