Riferimento delle impostazioni dell

Spiegazione di ogni impostazione dell

Apri Agenti vocali, seleziona un agente e usa la relativa scheda Configurazione per controllare come parla, ragiona, avvia le chiamate, usa gli strumenti, gestisce il silenzio e la segreteria, e raggiunge i chiamanti. Le modifiche vengono salvate automaticamente in una bozza; il traffico di produzione non cambia finché non selezioni Distribuisci.

Questa pagina è il riferimento completo del dashboard. Per i nomi dei campi e gli esempi di richiesta, usa il riferimento API degli agenti.

Prompt e identità#

Il nome dell'agente lo identifica in tutto il dashboard, nei report, nella cronologia delle chiamate e nei portali clienti. Il prompt è il copione operativo dell'agente: persona, informazioni aziendali, domande obbligatorie, politica di escalation e azioni di chiamata.

L'editor del prompt mostra i token stimati e segnala problemi comuni, come un prompt vuoto, segnaposto di modello non risolti, un percorso di escalation mancante o un prompt molto lungo. I primi 5.000 token stimati sono inclusi; i prompt più lunghi usano i prezzi con sovrapprezzo a blocchi.

Per le regole di instradamento, i trasferimenti a freddo e i trasferimenti a caldo con filtro, consulta Trasferire le chiamate.

Livello del modello#

Storm offre due controlli facoltativi:

• Conferma — Nessuno rimane silenzioso mentre prepara la risposta completa; Segnale acustico riproduce un lieve suono di attesa; Verbale pronuncia una breve conferma e aggiunge 2¢/min. Il testo verbale può essere generato dal prompt principale o fornito manualmente. Prompt di conferma personalizzato appare solo quando la modalità Storm selezionata supporta conferme verbali; altrimenti questo campo è temporaneamente non disponibile.
• Intelligenza aggiuntiva — aggiunge un ragionamento più approfondito per le chiamate complesse e 3¢/min.

Il builder mostra continuamente il costo totale al minuto dell'agente, inclusi il livello, il percorso voce/lingua, la lunghezza del prompt, la conferma verbale, l'intelligenza aggiuntiva e la supervisione.

Voce, sottofondo e lingue#

Seleziona una voce e riproduci il relativo campione prima di distribuire. Il selettore richiede solo che la voce scelta supporti la lingua principale. Se attivi Passa alle voci native, le lingue aggiuntive possono essere gestite da voci native del catalogo dello stesso genere. Le combinazioni premium sono contrassegnate con il relativo sovrapprezzo. Le tue voci personalizzate vengono visualizzate nello stesso selettore non appena sono pronte. Consulta Libreria vocale e voci personalizzate.

La traccia di sottofondo può essere:

• Nessuno — nessun audio ambientale.
• Call center — un sottofondo da call center, con anteprima nel dashboard.

Imposta una lingua principale, quindi un numero qualsiasi di lingue aggiuntive. L'agente rileva automaticamente quando un chiamante passa a una lingua selezionata e risponde in quella lingua. Alcune combinazioni di voce/lingua aggiungono 3¢/min; consulta il catalogo generato delle Lingue supportate.

Quando un agente ha Lingue aggiuntive, abilita Passa alle voci native per usare una voce del catalogo nativa della lingua rilevata, abbinata per genere. L'agente torna alla voce configurata per la lingua principale. Se non è disponibile una voce nativa corrispondente, continua a usare la voce corrente. Le voci personalizzate non cambiano. Prova ogni lingua con Parla, quindi seleziona Distribuisci.

Il passaggio alle voci native non comporta un sovrapprezzo separato. La combinazione selezionata di lingua e voce determina comunque se si applica la tariffa per lingua premium.

Funzionalità connesse#

La scheda Config dispone di quattro sezioni di funzionalità collegabili in modo indipendente:

Un collegamento fa parte della bozza e diventa disponibile per le chiamate in produzione dopo la distribuzione. Configura prima le risorse in Connessioni o Knowledge, quindi collegale all'agente.

Endpoint telefonici e web#

In Numeri di telefono, collega un numero esistente, ottieni un numero ThunderPhone oppure importa un numero tramite una connessione VoIP. Un numero può utilizzare agenti diversi per le direzioni in entrata e in uscita.

