Inserimento DTMF

Legge i tasti composti dal chiamante e mette il risultato in una variabile: un codice cliente, un numero di pratica, un riferimento da verificare in seguito.

In breve

Il testo di aiuto mostrato nella finestra è: « Legge i tasti DTMF del chiamante e memorizza il valore inserito in una variabile (utilizzabile tramite {{nome}}). »

Come funziona

DTMF è il nome tecnico dei toni emessi da una tastiera telefonica. Il modulo ascolta questi toni, assembla le cifre composte e le mette in una variabile che voi nominate.

Riproduce prima l'annuncio che avete scelto. Il chiamante può comporre durante l'annuncio: si interrompe alla prima cifra. L'inserimento termina quando viene raggiunto il numero di cifre atteso, o quando il tempo scade.

Poi, in ogni caso, la chiamata prosegue attraverso l'uscita unica del modulo. Un inserimento assente non è un errore: dà una variabile vuota, che spetta a voi verificare più avanti, con una Condizione (Se) o uno Switch / Case.

Cosa inserire

Procedura

1. Posizionate il modulo Inserimento DTMF e collegate il nodo precedente al suo ingresso.
2. Apritelo e nominate la Variabile (risultato), ad esempio pratica.
3. Scegliete il Messaggio (opzionale) tra i vostri annunci. Deve dire al chiamante cosa comporre e quante cifre.
4. Impostate il Numero di cifre sulla lunghezza reale di ciò che vi aspettate.
5. Impostate il Timeout (s). Cinque secondi bastano per un codice breve, di più per un riferimento lungo da cercare su un documento.
6. Cliccate su Salva, poi collegate l'uscita unica al seguito del piano.
7. Posizionate un modulo Debug subito dopo, con come messaggio pratica={{pratica}}, per leggere ciò che è stato realmente composto.
8. Gestite l'inserimento vuoto: una Condizione (Se) con l'operatore « è vuoto » su {{pratica}} vi permette di far ripartire l'annuncio o di passare a un umano.
9. Cliccate su Salva, poi su Applica le modifiche nella barra superiore.
10. Chiamate il vostro numero, componete un codice, poi aprite il Registro di debug del piano e confrontate il valore scritto con quello che avete digitato.

Se non funziona

La variabile è vuota mentre il chiamante ha composto qualcosa. Verificate prima che il campo Variabile (risultato) porti effettivamente un nome, e che questo nome sia scritto identico tra parentesi graffe più avanti. Verificate poi il tempo previsto: troppo corto, scade prima che il chiamante abbia finito di comporre.

Un codice composto solo di zeri non viene mai registrato. È un limite noto del modulo: un inserimento composto solo di zeri non si distingue da un'assenza di inserimento, e la variabile resta vuota. Uno zero in testa a un codice più lungo, invece, viene conservato correttamente. Evitate i codici composti interamente da zeri.

Il chiamante non sente nulla e non sa cosa fare. Nessun Messaggio (opzionale) è scelto: il modulo attende dopo un secondo di silenzio. Scegliete un annuncio, ed enunciate in esso il numero di cifre atteso.

L'inserimento si trascina mentre ho indicato sei cifre. Il chiamante ne ha composte meno. Il modulo attende allora tutto il tempo previsto prima di continuare. Riducete il Timeout (s), oppure annunciate più chiaramente la lunghezza attesa.

La chiamata si interrompe dopo l'inserimento. L'uscita unica non è collegata a nulla. Un modulo la cui uscita presa non porta da nessuna parte termina la chiamata, anche quando l'inserimento è andato bene.