📅 Configurazione Server MCP - Calendly

No. I tool MCP Calendly disponibili permettono solo di LEGGERE dati (disponibilità, eventi, invitati) e CANCELLARE eventi. La prenotazione vera e propria deve avvenire tramite il link pubblico Calendly o altri sistemi. L'assistente può però verificare disponibilità e fornire il link corretto al cliente.

Accedi al tuo account Calendly, vai su Impostazioni > Integrazioni > API & Webhooks. Genera un nuovo Personal Access Token e copialo. Questo token va inserito nel campo "Token di Autenticazione" nella configurazione AI4CALL. Il token inizia sempre con "eyJ".

L'assistente può: verificare disponibilità orari (calendly_get_available_times), consultare eventi programmati (calendly_get_scheduled_events), leggere dettagli invitati (calendly_get_event_invitees e calendly_get_invitee), recuperare tipi di evento disponibili (calendly_get_event_types), e cancellare eventi (calendly_cancel_event). Non può creare nuovi appuntamenti.

calendly_get_event_invitees restituisce TUTTI gli invitati di un evento specifico (lista completa). calendly_get_invitee restituisce i dettagli di UN SINGOLO invitato specifico tramite il suo UUID. Usa il primo per vedere chi partecipa a un evento, il secondo per recuperare dati dettagliati di una persona specifica.

Sì, l'operazione è IRREVERSIBILE. Una volta cancellato l'evento tramite il server MCP, non può essere ripristinato. Per questo è fondamentale istruire l'assistente a chiedere SEMPRE conferma esplicita al cliente prima di eseguire la cancellazione.

Deve prima invocare calendly_get_event_types per recuperare tutti i tipi di evento configurati sul tuo Calendly (es. "Consulenza 30min", "Videocall 1h"). Poi usa l'UUID del tipo evento corretto per chiamare calendly_get_available_times. Nel prompt puoi specificare nomi esatti o lasciare che l'assistente identifichi il tipo giusto dalla richiesta.

Non a livello di tool MCP - se attivi calendly_cancel_event, funziona su tutti gli eventi. La limitazione va gestita a livello di prompt: istruisci l'assistente a cancellare solo eventi che matchano criteri specifici (es. solo eventi futuri, solo per determinati clienti, solo con conferma esplicita).

L'assistente usa calendly_get_event_invitees o calendly_get_invitee per recuperare l'URL di conferma dall'evento. Poi, se hai configurato il tool WhatsApp Business o Email SMTP, può invocare send_whatsapp_message o send_email per inviare automaticamente il link al cliente durante la chiamata.

Sì. calendly_get_event_invitees restituisce TUTTI gli invitati di un evento, quindi funziona anche per eventi di gruppo. Puoi vedere quante persone hanno confermato, i loro dati, e lo stato di ciascun invitato (attivo, cancellato, in attesa).

Tutti i tool MCP smetteranno di funzionare immediatamente. L'assistente riceverà errori di autenticazione quando prova a invocare qualsiasi tool Calendly. Dovrai generare un nuovo token dalle impostazioni Calendly e aggiornarlo nella configurazione AI4CALL.

No. Puoi configurare un solo Bearer Token alla volta nel server MCP. Se hai più account Calendly, devi scegliere quale account collegare. Per gestire più account, dovresti configurare assistant AI4CALL separati, ciascuno con il proprio token.

Deve prima invocare calendly_get_scheduled_events per recuperare tutti gli eventi programmati, poi identificare quello corretto confrontando data/ora o dettagli forniti dal cliente. Una volta trovato l'UUID dell'evento giusto, può invocare calendly_cancel_event per cancellarlo.

Mostra SOLO gli slot effettivamente disponibili per la prenotazione, basandosi sui calendari collegati al tuo Calendly. Non vengono mostrati orari già occupati, slot fuori orario lavorativo, o date bloccate. È la stessa disponibilità che vedrebbe un cliente sul link pubblico Calendly.

No. L'API Calendly tramite MCP non supporta la modifica (reschedule) diretta degli eventi. Puoi solo cancellare l'evento esistente e far prenotare al cliente un nuovo slot. L'assistente può guidare il cliente in questo processo sequenzialmente.

Recupera informazioni sull'account Calendly autenticato tramite il token: nome, email, timezone, URL del profilo, e l'organization UUID. È utile per verificare che la connessione funzioni e per recuperare dati necessari ad altri tool (alcuni richiedono l'user URI).

Sì. Nel prompt istruisci l'assistente a invocare calendly_get_available_times con start_time impostato sulla data/ora attuale. Il tool restituirà gli slot disponibili in ordine cronologico, e l'assistente può proporre i primi 3-5 slot al cliente.

Per ogni invitato: nome completo, email, stato (active/canceled), timezone, data creazione invito, URL di conferma, eventuali domande/risposte custom, e l'UUID univoco dell'invitato. Tutti i dati necessari per contattare il cliente o verificare lo stato della prenotazione.

Sì, ma i limiti dipendono dal tuo piano Calendly. Se l'assistente fa troppe richieste in poco tempo, l'API Calendly può bloccare temporaneamente le chiamate. Per eventi ad alto traffico, ottimizza il prompt per ridurre chiamate non necessarie (es. cache delle disponibilità per alcuni minuti).

Sì. L'assistente può usare più tool MCP contemporaneamente. Esempio workflow: usa Calendly per verificare disponibilità, poi usa WhatsApp tool per inviare conferma, oppure usa Google Calendar MCP per sincronizzare l'evento. I tool MCP sono componibili e l'LLM li orchestra autonomamente.

Calendly gestisce automaticamente i timezone. calendly_get_available_times accetta il parametro start_time in formato ISO 8601 con timezone. Gli eventi e invitati restituiti includono sempre il timezone specifico. L'assistente può convertire automaticamente se necessario, usando il timezone del cliente.