In Widget web, collega un widget affinché i visitatori possano parlare con l'agente da un sito. La disponibilità del widget può anche essere abilitata o disabilitata nella configurazione dell'agente.

Fuso orario#

Il fuso orario, sotto i numeri di telefono, è ciò che l'agente considera come "adesso": indica data e ora, propone orari per gli appuntamenti e calcola "oggi" e "domani" in questo fuso. Anche gli orari lavorativi di questo agente nei report usano questo fuso.

Un nuovo agente inizia con il fuso orario della tua organizzazione oppure, se l'organizzazione non ne ha uno, con quello del tuo computer. Modificalo se i tuoi chiamanti si trovano altrove. Quando il numero di telefono dell'agente si trova in un fuso diverso da quello scelto, il builder te lo segnala e propone di cambiarlo.

Un agente senza fuso orario (uno precedente oppure creato tramite API senza timezone) usa il fuso del numero su cui avviene la chiamata, poi quello dei numeri dell'agente, poi quello dell'organizzazione e infine quello del Pacifico USA. Il builder mostra quale fuso viene usato e ti chiede di confermarlo oppure di sceglierne uno quando i numeri non consentono di determinarlo (un numero verde o numeri in fusi diversi).

Quando un agente serve contatti in più fusi orari, passa invece il fuso con ogni chiamata: timezone in POST /v1/call o nella risposta del webhook di configurazione.

Se il tuo agente non ha ancora un fuso orario#

I nuovi agenti richiedono un fuso orario. Gli agenti meno recenti potrebbero ancora non averne uno.

Se un agente meno recente non ha un fuso orario, ThunderPhone usa prima l'impostazione dell'agente stesso, se presente, poi quella della tua organizzazione, quindi il fuso orario dedotto dai numeri di telefono dell'agente. Se non è ancora possibile determinarlo, usa Los Angeles come alternativa. L'interfaccia di creazione mostra il fuso orario risolto e ti chiede di confermarlo oppure di sceglierne uno quando i numeri non consentono di determinarlo.

Comportamento avanzato delle chiamate#

Espandi Avanzate nella parte inferiore di Config per accedere ai seguenti controlli.

Supervisione#

Quando è abilitata, un secondo monitor IA controlla ogni turno dell'agente rispetto alle istruzioni e può intervenire senza farsi notare. La supervisione aggiunge 4¢/min e non è disponibile su Bolt.

Tono di connessione#

Riproduci un breve tono subito dopo la connessione della chiamata e prima che una delle parti parli.

Clip introduttiva#

Riproduci una clip preregistrata all'inizio delle chiamate in entrata, seguita dagli squilli, in modo che la linea sembri quella di un'azienda prima che l'agente risponda. Viene riprodotta nelle chiamate telefoniche in entrata e nelle chiamate di test Parla (browser) nel builder. Non viene riprodotta nelle chiamate in uscita, nelle chiamate di test AI, nelle chiamate del widget web o nelle chiamate API Realtime.

• Disattivata (predefinito) — l'agente risponde subito.
• Avviso di registrazione — una voce registrata dice "Questa chiamata potrebbe essere monitorata o registrata, a fini di controllo qualità." Ascoltala in anteprima nel builder.
• La tua registrazione — carica un file audio (MP3, WAV, M4A e altri formati riproducibili dal browser) oppure registrane uno nel browser. Le clip possono durare da 0,5 a 15 secondi. Il builder converte la clip prima di caricarla, quindi puoi riascoltarla o rimuoverla.

Squilli dopo l'introduzione imposta quanti squilli statunitensi vengono riprodotti dopo la clip: Disattivati, 1 squillo (predefinito) oppure 2 squilli.

L'ordine all'inizio di una chiamata è: tono di connessione (se attivo), clip introduttiva, squilli, quindi l'annuncio di consenso o l'informativa sul trattamento AI, se applicabili, e infine il saluto. La clip introduttiva non sostituisce mai l'annuncio di consenso né l'informativa sul trattamento AI, anche quando la clip indica che la chiamata viene registrata. L'audio del chiamante non viene elaborato mentre vengono riprodotti la clip e gli squilli. Una clip personalizzata viene recuperata all'avvio della chiamata; se non può essere caricata entro pochi secondi, la chiamata prosegue senza di essa, quindi un caricamento non riuscito può ritardare il saluto fino a circa 3 secondi.

