Panoramica
I controlli DTMF (Dual-Tone Multi-Frequency) consentono ai tuoi agenti AI sia di inviare che catturare toni della tastiera telefonica durante le conversazioni. Questo permette agli agenti di navigare i sistemi IVR, interagire con sistemi telefonici legacy e raccogliere input strutturati dai chiamanti attraverso pressioni di tasti - trasformando il tuo agente da solo voce a un sistema completo di automazione telefonica. Le capacità DTMF sono essenziali per integrare gli agenti AI con l’infrastruttura telefonica aziendale esistente, consentendo trasferimenti senza soluzione di continuità attraverso menu IVR complessi e raccogliendo input numerici precisi come numeri di conto, codici PIN o selezioni di menu.Cos’è DTMF?
Comprendere la Tecnologia DTMF
DTMF è il segnale generato quando premi i tasti su una tastiera telefonica. Ogni tasto produce due toni simultanei a frequenze diverse - uno alto e uno basso - creando un suono unico che i sistemi possono decodificare per identificare quale tasto è stato premuto. Tasti disponibili:- Cifre: 0-9 (input numerico)
- Asterisco: * (spesso usato come “indietro” o “annulla”)
- Cancelletto/Diesis: # (spesso usato come “conferma” o “invio”)
- Navigare menu IVR (“Premi 1 per Vendite, 2 per Supporto”)
- Inserire numeri di conto o PIN
- Confermare o annullare azioni
Capacità DTMF
Due Funzioni Primarie
Invio Toni
Cattura Toni
Casi d’Uso Invio Toni
Navigazione IVR
Navigazione IVR
Autenticazione
Autenticazione
Integrazione Sistema
Integrazione Sistema
Casi d’Uso Cattura Toni
Selezione Menu
Selezione Menu
Raccolta Informazioni
Raccolta Informazioni
Input Tastiera
Input Tastiera
Configurazione Controlli DTMF
Accesso Impostazioni DTMF
Naviga alla Configurazione DTMF


Toggle DTMF Globale
Abilita DTMF durante le chiamate Consenti all’agente di inviare toni tastiera e raccogliere cifre dai chiamanti. Quando abilitare:- L’agente deve navigare sistemi IVR
- L’agente deve raccogliere input numerico strutturato
- L’integrazione richiede interazione DTMF
Configurazione Invio Toni
Invio Toni
Configura il tuo agente per inviare toni DTMF a sistemi esterni. Toggle: Consenti all’agente di inviare toni tastiera Parametri:- Pausa tra toni (secondi): 3 secondi (predefinito)
- Durata tono (ms): 120 ms (predefinito)
- Pausa tra toni (ms): 70 ms (predefinito)
Parametri Invio Toni
Pausa tra toni (secondi)
Pausa tra toni (secondi)
- Aumenta (4-5s): Sistemi IVR lenti/legacy che perdono toni
- Diminuisci (1-2s): Sistemi moderni veloci, riduci tempo navigazione totale
Durata tono (ms)
Durata tono (ms)
- Aumenta (150-200ms): Sistemi IVR che non rilevano toni affidabilmente
- Diminuisci (80-100ms): Accelera interazioni, riduci latenza
Pausa tra toni (ms)
Pausa tra toni (ms)
- Aumenta (100-150ms): IVR che tratta toni rapidi come singolo input
- Diminuisci (40-50ms): Accelera sequenze multi-cifra
Impostazioni Raccomandate per Caso d’Uso
IVR Moderni Veloci
IVR Moderni Veloci
- Cooldown: 1-2 secondi
- Durata Tono: 100ms
- Pausa tra toni: 50ms
IVR Standard (Predefinito)
IVR Standard (Predefinito)
- Cooldown: 3 secondi (predefinito)
- Durata Tono: 120ms (predefinito)
- Pausa tra toni: 70ms (predefinito)
IVR Lenti/Problematici
IVR Lenti/Problematici
- Cooldown: 4-5 secondi
- Durata Tono: 150ms
- Pausa tra toni: 100ms
Configurazione Cattura Toni
Modalità Cattura
Scegli come il tuo agente riceve e interpreta input DTMF dai chiamanti.Menu (singolo tasto)
Collector (multi-cifra)
Modalità Menu
Per selezioni menu stile IVR La modalità Menu cattura una singola pressione tasto e la invia immediatamente all’agente.

