Che cos'è la scheda Pre-call dell'assistente AI4CALL

Nella scheda Pre-call prepari ciò che deve accadere prima della conversazione. I percorsi sono due: la verifica del numero chiamante, che interroga un tuo servizio esterno prima di avviare l'assistente, e il Pre-call con strumenti, che mette uno o più tool a disposizione in questa fase. In entrambi i casi il lavoro si chiude prima che l'assistente inizi a parlare con chi chiama.

Il videotutorial qui sopra mostra entrambe le configurazioni dentro l'assistente. Qui sotto trovi il riepilogo scritto, comodo da tenere aperto mentre configuri.

Verifica del numero chiamante: a cosa serve e come si configura

Questa funzione interroga un tuo servizio esterno prima di avviare l'assistente: puoi usarla, per esempio, per controllare se il numero appartiene a un cliente. La risposta può anche restituire informazioni utili a personalizzare la conversazione. Attenzione: il controllo deve essere attivo, altrimenti la verifica non viene eseguita.

Apri Nuova e dai un nome alla configurazione: nell'esempio la chiamiamo Verifica cliente. Inserisci l'indirizzo del tuo servizio, il metodo richiesto e il timeout; qui usiamo un indirizzo dimostrativo e una richiesta POST. Indica poi dove inviare il numero e con quale nome: nell'esempio il numero viaggia nel body, nel campo phone.

Autenticazione e header personalizzati

L'autenticazione deve corrispondere a quella richiesta dal servizio. Il menu propone nessuna autenticazione, Bearer Token, API Key e Basic Auth. Se il servizio richiede un token, scegli Bearer Token e compila il campo dedicato. Gli header personalizzati coprono i dati aggiuntivi eventualmente richiesti dall'integrazione.

Attenzione alla regola di blocco

La chiamata termina subito in un solo caso: la risposta contiene esplicitamente il campo enabled impostato a false. Se è true, se manca, oppure se la risposta è vuota o non valida, la conversazione prosegue. Una risposta mancante, quindi, non equivale a un rifiuto automatico. Il campo callerInfo può aggiungere informazioni sul chiamante.

Pre-call con strumenti: catalogo, istruzioni AI e output

Attiva il Pre-call e apri il catalogo: filtra gli strumenti disponibili e seleziona quelli che ti servono. La selezione rende il tool disponibile in questa fase, mentre le istruzioni dicono al modello quando usarlo. L'ordine mostrato è un suggerimento, non una sequenza automatica garantita.

Nell'esempio selezioniamo lo strumento che verifica la disponibilità nel calendario. Per eseguire la verifica servono già una data e un'ora, ma prima della conversazione il cliente non le ha ancora dette: l'esempio è adatto solo se quei dati arrivano da un contesto già disponibile.

Nel campo Istruzioni AI scriviamo una regola precisa:

• Verifica la disponibilità soltanto se data e ora sono già disponibili.
• Non creare eventi.
• Se mancano dati, segnala che la verifica non è stata eseguita.

Così distinguiamo una verifica preliminare da una prenotazione. Il modello può essere quello principale oppure una configurazione dedicata.

Configura output, voce e testo di attesa

Con Configura output definisci i valori da rendere disponibili dopo questa fase. Nell'esempio aggiungiamo un valore per l'esito della disponibilità, e la descrizione chiarisce anche cosa restituire quando data e ora mancano. Usa nomi riconoscibili e istruzioni che non lascino spazio a dati inventati.

Nella sezione audio scegli la voce del Pre-call e scrivi il testo di attesa, per esempio: un momento, sto verificando le informazioni necessarie. Il testo deve descrivere un'attività che stai davvero svolgendo. Controlla infine le opzioni per interrompere l'audio e per terminare in anticipo in caso di errore.

Domande frequenti sul Pre-call

Quando la verifica del chiamante blocca la chiamata?

In un solo caso: quando la risposta del servizio esterno contiene esplicitamente il campo enabled impostato a false. Se il campo è true, se manca, oppure se la risposta è vuota o non valida, la conversazione prosegue.

Che differenza c'è tra verifica del chiamante e Pre-call con strumenti?

La verifica del chiamante interroga un tuo servizio esterno con il numero della persona che chiama, prima di avviare l'assistente. Il Pre-call con strumenti seleziona invece dei tool dal catalogo e li rende disponibili in questa fase, con istruzioni che indicano al modello quando usarli.

Le prove consumano risorse?

Sì. La schermata ricorda che le prove possono eseguire davvero gli strumenti e generare consumi. Prima di una prova, controlla le azioni selezionate e i dati utilizzati.