La clip introduttiva è un'impostazione in bozza come le altre: viene applicata alle chiamate attive quando esegui il deploy.

Suono dello strumento#

Scegli il suono prodotto dallo strumento audio richiamabile dal prompt:

• Nessuno — lo strumento non viene offerto.
• Campanello, Ding o Beep — ciascuno può essere ascoltato in anteprima nel builder.

Suoni di digitazione#

Abilita Suoni di digitazione per riprodurre un leggero suono di tastiera mentre l'agente esegue uno strumento personalizzato. Gli strumenti gestiti dalla piattaforma non lo attivano.

Una volta attivata, scegli il suono. Puoi ascoltare l'anteprima di ciascuno nel builder:

• Tastiera e mouse (predefinito): digitazione con clic del mouse, come se qualcuno stesse cercando informazioni.
• Tastiera meccanica: tasti meccanici brillanti e scattanti.
• Tastiera desktop: digitazione costante su una tastiera standard.
• Laptop: tasti del laptop morbidi e piatti.
• Tastiera da ufficio: tastiera da ufficio silenziosa e discreta.
• Stanza silenziosa: lieve rumore di sottofondo della stanza con una persona che digita.

Riga di avvio dello strumento#

Scegli se riprodurre qualcosa quando l'agente chiama uno strumento:

• Sempre (impostazione predefinita per i nuovi agenti): viene riprodotta una frase a ogni chiamata dello strumento, indipendentemente dalla rapidità con cui lo strumento restituisce il risultato. Se l'agente ha parlato durante la chiamata, le sue parole costituiscono quella frase. Altrimenti, viene riprodotta una breve frase scritta per la chiamata non appena è pronta, oppure una frase standard come "Un momento, per favore" se richiede più di circa un secondo. Gli strumenti che riproducono il proprio audio o agiscono sulla chiamata stessa (input del tastierino, suoni, messa in attesa, trasferimenti, conclusione della chiamata, passaggi tra fasi) ricevono comunque una frase solo se sono lenti, così come qualsiasi strumento mentre l'agente si trova in un menu telefonico o sta parlando con la segreteria telefonica.
• Solo se lo strumento è lento: viene riprodotta una breve frase solo se lo strumento è ancora in esecuzione circa 3 secondi dopo l'ultima volta che l'agente ha parlato. Gli agenti creati prima dell'introduzione di questa impostazione mantengono questa scelta.
• Mai: ThunderPhone non dice nulla quando uno strumento si avvia e all'agente viene detto di non parlare quando chiama uno strumento. Viene comunque riprodotto tutto ciò che l'agente dice durante la chiamata.

Le parole dell'agente vengono sempre riprodotte, qualunque opzione tu scelga. Il chiamante sente al massimo una frase di avvio dello strumento per turno: una frase già pronunciata in quel turno, come le parole dell'agente o un riempitivo durante una risposta lenta, viene conteggiata come tale.

Aggiornamenti per attese prolungate#

Attivi per impostazione predefinita. Quando uno strumento è ancora in esecuzione dopo circa 12 secondi di silenzio, l'agente dice che ci sta ancora lavorando, quindi aggiunge una breve frase per chiedere pazienza circa ogni 15 secondi fino all'arrivo del risultato. Queste frasi sono formulate per la chiamata: seguono il prompt e la persona dell'agente, la conversazione fino a quel momento e la lingua della chiamata, quindi non ripetono una frase fissa. Se non è possibile scrivere una frase in tempo, l'agente usa una frase standard come "Mi dispiace, sta richiedendo un po' più tempo del previsto". Le risposte lente senza uno strumento ricevono brevi frasi standard come "Solo un attimo".

Disattiva Aggiornamenti per attese lunghe per restare in silenzio dopo la riga di avvio dello strumento fino all'arrivo del risultato. Anche le risposte lente senza uno strumento non riceveranno alcun riempitivo. I suoni di digitazione continuano a essere riprodotti se sono attivi. L'impostazione di conferma di Storm è separata e non viene modificata.

Le impostazioni prevalgono sul prompt#