- L’agente presenta opzioni menu
- Il cliente preme singolo tasto (0-9, *, #)
- L’agente riceve cifra immediatamente
- L’agente risponde in base al tasto premuto
- Cattura singola pressione tasto
- Processa immediatamente
- Nessun tasto terminazione richiesto
- Tasto cancella non disponibile
Modalità Collector
Per raccogliere sequenze come numeri conto, PIN, numeri telefono La modalità Collector bufferizza multiple cifre fino a quando l’utente preme il tasto terminazione o scade il timeout.

- L’agente richiede input multi-cifra
- Il cliente inserisce multiple cifre
- Preme tasto terminazione (di solito #) quando completo
- L’agente riceve stringa cifre completa
- Cifre minime: 1 (predefinito)
- Cifre massime: 25 (predefinito)
- Timeout (ms): 6000ms (6 secondi, predefinito)
- Tasto terminazione: # (Cancelletto)
- Tasto cancella input: * (Asterisco)
Parametri Modalità Collector
Cifre minime
Cifre minime
- Numero conto (10 cifre): Imposta a 10
- PIN (4 cifre): Imposta a 4
- Input flessibile: Imposta a 1 (qualsiasi lunghezza accettata)
- Se cliente preme # prima di raggiungere minimo → Errore, richiesta reinserimento
- Se cliente raggiunge minimo → Può premere # per inviare anticipatamente
Cifre massime
Cifre massime
- Numero telefono: Imposta a 10 (formato US)
- Numero conto: Imposta a lunghezza attesa
- Lunghezza variabile: Imposta più alto del massimo atteso
- Quando inserite cifre max → Invia automaticamente senza richiedere #
- Toni dopo max vengono ignorati
Timeout (ms)
Timeout (ms)
- Timer inizia dopo ogni pressione cifra
- Reset con ogni nuova cifra
- Se raggiunto timeout → Tratta come completo o richiedi più
- Input rapido (PIN): 3000-4000ms (3-4 secondi)
- Input lungo (numero conto): 6000-8000ms (6-8 secondi)
- Sistema paziente: 10000ms+ (10+ secondi)
Tasto terminazione
Tasto terminazione
Tasto cancella input
Tasto cancella input
Impostazioni Collector Raccomandate per Caso d’Uso
Raccolta Numero Conto (10 cifre)
Raccolta Numero Conto (10 cifre)
- Cifre minime: 10
- Cifre massime: 10
- Tasto terminazione: # (opzionale, auto-invia a 10)
- Timeout: 6000ms (6 secondi)
- Tasto cancella input: *
Raccolta PIN (4-6 cifre)
Raccolta PIN (4-6 cifre)
- Cifre minime: 4
- Cifre massime: 6
- Tasto terminazione: #
- Timeout: 4000ms (4 secondi)
- Tasto cancella input: *
Numero Telefono (Formato Variabile)
Numero Telefono (Formato Variabile)
- Cifre minime: 7
- Cifre massime: 15
- Tasto terminazione: #
- Timeout: 6000ms (6 secondi)
- Tasto cancella input: *
Input Numerico Flessibile (Predefinito)
Input Numerico Flessibile (Predefinito)
- Cifre minime: 1 (predefinito)
- Cifre massime: 25 (predefinito)
- Tasto terminazione: #
- Timeout: 6000ms (6 secondi, predefinito)
- Tasto cancella input: *
Usare DTMF nelle Istruzioni
Richiedere Input DTMF
Esempio selezione menu:Gestire Risposte DTMF
Processamento automatico: Quando cattura DTMF è abilitata, l’agente riceve automaticamente cifre raccolte e può rispondere ad esse. Nessuna configurazione aggiuntiva necessaria. Avanzato: Usare il tool wait_for_dtmf_input Per controllo esplicito nelle istruzioni agente, puoi chiamare il toolwait_for_dtmf_input. Restituisce:
Fallback a Voce
Offrire alternativa voce:Testare Configurazione DTMF
Piano Test
Testa Invio Toni (Navigazione IVR)
- Configura agente con azione trasferimento a numero telefono con IVR
- Aggiungi istruzioni per navigare IVR usando toni DTMF
- Inizia chiamata test
- Attiva azione trasferimento
- Monitora agente che naviga IVR (controlla log per toni inviati)
- Verifica che agente raggiunga destinazione corretta
- Toni inviati a intervalli corretti
- IVR riconosce tutti i toni
- Navigazione completa con successo
- Nessun tono perso o mal interpretato
Testa Modalità Menu (Cattura Singolo Tasto)
- Configura DTMF in Modalità Menu
- Aggiungi opzioni menu alle istruzioni
- Inizia chiamata test
- Ascolta opzioni menu
- Premi singolo tasto (1, 2, 3, ecc.)
- Verifica che agente riconosca e risponda appropriatamente
| Tasto | Azione Attesa |
|---|---|
| 1 | Instrada opzione 1 |
| 2 | Instrada opzione 2 |
| 9 | Instrada opzione 9 |
| * | Gestisci tasto asterisco |
| # | Gestisci tasto cancelletto |
| Invalido | Gestione errore |
Testa Modalità Collector (Multi-Cifra)
- Configura DTMF in Modalità Collector
- Imposta cifre min/max appropriate, tasto terminazione
- Inizia chiamata test
- Richiedi agente raccolga cifre
- Inserisci varie sequenze cifre:
- Esattamente cifre minime + #
- Tra min e max cifre + #
- Esattamente cifre massime (auto-invio)
- Usa tasto cancella (*) per correggere errori
- Lascia timeout input
- Verifica che agente riceva stringa cifre corretta
- Applicazione minimo cifre funziona
- Auto-invio massimo cifre funziona
- Tasto terminazione finalizza correttamente input
- Tasto cancella elimina correttamente ultima cifra
- Gestione timeout appropriata
Testa Casi Limite
- Premi # immediatamente (nessuna cifra)
- Dovrebbe rifiutare se min > 0
- Inserisci cifre parziali, attendi timeout
- Verifica gestione appropriata
- Inserisci cifre molto rapidamente
- Verifica tutte catturate correttamente
- Premi * su buffer vuoto (dovrebbe ignorare)
- Premi * più volte (elimina multiple cifre)
- Inserisci cifre, cancella tutte, inserisci nuova sequenza
- Premi tasti in modalità sbagliata (es. # in Modalità Menu)
- Tieni premuto tasto troppo a lungo
- Premi più tasti simultaneamente
Testa Integrazione con Istruzioni
- Agente richiede correttamente input DTMF
- Agente attende input (non continua a parlare)
- Agente conferma ricezione input
- Agente processa correttamente valore catturato
- Agente gestisce input invalido elegantemente
- Agente offre fallback voce quando appropriato
Problemi Test Comuni
Toni Non Rilevati
Toni Non Rilevati
- DTMF Support non abilitato globalmente
- Durata tono troppo corta per rilevamento
- Problemi rete/codec che degradano toni
- Istruzioni non gestiscono variabile DTMF
- Verifica che toggle DTMF Support sia ON
- Aumenta durata tono a 150-200ms
- Testa da telefono/rete diversa
- Controlla log per confermare che tool
wait_for_dtmf_inputsia registrato e invocato - Verifica che
session.userdata.last_dtmf_inputsia popolato nei log worker
Cifre Sbagliate Catturate
Cifre Sbagliate Catturate
- Pausa inter-tono troppo corta (toni si fondono)
- Rumore di fondo crea toni falsi
- Cliente preme tasti troppo rapidamente
- Aumenta pausa inter-tono a 100-150ms
- Testa in ambiente silenzioso
- Aumenta timeout per rallentare inserimento cliente
- Aggiungi validazione e conferma nelle istruzioni
Navigazione IVR Fallisce
Navigazione IVR Fallisce
Tasto Cancella Non Funziona
Tasto Cancella Non Funziona
- Tasto cancella non configurato correttamente
- Tasto cancella premuto in Modalità Menu (non applicabile)
- * assegnato come tasto terminazione (conflitto)
- Verifica che tasto cancella sia impostato a * in Modalità Collector
- Assicura che modalità sia Collector (tasto cancella funziona solo in Collector)
- Non usare * sia come tasto cancella che terminazione
Best Practice
Offri Sempre Fallback Voce
Offri Sempre Fallback Voce
- Telefoni cellulari in aree con segnale debole
- App VoIP senza tastiera
- Esigenze accessibilità
- Preferenza per interazione vocale
Conferma Input Ricevuto
Conferma Input Ricevuto
Istruzioni Chiare per Richieste DTMF
Istruzioni Chiare per Richieste DTMF
- Cosa inserire (numero conto, PIN, selezione)
- Quante cifre (se lunghezza fissa)
- Tasto terminazione (se applicabile)
- Metodo alternativo (voce)
Inizia con Temporizzazioni Conservative
Inizia con Temporizzazioni Conservative
- Inizia con predefiniti raccomandati
- Distribuisci a piccolo gruppo test
- Monitora errori DTMF nei log
- Regola temporizzazioni in base a fallimenti reali
- Distribuisci impostazioni ottimizzate
- Impostare temporizzazioni molto veloci senza testare
- Assumere che tutti gli IVR si comportino allo stesso modo
- Ottimizzare per velocità a scapito di affidabilità
Gestisci Retry Elegantemente
Gestisci Retry Elegantemente
- Arrendersi dopo singolo fallimento
- Ripetere esattamente stesse istruzioni (non utile)
- Rimanere bloccati in loop retry infinito