Sintesi
Un assistente telefonico AI può gestire appuntamenti e dati dei clienti in modo affidabile solo se comunica con il sistema aziendale che fa fede. Webhook e API permettono di consultare informazioni durante la chiamata e salvare risultati confermati. Questa guida illustra il flusso tipico, gli errori e le misure di protezione, dalla ricerca di disponibilità alla nota nel CRM.
Il sistema collegato deve essere la fonte attendibile
Un modello linguistico può capire una data e fare domande appropriate. Non dovrebbe decidere autonomamente se un appuntamento è libero o se un record è stato modificato. Questi dati devono provenire da calendario, CRM o gestionale degli interventi.
Un flusso sicuro funziona così: l’assistente identifica l’azione richiesta; raccoglie e conferma i dati necessari; un’integrazione interroga il sistema di destinazione; il sistema restituisce opzioni o un errore; l’assistente comunica solo risultati confermati; dopo l’assenso dell’utente invia la prenotazione o modifica; infine, il sistema conferma nuovamente l’esito.
Se non è disponibile un’integrazione adatta, l’assistente può raccogliere la richiesta in modo strutturato e passarla al team, invece di fingere di aver prenotato.
API e webhook: qual è la differenza?
Un’API espone dati o funzioni definite tramite endpoint tecnici. Un webhook è spesso una richiesta specifica inviata a uno di questi endpoint durante un flusso. Un assistente può usarlo, ad esempio, per verificare appuntamenti liberi o inviare al CRM contatti confermati e motivo della chiamata.
Con i nostri webhook, gli assistenti VoiceBooker possono recuperare informazioni aggiornate da un sistema esterno durante la chiamata o inviargli dati confermati. Le azioni disponibili dipendono anche dalle interfacce e dai permessi del sistema collegato.
Nei flussi con più fasi, i dati confermati possono restare disponibili per tutta la conversazione nell’oggetto State, per poi essere inviati a un webhook. L’assistente non deve chiedere di nuovo nome, richiesta o opzione scelta. Conservate e trasferite solo i valori necessari al passaggio successivo.
Esempio: prenotare un appuntamento al telefono
Immaginiamo un servizio che richiede tipo di prestazione, sede, periodo desiderato e contatti. L’assistente dovrebbe raccogliere i dati passo dopo passo e chiedere in modo mirato quelli mancanti.
Verificare la disponibilità
L’assistente invia i parametri di ricerca al calendario, che restituisce gli orari liberi. L’assistente propone solo quelli e lascia scegliere. Se non c’è un orario adatto, può chiedere un altro periodo o registrare una richiesta di richiamata.
Confermare la prenotazione
Dopo la scelta, il sistema invia la richiesta di prenotazione. Solo una risposta positiva del calendario consente all’assistente di confermare l’appuntamento. Se il calendario segnala un conflitto o non è raggiungibile, non deve dire che la prenotazione è riuscita.
Aggiornare il CRM
Dopo la prenotazione, una nota CRM può contenere appuntamento, motivo e contatti necessari. Trasferite solo le informazioni utili al passaggio successivo. Non è automaticamente necessario salvare la registrazione completa della chiamata.
Protezioni tecniche e gestione degli errori
Evitare azioni duplicate
Dopo un timeout può non essere chiaro se il sistema abbia ricevuto la richiesta. Un nuovo tentativo non deve prenotare lo stesso appuntamento due volte senza segnalarlo. Se il sistema lo supporta, usate un identificativo univoco e verificate lo stato corrente della prenotazione.
Convalidare i dati
Prima dell’invio controllate formato della data, telefono, campi obbligatori, prestazioni ammesse e sede. Per i dati critici chiedete conferma invece di indovinare da una frase poco chiara.
Gestire gli errori con chiarezza
Stabilite cosa fare se l’integrazione non è disponibile, i dati non sono validi o manca la risposta. Le alternative possono essere una richiamata, una notifica interna o il trasferimento al personale. L’assistente deve spiegare il limite in modo semplice e non dichiarare riuscita un’azione non confermata.
Limitare credenziali e dati
Le integrazioni richiedono autenticazione. Conservate in modo sicuro le credenziali, limitate i permessi alle azioni necessarie e non inserite segreti come token API nei dati della conversazione. Trasferite solo le informazioni richieste per la specifica attività.
Test prima dell’avvio
Provate non solo i casi corretti, ma anche date non valide o incomplete; un orario occupato poco prima della prenotazione; chiamate duplicate e nuovi tentativi API; identificazione errata del cliente; risposte vuote, timeout ed errori server; modifiche o cancellazioni rifiutate dal backend; messaggi per prenotazioni riuscite e fallite.
Confrontate il registro della conversazione con il sistema di destinazione: orari, nomi e azioni coincidono? Il team può ricostruire in seguito cosa è successo?
Conclusione
Collegare CRM o calendario rende operativo l’assistente, ma richiede aggiornamenti di sistema corretti. Il backend deve confermare disponibilità e modifiche concluse; l’assistente comunica il risultato con chiarezza. Percorsi d’errore, credenziali sicure e test realistici fanno parte dell’integrazione fin dall’inizio.
Per altri esempi consultate le nostre guide ai webhook e all’accesso API.