Riga di avvio dello strumento e Aggiornamenti per attese prolungate determinano ciò che ThunderPhone dice mentre uno strumento è in esecuzione. Il testo del prompt non può impedire né aggiungere queste frasi. Per un agente che rimane in silenzio mentre gli strumenti sono in esecuzione, imposta Riga di avvio dello strumento su Mai e disattiva Aggiornamenti per attese prolungate, invece di chiedere silenzio nel prompt. Il controllo del prompt nel builder avvisa quando il prompt richiede silenzio o una frase a ogni chiamata dello strumento e queste impostazioni indicano il contrario.

Invia email#

Abilita Invia email e inserisci un indirizzo del destinatario per fornire all'agente lo strumento send_email. L'indirizzo è fisso nelle impostazioni dell'agente. Il modello scrive l'oggetto e il corpo in testo normale, ma non può scegliere o modificare il destinatario. Indica all'agente le situazioni esatte che devono generare un'email, ad esempio l'invio del messaggio di un chiamante dopo aver raccolto il suo nome e il numero per essere richiamato.

Consulta Strumenti integrati per il comportamento completo degli strumenti.

Calculator#

Abilita Calculator per fornire all'agente lo strumento calculate. L'agente lo utilizza per calcolare con precisione i totali degli ordini, le commissioni e il resto invece di eseguire i calcoli autonomamente. È disattivato per impostazione predefinita; attivalo per gli agenti che comunicano prezzi. Non è necessaria alcuna modifica al prompt.

Consulta Strumenti integrati per il comportamento completo degli strumenti.

Invia SMS#

Abilita Invia SMS per fornire all'agente uno strumento send_sms.

Scegli da quale numero VoIP connesso (Twilio o Telnyx, abilitato agli SMS e verificato) inviare; i numeri forniti da ThunderPhone non possono inviare SMS. Puoi limitare l'invio al solo chiamante oppure consentire altri destinatari e mantenere un elenco consentito di numeri approvati. Puoi anche abilitare un modello di follow-up via SMS per i messaggi inviati dopo la chiamata.

Consulta Strumenti integrati per il comportamento completo degli strumenti.

Contesto audio aggiuntivo#

Contesto audio aggiuntivo controlla la quantità di audio recente del chiamante che viene mantenuta tra i turni:

• Automatico (consigliato) utilizza più audio recente per le chiamate in entrata, dal browser e WebSocket, e solo l'ultimo turno per le chiamate telefoniche in uscita.
• Attivo include gli ultimi turni del chiamante per agevolare correzioni, spelling e raccolta di dati con molti numeri.
• Disattivo include solo l'ultimo turno del chiamante per una latenza inferiore.

L'API Agents espone anche il campo di compatibilità audio_context_mode solo per Storm: full o reduced. È separato dall'impostazione a tre stati additional_audio_context della dashboard riportata sopra.

Chi parla per primo#

Configura separatamente le chiamate in entrata e in uscita:

• In entrata: l'agente parla per primo oppure parla per primo il chiamante.
• In uscita: l'agente parla per primo oppure parla per primo il destinatario.

Per rimuovere il saluto iniziale dell'agente, scegli Il chiamante parla per primo per le chiamate in entrata oppure Il destinatario parla per primo per le chiamate in uscita.

Questa impostazione è utile per i dialer in uscita che devono attendere una persona o un menu telefonico prima di iniziare il copione.

Gestione della segreteria telefonica#

Scegli cosa accade quando una chiamata in uscita raggiunge la segreteria telefonica:

I messaggi della segreteria telefonica possono contenere fino a 2.000 caratteri e supportano {agent_name} e {org_name}. Consulta Prezzi per informazioni su come viene misurato il tempo di chiamata.

Annuncio del consenso#

Per impostazione predefinita, un breve annuncio all'inizio di ogni chiamata informa il chiamante che sta parlando con un assistente IA e che la chiamata viene registrata. Puoi modificare il testo dell'annuncio, fino a 2.000 caratteri; viene riprodotto testualmente nella lingua dell'agente.

La disabilitazione dell'annuncio su un agente idoneo richiede che un amministratore dell'organizzazione confermi che l'organizzazione fornirà qualsiasi avviso legalmente richiesto e otterrà qualsiasi consenso legalmente richiesto. Riabilitarlo e disabilitarlo successivamente richiede una nuova conferma. Consulta la guida alle leggi sul consenso alla registrazione prima di modificare questa impostazione.

Registra chiamate#

