Collegare un assistente telefonico al sistema di appuntamenti
Pianifichi prenotazioni, orari occupati, risposte perse e modifiche degli appuntamenti con un esempio di integrazione svolto.
Un assistente telefonico deve confermare un appuntamento solo dopo che il sistema di prenotazione di riferimento ha confermato il record corretto. Servono funzioni di integrazione circoscritte e risposte che mostrino lo stato effettivo. Un elenco di orari liberi non è ancora una prenotazione.
Mantenere le regole nel sistema di prenotazione
Nell’esempio fittizio, un’azienda software propone ai clienti esistenti incontri di progetto di 30 minuti per la risorsa consultation-a. La persona sceglie il 19 novembre 2026 dalle 14:00 alle 14:30, nel fuso Europe/Berlin. L’assistente ripete data, ora e durata e attende una scelta esplicita.
Il servizio di prenotazione verifica tipi di appuntamento ammessi, permessi e sovrapposizioni al momento della scrittura. Anche sito e personale devono usare la stessa regola di assegnazione. Una sincronizzazione successiva del calendario non impedisce a due canali di assegnare contemporaneamente lo stesso orario.
Prevedere quattro funzioni circoscritte
Funzione dell’esempio | Compito | Risposta necessaria |
|---|---|---|
| Cercare intervalli adatti e liberi | Intervalli con data e fuso orario |
| Prenotare l’intervallo scelto esplicitamente | Prenotazione confermata o motivo preciso di rifiuto |
| Chiarire l’esito di una richiesta tramite identificatore | Prenotazione esistente, richiesta fallita o stato ancora incerto |
| Spostare una prenotazione esistente | Modifica confermata o appuntamento iniziale invariato |
ElevenLabs descrive queste funzioni esterne come strumenti webhook. Nomi e regole qui sono un nostro progetto. Il server verifica autonomamente parametri e permessi; una chiamata del modello non concede diritti di accesso. Le chiavi non vanno inserite nel testo della conversazione. Citare un identificatore di prenotazione non dimostra da solo il diritto di modificarla.
Compilare richiesta e risposta
Il server assegna l’identificatore stabile R-94 a questa richiesta. Dopo aver stabilito l’associazione della persona all’account corretto, la funzione riceve questi dati applicativi:
{"requestId":"R-94","resourceId":"consultation-a","start":"2026-11-19T14:00:00+01:00","timeZone":"Europe/Berlin","durationMinutes":30}Non è una chiamata diretta a Google Calendar. La query Freebusy di Google restituisce gli intervalli occupati; il percorso di prenotazione scelto deve assicurare separatamente l’assegnazione esclusiva. Nell’esempio, controllo e prenotazione sono protetti dalle prenotazioni concorrenti. Solo questa conferma applicativa consente di promettere l’appuntamento:
{"requestId":"R-94","status":"confirmed","bookingId":"B-94"}L’assistente può ora confermare l’orario concordato. Creare un evento non dimostra da solo che un invito sia stato letto.
Verificare quattro casi fino al risultato salvato
Caso | Comportamento atteso del sistema | Messaggio durante la chiamata |
|---|---|---|
L’orario è libero al momento della scrittura | Viene confermata una prenotazione | Confermare l’appuntamento concordato |
L’orario è stato nel frattempo assegnato | Nessun’altra prenotazione per la stessa risorsa e lo stesso orario | Proporre nuovi orari liberi |
La risposta alla prenotazione si perde | Chiarire prima l’esito esistente con | La conferma è ancora in attesa |
Lo spostamento richiesto alle |
| Modifica rifiutata; indicare l’appuntamento iniziale |
Ripetere lo stesso identificatore con gli stessi dati nello stesso ambito di autorizzazione deve restituire l’esito esistente. Una richiesta modificata riceve un nuovo identificatore. Se l’esito resta incerto, non si forza una seconda prenotazione con un nuovo identificatore: si segue il percorso di chiarimento predisposto.
Lo spostamento non deve eliminare prematuramente il vecchio appuntamento. Se l’integrazione non supporta un passaggio protetto, serve un flusso distinto invece di una promessa automatica. I casi di collaudo definiti in anticipo mostrano prima dell’avvio se conversazione e prenotazione coincidono davvero.
Fonti
Continuate a leggere
Tutti gli articoli
IA & automazione con ASES
Assistenti IA e processi automatizzati