Integrazione Cal.com
Collega Cal.com e il tuo agente AI prenota appuntamenti in chat
Incolla una API key di Cal.com, scegli un tipo di evento e il tuo agente intoCHAT mostra orari liberi reali sotto la sua risposta. Il visitatore ne sceglie uno, inserisce nome ed email e la prenotazione viene creata in Cal.com, che invia la sua solita conferma.
Come lavorano insieme intoCHAT e Cal.com
intoCHAT comunica con l'API di Cal.com (versione 2, su api.cal.com) usando una API key del tuo account Cal.com. Con quella chiave fa tre cose e nient'altro: elenca i tuoi tipi di evento perché tu possa sceglierne uno, legge gli orari liberi di quel tipo di evento e crea una prenotazione quando un visitatore conferma un orario. Le tue regole di disponibilità, i tempi cuscinetto e i calendari collegati restano in Cal.com, ed è da lì che arrivano gli orari liberi. Il modello AI non inventa mai un orario. È l'agente a decidere quando mostrare la scelta degli orari, guidato da un breve testo che scrivi tu: When to offer booking. Quando la conversazione lo richiede, per esempio se un visitatore chiede una demo o vuole sapere quando qualcuno è disponibile, mostra gli orari liberi sotto la sua risposta. Non elenca gli orari nel testo e non chiede nome o email in chat: il visitatore li inserisce nel selettore. Subito prima di prenotare, intoCHAT chiede di nuovo a Cal.com se l'orario è ancora libero. Se nel frattempo l'ha preso qualcun altro, il visitatore viene invitato a sceglierne un altro e nulla viene prenotato due volte. Se il tuo tipo di evento richiede che tu confermi le prenotazioni, la conferma in chat inizia con «Richiesto:» invece di «Prenotato:» e dice che l'appuntamento deve ancora essere confermato. Questa pagina riguarda la connessione con Cal.com in sé: configurazione, cosa si sincronizza e i limiti. Per vedere come appare la prenotazione in chat ai visitatori e come usarla nelle conversazioni di vendita e assistenza, consulta la pagina della funzionalità di prenotazione appuntamenti.
Collega Cal.com al tuo agente intoCHAT
Crea una API key in Cal.com
In Cal.com apri Settings, Developer, API keys e crea una chiave. Inizia con cal_. Ti serve anche almeno un tipo di evento, per esempio una call conoscitiva di 30 minuti.
Apri la scheda Booking
In intoCHAT apri il tuo agente e vai alla scheda Actions. La scheda Booking si trova sotto le tue azioni e i tuoi moduli. In Calendar scegli Cal.com.
Incolla la chiave e clicca Connect
Incollala nel campo Cal.com API key. intoCHAT verifica la chiave caricando i tuoi tipi di evento, la salva cifrata e da quel momento mostra solo cal_… e gli ultimi quattro caratteri.
Scegli il tipo di evento da prenotare
Ogni tipo di evento mostra titolo e durata. Uno contrassegnato «(hidden in Cal.com)» è nascosto nella tua pagina di prenotazione pubblica, ma i visitatori possono comunque prenotarlo dalla chat.
Indica quando proporre la prenotazione e salva
Se vuoi, compila When to offer booking, fino a 1.000 caratteri: lo legge l'agente, i visitatori non lo vedono mai. Clicca Save: la prenotazione è attiva appena salvi.
Prenota un appuntamento di prova
Chiedi un appuntamento nel Playground e prenota un orario. Le prenotazioni nel Playground sono reali: creano l'appuntamento in Cal.com e fanno partire le sue email, quindi poi annulla le prenotazioni di prova in Cal.com.
When to offer booking, se lasci il campo vuoto
When the visitor wants to book a meeting, call, demo or appointment, or asks when the team is available.Il campo mostra questo testo predefinito in inglese. Scrivine uno tuo per restringere i casi, per esempio solo dopo che il visitatore ha detto quale prodotto gli interessa.
Cosa si sincronizza tra intoCHAT e Cal.com
Orari liberi, letti in tempo reale
Gli orari arrivano da Cal.com ogni volta che si apre il selettore: fino a 5 giorni con orari liberi e fino a 8 orari al giorno, 7 giorni in avanti per impostazione predefinita, oppure i giorni chiesti dal visitatore, fino a un anno in avanti.
Prenotazioni create in Cal.com
Un orario confermato diventa una prenotazione Cal.com con nome, email e fuso orario del visitatore. Cal.com invia le sue solite email e gli inviti del calendario; intoCHAT non invia email proprie.
Il fuso orario del visitatore
Gli orari appaiono nel fuso orario del browser del visitatore, per esempio «Orari nel fuso Europe/Berlin», e scritti come il suo browser scrive date e ore.
Un elenco delle prenotazioni in intoCHAT
La scheda Bookings nella scheda Leads elenca ogni appuntamento prenotato dalla chat, con nome, email e fuso orario del visitatore e un link alla conversazione.
Webhook e avviso Slack
Iscrivi un webhook a Meeting booked per ricevere booking.created con provider calcom e l'ID della prenotazione in Cal.com, oppure spunta Booked meeting in Slack alerts.
Una chiave usata solo per prenotare
La chiave è salvata cifrata e non viene più mostrata. intoCHAT la usa per leggere tipi di evento e orari liberi e per creare prenotazioni, nient'altro in Cal.com.
Domande frequenti
Quale piano intoCHAT mi serve per Cal.com?
Qualsiasi piano, anche Free: la prenotazione con Cal.com non è legata a un piano intoCHAT a pagamento. Prenotare un orario non consuma messaggi; la risposta che mostra gli orari conta come qualsiasi altra risposta. Le procedure, da Starter, possono anche dire all'agente di proporre la prenotazione dopo qualche domanda di qualificazione.
Un annullamento in Cal.com compare in intoCHAT?
No. Da Cal.com non si sincronizza nulla all'indietro. Se un appuntamento viene spostato o annullato lì, l'elenco delle prenotazioni e la conversazione mostrano ancora la prenotazione originale e non viene inviato alcun webhook. I visitatori annullano o spostano tramite le email di Cal.com, non in chat.
Posso collegare un'istanza Cal.com self-hosted?
Per ora no. intoCHAT si collega all'API ospitata di Cal.com su api.cal.com, quindi la API key deve provenire da un account lì.
Un agente può offrire più tipi di evento?
No. Ogni agente prenota un tipo di evento di un calendario alla volta. Usa Change event type nella scheda Booking per cambiarlo. Per offrire una demo commerciale e una call di assistenza, crea due agenti, ciascuno con il proprio tipo di evento.
E se Cal.com rifiuta la mia chiave?
La scheda dice «Cal.com didn't accept this API key.» Controlla di aver copiato tutta la chiave e che non sia scaduta o eliminata in Cal.com. Se il tuo account non ha ancora tipi di evento, creane uno e clicca di nuovo Connect. Puoi verificare le chiavi fino a 10 volte in 10 minuti.
Cosa succede se l'orario è appena stato preso?
intoCHAT chiede di nuovo a Cal.com subito prima di prenotare. Se l'orario non c'è più, il visitatore vede «Questo orario è appena stato prenotato. Sceglierne un altro.» e quell'orario sparisce dall'elenco.
Una prenotazione viene salvata anche come lead?
No. Una prenotazione ha il suo elenco, il suo webhook (booking.created) e il suo avviso Slack. Nome ed email inseriti nel selettore non creano un lead né inviano un avviso lead, e le prenotazioni non vengono contate in Outcomes nella dashboard.
Come sospendo la prenotazione senza perdere la configurazione?
Usa l'interruttore On / Off nell'intestazione della scheda Booking. Disconnect interrompe la prenotazione ed elimina la chiave salvata; gli appuntamenti già prenotati restano in Cal.com e nell'elenco delle prenotazioni. Un agente duplicato non copia la connessione a Cal.com, quindi collegala di nuovo nella copia.
Guardalo rispondere dal tuo sito
Incolla l’indirizzo del tuo sito e chatta con un agente creato dalle tue pagine. Ci vuole circa un minuto.
Crea il tuo agente gratisPiano gratuito, nessuna carta di credito.