---
title: "Connetti app (Google, Slack, HubSpot e altro)"
description: "Offri ai tuoi agenti funzionalità concrete in pochi clic e senza codice: controlla i calendari, aggiorna il tuo CRM, pubblica su Slack, grazie a connessioni preconfigurate alle app che utilizzi."
---

Le connessioni alle app consentono a un agente vocale di agire negli strumenti che il tuo team già
utilizza, durante la conversazione: verificare la disponibilità in un calendario, cercare un chiamante
nel tuo CRM, aggiungere un lead a un foglio di calcolo, pubblicare un riepilogo su Slack. Colleghi
un account una sola volta in **Connessioni → App**
(`/dashboard/app-connections`), scegli cosa può fare l'agente e
associ la connessione a qualsiasi agente nel relativo editor.

Oggi sono disponibili sei applicazioni:

| Applicazione | Cosa può fare il tuo agente |
| --- | --- |
| **Google Calendar** | Visualizzare la disponibilità e gestire gli eventi del calendario. |
| **Google Sheets** | Aggiungere dettagli dei lead e risultati delle chiamate a un foglio. |
| **Slack** | Trovare canali, cercare messaggi e pubblicare con autorizzazione. |
| **HubSpot** | Trovare contatti, aggiornare record e aggiungere note. |
| **Salesforce** | Cercare record, aggiornare lead e registrare attività. |
| **Cal.com** | Verificare la disponibilità e gestire le prenotazioni. |

Per qualsiasi elemento non presente in questo elenco, crea una
[connessione API](/it/guides/api-connections) personalizzata o aggiungi un
[server MCP](/it/guides/mcp-servers).

## Collega un account

<Steps>
  <Step title="Apri Connessioni → App e fai clic su Aggiungi applicazione">
    Un selettore mostra le sei applicazioni. Puoi collegare più account
    della stessa app — ognuna mostra un conteggio di "connessi" dopo averne collegato uno.
  </Step>
  <Step title="Autorizza l'account">
    La maggior parte delle app usa OAuth: si apre un popup, accedi al provider e
    approvi l'accesso, quindi la connessione appare nella pagina. **Cal.com è
    l'eccezione** — si collega invece con una chiave API. Incolla la chiave
    e fai clic su **Verifica e connetti**; la chiave viene verificata con Cal.com
    prima di essere crittografata e salvata.
  </Step>
  <Step title="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 **Esamina foglio di calcolo** e
    scegli la scheda. Il pannello conferma le colonne trovate. Finché questa operazione non viene
    completata, il riquadro della connessione mostra **Richiede configurazione**.
  </Step>
</Steps>

Per collegare e gestire le connessioni alle app è necessario 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 abilitate inizialmente; le operazioni che
scrivono o modificano i tuoi dati sono inizialmente **disattivate** finché non le abiliti:

| Applicazione | Abilitato per impostazione predefinita | Disattivato per impostazione predefinita |
| --- | --- | --- |
| Google Calendar | Visualizzare eventi e disponibilità, Creare eventi | Aggiornare eventi, Annullare eventi |
| Google Sheets | Aggiungere righe | — |
| Slack | Visualizzare canali e messaggi recenti, Cercare messaggi | Pubblicare messaggi |
| HubSpot | Cercare e leggere contatti e aziende | Creare o aggiornare contatti e aggiungere note |
| Salesforce | Cercare e leggere lead, contatti e opportunità | Creare o aggiornare record e registrare attività |
| Cal.com | Elencare tipi di evento e verificare la disponibilità, Creare prenotazioni | Ripianificare o annullare prenotazioni |

Un'operazione che disattivi semplicemente non è disponibile per l'agente — gli
strumenti corrispondenti non gli vengono mai offerti durante le chiamate.

Le connessioni Google Calendar includono anche un interruttore **Invia inviti via email agli ospiti**,
attivato per impostazione predefinita. Quando l'agente raccoglie l'indirizzo email del chiamante
e lo aggiunge come ospite all'evento, Google gli invia l'invito via email,
così come qualsiasi aggiornamento o annullamento successivo effettuato dall'agente. Disattivalo per mantenere
gli ospiti nell'evento senza email. L'invito include la descrizione dell'evento,
quindi fai in modo che l'agente non inserisca note interne e legga
l'indirizzo al chiamante prima della prenotazione.

## Gli strumenti a disposizione del tuo agente

Una volta collegata a un agente, le operazioni abilitate diventano
strumenti richiamabili durante le conversazioni:

- **Google Calendar** — `calendar_list_events`, `calendar_check_availability`,
  `calendar_create_event`, `calendar_update_event`, `calendar_cancel_event`
- **Google Sheets** — `sheets_append_row` (scrive nel foglio di calcolo e nella scheda
  configurati)
- **Slack** — `slack_list_channels`, `slack_search_messages`,
  `slack_post_message`
- **HubSpot** — `hubspot_search_contacts`, `hubspot_get_contact`,
  `hubspot_upsert_contact`, `hubspot_add_note`
- **Salesforce** — `salesforce_search_records`, `salesforce_get_record`,
  `salesforce_upsert_lead`, `salesforce_log_activity`
- **Cal.com** — `calcom_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](/it/guides/build-an-agent)) 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 questi strumenti alla chiamata successiva.

## Passaggi successivi

<CardGroup cols={2}>
  <Card title="Trasforma qualsiasi API in un'azione dell'agente" icon="plug" href="/it/guides/api-connections">
    La procedura guidata incolla-un-cURL per servizi senza una connessione nativa.
  </Card>
  <Card title="Aggiungi un server MCP" icon="server" href="/it/guides/mcp-servers">
    Usa il tuo server di strumenti tramite Streamable HTTP.
  </Card>
</CardGroup>
