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

# Collega app (Google, Slack, HubSpot e altro)

> Dai ai tuoi agenti capacità concrete — controlla i calendari, aggiorna il tuo CRM, pubblica su Slack — in pochi clic, senza codice.

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:

| 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 tutto ciò che non è in questo elenco, crea una
[connessione API](/it/guides/api-connections) personalizzata o aggiungi un
[server MCP](/it/guides/mcp-servers).

## Connetti un account

<Steps>
  <Step title="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".
  </Step>

  <Step title="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.
  </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 **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**.
  </Step>
</Steps>

<Note>
  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**).
</Note>

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:

| Applicazione    | Abilitato per impostazione predefinita                               | Disattivato per impostazione predefinita   |
| --------------- | -------------------------------------------------------------------- | ------------------------------------------ |
| Google Calendar | Visualizza eventi e disponibilità, Crea eventi                       | Aggiorna eventi, Annulla eventi            |
| Google Sheets   | Aggiungi righe                                                       | —                                          |
| Slack           | Visualizza canali e messaggi recenti, Cerca messaggi                 | Pubblica messaggi                          |
| HubSpot         | Cerca e leggi contatti e aziende                                     | Crea o aggiorna contatti e aggiungi note   |
| Salesforce      | Cerca e leggi lead, contatti e opportunità                           | Crea o aggiorna record e registra attività |
| Cal.com         | Elenca tipi di evento e verifica la disponibilità, Crea prenotazioni | Riprogramma o annulla prenotazioni         |

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 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 lavoro 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 quegli 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 per incollare un cURL per i 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>
