Skip to Content

Changes for page 11 - Chat

Last modified by administrator BDP on 2024/10/16 17:42
From version 46.1
edited by administrator BDP
on 2019/04/19 16:48
Change comment: There is no comment for this version
To version 69.6
edited by administrator BDP
on 2024/10/14 16:14
Change comment: There is no comment for this version

Summary

Details

Page properties
Hidden
... ... @@ -1,1 +1,1 @@
1 -true
1 +false
Content
... ... @@ -3,14 +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" title="**Sommario**" width="300px"}}
7 -{{toc start=2 depth="3"/}}
6 +{{box cssClass="floatinginfobox" width="300px" title="**Sommario**"}}
7 +{{toc start="2" depth="3"/}}
8 8  {{/box}}
9 9  
10 10  
11 11  == ReadTextMessage ==
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"]].
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"]].
14 14  
15 15  === **Parametri di Configurazione** ===
16 16  
... ... @@ -20,23 +20,32 @@
20 20  
21 21  //Scheda Salva in//
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"]]
23 +[[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"]]
24 24  
25 25  L'elenco dei campi visualizzati è il seguente:
26 26  
27 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 messaggio di chat.
30 -|**Call Data**|
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.
31 +|**Tempo massimo per l'inserimento**|Indicare il timeout di attesa di ricezione di un messaggio.
32 +|**Ottieni lo storico dei messaggi della chat**|Se selezionato, abiolita la richiesta
31 31  
34 +==== Port di Uscita ====
32 32  
33 -== WriteTextMessage ==
36 +[[image:rtm_po.jpg||style="margin-bottom:20px; margin-top:20px"]]
34 34  
35 -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.
38 +La funzionalità del //Port di Uscita// del blocchetto prevede solamente il seguente parametro:
36 36  
37 -Il servizio è disponibile anche in //compatibility mode.//
40 +(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
41 +(% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
42 +|**Out**|Port di uscita predefinito.
38 38  
44 +== WriteTextMessage ==
39 39  
46 +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.
47 +
48 +
40 40  === **Parametri di Configurazione** ===
41 41  
42 42  ==== **Proprietà** ====
... ... @@ -43,89 +43,116 @@
43 43  
44 44  Cliccando sulla funzionalità //Proprietà// del blocchetto sono visualizzate le seguenti schede:
45 45  
46 -//Scheda Messaggi//
55 +//Scheda Sorgente//
47 47  
48 -[[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"]]
57 +[[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"]]
49 49  
50 50  L'elenco dei campi visualizzati è il seguente:
51 51  
52 52  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
53 -(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
54 -|**Lista messaggi**|Lista dei messaggi da riprodurre al chiamante come invito e istruzioni per ciò che deve dire.
62 +(% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
63 +|**Tipo sorgente**|(((
64 +Selezionare il tipo di sorgente da cui prendere il testo del messaggio tra i seguenti:
55 55  
56 -Utilizzare i tasti **Nuovo**, **Modifica** e **Cancella** per selezionare e impostare il tipo di messaggio da riprodurre tra i seguenti:
66 +* Stringa di test costante
67 +* Transfer Property
68 +* Call Data
69 +* Comando per SMG
70 +)))
57 57  
58 -* File
59 -* Numero
60 -* Importo
61 -* Sequenza di caratteri
62 -* Lista formattata
63 -* Data/Ora
64 -* Data/Ora attuale
65 -* Data/Ora del file
66 -* Ordinale
72 +//Scheda Testo//
67 67  
68 -//Scheda Motore//
74 +Se è stata selezionata la sorgente //testo//, viene visualizzata la seguente scheda //Testo//:
69 69  
70 -[[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"]]
76 +[[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"]]
71 71  
72 72  Impostare i campi seguenti:
73 73  
74 74  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
75 -(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
76 -|**Motore di riconoscimento vocale da utilizzare**|Selezionare il motore di riconoscimento da utilizzare. Al momento l’unico motore disponibile e configurabile è //Google Speech API//.
77 -|**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//.
78 -|**Termina riconoscimento su ricezione digits**|Selezionare se il riconoscimento può essere terminato dalla pressione di un digit da parte del chiamante.
79 -|**Tempo massimo di attesa**|Indicare il tempo massimo consentito, espresso in secondi, al chiamante per effettuare la sua scelta vocale. Valore predefinito: 30 secondi.
80 -|**Soglia di affidabilità**|Indicare il livello di affidabilità, tra 0 e 100, da raggiungere per considerare il riconoscimento valido. Valore predefinito: 70.
81 +(% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
82 +|**Testo da sintetizzare**|Inserire il testo libero del messaggio da inviare sulla chat.
81 81  
82 -//Scheda Messaggi errore//
84 +//Scheda Transfer Property//
83 83  
84 -[[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"]]
86 +Se è stata selezionata la sorgente //Transfer Property//, viene visualizzata la seguente scheda //Transfer Property//:
85 85  
88 +[[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"]]
89 +
86 86  Impostare i campi seguenti:
87 87  
88 88  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
89 -(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
90 -|**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.
91 -|**Messaggio di errore con invito a ripetere**|Indicare il messaggio da riprodurre in caso di mancato riconoscimento.
93 +(% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
94 +|**Transfer Property**|Indicare la Transfer Property, il cui contenuto deve essere inviato come testo del messaggio di chat.
92 92  
93 -//Scheda Salvataggio scelta//
96 +//Scheda Call Data//
94 94  
95 -[[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"]]
98 +Se è stata selezionata la sorgente //Call Data//, viene visualizzata la seguente scheda //Call Data//:
96 96  
100 +[[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"]]
101 +
97 97  Impostare i campi seguenti:
98 98  
99 99  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
100 -(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
101 -|**Nome Transfer Property**|Selezionare la Transfer Property in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
102 -|**CallData**|Indicare il CallData in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
105 +(% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
106 +|**Call Data**|Indicare il Call Data, il cui contenuto deve essere inviato come testo del messaggio di chat.
103 103  
104 -==== Port di Uscita ====
108 +//Scheda Comando per SMG//
105 105  
106 -[[image:output_port.jpg||style="margin-bottom:20px; margin-top:20px"]]
110 +Se è stata selezionata la sorgente //Comando per SMG//, viene visualizzata la seguente scheda //Comando//:
107 107  
108 -Le funzionalità dei //Port di Uscita// del blocchetto sono le seguenti :
112 +[[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"]]
109 109  
114 +Impostare i campi seguenti:
115 +
110 110  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
111 -(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
112 -|**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.
113 -|**Digit Detected**|Indicare il servizio successivo da attivare nel caso in cui il riconoscimento sia interrotto dalla pressione di un digit.
114 -|**Success**|Indicare il servizio successivo da attivare nel caso il riconoscimento abbia successo.
117 +(% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
118 +|**Comando**|(((
119 +Selezionare dalla lista il comando da inviare al SocialMediaGateway tra i seguenti:
115 115  
116 -=== **Transfer Property** ===
121 +* **Comando 'HANDLED'**
122 +Invia il comando //*begin*HANDLED%%%%%%§end§// che segnala che la conversazione è conclusa e che quindi non deve essere più inviata all'operatore.
123 +**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).
124 +
125 +* **Comando 'SETCALLDATA'**
126 +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§//.
127 +)))
117 117  
118 -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:
129 +//Scheda Keyboard//
119 119  
131 +Da utilizzare solamente per chat Telegram. Nella scheda //Keyboard// è possibile personalizzare una tastiera, selezionare un tastierino numerico o una scelta singola (Sì/No).
132 +
133 +[[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"]]
134 +
135 +Impostare i campi seguenti:
136 +
120 120  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
121 -(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
122 -|**~_~_RecognizeResult~_~_**|Contiene l’esito della richiesta di riconoscimento.
123 -|**_ASR_Source**|(((
124 -Contiene la sorgente dell’informazione contenuta nella Transfer Property e nel Call Data definiti in configurazione. I valori possibili sono:
138 +(% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
139 +|**Predefiniti**|(((
140 +Selezionare dalla lista uno dei seguenti valori:
125 125  
126 -* **“”** (stringa vuota): nel caso in cui non sia riconosciuto l'audio e non sia rilevato alcun digit.
127 -* **“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.
128 -* **“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.
142 +* **Personalizzata**
143 +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.
144 +\\[[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"]]
145 +
146 +
147 +* **Numerica**
148 +Consente di impostare un tastierino numerico predefinito.
149 +\\[[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"]]
150 +\\
151 +* **Sì/No**
152 +Consente di impostare una tastiera con i soli valori //Sì// e //No//.
153 +\\[[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"]]
154 +
129 129  )))
130 130  
157 +==== Port di Uscita ====
158 +
159 +[[image:wtm_po.png]]
160 +
161 +La funzionalità del //Port di Uscita// del blocchetto prevede solamente il seguente parametro:
162 +
163 +(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
164 +(% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
165 +|**Out**|Port di uscita predefinito.
166 +
131 131  
ReadTextMessage.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +15.0 KB
Content
rtm_po.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +5.7 KB
Content
wtm_cd.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +11.9 KB
Content
wtm_key.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +13.9 KB
Content
wtm_keynum.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +4.7 KB
Content
wtm_keypers.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +4.2 KB
Content
wtm_keysn.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +3.7 KB
Content
wtm_po.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +2.1 KB
Content
wtm_smg.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +12.9 KB
Content
wtm_sorgente.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +16.8 KB
Content
wtm_testo.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +12.0 KB
Content
wtm_tp.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +13.6 KB
Content