Skip to main content
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

1

Fai clic su Nuova connessione API

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

Fai clic su Analizza

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

Conferma i campi evidenziati

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

Convalida e salva

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”). 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). L’elenco mostra quali agenti vocali utilizzano ciascuna connessione, così puoi capire a colpo d’occhio cosa influenza una modifica.

​
Passaggi successivi

Integrazioni di strumenti tramite API

Crea e gestisci le stesse connessioni a livello programmatico.

Connetti app

Connessioni preconfigurate per Google, Slack, HubSpot, Salesforce e Cal.com.

Aggiungi un server MCP

Esponi un intero server di strumenti ai tuoi agenti.

Riferimento API delle integrazioni

Ogni campo della risorsa di integrazione.