Registra chiamate controlla se questo agente archivia l'audio delle chiamate, le trascrizioni e altri contenuti delle chiamate. Affinché la registrazione avvenga, deve essere abilitata anche l'impostazione di registrazione a livello dell'organizzazione. Quando la registrazione è disattivata, questi elementi non vengono archiviati. Una registrazione copre al massimo le prime 3 ore di una chiamata; una chiamata più lunga continua, ma l'audio successivo alle 3 ore non viene registrato. Consulta le leggi sul consenso alla registrazione delle chiamate.

Informativa sul trattamento tramite IA#

Quando la registrazione è disattivata, Informativa sul trattamento tramite IA controlla l'avviso più breve che informa che l'audio viene elaborato in tempo reale ma non registrato. Scegli Usa impostazione dell'organizzazione, Riproduci sempre o Non riprodurre. La disabilitazione dell'informativa richiede un'attestazione da parte di un amministratore dell'organizzazione.

Informative non interrompibili#

Informative non interrompibili rimane visibile per compatibilità, ma abilitarla non ha alcun effetto. Lasciala disattivata. Per il testo iniziale obbligatorio, usa Annuncio del consenso, che viene riprodotto prima della conversazione e non può essere interrotto.

Verifiche del silenzio#

Quando è abilitata, l'agente controlla se il chiamante è ancora presente dopo un periodo di silenzio, ripete fino al limite impostato, quindi riaggancia:

• Secondi prima della verifica: 10–120 secondi.
• Numero massimo di verifiche: 1–10.

I valori predefiniti sono 15 secondi e 3 verifiche.

Durata della chiamata e timeout#

Usa questi controlli per evitare che chiamate bloccate o insolitamente lunghe accumulino tempo di chiamata e costi di telefonia:

• Minuti di silenzio prima di riagganciare: 1–60 minuti. Il valore predefinito è 10 minuti e si applica quando i controlli del silenzio sono disattivati.
• Durata massima della chiamata: 1–360 minuti. I nuovi agenti iniziano con 60 minuti, tranne gli agenti creati dal modello Interpreter, che iniziano senza un limite a livello di agente; aumentalo, riducilo o disattivalo per non avere un limite a livello di agente. Gli agenti creati prima di questo valore predefinito mantengono l'impostazione esistente. 45 secondi prima del limite (un quarto del limite quando è inferiore a 3 minuti), all'agente viene chiesto di concludere e salutare.
• Limite della piattaforma: ogni chiamata termina dopo 6 ore, indipendentemente dall' impostazione dell'agente. L'agente riceve prima lo stesso avviso di conclusione.
• Durata dello squillo: consenti alle chiamate in uscita e trasferite di squillare per 5–120 secondi. Lascialo non impostato per usare i valori predefiniti della piattaforma: 60 secondi per le chiamate in uscita, 45 secondi per i trasferimenti assistiti e il valore predefinito dell'operatore per i trasferimenti diretti. Questa impostazione non influisce sullo squillo delle chiamate in entrata.

Schede del builder e ciclo di vita#

Se un altro editor salva lo stesso agente dopo che lo hai caricato, ThunderPhone blocca il salvataggio o il deploy in conflitto e ti chiede di aggiornare la pagina anziché sovrascrivere le sue modifiche.

Gestisci gli agenti dall'elenco#

La pagina Agenti vocali supporta anche azioni del ciclo di vita a livello di organizzazione:

• Duplica un agente come nuovo punto di partenza nella stessa organizzazione.
• Trasferisci un agente a un'altra organizzazione di cui fai parte. Copia mantiene la sorgente; Sposta la rimuove dall'organizzazione corrente e richiede l'accesso da amministratore.
• Elimina un agente oppure elimina in blocco gli agenti selezionati, dopo la conferma.

Esporta l'elenco degli agenti#

Seleziona uno o più agenti ed esporta i relativi campi di riepilogo in formato CSV o JSON. L'esportazione non include i prompt completi e non è un backup della configurazione.

La copia o lo spostamento di un agente tra organizzazioni non concede automaticamente all'organizzazione di destinazione l'accesso alle connessioni disponibili solo nell'organizzazione di origine. Esamina le associazioni dell'agente copiato a app, API, Knowledge, MCP, numeri di telefono e widget prima di distribuirlo lì.

Pagine correlate#