# Cal.com

> Colleghi Cal.com con una chiave API e l'agente vocale prenota sui tuoi tipi di evento durante le chiamate.

Pagina: https://supportfast.ai/it/guida/calendari/calcom/ · Sezione: Calendari · Aggiornata il 30 ottobre 2026

> **Prima di iniziare**
>
> - Un account sul servizio in cloud di [Cal.com](https://cal.com), con i tipi di evento già creati. Un Cal.com installato sul tuo server non si collega: la console chiede solo la chiave, non l'indirizzo del server.
> - La funzione «Prenotazioni a calendario» nel tuo piano.

## Crea la chiave API su Cal.com

1. **Apri le impostazioni di Cal.com**
   Entra in Cal.com e vai in Settings › Security › API Keys.

2. **Crea la chiave e copiala**
   Crea una nuova chiave, dalle un nome riconoscibile, per esempio «SupportFast», e copiala.

> **Consiglio**
>
> **Scegli bene la scadenza.** Cal.com ti fa decidere quando scade la chiave. Dopo la scadenza Cal.com la rifiuta: l'agente non prenota più e, alla sincronizzazione successiva, il collegamento passa a «Da riconnettere». Ti consigliamo una chiave senza scadenza, da eliminare su Cal.com quando non serve più. Se preferisci una scadenza, segnati la data: prima che arrivi, crea una chiave nuova e incollala con Riconnetti.

> **Attenzione**
>
> **Tratta la chiave come una password.** Chi la possiede può leggere e modificare il tuo calendario. Non mandarla via email o in chat: incollala solo in SupportFast.

## Collega Cal.com

1. **Apri le Integrazioni**
   Vai in Workspace › Integrazioni. Nel riquadro «Calendari», sulla riga «Cal.com», premi Connetti.

2. **Incolla la chiave**
   Nella finestra «Collega Cal.com» incolla la chiave nel campo API Key di Cal.com.

3. **Collega**
   Premi Connetti e Sincronizza. SupportFast verifica la chiave e importa i tipi di evento, il nome e l'email dell'account e gli orari. Compare «Cal.com collegato».

4. **Dai i tipi di evento all'agente vocale**
   Scegli quali tipi di evento l'agente può prenotare: vedi [In Chiamata: appuntamenti](https://supportfast.ai/it/guida/agente-vocale/appuntamenti.md).

> **Risultato**
>
> La riga «Cal.com» è «Attiva». L'agente vocale conosce i tuoi tipi di evento e può prenotarli durante le chiamate.

## Come verificare

1. Nella pagina di Cal.com in SupportFast premi Test Connessione: deve comparire «Connessione riuscita».
2. Fai una [chiamata di prova](https://supportfast.ai/it/guida/agente-vocale/prova.md) all'agente vocale e chiedi un appuntamento.
3. Controlla su Cal.com che la prenotazione ci sia. Il cliente riceve l'email di conferma di Cal.com all'indirizzo che ha dettato.

![Finestra Collega Cal.com con il campo API Key di Cal.com, l'aiuto su dove recuperare la chiave e i pulsanti Annulla e Connetti e Sincronizza.](https://supportfast.ai/_astro/06-calcom-collega.BKuxnw4m.webp)

_Per collegare Cal.com basta incollare la API Key presa dalle impostazioni di sicurezza di Cal.com._

## La pagina di Cal.com

In alto trovi lo stato, il pulsante Test Connessione e il menu ⋮ «Azioni del calendario», con Riconnetti ed Elimina integrazione. Il riquadro «Calendari Sincronizzati» con i tipi di evento è spiegato in [I tipi di evento](https://supportfast.ai/it/guida/calendari/panoramica.md#tipi-di-evento).

Quali «Campi della Prenotazione» chiede l'agente, e perché il «Telefono» non serve chiederlo, è in [Limiti da conoscere](https://supportfast.ai/it/guida/calendari/panoramica.md#limiti).

## Gli avvisi che puoi vedere

«La chiave non è valida: Cal.com non la riconosce», oppure «Accesso scaduto» con lo stato «Da riconnettere», vuol dire che la chiave è sbagliata, incompleta, scaduta o eliminata su Cal.com. Copiala di nuovo per intero, o creane una nuova; se Cal.com era già collegato, incollala da menu ⋮ › Riconnetti. Per gli altri avvisi premi Test Connessione; se l'avviso resta, crea una chiave nuova.

## Scollegare Cal.com

Dal menu ⋮ scegli Elimina integrazione e conferma. Per sicurezza elimina anche la chiave su Cal.com, in Settings › Security › API Keys. Cosa succede agli agenti e agli appuntamenti già presi è in [Scollegare un calendario](https://supportfast.ai/it/guida/calendari/panoramica.md#scollegare).

## Domande frequenti

**Ho aggiunto un campo obbligatorio su Cal.com: l'agente lo chiede?**

Sì, dopo la sincronizzazione: premi Sincronizza ora. Se il campo è a scelta, l'agente propone al cliente le opzioni che hai scritto su Cal.com.

## Leggi anche

- [Appuntamenti: come funzionano](https://supportfast.ai/it/guida/calendari/panoramica.md): Tipi di evento e limiti comuni ai calendari.

- [Calendly](https://supportfast.ai/it/guida/calendari/calendly.md): L'alternativa con l'accesso in finestra.

- [Google Calendar](https://supportfast.ai/it/guida/calendari/google-calendar.md): I tipi di evento creati in SupportFast.

- [In Chiamata: appuntamenti](https://supportfast.ai/it/guida/agente-vocale/appuntamenti.md): Il passo «In Chiamata» dell'agente vocale.