DTMF per le integrazioni di telefonia

Puoi attivare e configurare la tecnologia DTMF (Dual-tone multi-frequency signaling) per le integrazioni di telefonia. Se questa opzione è abilitata, la pressione dei tasti del telefono da parte dell'utente finale viene convertita in testo normale ed elaborata come input dell'utente finale dall'agente. Questa conversione può essere semplice come i caratteri associati alla pressione dei tasti del telefono (12*34#) oppure puoi utilizzare le espressioni regolari (regex) per sequenze più complicate.

Regole di corrispondenza

Le impostazioni DTMF hanno tre diverse regole di corrispondenza:

Puoi associare i pattern DTMF a singoli intent ed entità per attivare una corrispondenza con le sequenze di input utente finale. Quando attivi il DTMF a livello globale, le entità di sistema vengono attivate per impostazione predefinita.

Regola delle entità di sistema

Le regole delle entità di sistema sono attivate per impostazione predefinita quando attivi il DTMF.

Nome del tipo Pattern DTMF Esempio
sys.percentage qualsiasi numero intero 29 -> 29%
sys.temperature qualsiasi numero intero 30 -> 30C o 30F
sys.phone-number qualsiasi sequenza di cifre 4081111111
sys.date (a seconda delle impostazioni internazionali) AAAAMMGG (en-us) o MMGGAAAA 20231001 -> 2023-10-01, 10-01-2023 -> 10-01-2023
sys.zip-code qualsiasi sequenza di cifre 94043
sys.number sequenza di cifre con punto rappresentato dal tasto "*" 123 -> 123, 123*45 -> 123.45
sys.cardinal qualsiasi sequenza di cifre 12345
sys.number-integer qualsiasi sequenza di cifre 12345
sys.number-sequence qualsiasi sequenza di cifre 12345
sys.ordinal qualsiasi sequenza di cifre 12345

Impostazioni

Questa sezione descrive le impostazioni aggiuntive che puoi configurare quando attivi il DTMF.

Termina cifra

Questa impostazione controlla la pressione del tasto che interromperà immediatamente l'input DTMF, senza attendere ulteriori input. È comune utilizzare # per questa impostazione. La cifra finale non è inclusa nell'input utente finale convertito. Ad esempio, se la cifra finale è # e l'input è 123#, l'input dell'utente finale convertito fornito all'elaborazione dell'agente è 123.

Disattiva il rilevamento della voce

Se questa impostazione è attiva, l'agente ignora gli input vocali e utilizza la modalità di input solo DTMF.

Durata del timeout tra le cifre

Un utente finale potrebbe fare una pausa durante l'inserimento di una sequenza di tasti. Se questa durata della pausa è superiore alla durata del timeout tra le cifre, Dialogflow interrompe l'elaborazione DTMF per la sequenza.

Se Dialogflow interrompe l'elaborazione DTMF, fornisce all'agente la sequenza non convertita acquisita fino a quel momento come input utente finale. È improbabile che questo input corrisponda a parametri di intent o modulo, quindi Dialogflow probabilmente richiamerà un evento no-match.

Quando utilizzi la console, questo campo è espresso in secondi.

Durata del timeout di endpointing

Dopo aver trovato una corrispondenza per una sequenza di tasti, Dialogflow continua a elaborare le pressioni dei tasti. Durata del timeout di endpointing è la durata che Dialogflow attenderà per ricevere ulteriori input dopo che è stata trovata una corrispondenza prima di terminare il rilevamento. Questo comportamento gestisce gli scenari in cui la sequenza ha una lunghezza variabile, come i numeri illimitati.

Se l'utente finale mette in pausa l'inserimento per un periodo di tempo superiore a quello impostato in Durata del timeout di endpointing, Dialogflow interrompe l'elaborazione DTMF e converte la sequenza attualmente corrispondente come farebbe normalmente.

Attiva DTMF

Puoi attivare il DTMF a livello di agente, pagina o parametro. Il DTMF verrà applicato a tutto ciò che rientra in questo ambito. Questa sezione descrive l'attivazione del DTMF per un agente come esempio. Puoi anche attivare il DTMF utilizzando le Impostazioni pagina (pagine), le Impostazioni flusso (flussi) o selezionando un parametro e visualizzando il menu delle impostazioni. In tutti i casi, le impostazioni DTMF si trovano nella parte inferiore della pagina.

  1. Vai a Impostazioni agente e seleziona la scheda Sintesi vocale e IVR.

  2. Vai in fondo alla pagina e fai clic sulla casella di controllo Abilita DTMF.

  3. Imposta i valori per Cifra finale, Durata del timeout tra le cifre e Durata del timeout di endpointing. DTMF è ora abilitato per tutto ciò che rientra nell'ambito di quell'agente. Se impostate a un livello inferiore, queste impostazioni ora sostituiscono quelle di livello superiore. Qualsiasi intent o tipo di entità attivo degli slot attivi all'interno di questo ambito potrebbe essere attivato se sono stati definiti pattern DTMF.

Aggiungi un pattern DTMF a un intent

  1. Nel menu di navigazione a sinistra, seleziona la scheda Gestisci e fai clic su Intent.

  2. Seleziona un intent dall'elenco visualizzato e vai alla casella Pattern DTMF.

  3. Inserisci una sequenza DTMF. Puoi utilizzare i pattern regex in caso di pattern DTMF più complessi.

  4. Fai clic su Salva per salvare le modifiche.

Aggiungi un pattern DTMF a un'entità

  1. Nel menu di navigazione a sinistra, seleziona la scheda Gestisci e fai clic su Tipi di entità.

  2. Seleziona un tipo di entità dall'elenco visualizzato. Vai alla colonna Pattern DTMF nella tabella Entità.

  3. Imposta un pattern DTMF per ogni entità nella tabella. Puoi utilizzare i pattern regex in caso di pattern DTMF più complessi.

  4. Fai clic su Salva per salvare le modifiche.

Utilizza DTMF nel simulatore

Puoi testare la configurazione DTMF nel simulatore della console.

  1. Nella console Dialogflow, fai clic su Test Agent nell'angolo in alto a destra dello schermo.

  2. Nel riquadro che si apre, fai clic sul simbolo + accanto alla casella di immissione di testo Parla con un agente. Seleziona DTMF.

  3. Inserisci il pattern DTMF che vuoi testare e la cifra finale DTMF. Assicurati che la casella Invia nuovo input DTMF sia selezionata, quindi fai clic su Invia. La risposta all'input DTMF verrà visualizzata nel simulatore.