Changes for page 11 - Chat

Last modified by administrator BDP on 2024/10/16 17:42

From version 59.2
edited by administrator BDP
on 2019/04/29 15:41
Change comment: There is no comment for this version
To version 49.1
edited by administrator BDP
on 2019/04/19 17:02
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -10,7 +10,7 @@
10 10  
11 11  == ReadTextMessage ==
12 12  
13 -Questo blocchetto consente di leggere il testo di 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"]].
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"]].
14 14  
15 15  === **Parametri di Configurazione** ===
16 16  
... ... @@ -26,7 +26,7 @@
26 26  
27 27  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
28 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.
29 +|**Transfer Property**|Selezionare dalla lista il nome della transfer property in cui salvare il messaggio di chat.
30 30  |**Call Data**|Indicare il CallData in cui salvare il messaggio di chat.
31 31  
32 32  ==== Port di Uscita ====
... ... @@ -33,17 +33,24 @@
33 33  
34 34  [[image:rtm_po.jpg||style="margin-bottom:20px; margin-top:20px"]]
35 35  
36 -La funzionalità del //Port di Uscita// del blocchetto prevede solamente il seguente parametro:
36 +Le funzionalità dei //Port di Uscita// del blocchetto sono le seguenti :
37 37  
38 38  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
39 39  (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
40 -|**Out**|Port di uscita predefiito.
40 +|**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.
41 +|**Digit Detected**|Indicare il servizio successivo da attivare nel caso in cui il riconoscimento sia interrotto dalla pressione di un digit.
42 +|**Success**|Indicare il servizio successivo da attivare nel caso il riconoscimento abbia successo.
41 41  
44 +
45 +
46 +
42 42  == WriteTextMessage ==
43 43  
44 -Questo blocchetto consente di selezionare il tipo di sorgente (stringa di testo, una [[transfer property>>doc:ifmhelpplatform.MessengerConcetti.TransferProperty.WebHome||target="_blank"]], [[Call Data>>doc:03 - Sviluppo Moduli Applicativi.CallData.WebHome||target="_blank"]], o tramite comando per il SocialMediaGateway) da cui prelevare il testo del messaggio da inviare in chat. Inoltre, solamente per Telegram, è possibile indicare o impostare una tastiera personalizzata da visualizzare nella chat.
49 +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.
45 45  
51 +Il servizio è disponibile anche in //compatibility mode.//
46 46  
53 +
47 47  === **Parametri di Configurazione** ===
48 48  
49 49  ==== **Proprietà** ====
... ... @@ -50,81 +50,51 @@
50 50  
51 51  Cliccando sulla funzionalità //Proprietà// del blocchetto sono visualizzate le seguenti schede:
52 52  
53 -//Scheda Sorgente//
60 +//Scheda Messaggi//
54 54  
55 -[[image:wtm_sorgente.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"]]
62 +[[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"]]
56 56  
57 57  L'elenco dei campi visualizzati è il seguente:
58 58  
59 59  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
60 60  (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
61 -|**Tipo sorgente**|(((
62 -Selezionare il tipo di sorgente da cui prendere il testo del messaggio tra i seguenti:
68 +|**Lista messaggi**|Lista dei messaggi da riprodurre al chiamante come invito e istruzioni per ciò che deve dire.
63 63  
64 -* Stringa di test costante
65 -* Transfer Property
66 -* Call Data
67 -* Comando per SMG
68 -)))
69 69  
70 -Se è stata selezionata la sorgente //testo//, viene visualizzata la seguente scheda //Testo//:
71 +Utilizzare i tasti **Nuovo**, **Modifica** e **Cancella** per selezionare e impostare il tipo di messaggio da riprodurre tra i seguenti:
71 71  
72 -[[image:wtm_testo.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"]]
73 +* File
74 +* Numero
75 +* Importo
76 +* Sequenza di caratteri
77 +* Lista formattata
78 +* Data/Ora
79 +* Data/Ora attuale
80 +* Data/Ora del file
81 +* Ordinale
73 73  
74 -Impostare i campi seguenti:
83 +//Scheda Motore//
75 75  
76 -(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
77 -(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
78 -|**Testo da sintetizzare**|Inserire il testo libero del messaggio da inviare sulla chat.
85 +[[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"]]
79 79  
80 -Se è stata selezionata la sorgente //Transfer Property//, viene visualizzata la seguente scheda //Transfer Property//:
81 -
82 -[[image:wtm_tp.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"]]
83 -
84 84  Impostare i campi seguenti:
85 85  
86 86  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
87 87  (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
88 -|**Transfer Property**|Indicare la Transfer Property, il cui contenuto deve essere inviato come testo del messaggio di chat.
91 +|**Motore di riconoscimento vocale da utilizzare**|Selezionare il motore di riconoscimento da utilizzare. Al momento l’unico motore disponibile e configurabile è //Google Speech API//.
92 +|**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//.
93 +|**Termina riconoscimento su ricezione digits**|Selezionare se il riconoscimento può essere terminato dalla pressione di un digit da parte del chiamante.
94 +|**Tempo massimo di attesa**|Indicare il tempo massimo consentito, espresso in secondi, al chiamante per effettuare la sua scelta vocale. Valore predefinito: 30 secondi.
95 +|**Soglia di affidabilità**|Indicare il livello di affidabilità, tra 0 e 100, da raggiungere per considerare il riconoscimento valido. Valore predefinito: 70.
89 89  
90 -Se è stata selezionata la sorgente //Call Data//, viene visualizzata la seguente scheda //Call Data//:
97 +//Scheda Messaggi errore//
91 91  
92 -[[image:wtm_cd.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"]]
99 +[[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"]]
93 93  
94 94  Impostare i campi seguenti:
95 95  
96 96  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
97 97  (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
98 -|**Call Data**|Indicare il Call Data, il cui contenuto deve essere inviato come testo del messaggio di chat.
99 -
100 -Se è stata selezionata la sorgente //Comando per SMG//, viene visualizzata la seguente scheda //Comando//:
101 -
102 -[[image:wtm_smg.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"]]
103 -
104 -Impostare i campi seguenti:
105 -
106 -(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
107 -(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
108 -|**Comando**|(((
109 -Selezionare dalla lista il comando da inviare al SocialMediaGateway tra i seguenti:
110 -
111 -* **Comando 'HANDLED'**
112 -Segnala al SocialMediaGateway che il messaggio corrente è stato preso in carico dall'operatore. Il comando inviato sarà //"*begin*HANDLED%%%%%%§end§"//.
113 -
114 -* **Comando 'SETCALLDATA'**
115 -Consente di inviare ulteriori Call Data al SocialMediaGateway come parametri. Il formato dei parametri è il seguente: //CallData_1=[Value_1],CallData_2=[Value_2]//. Il comando inviato sarà //"*begin*SETCALLDATA%%%%%%CallData_1=Value_1,CallData_2=Value_2%%%%%%§end§"//.
116 -)))
117 -
118 -//Scheda Keyboard//
119 -
120 -Da utilizzare solamente per chat Telegram. Nella scheda //Keyboard// è possibile personalizzare una tastiera, selezionare un tastierino numerico o una celta singola (Sì/No).
121 -
122 -[[image:wtm_key.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"]]
123 -
124 -Impostare i campi seguenti:
125 -
126 -(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
127 -(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
128 128  |**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.
129 129  |**Messaggio di errore con invito a ripetere**|Indicare il messaggio da riprodurre in caso di mancato riconoscimento.
130 130  
... ... @@ -149,6 +149,21 @@
149 149  (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
150 150  |**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.
151 151  |**Digit Detected**|Indicare il servizio successivo da attivare nel caso in cui il riconoscimento sia interrotto dalla pressione di un digit.
152 -|**Success**|(((
153 -Indicare il servizio successivo da attivare nel caso il riconoscimento abbia successo.
129 +|**Success**|Indicare il servizio successivo da attivare nel caso il riconoscimento abbia successo.
130 +
131 +=== **Transfer Property** ===
132 +
133 +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:
134 +
135 +(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
136 +(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
137 +|**~_~_RecognizeResult~_~_**|Contiene l’esito della richiesta di riconoscimento.
138 +|**_ASR_Source**|(((
139 +Contiene la sorgente dell’informazione contenuta nella Transfer Property e nel Call Data definiti in configurazione. I valori possibili sono:
140 +
141 +* **“”** (stringa vuota): nel caso in cui non sia riconosciuto l'audio e non sia rilevato alcun digit.
142 +* **“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.
143 +* **“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.
154 154  )))
145 +
146 +
wtm_cd.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -11.9 KB
Content
wtm_key.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -13.9 KB
Content
wtm_smg.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -12.9 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
wtm_tp.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -13.6 KB
Content