DTMF per le integrazioni di telefonia

Puoi abilitare e configurare DTMF (segnale multifrequenza dual-tono) per le integrazioni di telefonia. Quando questa opzione è abilitata, i tasti premuti dall'utente finale sul telefono vengono convertiti in testo normale ed elaborati come input dell'utente finale da parte dell'agente. Questa conversione può essere semplice: bastano i caratteri associati alla pressione dei tasti telefonici (12*34#) oppure puoi utilizzare 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 DTMF a livello globale, le entità di sistema vengono abilitate per impostazione predefinita.

Regola di entità di sistema

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

Digita il nome pattern DTMF Esempio
sys.percentage qualsiasi numero intero 29 -> 29%
sys.temperature qualsiasi numero intero 30 -> 30 °C o 30 F
sys.phone-number sequenza di cifre qualsiasi 4081111111
sys.date (in base alle impostazioni internazionali) AAAAMMGG (en-us) o MMGGYAA 20231001 -> 01-10-2023, 10-01-2023 -> 01-10-2023
sys.zip-code sequenza di cifre qualsiasi 94043
sys.number sequenza di cifre con punto rappresentato dal tasto "*" 123 -> 123, 123*45 -> 123,45
sys.cardinal sequenza di cifre qualsiasi 12345
sys.number-integer sequenza di cifre qualsiasi 12345
sys.number-sequence sequenza di cifre qualsiasi 12345
sys.ordinal sequenza di cifre qualsiasi 12345

Impostazioni

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

Cifra finale

Questa impostazione controlla la pressione dei tasti che termina immediatamente l'input DTMF, senza attendere altri 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.

Durata timeout tra cifre

Un utente finale potrebbe fare una pausa mentre digita una sequenza di tasti. Se questa durata della pausa è superiore alla durata del timeout tra 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 punto come input utente finale. È improbabile che questo input corrisponda a qualsiasi intent o parametro del modulo, pertanto Dialogflow probabilmente richiamerà un evento senza corrispondenza.

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

Durata timeout endpoint

Dopo aver stabilito una corrispondenza per una sequenza di tasti, Dialogflow continua a elaborare le pressioni dei tasti. La durata del timeout dell'endpoint è la durata del tempo in cui Dialogflow attende un ulteriore input dopo una corrispondenza prima di terminare il rilevamento. Questo comportamento gestisce gli scenari in cui la sequenza è a lunghezza variabile, come i numeri illimitati.

Se l'utente finale mette in pausa la voce per un tempo superiore a quello impostato nella durata del timeout dell'endpoint, 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 quell'ambito. Questa sezione descrive, ad esempio, l'abilitazione di DTMF per un agente. Puoi attivare il DTMF anche utilizzando Impostazioni pagina (pagine), Impostazioni flusso (flussi) oppure selezionando un parametro e visualizzando il menu Impostazioni. In ogni caso, le impostazioni DTMF si trovano nella parte inferiore della pagina.

  1. Vai a Impostazioni agente e seleziona la scheda Speech 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 timeout interdigit e Durata del timeout entro il limite. Ora il DTMF è abilitato per tutto ciò che rientra nell'ambito di quell'agente. Se configurate a un livello inferiore, ora queste impostazioni sostituiscono quelle di livello superiore. Qualsiasi intent o tipo di entità attivi degli slot attivi all'interno di quell'ambito potrebbe essere attivato se hanno pattern DTMF definiti.

Aggiungere 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à della tabella. Puoi utilizzare i pattern regex in caso di pattern DTMF più complessi.

  4. Fai clic su Salva per salvare le modifiche.

Usa il DTMF nel simulatore

Puoi testare la tua configurazione DTMF nel simulatore della console.

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

  2. Nel riquadro che appare, fai clic sul simbolo + accanto alla casella di immissione di testo Parla con l'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 del DTMF apparirà nel simulatore.