Skip to Content

Changes for page 11 - Chat

Last modified by administrator BDP on 2024/10/16 17:42
From version 51.1
edited by administrator BDP
on 2019/04/29 12:22
Change comment: Uploaded new attachment "wtm_testo.png", version {1}
To version 17.4
edited by administrator BDP
on 2019/03/22 12:09
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -11 - Chat
1 +09 - Riconoscimento vocale
Hidden
... ... @@ -1,1 +1,1 @@
1 -true
1 +false
Content
... ... @@ -7,124 +7,309 @@
7 7  {{toc start=2 depth="3"/}}
8 8  {{/box}}
9 9  
10 +== CChangeCampaign ==
10 10  
11 -== ReadTextMessage ==
12 +(% class="box errormessage" %)
13 +(((
14 +**ATTENZIONE**: il servizio è disponibile solamente in //compatibility mode//, mentre non è presente nel Call Designer.
15 +)))
12 12  
13 -Questo blocchetto consente di leggere un messaggio di chat e memorizzarlo in una [[transfer property>>doc:ifmhelpplatform.MessengerConcetti.TransferProperty.WebHome||target="_blank"]] o [[Call Data>>doc:03 - Sviluppo Moduli Applicativi.CallData.WebHome||target="_blank"]].
17 +Permette di effettuare un cambio di campagna senza eseguire un trasferimento telefonico. Entrambe le campagne devono essere composte do soli IVR e correttamente definite e configurate tramite il Messenger Configurator. La chiamata continuerà ad essere gestita dallo stesso canale Dialogic.
14 14  
15 -=== **Parametri di Configurazione** ===
16 16  
17 -==== **Proprietà** ====
18 18  
19 -Cliccando sulla funzionalità //Proprietà// del blocchetto viene visualizzata solamente la seguente scheda:
21 +**Parametri di Configurazione**
20 20  
21 -//Scheda Salva in//
23 +|=(% style="width: 200px;" %)**Parametro**|**Descrizione**
24 +|**Campagna destinazione**|Nome campagna da attivare.
25 +|**Servizio da attivare**|//Solo configurando il Servizio tramite Messenger Configurator//. Nome servizio della nuova campagna da attivare.
26 +| |
22 22  
23 -[[image:rtm_proprieta.png||style="-moz-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); -webkit-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); margin:20px 10px"]]
28 +== CCustomMessage ==
24 24  
25 -L'elenco dei campi visualizzati è il seguente:
30 +Esegue il play di un messaggio il cui nome gli viene passato nei [[Call Data>>doc:03 - Sviluppo Moduli Applicativi.CallData.WebHome]]. E' da usarsi in abbinamento ad un modulo applicativo in cui l'operatore seleziona il messaggio da far sentire al cliente (da un MDB) e trasferisce la chiamata alla campagna IVR che si occupa del Play. Il modulo applicativo deve inserire nei Call Data le informazioni necessarie ad identificare in modo univoco il file wav o avi da suonare (//CustomMessageType //e //CustomMessageId//).
26 26  
27 -(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
28 -(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
29 -|**Transfer Property**|Selezionare dalla lista il nome della transfer property in cui salvare il testo del messaggio di chat.
30 -|**Call Data**|Indicare il CallData in cui salvare il messaggio di chat.
32 +Il Database deve avere i seguenti campi:
31 31  
32 -==== Port di Uscita ====
34 +|=(% style="width: 150px;" %)**Campo**|=(% style="width: 150px;" %)Tipo|**Descrizione**
35 +|**Type**|(((
36 +Text
37 +(max 50 caratteri)
38 +)))|Permette di suddividere i messaggi in gruppi logici in base al tipo di informazione fornita.
39 +|**ID**|Autonumber|Identifica in modo univoco il messaggio ed è l'informazione che viene passata dal modulo applicativo all'IVR per comandarne il play.
40 +|**Description**|Text|Utilizzata solo dal modulo applicativo per visualizzare la lista dei messaggi disponibili.
41 +|**FileName**|Text|Contiene il nome del file wav o avi contenente il messaggio.
42 +| | |
33 33  
34 -[[image:rtm_po.jpg||style="margin-bottom:20px; margin-top:20px"]]
44 +**Parametri di Configurazione**
35 35  
36 -La funzionalità del //Port di Uscita// del blocchetto prevede solamente il seguente parametro:
46 +|=(% style="width: 200px;" %)**Parametro**|(**Descrizione**
47 +|**Directory Messaggi**|Indica il nome della cartella, contenuta nella directory base dei messaggi definita nella configurazione, da cui prelevare i file wav o avi da suonare.
48 +|**Nome Database**|Percorso completo del database contenente l'associazione //msgId// nome file.
49 +|**Nome Tabella**|Nome tabella contenente la lista dei messaggi custom.
50 +|**Servizio successivo**|Nome servizio da attivare a termine delle ripetizioni impostate (nulla per terminare).
51 +| |
37 37  
38 -(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
39 -(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
40 -|**Out**|Port di uscita predefiito.
53 +== Chat ==
41 41  
55 +(% class="box errormessage" %)
56 +(((
57 +**ATTENZIONE**: servizio obsoleto. Il servizio è disponibile solamente in //compatibility mode//, mentre non è presente nel Call Designer.
58 +)))
42 42  
60 +Inserisce il canale Dialogic su cui è attiva la chiamata nella stanza della Chat definita dalla configurazione. Deve essere ovviamente presente il programma che gestisce la Chat e deve essere presente nel sistema almeno una scheda Dialogic MSI.
43 43  
44 -== WriteTextMessage ==
45 45  
46 -Questo blocchetto permette di convertire l'audio del chiamante (parlato) in testo tramite il motore di riconoscimento vocale di Google (//Google Speech API//). Il testo può essere salvato in una Transfer Property o in un CallData, per potere essere analizzato/elaborato successivamente da ulteriori blocchetti impostati nel flusso della chiamata.
63 +**Parametri di Configurazione**
47 47  
48 -Il servizio è disponibile anche in //compatibility mode.//
65 +|=(% style="width: 200px;" %)**Parametro**|**Descrizione**
66 +|**Nome Stanza**|Nome stanza di ingresso nel servizio.
67 +|**Tipo chiamante**|(((
68 +Tipologia della persona chiamante:
49 49  
70 +* 0 per cliente
71 +* 1 per Controller (ce ne può essere solo uno)
72 +* 2 per Jocker (Animatori).
50 50  
51 -=== **Parametri di Configurazione** ===
74 +Clienti ed Animatori hanno gli stessi diritti, sono rappresentati con icone diverse solo per comodità del Controller. Questo deve essere unico, avere accesso diretto al PC su cui è installata la Chat ed ha la possibilità di ascoltare le conversazioni senza essere sentito, spostarsi ciclicamente tra le stanze occupate, spostare i Clienti ed i Jocker da una stanza a un'altra o farli uscire dalla Chat abbattendo la loro linea.
75 +)))
76 +| |
52 52  
53 -==== **Proprietà** ====
78 +== CPTT ==
54 54  
55 -Cliccando sulla funzionalità //Proprietà// del blocchetto sono visualizzate le seguenti schede:
80 +(% class="box errormessage" %)
81 +(((
82 +**ATTENZIONE**: il servizio è disponibile solamente in //compatibility mode//, mentre non è presente nel Call Designer.
83 +)))
56 56  
57 -//Scheda Messaggi//
85 +Esegue gestione delle code con possibilità di, al termine delle ripetizioni previste, terminare la chiamata, trasferire ad altra campagna, trasferire a numero di telefono, lasciare un messaggio vocale, lasciare dati per richiamo automatico ([[CCollectData>>doc:ifmhelpplatform.MessengerServiziBase.TrasferimentoControlloChiamata.WebHome]]), o modalità di prosecuzione selezionata dal chiamante.
58 58  
59 -[[image:STT_skMessaggi.jpg||style="-moz-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); -webkit-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); margin:20px 10px"]]
60 60  
61 -L'elenco dei campi visualizzati è il seguente:
88 +**Parametri di Configurazione**
62 62  
63 -(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
64 -(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
65 -|**Lista messaggi**|Lista dei messaggi da riprodurre al chiamante come invito e istruzioni per ciò che deve dire.
90 +|=(% style="width: 200px;" %)**Parametro**|**Descrizione**
91 +|**Directory Messaggi**|Indica il nome della cartella, contenuta nella directory base dei messaggi definita nella configurazione, da cui prelevare i file wav/avi da suonare. La tabella sotto //Messaggi Disponibili //riporta l'elenco dei messaggi utilizzabili.
92 +|**Records Directory**|Indica il nome della cartella, contenuta nella directory base di record definita nella configurazione, in cui registrare il messaggio dell'utente.
93 +|**Abilita Introduzione**|Abilita a suonare //IntroMessage//.
94 +|**Tipo d'accoglienza**|Specifica se l'introduzione consiste di un semplice messaggio di benvenuto (0) oppure di una richiesta di codice utente (1). In entrambi i casi viene suonato il file //IntroMessage//.
95 +|**Lunghezza Codice utente**|Indica la lunghezza massima del codice cliente da acquisire.
96 +|**Timeout d'acquisizione**|Indica il tempo massimo, in secondi, che il sistema attende per permettere all'utente di digitare il suo codice. Nel caso di codici più corti del massimo previsto, l'acquisizione può essere interrotta sia con il tasto # sia con il *.
97 +|**Nome Transfer Property**|Eventuale nome della [[Transfer Property>>doc:ifmhelpplatform.MessengerConfigurator.TransferProperty.WebHome]] in cui salvare il codice inserito dall'utente.
98 +|**Nome Call Data**|Eventuale nome del [[Call Data>>doc:03 - Sviluppo Moduli Applicativi.CallData.WebHome]] in cui salvare il codice inserito dall'utente.
99 +|**Accodamento Preventivo**|Abilita la funzionalità di accodamento preventivo.
100 +|**Modalità di prosecuzione**|Nel caso si sia stabilito un numero massimo di ripetizioni dell'attesa, stabilisce cosa fare nel caso esso sia superato. Le possibilità sono: terminare la chiamata, trasferire ad altra campagna di #phones, trasferire ad un numero di telefono esterno al contact center, registrare un messaggio in segreteria, richiedere numero di telefono dell'utente per richiamo, proporre all'utente di scegliere se rimanere in attesa, lasciare i dati per essere richiamato o terminare.
101 +|**Nome campagna**|Nome della campagna alla quale trasferire la chiamata.
102 +|**Call Data**|Eventuale stringa da passare nei Call Data come PTTParam.
103 +|**Numero di telefono**|Numero di telefono al quale trasferire la chiamata in coda.
104 +|**Tempo di registrazione**|Tempo massimo di registrazione per la segreteria vocale.
105 +|**Max messaggi**|Numero massimo di messaggi accettati in casella vocale (0 per infiniti). Se viene raggiunto il limite l'utente non potrà lasciare la sua richiesta.
106 +|**Nome Database**|Nome, completo di percorso, del database (vedere sezione [[Database per la raccolta dei dati per il richiamo automatico e segreteria>>doc:ifmhelpplatform.MessengerServiziBase.DatabaseRaccoltaDati.WebHome]]) in cui inserire le informazioni sul messaggio registrato.
107 +|**Richiesta data**|Abilita, per la raccolta dati, a richiedere data per appuntamento.
108 +|**Richiesta ora**|Abilita, per la raccolta dati, a richiedere ora per appuntamento.
109 +|**Max Contatti**|Numero massimo di contatti attivi accettati nel Database (0 per infiniti).
110 +|**Query Contatti Attivi**|Nome di una query del Database dei contatti per la selezione dei contatti da considerare attivi.
111 +|**Nome Database**|Nome completo del database Access in cui inserire il contatto.
112 +|**Digit segreteria**|Per la modalità di prosecuzione guidata da menu, indica il digit che porta alla segreteria (- opzione non consentita).
113 +|**Digit Raccolta Dati**|Per la modalità di prosecuzione guidata da menu, indica il digit che porta alla richiesta numero per richiamo (- opzione non consentita).
114 +|**Digit Attesa**|Per la modalità di prosecuzione guidata da menu, indica il digit che porta a rimanere in attesa dell'operatore (- opzione non consentita).
115 +|**Digit Termine**|Per la modalità di prosecuzione guidata da menu, indica il digit che porta ad abbattimento della chiamata (- opzione non consentita).
116 +| |
66 66  
67 -Utilizzare i tasti **Nuovo**, **Modifica** e **Cancella** per selezionare e impostare il tipo di messaggio da riprodurre tra i seguenti:
118 +Se si utilizza la funzione d'accodamento preventivo, la campagna di coda riproduce, prima del trasferimento, il nome dell'operatore a cui la chiamata sta per essere passata. Perché questo sia possibile deve esistere un file wav/avi per ogni agente del Contact Center in cui è registrato il nome dell'operatore stesso. Questi messaggi devono essere messi in una cartella con nome //Agents //contenuta nella directory base dei messaggi definita nella configurazione. Il nome del file wav /avi deve essere la concatenazione di nome e cognome dell'agente: ad esempio per un operatore che si logga a #phones come "Mario" "Rossi", il file con il suo nome deve chiamarsi "MarioRossi.wav"/"MarioRossi.avi". Nella directory //Agents //deve esistere anche il file "PreTransfMsg.wav"/"PreTransfMsg.avi" che recita un messaggio del tipo: //"Risponde l'operatore..."//. Per informazioni sulla struttura dei Database per la memorizzazione dei dati sui contatti raccolti e/o dei messaggi registrati in casella si veda il paragrafo relativo più avanti.
68 68  
69 -* File
70 -* Numero
71 -* Importo
72 -* Sequenza di caratteri
73 -* Lista formattata
74 -* Data/Ora
75 -* Data/Ora attuale
76 -* Data/Ora del file
77 -* Ordinale
78 78  
79 -//Scheda Motore//
121 +**Messaggi Disponibili**
80 80  
81 -[[image:STT_skMotore.jpg||style="-moz-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); -webkit-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); margin:20px 10px"]]
123 +|=(% style="width: 200px;" %)**Nome File**|**Messaggio**
124 +|**IntroMessage.wav**|Messaggio introduttivo suonato una sola volta.
125 +|**WaitMessage.wav**|Messaggio di coda.
126 +|**WaitMusic.wav**|Musica di attesa suonata tra una ripetizione e l'altra del //WaitMessage//.
127 +|**EndMessagge.wav**|Messaggio di commiato.
128 +|**RecordMsg.wav**|Messaggio con invito a lasciare dati in casella vocale.
129 +|**GoodBye.wav**|Messaggio di saluto dopo registrazione dati in casella vocale.
130 +|**NoResource.wav**|Messaggio di commiato in caso di trasferimento ad altra campagna rifiutato per mancanza risorse.
131 +|**InsertPrefisso.wav**|Messaggio con richiesta digitazione prefisso telefonico del chiamante.
132 +|**InsertPhone.wav**|Messaggio con richiesta digitazione numero telefonico del chiamante.
133 +|**InsertDay.wav**|Messaggio con richiesta digitazione giorno preferenziale per richiamo; nel formato GGMM.
134 +|**InsertTime.wav**|Messaggio con richiesta digitazione ora preferenziale per richiamo; nel formato HHmm.
135 +|**InvalidDatas.wav**|Messaggio per rilevazione di errore nella digitazione dei dati per richiamo automatico (Data/Ora non valida).
136 +|**OptionMenu.wav**|Messaggio con lista opzioni nel caso di modalità di prosecuzione guidata da menu.
137 +|**VoiceMailIsFull.wav**|Messaggio che invita a richiamare più tardi (tutti gli operatori occupati e casella vocale piena).
138 +|**ContactTableIsFull.wav**|Messaggio che invita a richiamare più tardi (tutti gli operatori occupati e tabella contatti piena).
139 +| |
82 82  
83 -Impostare i campi seguenti:
141 +(% class="box infomessage" %)
142 +(((
143 +Se il servizio configurato nel Client #phones, a cui viene assegnato questo servizio base del Messenger, è in grado di ricevere sia chiamate video che solo audio, è possibile omettere l'estensione del file, ad esempio //IntroMessage //invece di //IntroMessage.wav//.
144 +)))
84 84  
85 -(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
86 -(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
87 -|**Motore di riconoscimento vocale da utilizzare**|Selezionare il motore di riconoscimento da utilizzare. Al momento l’unico motore disponibile e configurabile è //Google Speech API//.
88 -|**Codice Lingua**|Indicare il codice della lingua, in formato [[BCP-47>>https://it.wikipedia.org/wiki/Codice_di_lingua_IETF||rel="noopener noreferrer" target="_blank"]], da utilizzare per il riconoscimento. Valore predefinito: //it-IT//.
89 -|**Termina riconoscimento su ricezione digits**|Selezionare se il riconoscimento può essere terminato dalla pressione di un digit da parte del chiamante.
90 -|**Tempo massimo di attesa**|Indicare il tempo massimo consentito, espresso in secondi, al chiamante per effettuare la sua scelta vocale. Valore predefinito: 30 secondi.
91 -|**Soglia di affidabilità**|Indicare il livello di affidabilità, tra 0 e 100, da raggiungere per considerare il riconoscimento valido. Valore predefinito: 70.
92 92  
93 -//Scheda Messaggi errore//
147 +== GetAlfaNumCode (CGetAlfaNumCode) ==
94 94  
95 -[[image:STT_skMessaggiErr.jpg||style="-moz-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); -webkit-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); margin:20px 10px"]]
149 +Richiede al chiamante, tramite riconoscimento vocale, il codice di identificazione alfanumerico, eseguendo un riconoscimento vocale per ogni carattere del codice. In alternativa è in grado di riconoscere anche i [[toni DTMF>>doc:Glossario.WebHome]]. E' necessario che sul sistema sia stato installato un motore di riconoscimento vocale SAPI compatibile, con relative licenze, non fornito con il Messenger oppure un motore integrato (disponibile solamente utilizzando [[LightHouse>>doc:Glossario.WebHome]]).
96 96  
97 -Impostare i campi seguenti:
98 98  
99 -(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
100 -(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
101 -|**Numero massimo di tentativi**|Indicare il numero massimo di tentativi di riconoscimento. Se la fase di riconoscimento non avesse successo, indica il numero di tentativi consentiti al chiamante. Valore predefinito: 2.
102 -|**Messaggio di errore con invito a ripetere**|Indicare il messaggio da riprodurre in caso di mancato riconoscimento.
152 +**Parametri di Configurazione**
103 103  
104 -//Scheda Salvataggio scelta//
154 +|=(% style="width: 200px;" %)**Parametri**|**Descrizione**
155 +|**Tipo di motore di sintesi vocale**|(((
156 +Selezionare il tipo di motore tra i seguenti:
105 105  
106 -[[image:STT_skSalvataggio.jpg||style="-moz-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); -webkit-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); margin:20px 10px"]]
158 +* SAPI (solo con PhoneSwitch, [[PBXServer>>doc:Glossario.WebHome]], [[DialServer>>doc:Glossario.WebHome]])
159 +* Integrati (solo per LightHouse)
160 +)))
161 +|**Directory contenente i file wav/avi**|Indicare la directory, o selezionare dalla lista, tramite il pulsante //Browse//, in cui sono contenuti i messaggi che il sistema deve riprodurre al chiamante. La tabella sotto //Messaggi Disponibili //riporta l'elenco dei messaggi utilizzabili.
162 +|**Motore**|Selezionare il motore di riconoscimento vocale da utilizzare dal sistema. **Nota**: il suo valore dipende dai motori installati nel sistema.
163 +|**Abilita Beep di avviso ad inizio riconoscimento**|Indicare se deve essere emesso un breve segnale acustico prima di ogni fase di riconoscimento vocale.
164 +|**Termina riconoscimento su ricezione Digit**|Indicare se la fase di riconoscimento può essere interrotta dalla pressione di un tasto dal parte dell'utente. Se abilitato, i tasti numerici entrano a far parte del codice, mentre * e # concludono l'acquisizione dei caratteri (fine del codice).
165 +|**Tempo massimo di attesa (secondi)**|Se è stato selezionato un motore SAPI, specificare il tempo massimo, in secondi, di ogni fase di riconoscimento vocale. Valore predefinito: 20 secondi.
166 +|**Massimo silenzio iniziale (secondi)**|Se è stato selezionato un motore integrato, specificare il periodo massimo di silenzio, in secondi, che il riconoscimento attende, prima che l'utente cominci a parlare, prima di uscire per fallimento. Valore predefinito: 20 secondi.
167 +|**Soglia di affidabilità (0-100)**|Indicare un valore tra 1 e 100 che indica il grado di sicurezza con cui un carattere deve essere riconosciuto per poter essere considerato valido. Valori alti indicano maggiore precisione e, quindi, maggior probabilità di nessun riconoscimento. Valore predefinito: 70.
168 +|**Numero massimo tentativi**|Numero massimo di tentativi in caso di codice non valido (nessuna digitazione).
169 +|**Lunghezza massima dei codici**|Numero massimo di digit del codice utente. Il tasto //Assegna Valore// consente di salvare il valore indicato in una costante, oppure recuperarlo da una Transfer Property o un Call Data.
170 +|**File Grammatica da utilizzare**|Nome del file contenente la [[grammatica>>||anchor="HGrammatica"]] da utilizzare. Il tasto //Assegna Valore// consente di salvare il valore indicato in una costante, oppure recuperarlo da una Transfer Property o un Call Data.
171 +|**Nome Transfer Property**|Selezionare la [[Transfer Property>>doc:ifmhelpplatform.MessengerConfigurator.TransferProperty.WebHome]] in cui viene salvati il codice acquisito.
172 +|**Servizio successivo se riconoscimento valido**|//Solamente configurando il Servizio tramite Messenger Configurator//. Selezionare dall'elenco il servizio da attivare nel caso di codice riconosciuto e confermato dall'utente.
173 +|**Servizio successivo per mancato riconoscimento**|//Solamente configurando il Servizio tramite Messenger Configurator//. Selezionare dall'elenco il servizio da attivare nel caso di codice NON riconosciuto o NON confermato dall'utente.
174 +| |
107 107  
108 -Impostare i campi seguenti:
176 +**Messaggi Disponibili**
109 109  
110 -(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
111 -(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
112 -|**Nome Transfer Property**|Selezionare la Transfer Property in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
113 -|**CallData**|Indicare il CallData in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
178 +|=(% style="width: 200px;" %)**Nome File**|**Messaggio**
179 +|**IntroMessage.wav**|Messaggio di accoglienza con istruzioni per l'inserimento del proprio codice.
180 +|**CharNotRecognized.wav**|Comunica che il riconoscimento del carattere corrente non è andato a buon fine.
181 +|**RecognizedCodeIs.wav**|Messaggio del tipo: //"Il codice riconosciuto è...".//
182 +|**confirm.wav**|Messaggio del tipo: //"Premere 1 per confermare, 0 per riprovare..."//.
183 +|**RepeatCode.wav**|Invita l'utente a riprovare il riconoscimento del codice dall'inizio.
184 +| |
114 114  
115 -==== Port di Uscita ====
186 +==== Grammatica ====
116 116  
117 -[[image:output_port.jpg||style="margin-bottom:20px; margin-top:20px"]]
188 +Il file contenente la definizione della grammatica utilizzata per il riconoscimento del codice dell'utente ha la struttura di un file INI con le seguenti quattro sezioni:
118 118  
119 -Le funzionalità dei //Port di Uscita// del blocchetto sono le seguenti :
190 +* La sezione (% style="font-family:Courier New,Courier,monospace" %)[Grammar] (%%)contiene i parametri generali della grammatica, attualmente il solo nome.
191 +* La sezione (% style="font-family:Courier New,Courier,monospace" %)[List](%%) contiene le associazioni tra le parole che il sistema deve essere in grado di riconoscere ed il relativo carattere da aggiungere al codice nel caso che il sistema riconosca una certa parola.
192 +* La sezione (% style="font-family:Courier New,Courier,monospace" %)[Stop](%%) indica le parole chiave che il sistema deve considerare come conclusione del codice; utili nel caso in cui i codici cliente non siano tutti della stessa lunghezza.
193 +* La sezione (% style="font-family:Courier New,Courier,monospace" %)[ConfirmOptions](%%) contiene le opzioni ammesse per la conferma del codice riconosciuto dal sistema;
194 +** la chiave "Confirm" indica la parola che deve essere pronunciata dal cliente per confermare il codice riconosciuto
195 +** la chiave "Cancel" indica la parola per annullare il riconoscimento e introdurre il codice dall'inizio.
120 120  
197 +**Esempio File Grammatica**
198 +
199 +(% style="background-color:#cccccc; width:600px" %)
200 +|(((
201 +(% class="small" style="font-family:Courier New,Courier,monospace" %)[Grammar](%%)
202 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Type=AlfaCode(%%)
203 +(% class="small" style="font-family:Courier New,Courier,monospace" %)[List](%%)
204 +(% class="small" style="font-family:Courier New,Courier,monospace" %)0=0(%%)
205 +(% class="small" style="font-family:Courier New,Courier,monospace" %)1=1(%%)
206 +(% class="small" style="font-family:Courier New,Courier,monospace" %)2=2(%%)
207 +(% class="small" style="font-family:Courier New,Courier,monospace" %)3=3(%%)
208 +(% class="small" style="font-family:Courier New,Courier,monospace" %)4=4(%%)
209 +(% class="small" style="font-family:Courier New,Courier,monospace" %)5=5(%%)
210 +(% class="small" style="font-family:Courier New,Courier,monospace" %)6=6(%%)
211 +(% class="small" style="font-family:Courier New,Courier,monospace" %)7=7(%%)
212 +(% class="small" style="font-family:Courier New,Courier,monospace" %)8=8(%%)
213 +(% class="small" style="font-family:Courier New,Courier,monospace" %)9=9(%%)
214 +(% class="small" style="font-family:Courier New,Courier,monospace" %)uno=1(%%)
215 +(% class="small" style="font-family:Courier New,Courier,monospace" %)due=2(%%)
216 +(% class="small" style="font-family:Courier New,Courier,monospace" %)tre=3(%%)
217 +(% class="small" style="font-family:Courier New,Courier,monospace" %)quattro=4(%%)
218 +(% class="small" style="font-family:Courier New,Courier,monospace" %)cinque=5(%%)
219 +(% class="small" style="font-family:Courier New,Courier,monospace" %)sei=6(%%)
220 +(% class="small" style="font-family:Courier New,Courier,monospace" %)sette=7(%%)
221 +(% class="small" style="font-family:Courier New,Courier,monospace" %)otto=8(%%)
222 +(% class="small" style="font-family:Courier New,Courier,monospace" %)nove=9(%%)
223 +(% class="small" style="font-family:Courier New,Courier,monospace" %)zero=0(%%)
224 +(% class="small" style="font-family:Courier New,Courier,monospace" %)a=A(%%)
225 +(% class="small" style="font-family:Courier New,Courier,monospace" %)bi=B(%%)
226 +(% class="small" style="font-family:Courier New,Courier,monospace" %)ci=C(%%)
227 +(% class="small" style="font-family:Courier New,Courier,monospace" %)di=D(%%)
228 +(% class="small" style="font-family:Courier New,Courier,monospace" %)e=E(%%)
229 +(% class="small" style="font-family:Courier New,Courier,monospace" %)effe=F(%%)
230 +(% class="small" style="font-family:Courier New,Courier,monospace" %)gi=G(%%)
231 +(% class="small" style="font-family:Courier New,Courier,monospace" %)acca=H(%%)
232 +(% class="small" style="font-family:Courier New,Courier,monospace" %)i=I(%%)
233 +(% class="small" style="font-family:Courier New,Courier,monospace" %)elle=L(%%)
234 +(% class="small" style="font-family:Courier New,Courier,monospace" %)emme=M(%%)
235 +(% class="small" style="font-family:Courier New,Courier,monospace" %)enne=N(%%)
236 +(% class="small" style="font-family:Courier New,Courier,monospace" %)o=O(%%)
237 +(% class="small" style="font-family:Courier New,Courier,monospace" %)pi=P(%%)
238 +(% class="small" style="font-family:Courier New,Courier,monospace" %)qu=Q(%%)
239 +(% class="small" style="font-family:Courier New,Courier,monospace" %)erre=R(%%)
240 +(% class="small" style="font-family:Courier New,Courier,monospace" %)esse=S(%%)
241 +(% class="small" style="font-family:Courier New,Courier,monospace" %)ti=T(%%)
242 +(% class="small" style="font-family:Courier New,Courier,monospace" %)u=U(%%)
243 +(% class="small" style="font-family:Courier New,Courier,monospace" %)vu=V(%%)
244 +(% class="small" style="font-family:Courier New,Courier,monospace" %)zeta=Z(%%)
245 +(% class="small" style="font-family:Courier New,Courier,monospace" %)x=X(%%)
246 +(% class="small" style="font-family:Courier New,Courier,monospace" %)y=Y(%%)
247 +(% class="small" style="font-family:Courier New,Courier,monospace" %)k=K(%%)
248 +(% class="small" style="font-family:Courier New,Courier,monospace" %)j=J(%%)
249 +(% class="small" style="font-family:Courier New,Courier,monospace" %)w=W(%%)
250 +(% class="small" style="font-family:Courier New,Courier,monospace" %)ics=X(%%)
251 +(% class="small" style="font-family:Courier New,Courier,monospace" %)ipsilon=Y(%%)
252 +(% class="small" style="font-family:Courier New,Courier,monospace" %)cappa=K(%%)
253 +(% class="small" style="font-family:Courier New,Courier,monospace" %)vudoppia=W(%%)
254 +(% class="small" style="font-family:Courier New,Courier,monospace" %)doppiavu=W(%%)
255 +(% class="small" style="font-family:Courier New,Courier,monospace" %)gei=J(%%)
256 +(% class="small" style="font-family:Courier New,Courier,monospace" %)ilunga=J(%%)
257 +(% class="small" style="font-family:Courier New,Courier,monospace" %)igreca=Y(%%)
258 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Ancona=A(%%)
259 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Bologna=B(%%)
260 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Catania=C(%%)
261 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Domodossola=D(%%)
262 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Empoli=E(%%)
263 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Firenze=F(%%)
264 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Genova=G(%%)
265 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Hotel=H(%%)
266 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Imperia=I(%%)
267 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Livorno=L(%%)
268 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Milano=M(%%)
269 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Napoli=N(%%)
270 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Otranto=O(%%)
271 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Palermo=P(%%)
272 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Quadro=Q(%%)
273 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Roma=R(%%)
274 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Savona=S(%%)
275 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Torino=T(%%)
276 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Urbino=U(%%)
277 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Verona=V(%%)
278 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Zagabria=Z(%%)
279 +(% class="small" style="font-family:Courier New,Courier,monospace" %)[Stop](%%)
280 +(% class="small" style="font-family:Courier New,Courier,monospace" %)stop(%%)
281 +(% class="small" style="font-family:Courier New,Courier,monospace" %)end(%%)
282 +(% class="small" style="font-family:Courier New,Courier,monospace" %)[ConfirmOptions](%%)
283 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Confirm=corretto(%%)
284 +(% class="small" style="font-family:Courier New,Courier,monospace" %)Cancel=annulla
285 +)))
286 +
287 +== SpeechToText (CSpeechToText) ==
288 +
289 +Questo blocchetto permette di convertire l'audio del chiamante (parlato) in testo tramite il motore di riconoscimento vocale di Google (Google Speech API). Il testo può essere salvato in una Transfer Property o in un CallData, per potere essere analizzato/elaborato successivamente da ulteriori blocchetti impostati nel flusso della chiamata.
290 +
291 +Il servizio è disponibile anche in //compatibility mode.//
292 +
293 +
294 +**Parametri di Configurazione**
295 +
121 121  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
122 122  (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
123 -|**Failure**|Indicare il servizio successivo da attivare nel caso in cui il motore non riconosca l'audio e non sia premuto dal chiamante alcun digit.
124 -|**Digit Detected**|Indicare il servizio successivo da attivare nel caso in cui il riconoscimento sia interrotto dalla pressione di un digit.
125 -|**Success**|Indicare il servizio successivo da attivare nel caso il riconoscimento abbia successo.
298 +|**Lista messaggi**|Lista dei messaggi da riprodurre al chiamante come invito e istruzioni per ciò che deve dire.
299 +|**ConfidenceLevel**|Valore numerico compreso tra 0 e 100 che indica il livello di affidabilità da raggiungere per considerare il riconoscimento valido.
300 +|**RecognitionTimeout**|Tempo massimo consentito al chiamante per effettuare la sua scelta vocale.
301 +|**EngineName**|Nome del motore di riconoscimento da utilizzare. Al momento l’unico motore disponibile e configurabile è //Google Speech API//.
302 +|**EngineLanguage**|Codice della lingua, in formato [[BCP-47>>https://it.wikipedia.org/wiki/Codice_di_lingua_IETF||rel="noopener noreferrer" target="_blank"]], da utilizzare per il riconoscimento.
303 +|**StopOnDigit**|Flag che indica se il riconoscimento può essere terminato dalla pressione di un digit da parte del chiamante.
304 +|**NotRecognizedMessage**|Messaggio riprodotto in caso di mancato riconoscimento.
305 +|**MaxRetries**|Numero massimo dei tentativi di riconoscimento. Se la fase di riconoscimento non avesse successo, indica il numero di tentativi consentiti al chiamante.
306 +|**TransferProperty**|Nome della Transfer Property in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
307 +|**CallData**|Nome del CallData in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
308 +|**NextServiceFailure**|Nome del servizio successivo da attivare nel caso in cui il motore non riconosca l'audio e non sia premuto dal chiamante alcun digit.
309 +|**NextServiceDigitDetected**|Nome del servizio successivo da attivare nel caso in cui il riconoscimento sia interrotto dalla pressione di un digit.
310 +|**NextServiceRecognized**|Nome del servizio successivo da attivare nel caso il riconoscimento abbia successo.
126 126  
127 -=== **Transfer Property** ===
312 +**Transfer Property**
128 128  
129 129  Oltre alla Transfer Property definita in fase di configurazione, il blocchetto crea le due seguenti Transfer Property di sistema che possono essere eventualmente usate dai blocchetti successivi:
130 130  
... ... @@ -134,9 +134,71 @@
134 134  |**_ASR_Source**|(((
135 135  Contiene la sorgente dell’informazione contenuta nella Transfer Property e nel Call Data definiti in configurazione. I valori possibili sono:
136 136  
137 -* **“”** (stringa vuota): nel caso in cui non sia riconosciuto l'audio e non sia rilevato alcun digit.
138 -* **“DTMF”**: nel caso sia rilevato un digit che interrompe la fase di riconoscimento. La Transfer Property e il Call Data, eventualmente configurati come variabili di uscita, conterranno il digit ricevuto.
139 -* **“STT”**: nel caso il motore di riconoscimento restituisca un qualsiasi valore. La Transfer Property e il Call Data, eventualmente configurati come variabili di uscita, conterranno il testo riconosciuto.
322 +
140 140  )))
141 141  
325 +* **“”** (stringa vuota): nel caso in cui non venga riconosciuto nulla e nessun digit venga rilevato .
326 +*
327 +(% style="list-style-type:circle" %)
328 +** **“DTMF”**: nel caso venga rilevato un digit che interrompe la fase di riconoscimento. La Transfer Property ed il Call Data eventualmente configurati come variabili di uscita conterranno il digit ricevuto.
329 +** **“STT”**: nel caso il motore di riconoscimento restituisca un qualche valore. La Transfer Property ed il Call Data eventualmente configurati come variabili di uscita conterranno il testo riconosciuto.
330 +
331 +
332 +
333 +
334 +== VoiceMenu (CVoiceMenu) ==
335 +
336 +Presenta un menu di opzioni e, in base alla scelta del chiamante, effettuata tramite il riconoscimento vocale, attiva il servizio associato. Permette di configurare la sequenza di messaggi (file wav/avi, numeri, date, ecc.) da riprodurre all'utente per invitarlo a segnalare al sistema la sua scelta.
337 +
338 +E' inoltre possibile, in caso di nessuna scelta o di scelta errata, configurare un servizio predefinito. Questo servizio richiede che sul sistema sia stato installato un motore di riconoscimento vocale SAPI compatibile, con relative licenze, non fornito con il Messenger oppure un motore integrato (solo disponibile utilizzando [[LightHouse>>doc:Glossario.WebHome]]).
339 +
340 +
341 +**Parametri di Configurazione**
342 +
343 +|=(% style="width: 200px;" %)**Parametri**|**Descrizione**
344 +|**Tipo di motore di sintesi vocale**|(((
345 +Selezionare il tipo di motore tra i seguenti:
346 +
347 +* //SAPI (solo con PhoneSwitch, [[PBXServer>>doc:Glossario.WebHome]], [[DialServer>>doc:Glossario.WebHome]])//
348 +* //Integrati (solo per LightHouse)//
349 +)))
350 +|**Usa un dizionario interno al motore**|Se è stato selezionato un motore di sintesi integrato, è possibile abilitare l'uso di un dizionario interno, specificandone il folder e il nome.
351 +|**Lista dei messaggi**|(((
352 +Indicare la lista dei messaggi da riprodurre alla chiamante per guidarlo nella scelta. Utilizzare i tasti //Nuovo//, //Modifica//, //Cancella //e le frecce di ordine per selezionare il tipo di messaggio tra i seguenti:
353 +
354 +* File WAV/AVI
355 +* Numero
356 +* Importo
357 +* Sequenza di caratteri
358 +* Lista formattata
359 +* Data/Ora
360 +* Data/Ora corrente
361 +* Data/Ora di un file
362 +* Ordinale.
363 +
364 +Per ogni tipo, oltre alla selezione o al valore, occorre indicare ulteriori parametri specifici, come formato di data e ora, sequenze, decimali significativi, ecc.
365 +
366 +Inoltre è possibile indicare eventuali parametri specifici per la lingua corrente. Questo parametro gestisce esclusivamente l'italiano e lo spagnolo. Per entrambe le lingue, se questo parametro è impostato con "F", gli ordinali sono riprodotti al femminile, in tutti gli altri casi al maschile. Solo per lo spagnolo, se questo parametro è impostato con "F", il numero 1 è riprodotto al femminile, altrimenti al maschile. Solo per l'italiano, se questo parametro è impostato con "E", l'importo è riprodotto in EURO altrimenti in Lire.
367 +)))
368 +|**Motore del Riconoscimento Vocale**|Selezionare dalla lista il motore di riconoscimento vocale da utilizzare.
369 +|**Abilita Beep di avviso ad inizio riconoscimento**|Abilitato se è stato selezionato un motore integrato. Indica se deve essere emesso un breve segnale acustico prima di ogni fase di riconoscimento vocale.
370 +|**Termina riconoscimento su ricezione Digits**|Abilitato se è stato selezionato un motore SAPI. Indica se la fase di riconoscimento può essere interrotta dalla pressione di un tasto dal parte dell'utente. Se abilitato, i tasti numerici entrano a far parte del codice, mentre * e # concludono l'acquisizione dei caratteri (fine del codice).
371 +|**Tempo massimo di attesa (secondi)**|Abilitato se è stato selezionato un motore SAPI. Massimo periodo di silenzio, espresso in secondi, che il riconoscimento attende prima che l'utente cominci a parlare, prima di uscire per fallimento. Valore predefinito: 20 secondi.
372 +|**Abilita riconoscimento durante la play (Barge ln)**|Abilitato se è stato selezionato un motore integrato. Abilita l’interruzione dei messaggi nel momento in cui l’utente pronuncia una frase, un nome o un qualsiasi comando vocale (senza attendere il “beep” di fine messaggio).
373 +|**Massimo silenzio iniziale (secondi)**|Abilitato se è stato selezionato un motore integrato. Specificare il periodo massimo di silenzio, in secondi, che il riconoscimento attende, prima che l'utente cominci a parlare, prima di uscire per fallimento. Valore predefinito: 20 secondi.
374 +|**Look Ahead Time**|Abilitato se è stato selezionato un motore integrato. Indicare il tempo in millisecondi che l'algoritmo di riconoscimento utilizza per verificare il frame audio successivo al fine di migliorare la qualità della codifica. Valore predefinito: 800 millisecondi. Per maggiori informazioni vedere anche [[Look Ahead Time>>doc:Glossario.WebHome||anchor="HLookAheadTime" target="_blank"]].
375 +|**Soglia di affidabilità (0-100)**|E' un valore tra 1 e 100 che indica il grado di sicurezza con cui un carattere deve essere riconosciuto per poter essere considerato valido. Valori alti indicano maggiore precisione e, quindi, maggior probabilità di nessun riconoscimento. Valore predefinito: 70.
376 +|**Servizio da attivare a seconda della selezione**|Utilizzare i tasti //Nuovo//, //Modifica// e //Cancella// per indicare il servizio da attivare a seconda della scelta fatta dal chiamante.
377 +|**Parola chiave**|Parola che l'utente deve pronunciare per attivare l'opzione. Se si indica il carattere "-", il servizio associato è quello di default attivato nel caso che nessuna delle altre condizioni sia soddisfatta al termine delle ripetizioni previste.
378 +|**Digit associato**|Eventuale digit che l'utente può digitare per attivare il servizio associato.
379 +|**Servizio attivato**|//Solo configurando il Servizio tramite Messenger Configurator//. Selezionare dalla lista il servizio da attivare per la particolare sequenza.
380 +|**Numero massimo di tentativi**|Massimo numero di tentativi concessi all'utente per effettuare la sua scelta prima di proseguire con il servizio di default.
381 +|**Messaggio di errore con invito a ripetere**|Messaggio che, in caso di mancato riconoscimento, invita l'utente a ripetere la sua scelta. Il tasto //Assegna Valore// consente di salvare il valore indicato in una costante, oppure recuperarlo da una Transfer Property o un Call Data.
382 +|**Messaggio di errore su raggiungimento limite**|Messaggio di errore nel caso che si superi il numero di tentativi concessi senza aver riconosciuto con successo la scelta dell'utente. Il tasto //Assegna Valore// consente di salvare il valore indicato in una costante, oppure recuperarlo da una Transfer Property o un Call Data.
383 +|**Abilitazione salvataggio scelta**|Abilitare la casella per attivare il salvataggio della scelta dell'utente in una [[Transfer Property>>doc:ifmhelpplatform.MessengerConfigurator.TransferProperty.WebHome]].
384 +|**Nome Transfer Property**|Selezionare dall'elenco il nome della Transfer Property in cui salvare la scelta.
385 +|**Aggiungere all'attuale valore**|Se abilitato, la scelta dell'utente viene accodata, separata da virgola, all'attuale contenuto della Transfer Property. E' possibile quindi usare una Transfer Property per memorizzare tutta la sequenza di scelta dell'utente.
386 +|**Eventuale separatore**|Eventuale caratteri di separazione da inserire nella transfer property tra il valore esistente e la parola riconosciuta dal servizio.
387 +| |
388 +
142 142  
STT_skMessaggi.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -45.2 KB
Content
STT_skMessaggiErr.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -40.5 KB
Content
STT_skMotore.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -50.4 KB
Content
STT_skSalvataggio.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -37.7 KB
Content
output_port.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -29.1 KB
Content
rtm_po.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -5.7 KB
Content
rtm_proprieta.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -12.5 KB
Content
wtm_sorgente.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -16.8 KB
Content
wtm_testo.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -12.0 KB
Content