DTMF per integrazioni di telefonia

Puoi abilitare e configurare il protocollo DTMF (Segnale multifrequenza a doppio tono) per le integrazioni di telefonia. Quando questa opzione è abilitata, le pressioni dei tasti dell'utente finale vengono convertite in testo normale ed elaborate come input dell'utente finale dall'agente. Questa conversione può essere semplice, ad esempio i caratteri associati alla pressione dei tasti del telefono (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 pattern DTMF a singoli intent ed entità per attivare una corrispondenza con sequenze di input utente finale. Quando abiliti il DTMF a livello globale, le entità di sistema sono abilitate per impostazione predefinita.

Regola entità di sistema

Le regole per le entità di sistema sono abilitate per impostazione predefinita quando abiliti i file DTMF.

Digita 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 qualsiasi sequenza di cifre 4081111111
sys.date (in base alle impostazioni internazionali) YYYYMMDD (en-us) o MMDDYYY 20231001 -> 1/10/2023, 1/10/2023 -> 1/10/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 i DTMF.

Cifra finale

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

Un utente finale potrebbe fare una pausa durante l'inserimento di una sequenza di tasti. Se la durata della pausa supera la 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 momento come input utente finale. È improbabile che questo input corrisponda a qualsiasi intent o parametro del modulo, pertanto è probabile che Dialogflow richiami un evento senza corrispondenza.

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

Durata del timeout dell'endpoint

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

Se l'utente finale mette in pausa la voce per un periodo di tempo maggiore di quello impostato nella durata del timeout dell'endpoint, Dialogflow interrompe l'elaborazione DTMF e converte la sequenza attualmente corrispondente come farebbe normalmente.

Abilita DTMF

Puoi abilitare DTMF a livello di agente, pagina o parametro. Il DTMF verrà applicato a tutti gli elementi in quell'ambito. In questa sezione viene descritto, ad esempio, l'abilitazione del DTMF per un agente. Puoi attivare il DTMF anche utilizzando Impostazioni pagina (pagine), Impostazioni di flusso (flussi) o selezionando un parametro e visualizzando il menu delle impostazioni. In ogni caso, le impostazioni DTMF si trovano in fondo alla pagina.

  1. Vai a Impostazioni agente e seleziona la scheda Voce e IVR.

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

  3. Imposta i valori per Cifra fine, Durata timeout intercifra e Durata del timeout per individuazione. DTMF è ora abilitato per tutto ciò che rientra nell'ambito dell'agente. Se impostate a un livello inferiore, ora hanno la precedenza su qualsiasi impostazione di livello superiore. Tutti gli intent o i tipi di entità attivi degli slot attivi all'interno dell'ambito potrebbero essere attivati se hanno pattern DTMF definiti.

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 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 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 di Console.

  1. Nella console di Dialogflow, fai clic su Agente di test nell'angolo in alto a destra dello schermo.

  2. Nel riquadro visualizzato, fai clic sul simbolo + accanto alla casella di immissione del testo Parla con l'agente. Seleziona DTMF.

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