Vai alla navigazione
ConfigurazioneIntegrazioni

Cal.com

Collega i tuoi agenti ElevenLabs alla pianificazione di Cal.com.

Panoramica

Collega i tuoi agenti IA di ElevenLabs a Cal.com per gestire la pianificazione e le prenotazioni sul calendario. Questa integrazione consente ai tuoi agenti di controllare la disponibilità, prenotare appuntamenti, annullare o riprogrammare riunioni e cercare prenotazioni esistenti tramite conversazioni naturali.

Funzionalità

FunzionalitàSupporto
Modalità a ritenzione zero (ZRM)Non supportata
Allegati negli strumentiNon supportati — gli strumenti operano solo sul testo

Configurazione

Questa integrazione utilizza una chiave API di Cal.com per l’autenticazione (non un’app OAuth).

1

Genera una chiave API in Cal.com

Vai a Impostazioni > Sviluppatore > Chiavi API nel tuo account Cal.com e fai clic su Nuova. Copia immediatamente la chiave generata: non verrà mostrata di nuovo.

2

Usa una chiave live

Cal.com genera due tipi di chiavi: chiavi di test (che iniziano con cal_) e chiavi live (che iniziano con cal_live_). Usa una chiave live affinché il tuo agente possa accedere ai dati reali del calendario.

3

Connetti in ElevenLabs

Nella configurazione dell’integrazione ElevenLabs, incolla la chiave API di Cal.com nel campo API Key.

Demo

Questa demo utilizza strumenti webhook legacy. Se usi l’integrazione nativa di Cal.com, gli strumenti vengono configurati automaticamente: non è necessaria alcuna configurazione manuale dei webhook.

Demo dell'integrazione Cal.com

Come funziona

L’agente pianifica le riunioni usando chiamate agli strumenti per seguire il processo di prenotazione passo dopo passo. Le schede seguenti mostrano una panoramica generale e il prompt di sistema dettagliato.

1

Richiesta iniziale e dettagli della riunione

L’agente chiede lo scopo della riunione, la data e l’ora preferite e la durata per raccogliere le informazioni necessarie alla pianificazione.

2

Controlla la disponibilità del calendario

L’agente controlla la disponibilità del calendario:

  • Usa lo strumento get_available_slots per recuperare le fasce orarie libere.
  • Verifica se l’orario richiesto è disponibile.
  • Suggerisce alternative se l’orario richiesto non è disponibile.
  • Conferma l’orario selezionato con il chiamante.
3

Raccolta delle informazioni di contatto

Una volta concordato un orario, l’agente:

  • Raccoglie e convalida il nome completo del partecipante.
  • Verifica la correttezza dell’indirizzo email.
  • Conferma le informazioni sul fuso orario.
  • Raccoglie eventuali altri campi richiesti per il tipo di evento Cal.com.
4

Creazione della riunione

L’agente:

  • Chiama lo strumento book_meeting dopo aver verificato tutte le informazioni.
  • Segue la struttura del modello di prenotazione.
  • Conferma la creazione della riunione con il partecipante.
  • Lo informa che riceverà un invito nel calendario.

Configurazione manuale dei webhook

Se usi l’integrazione nativa di Cal.com, gli strumenti vengono configurati automaticamente. I passaggi seguenti si applicano solo alla configurazione manuale dei webhook.

1

Archivia il tuo segreto Cal.com

Archivia la chiave API in modo sicuro prima di effettuare richieste autenticate. Genera una nuova chiave API di Cal.com se non l’hai già fatto.

L’API di Cal.com prevede il seguente header di autenticazione:

Struttura dell'header di richiesta Cal
'Authorization': 'Bearer YOUR_API_KEY'

Archivia la chiave nell’archivio dei segreti dell’agente per mantenerla al sicuro e accessibile durante le richieste.

Per rispettare la struttura di autenticazione prevista da Cal.com, ricordati di anteporre Bearer alla chiave API quando crei il segreto.

Segreti degli strumenti

2

Aggiungi strumenti all'agente

Abilita le prenotazioni sul calendario creando due strumenti:

  1. get_available_slots: Quando un utente chiede “Louis è libero alle 10:30 di martedì?”, l’agente usa l’endpoint “Ottieni fasce orarie disponibili” di Cal.com per controllare le fasce orarie libere.

  2. book_meeting: Dopo aver individuato un orario adatto, l’agente prenota la riunione usando l’endpoint “Crea una prenotazione” di Cal.com.

Vai alla sezione Strumenti della dashboard e seleziona Aggiungi strumento. Scegli Webhook come tipo di strumento, quindi compila le sezioni seguenti:

Metadati usati dall’agente per determinare quando chiamare lo strumento:

CampoValore
Nomeget_available_slots
DescrizioneQuesto strumento controlla se una determinata fascia oraria è disponibile nel calendario.
MetodoGET
URLhttps://api.cal.com/v2/slots

Metadati usati dall’agente per determinare quando chiamare lo strumento:

CampoValore
Nomebook_meeting
DescrizioneQuesto strumento prenota una riunione nel calendario dopo aver concordato un orario.
MetodoPOST
URLhttps://api.cal.com/v2/bookings

Testa l’agente premendo il pulsante Testa agente IA. Modifica il prompt di sistema secondo necessità.

3

Aggiungi la consapevolezza di data e ora

Per impostazione predefinita, l’agente non conosce la data o l’ora correnti. Usa uno dei seguenti approcci:

  1. Crea uno strumento per recuperare l’ora: aggiungi uno strumento che recuperi la data e l’ora correnti.

  2. Override: usa la funzionalità override per inserire la data e l’ora correnti nel prompt di sistema all’inizio di ogni conversazione.

Considerazioni sulla sicurezza

  • Usa endpoint HTTPS per tutte le chiamate webhook.
  • Archivia i valori sensibili come segreti usando ElevenLabs Secrets Manager.
  • Verifica che tutti gli header di autorizzazione rispettino il formato richiesto (Bearer YOUR_API_KEY).
  • Non esporre mai gli ID dei tipi di evento o i dettagli dell’API ai chiamanti.