Skip to Content

Changes for page 11 - Chat

Last modified by administrator BDP on 2024/10/16 17:42
From version 72.1
edited by administrator BDP
on 2024/10/16 17:42
Change comment: There is no comment for this version
To version 48.1
edited by administrator BDP
on 2019/04/19 17:02
Change comment: Uploaded new attachment "rtm_po.jpg", version {1}

Summary

Details

Page properties
Hidden
... ... @@ -1,1 +1,1 @@
1 -false
1 +true
Content
... ... @@ -3,19 +3,14 @@
3 3  [[image:acrobat-logo.png]] [[Scarica la pagina come pdf>>https://wiki.ifmgroup.it/bin/export/ifmhelpplatform/MessengerServiziBase/VoiceRecognition/?format=pdf||rel="noopener noreferrer" target="new"]]
4 4  )))
5 5  
6 -{{box cssClass="floatinginfobox" width="300px" title="**Sommario**"}}
7 -{{toc start="2" depth="3"/}}
6 +{{box cssClass="floatinginfobox" title="**Sommario**" width="300px"}}
7 +{{toc start=2 depth="3"/}}
8 8  {{/box}}
9 9  
10 -(% class="box errormessage" %)
11 -(((
12 -**ATTENZIONE**: i caratteri **cancelletto** (#) e **dollaro** ($) sono considerati caratteri speciali in quanto definiscono i calldata e le transfer property. Se è necessario inserire uno di questi caratteri, in un qualsiasi campo, occorre specificarli in coppia, ad esempio "~#~#" oppure "$$".
13 -)))
14 14  
15 -
16 16  == ReadTextMessage ==
17 17  
18 -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"]].
19 19  
20 20  === **Parametri di Configurazione** ===
21 21  
... ... @@ -25,32 +25,22 @@
25 25  
26 26  //Scheda Salva in//
27 27  
28 -[[image:ReadTextMessage.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" width="400"]]
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"]]
29 29  
30 30  L'elenco dei campi visualizzati è il seguente:
31 31  
32 32  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
33 -(% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
34 -|**Transfer Property**|Selezionare dalla lista il nome della transfer property in cui salvare il testo del messaggio di chat.
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 messaggio di chat.
35 35  |**Call Data**|Indicare il CallData in cui salvare il messaggio di chat.
36 -|**Tempo massimo per l'inserimento**|Indicare il timeout di attesa di ricezione di un messaggio da parte dell'utente.
37 -|**Ottieni lo storico dei messaggi della chat**|Se selezionato, abilita la richiesta dello storico della chat. Se l'opzione non viene selezionata o si utilizzano configurazioni precedenti in cui questa funzionalità non è presente, il comportamento del blocchetto rimane invariato.
38 38  
39 -==== Port di Uscita ====
40 -
41 -[[image:rtm_po.jpg||style="margin-bottom:20px; margin-top:20px"]]
42 -
43 -La funzionalità del //Port di Uscita// del blocchetto prevede solamente il seguente parametro:
44 -
45 -(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
46 -(% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
47 -|**Out**|Port di uscita predefinito.
48 -
49 49  == WriteTextMessage ==
50 50  
51 -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.
34 +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.
52 52  
36 +Il servizio è disponibile anche in //compatibility mode.//
53 53  
38 +
54 54  === **Parametri di Configurazione** ===
55 55  
56 56  ==== **Proprietà** ====
... ... @@ -57,116 +57,89 @@
57 57  
58 58  Cliccando sulla funzionalità //Proprietà// del blocchetto sono visualizzate le seguenti schede:
59 59  
60 -//Scheda Sorgente//
45 +//Scheda Messaggi//
61 61  
62 -[[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"]]
47 +[[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"]]
63 63  
64 64  L'elenco dei campi visualizzati è il seguente:
65 65  
66 66  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
67 -(% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
68 -|**Tipo sorgente**|(((
69 -Selezionare il tipo di sorgente da cui prendere il testo del messaggio tra i seguenti:
52 +(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
53 +|**Lista messaggi**|Lista dei messaggi da riprodurre al chiamante come invito e istruzioni per ciò che deve dire.
70 70  
71 -* Stringa di test costante
72 -* Transfer Property
73 -* Call Data
74 -* Comando per SMG
75 -)))
55 +Utilizzare i tasti **Nuovo**, **Modifica** e **Cancella** per selezionare e impostare il tipo di messaggio da riprodurre tra i seguenti:
76 76  
77 -//Scheda Testo//
57 +* File
58 +* Numero
59 +* Importo
60 +* Sequenza di caratteri
61 +* Lista formattata
62 +* Data/Ora
63 +* Data/Ora attuale
64 +* Data/Ora del file
65 +* Ordinale
78 78  
79 -Se è stata selezionata la sorgente //testo//, viene visualizzata la seguente scheda //Testo//:
67 +//Scheda Motore//
80 80  
81 -[[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"]]
69 +[[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"]]
82 82  
83 83  Impostare i campi seguenti:
84 84  
85 85  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
86 -(% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
87 -|**Testo da sintetizzare**|Inserire il testo libero del messaggio da inviare sulla chat.
74 +(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
75 +|**Motore di riconoscimento vocale da utilizzare**|Selezionare il motore di riconoscimento da utilizzare. Al momento l’unico motore disponibile e configurabile è //Google Speech API//.
76 +|**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//.
77 +|**Termina riconoscimento su ricezione digits**|Selezionare se il riconoscimento può essere terminato dalla pressione di un digit da parte del chiamante.
78 +|**Tempo massimo di attesa**|Indicare il tempo massimo consentito, espresso in secondi, al chiamante per effettuare la sua scelta vocale. Valore predefinito: 30 secondi.
79 +|**Soglia di affidabilità**|Indicare il livello di affidabilità, tra 0 e 100, da raggiungere per considerare il riconoscimento valido. Valore predefinito: 70.
88 88  
89 -//Scheda Transfer Property//
81 +//Scheda Messaggi errore//
90 90  
91 -Se è stata selezionata la sorgente //Transfer Property//, viene visualizzata la seguente scheda //Transfer Property//:
83 +[[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"]]
92 92  
93 -[[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"]]
94 -
95 95  Impostare i campi seguenti:
96 96  
97 97  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
98 -(% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
99 -|**Transfer Property**|Indicare la Transfer Property, il cui contenuto deve essere inviato come testo del messaggio di chat.
88 +(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
89 +|**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.
90 +|**Messaggio di errore con invito a ripetere**|Indicare il messaggio da riprodurre in caso di mancato riconoscimento.
100 100  
101 -//Scheda Call Data//
92 +//Scheda Salvataggio scelta//
102 102  
103 -Se è stata selezionata la sorgente //Call Data//, viene visualizzata la seguente scheda //Call Data//:
94 +[[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"]]
104 104  
105 -[[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"]]
106 -
107 107  Impostare i campi seguenti:
108 108  
109 109  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
110 -(% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
111 -|**Call Data**|Indicare il Call Data, il cui contenuto deve essere inviato come testo del messaggio di chat.
99 +(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
100 +|**Nome Transfer Property**|Selezionare la Transfer Property in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
101 +|**CallData**|Indicare il CallData in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
112 112  
113 -//Scheda Comando per SMG//
103 +==== Port di Uscita ====
114 114  
115 -Se è stata selezionata la sorgente //Comando per SMG//, viene visualizzata la seguente scheda //Comando//:
105 +[[image:output_port.jpg||style="margin-bottom:20px; margin-top:20px"]]
116 116  
117 -[[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"]]
107 +Le funzionalità dei //Port di Uscita// del blocchetto sono le seguenti :
118 118  
119 -Impostare i campi seguenti:
120 -
121 121  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
122 -(% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
123 -|**Comando**|(((
124 -Selezionare dalla lista il comando da inviare al SocialMediaGateway tra i seguenti:
110 +(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
111 +|**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.
112 +|**Digit Detected**|Indicare il servizio successivo da attivare nel caso in cui il riconoscimento sia interrotto dalla pressione di un digit.
113 +|**Success**|Indicare il servizio successivo da attivare nel caso il riconoscimento abbia successo.
125 125  
126 -* **Comando 'HANDLED'**
127 -Invia il comando //*begin*HANDLED%%%%%%§end§// che segnala che la conversazione è conclusa e che quindi non deve essere più inviata all'operatore.
128 -**NOTA BENE**: se un IVR o un operatore chiude una chiamata del SMG senza comunicare il messaggio //HANDLED// o solamente con il blocchetto //Hangup//, la conversazione verrà riproposta a #phones dalla fase successiva del SMG e quindi passata nuovamente all'operatore (umano o IVR).
129 -
130 -* **Comando 'SETCALLDATA'**
131 -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§//.
132 -)))
115 +=== **Transfer Property** ===
133 133  
134 -//Scheda Keyboard//
117 +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:
135 135  
136 -Da utilizzare solamente per chat Telegram. Nella scheda //Keyboard// è possibile personalizzare una tastiera, selezionare un tastierino numerico o una scelta singola (Sì/No).
137 -
138 -[[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"]]
139 -
140 -Impostare i campi seguenti:
141 -
142 142  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
143 -(% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
144 -|**Predefiniti**|(((
145 -Selezionare dalla lista uno dei seguenti valori:
120 +(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
121 +|**~_~_RecognizeResult~_~_**|Contiene l’esito della richiesta di riconoscimento.
122 +|**_ASR_Source**|(((
123 +Contiene la sorgente dell’informazione contenuta nella Transfer Property e nel Call Data definiti in configurazione. I valori possibili sono:
146 146  
147 -* **Personalizzata**
148 -Consente di impostare una tastiera in formato tabellare. Indicare il numero di righe e colonne e digitare il testo che si vuole visualizzare nella chat.
149 -\\[[image:wtm_keypers.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"]]
150 -
151 -
152 -* **Numerica**
153 -Consente di impostare un tastierino numerico predefinito.
154 -\\[[image:wtm_keynum.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"]]
155 -\\
156 -* **Sì/No**
157 -Consente di impostare una tastiera con i soli valori //Sì// e //No//.
158 -\\[[image:wtm_keysn.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"]]
159 -
125 +* **“”** (stringa vuota): nel caso in cui non sia riconosciuto l'audio e non sia rilevato alcun digit.
126 +* **“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.
127 +* **“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.
160 160  )))
161 161  
162 -==== Port di Uscita ====
163 -
164 -[[image:wtm_po.png]]
165 -
166 -La funzionalità del //Port di Uscita// del blocchetto prevede solamente il seguente parametro:
167 -
168 -(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
169 -(% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
170 -|**Out**|Port di uscita predefinito.
171 -
172 172  
ReadTextMessage.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -15.0 KB
Content
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_keynum.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -4.7 KB
Content
wtm_keypers.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -4.2 KB
Content
wtm_keysn.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -3.7 KB
Content
wtm_po.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -2.1 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