Puoi attivare e configurare il protocollo DTMF (Dual-tone multi-frequency signaling) per le integrazioni di telefonia. Se questa opzione è attivata, le pressioni dei tasti del telefono dell'utente finale vengono convertite in testo normale ed elaborate dall'agente come input dell'utente finale. Questa conversione può essere semplice come i caratteri associati alle pressioni dei tasti del telefono (12*34#) oppure puoi utilizzare le espressioni regolari (regex) per sequenze più complesse.
Regole di corrispondenza
Le impostazioni DTMF hanno tre diverse regole di corrispondenza:
- Trova una corrispondenza con un'intenzione.
- Corrispondenza a un'entità personalizzata.
- Corrispondenza a un tipo di entità di sistema
Puoi associare pattern DTMF a singoli intent e 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 entità di sistema
Le regole per le 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 -> 30 °C o 30 °F |
sys.phone-number |
qualsiasi sequenza di cifre | 4081111111 |
sys.date |
(a seconda delle impostazioni internazionali) YYYYMMDD (en-us) o MMDDYYY | 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 rappresentata dalla chiave "*" | 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 illustra le impostazioni aggiuntive che puoi configurare quando attivi il DTMF.
Cifra finale
Questa impostazione controlla il tasto premuto che termina immediatamente l'inserimento DTMF,
senza attendere altri input. È comune utilizzare # per questa impostazione.
Il numero finale non è incluso 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 mettere in pausa l'inserimento di una sequenza di pressioni dei tasti. Se questa durata della pausa è superiore alla durata del timeout tra i numeri, 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, pertanto Dialogflow probabilmente attiverà un evento di mancata corrispondenza.
Quando utilizzi la console, questo campo è in secondi.
Durata del timeout dell'endpointing
Dopo aver trovato una corrispondenza per una sequenza di tasti, Dialogflow continua a elaborare le pressioni dei tasti. La durata del timeout di endpoint è il tempo che Dialogflow attenderà per ulteriori input dopo una corrispondenza prima di terminare il rilevamento. Questo comportamento gestisce gli scenari in cui la sequenza è di lunghezza variabile, ad esempio numeri illimitati.
Se l'utente finale mette in pausa l'inserimento per più tempo rispetto a quello impostato in endpointing timeout duration, Dialogflow interrompe l'elaborazione DTMF e converte la sequenza attualmente associata come farebbe normalmente.
Attiva DTMF
Puoi attivare la DTMF a livello di agente, pagina o parametro. Il DTMF verrà applicato a tutto ciò che rientra in questo ambito. Questa sezione descrive come attivare la 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 Impostazioni. In tutti i casi, le impostazioni DTMF si trovano nella parte inferiore della pagina.
Vai a Impostazioni agente e seleziona la scheda Speech e IVR.
Vai in fondo alla pagina e fai clic sulla casella di controllo Attiva DTMF.
Imposta i valori per Cifra finale, Durata del timeout tra cifre e Durata del timeout per l'inserimento di un punto. Il DTMF è ora abilitato per tutto ciò che rientra nell'ambito dell'agente. Se impostate a un livello inferiore, ora queste impostazioni sostituiscono qualsiasi impostazione di livello superiore. Eventuali intent o tipi di entità attivi degli slot attivi all'interno di questo ambito potrebbero essere attivati se sono definiti pattern DTMF.
Aggiungere un pattern DTMF a un'intenzione
Nel menu di navigazione a sinistra, seleziona la scheda Gestisci e fai clic su Intent.
Seleziona un'intenzione dall'elenco visualizzato e vai alla casella Pattern DTMF.
Inserisci una sequenza DTMF. Puoi utilizzare pattern regex in caso di pattern DTMF più complessi.
Fai clic su Salva per salvare le modifiche.
Aggiungere un pattern DTMF a un'entità
Nel menu di navigazione a sinistra, seleziona la scheda Gestisci e fai clic su Tipi di entità.
Seleziona un tipo di entità dall'elenco visualizzato. Vai alla colonna Pattern DTMF nella tabella Entità.
Imposta un pattern DTMF per ogni entità della tabella. Puoi utilizzare pattern regex in caso di pattern DTMF più complessi.
Fai clic su Salva per salvare le modifiche.
Utilizzare DTMF nel simulatore
Puoi testare la configurazione DTMF nel simulatore della console.
Nella console Dialogflow, fai clic su Agente di test nell'angolo in alto a destra dello schermo.
Nel riquadro visualizzato, fai clic sul simbolo + accanto alla casella di immissione di testo Parla con un agente. Seleziona DTMF.
Inserisci il pattern DTMF che vuoi testare e il numero 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.