Skip to main content
Le connessioni alle app consentono a un agente vocale di agire negli strumenti che il tuo team già usa, durante la conversazione: verificare la disponibilità su un calendario, cercare un chiamante nel CRM, aggiungere un lead a un foglio di calcolo, pubblicare un riepilogo su Slack. Devi connettere un account una sola volta in Connessioni → App (/dashboard/app-connections), scegliere cosa l’agente può fare e associare la connessione a qualsiasi agente nel relativo builder. Oggi sono disponibili sei applicazioni: Per tutto ciò che non è in questo elenco, crea una connessione API personalizzata o aggiungi un server MCP.

Connetti un account

1

Apri Connessioni → App e fai clic su Aggiungi applicazione

Un selettore mostra le sei applicazioni. Puoi connettere più account della stessa app: dopo averne connesso uno, ciascuna mostra un conteggio “connesso”.
2

Autorizza l'account

La maggior parte delle app usa OAuth: si apre un popup, accedi al provider, approvi l’accesso e la connessione appare nella pagina. Cal.com è l’eccezione: si connette invece con una chiave API. Incolla la chiave e fai clic su Convalida e connetti; la chiave viene verificata su Cal.com prima di essere crittografata e salvata.
3

Solo Google Sheets: scegli il foglio di calcolo

Una connessione Sheets deve sapere su quale foglio di calcolo e scheda scrivere. Subito dopo la connessione, si apre un pannello di configurazione: incolla l’URL del foglio di calcolo (o il relativo ID), fai clic su Ispeziona foglio di calcolo e scegli la scheda. Il pannello conferma le colonne trovate. Finché questa operazione non è completata, il riquadro della connessione mostra Configurazione necessaria.
La verifica OAuth di Google di ThunderPhone è attualmente in revisione, quindi Google mostra un avviso di “app non verificata” durante il consenso per Google Calendar e Google Sheets. La finestra di dialogo Aggiungi applicazione ti guida attraverso i due clic per continuare (Avanzate → Vai a ThunderPhone).
La connessione e la gestione delle connessioni alle app richiedono il ruolo di amministratore o proprietario nell’organizzazione.

Controlla cosa può fare l’agente

Ogni connessione dispone di interruttori di autorizzazione per singola operazione: apri un riquadro della connessione per gestirli. Le operazioni di lettura sono inizialmente abilitate; le operazioni che scrivono o modificano i tuoi dati sono inizialmente disattivate finché non le abiliti: Un’operazione che disabiliti semplicemente non è disponibile per l’agente: gli strumenti corrispondenti non gli vengono mai offerti durante le chiamate.

Gli strumenti a disposizione del tuo agente

Una volta collegata a un agente, le operazioni abilitate vengono esposte come strumenti richiamabili durante le conversazioni:
  • Google Calendarcalendar_list_events, calendar_check_availability, calendar_create_event, calendar_update_event, calendar_cancel_event
  • Google Sheetssheets_append_row (scrive nel foglio di lavoro e nella scheda configurati)
  • Slackslack_list_channels, slack_search_messages, slack_post_message
  • HubSpothubspot_search_contacts, hubspot_get_contact, hubspot_upsert_contact, hubspot_add_note
  • Salesforcesalesforce_search_records, salesforce_get_record, salesforce_upsert_lead, salesforce_log_activity
  • Cal.comcalcom_list_event_types, calcom_check_availability, calcom_create_booking, calcom_cancel_booking
Non devi scrivere schemi per nessuno di questi strumenti: ThunderPhone definisce gli strumenti e instrada le chiamate tramite l’account connesso.

Collega la connessione a un agente

Le connessioni non fanno nulla finché un agente non le utilizza. Apri l’agente nel builder (Crea un agente) e aggiungi la connessione nella sezione App connesse. Il riquadro di una connessione nella pagina App mostra quante operazioni sono abilitate e quanti agenti la utilizzano.

Disconnetti

Apri il riquadro di una connessione e disconnettila da lì. Gli agenti che la utilizzavano perderanno quegli strumenti alla chiamata successiva.

Passaggi successivi

Trasforma qualsiasi API in un'azione dell'agente

La procedura guidata per incollare un cURL per i servizi senza una connessione nativa.

Aggiungi un server MCP

Usa il tuo server di strumenti tramite Streamable HTTP.