Generare una chiave API di Cal.com

Per abilitare la prenotazione degli appuntamenti nell’AI Scheduler occorre collegare l’account Cal.com tramite una chiave API. Una volta collegato, l’AI Scheduler può prenotare, spostare, annullare e verificare gli appuntamenti in tempo reale durante le chiamate dei clienti. La funzione è disponibile sia per il centralino in cloud EagleMercury sia per il Contact Center EagleMercury.

Prima di iniziare

Serve un account Cal.com. Se non ne hai uno, è possibile crearlo sul sito di Cal.com, il software di pianificazione per le prenotazioni online.

Nota

La skill Booking (prenotazione) è facoltativa. Se non è configurata, l’AI Scheduler non tenta di fissare appuntamenti.

Generare la chiave API di Cal.com

Seguire questi passaggi per creare una chiave API in Cal.com:

1. Accedere al proprio account Cal.com.
2. Fare clic sul menu a discesa accanto al proprio nome.
3. Selezionare My Settings.
4. Scorrere fino alla sezione Developer e fare clic su API Keys.
5. In alto a destra, fare clic su + New.
6. Inserire un nome per la chiave API.
7. Impostare la data di scadenza (Expiration date) dal menu a discesa oppure attivare Never expires (nessuna scadenza).
8. Fare clic su Create.
9. Copiare subito la chiave API e conservarla in un luogo sicuro.

Importante

Una volta generata, la chiave API non può più essere visualizzata. Se la si perde, occorre crearne una nuova. Non c’è limite al numero di chiavi API attive.

Buone pratiche consigliate

Usare una chiave API senza scadenza

Usare una chiave API senza scadenza aiuta a evitare interruzioni del servizio.

Mantenere semplici i nomi dei tipi di evento

Usare nomi chiari e facili da pronunciare, ad esempio:

• Prima consulenza
• Appuntamento di 30 minuti

Evitare etichette troppo complesse, che i chiamanti o l’AI Agent potrebbero avere difficoltà a riconoscere.

Verificare che i tipi di evento siano visibili

I tipi di evento configurati in Cal.com non devono essere nascosti, altrimenti l’AI Scheduler potrebbe non riuscire ad accedervi correttamente.

Collegare i calendari esterni

Cal.com può sincronizzarsi con:

• Google Calendar;
• Outlook;
• altri sistemi di calendario.

In questo modo è possibile:

• evitare doppie prenotazioni;
• mostrare solo le fasce orarie disponibili;
• inviare aggiornamenti in tempo reale al personale.

Risoluzione dei problemi

Se la comunicazione con Cal.com non riesce durante un tentativo di prenotazione:

• l’errore viene mostrato in AI Builder;
• è possibile generare una nuova chiave API e ricollegare l’account;
• è possibile disattivare temporaneamente la skill Booking e completare la configurazione in seguito in modalità Edit (modifica).

Nota

Se la prenotazione non è configurata, l’AI Scheduler non tenta di fissare appuntamenti.