Changes for page Registrazione Chiamate

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -13,7 +13,7 @@
13	13	* attraverso il [[Call Designer>>doc:CallDesigner.WebHome]]
14	14	* oppure attraverso il [[Messenger Configurator>>doc:MessengerConfigurator.WebHome]]; questo metodo è noto come [[Compatibility Mode>>doc:ClientPhones.WebHome]].
15	15
16		-La scelta del metodo dipende in particolare dal [[modo in cui viene gestito il call flow>>doc:CallFlow.WebHome]].
	16	+La scelta del metodo dipende in particolare dal [[modo in cui viene gestito il call flow>>doc:ifmhelpplatform.CallFlow.WebHome]].
17	17
18	18	== Configurazione di AudioRecordingManager attraverso il Call Designer ==
19	19
...	...	@@ -21,15 +21,15 @@
21	21
22	22	[[image:hashphones.la-registrazione-delle-chiamate.html_html_m233861ef.png||width="400"]]
23	23
24		-Nell'immagine, evidenziato in rosso, è illustrato il comando posto all'interno della [[tool-box del Call Designer>>doc:CallDesigner.WebHome]] che permette di creare un [[call flow>>doc:CallFlow.WebHome]] contenente il [[blocchetto>>doc:CallDesigner.WebHome]] **AudioRecordingManager**. Per creare un nuovo blocchetto, è sufficiente trascinare la voce **AudioRecordingManager** della [[tool-box del Call Designer>>doc:CallDesigner.WebHome]] nel [[workspace del Call Designer>>doc:CallDesigner.WebHome]] nel modo descritto in [[Creare un servizio base del Messenger>>doc:CallDesigner.WebHome]].
	24	+Nell'immagine, evidenziato in rosso, è illustrato il comando posto all'interno della [[tool-box del Call Designer>>doc:CallDesigner.WebHome]] che permette di creare un [[call flow>>doc:ifmhelpplatform.CallFlow.WebHome]] contenente il [[blocchetto>>doc:CallDesigner.WebHome]] **AudioRecordingManager**. Per creare un nuovo blocchetto, è sufficiente trascinare la voce **AudioRecordingManager** della [[tool-box del Call Designer>>doc:CallDesigner.WebHome]] nel [[workspace del Call Designer>>doc:CallDesigner.WebHome]] nel modo descritto in [[Creare un servizio base del Messenger>>doc:CallDesigner.WebHome]].
25	25
26		-Infine, per comprendere il processo di creazione di un [[call flow>>doc:CallFlow.WebHome]] con il [[Call Designer>>doc:CallDesigner.WebHome]], consultare [[#phones Client: Call Designer tutorial>>doc:CallDesigner.WebHome]].
	26	+Infine, per comprendere il processo di creazione di un [[call flow>>doc:ifmhelpplatform.CallFlow.WebHome]] con il [[Call Designer>>doc:CallDesigner.WebHome]], consultare [[#phones Client: Call Designer tutorial>>doc:CallDesigner.WebHome]].
27	27
28	28	=== Le operazioni consentite dall'AudioRecordingManager ===
29	29
30	30	[[image:hashphones.la-registrazione-delle-chiamate.html_html_485565a5.png||height="159" width="168"]]
31	31
32		-Una volta creato il blocchetto, è necessario modificare le proprietà al fine di impiegarlo nel modo ritenuto coerente col proprio [[call flow>>doc:CallFlow.WebHome]]. Per fare ciò è sufficiente premere col tasto destro del mouse nella parte superiore del blocchetto (raffigurato nell'immagine precedente) e selezionare la voce **Properties**.
	32	+Una volta creato il blocchetto, è necessario modificare le proprietà al fine di impiegarlo nel modo ritenuto coerente col proprio [[call flow>>doc:ifmhelpplatform.CallFlow.WebHome]]. Per fare ciò è sufficiente premere col tasto destro del mouse nella parte superiore del blocchetto (raffigurato nell'immagine precedente) e selezionare la voce **Properties**.
33	33
34	34	[[image:hashphones.la-registrazione-delle-chiamate.html_html_c340174.png||height="510" width="400"]]
35	35
...	...	@@ -50,7 +50,7 @@
50	50
51	51	Nell'immagine, il nome del file deve essere inserito nel campo **File name**.
52	52
53		-**ATTENZIONE!** il primo blocchetto AudioRecordingManager di un [[call flow>>doc:CallFlow.WebHome]], deve essere sempre impostato su [[Start Recording>>||anchor="HStartRecording"]]; se fosse scelta qualunque altra opzione, cioè [[Stop recording>>||anchor="HStoprecording"]], [[Set recording mute state>>||anchor="HSetrecordingmutestate"]] o [[Append cue sheet>>||anchor="HAppendcuesheet"]], **AudioRecordingManager** verrebbe posto in uno stato non valido.
	53	+**ATTENZIONE!** il primo blocchetto AudioRecordingManager di un [[call flow>>doc:ifmhelpplatform.CallFlow.WebHome]], deve essere sempre impostato su [[Start Recording>>||anchor="HStartRecording"]]; se fosse scelta qualunque altra opzione, cioè [[Stop recording>>||anchor="HStoprecording"]], [[Set recording mute state>>||anchor="HSetrecordingmutestate"]] o [[Append cue sheet>>||anchor="HAppendcuesheet"]], **AudioRecordingManager** verrebbe posto in uno stato non valido.
54	54
55	55	==== Stop recording ====
56	56
...	...	@@ -65,7 +65,7 @@
65	65	Questo comando permette di escludere dalla registrazione:
66	66
67	67	* il canale audio del chiamante (remoto)
68		-* il canale audio dell'[[operatore>>doc:AgentiPhones.WebHome]]
	68	+* il canale audio dell'[[operatore>>doc:ifmhelpplatform.AgentiPhones.WebHome]]
69	69	* oppure entrambi.
70	70
71	71	Ciò può essere utile ad esempio per non registrare eventuali fasi in cui viene chiesta la password del chiamante. Oltre ad escludere dalla registrazione i canali audio, il blocchetto permette di specificare un [[cue sheet>>doc:Glossario.WebHome]], con testo configurabile, da appendere al file wave. Così è possibile individuare il punto della registrazione in fase di riascolto.
...	...	@@ -88,9 +88,9 @@
88	88
89	89	== Il call flow ==
90	90
91		-Un blocchetto **AudioRecordingManager** può essere posto in qualunque punto del [[call flow>>doc:CallFlow.WebHome]], tuttavia è opportuno ricordare che il primo blocchetto **AudioRecordingManager**, cioè quello che avvia la registrazione, ovunque esso sia, deve essere **sempre **impostato su [[Start Recording>>||anchor="HStartRecording"]]. In caso contrario verrebbe posto in uno stato non valido, le cui conseguenze sono descritte nel paragrafo [[Invalid state>>||anchor="HInvalidstate"]].
	91	+Un blocchetto **AudioRecordingManager** può essere posto in qualunque punto del [[call flow>>doc:ifmhelpplatform.CallFlow.WebHome]], tuttavia è opportuno ricordare che il primo blocchetto **AudioRecordingManager**, cioè quello che avvia la registrazione, ovunque esso sia, deve essere **sempre **impostato su [[Start Recording>>||anchor="HStartRecording"]]. In caso contrario verrebbe posto in uno stato non valido, le cui conseguenze sono descritte nel paragrafo [[Invalid state>>||anchor="HInvalidstate"]].
92	92
93		-Come tutti gli altri blocchetti del [[Call Designer>>doc:CallDesigner.WebHome]], **AudioRecordingManager** possiede dei **port** che permettono di costruire un [[call flow>>doc:CallFlow.WebHome]]; per maggiori dettagli consultare [[Connessioni tra i blocchetti>>doc:CallDesigner.WebHome]].
	93	+Come tutti gli altri blocchetti del [[Call Designer>>doc:CallDesigner.WebHome]], **AudioRecordingManager** possiede dei **port** che permettono di costruire un [[call flow>>doc:ifmhelpplatform.CallFlow.WebHome]]; per maggiori dettagli consultare [[Connessioni tra i blocchetti>>doc:CallDesigner.WebHome]].
94	94
95	95	Per tutte le 4 opzioni, indicate nel paragrafo [[Le operazioni consentite dall'AudioRecordingManage>>||anchor="HLeoperazioniconsentite"]], si possono configurare i seguenti port di uscita:
96	96
...	...	@@ -100,7 +100,7 @@
100	100
101	101	[[image:hashphones.la-registrazione-delle-chiamate.html_html_m2d1f281a.png||width="400"]]
102	102
103		-Nell'immagine precedente è raffigurato un ipotetico [[call flow>>doc:CallFlow.WebHome]], elaborato col [[Call Designer>>doc:CallDesigner.WebHome]] in grado di registrare una chiamata a partire dal suo inizio; su di esso vanno fatte alcune importanti osservazioni.
	103	+Nell'immagine precedente è raffigurato un ipotetico [[call flow>>doc:ifmhelpplatform.CallFlow.WebHome]], elaborato col [[Call Designer>>doc:CallDesigner.WebHome]] in grado di registrare una chiamata a partire dal suo inizio; su di esso vanno fatte alcune importanti osservazioni.
104	104
105	105	* Se la richiesta di avvio della registrazione viene eseguita con successo (port **Success**), il servizio successivo è costituito dal blocchetto **VoiceMenu**.
106	106	* Se la richiesta di avvio della registrazione **non **viene eseguita con successo (port **Failure**), allora il servizio successivo è costituito dal primo blocchetto **PlayMessage**.
...	...	@@ -107,24 +107,24 @@
107	107	* Se per errore **AudioRecordingManager** fosse stato impostato su [[Stop recording>>||anchor="HStoprecording"]], allora verrebbe invocato il port **Invalid state**, e con esso il secondo blocchetto **PlayMessage**.
108	108	* Infine **AudioRecordingManager** è preceduto da un blocchetto **PlayMessage**: è necessario al fine di garantire una corretta gestione del canale IVR]; per maggiori dettagli consultare il paragrafo [[Avvio di una registrazione all'inizio del call flow>>||anchor="HAvviodiunaregistrazioneall27iniziodelcallflow"]].
109	109
110		-Il blocchetto **AudioRecordingManager** può essere inserito in qualunque punto di un [[call flow>>doc:CallFlow.WebHome]], elaborato col [[Call Designer>>doc:CallDesigner.WebHome]]. Ma si ricorda che il suo comportamento dipende dalle impostazioni descritte nella sezione [[Le operazioni consentite dall'AudioRecordingManager>>||anchor="HLeoperazioniconsentitedall27AudioRecordingManager"]].
	110	+Il blocchetto **AudioRecordingManager** può essere inserito in qualunque punto di un [[call flow>>doc:ifmhelpplatform.CallFlow.WebHome]], elaborato col [[Call Designer>>doc:CallDesigner.WebHome]]. Ma si ricorda che il suo comportamento dipende dalle impostazioni descritte nella sezione [[Le operazioni consentite dall'AudioRecordingManager>>||anchor="HLeoperazioniconsentitedall27AudioRecordingManager"]].
111	111
112		-**ATTENZIONE:** quando di intende registrare una telefonata a partire dal suo inizio, **AudioRecordingManager**, [[call flow>>doc:CallFlow.WebHome]], andrebbe collocato per primo; tuttavia ciò potrebbe avere delle conseguenze capaci di bloccare la registrazione, pertanto in queste circostanze devono essere seguite le indicazioni contenute nel paragrafo [[Avvio di una registrazione all'inizio del call flow>>||anchor="HAvviodiunaregistrazioneall27iniziodelcallflow"]].
	112	+**ATTENZIONE:** quando di intende registrare una telefonata a partire dal suo inizio, **AudioRecordingManager**, [[call flow>>doc:ifmhelpplatform.CallFlow.WebHome]], andrebbe collocato per primo; tuttavia ciò potrebbe avere delle conseguenze capaci di bloccare la registrazione, pertanto in queste circostanze devono essere seguite le indicazioni contenute nel paragrafo [[Avvio di una registrazione all'inizio del call flow>>||anchor="HAvviodiunaregistrazioneall27iniziodelcallflow"]].
113	113
114	114	=== Avvio di una registrazione all'inizio del call flow ===
115	115
116		-Se si desiderasse registrare la chiamata a partire dal suo inizio, **AudioRecordingManager** andrebbe posto all'inizio del [[call flow>>doc:CallFlow.WebHome]]. Tuttavia è opportuno sottolineare che tra il momento in cui il canale IVR] viene effettivamente impegnato dalla chiamata e il momento in cui [[LightHouse>>doc:Glossario.WebHome]] riceve la notifica dell'evento e pone il [[canale IVR>>doc:MessengerConfigurator.WebHome]] in [[stato di conversazione>>doc:AgentiPhones.WebHome]], possono trascorrere alcuni attimi di ritardo provocati dall'infrastruttura di rete. In linea di massima ciò non ha alcun effetto reale, ma nel caso di una registrazione con **AudioRecordingManager**, [[LightHouse>>doc:Glossario.WebHome]] potrebbe ricevere una richiesta ([[Start Recording>>||anchor="HStartRecording"]]) per un [[canale IVR>>doc:MessengerConfigurator.WebHome]] formalmente non ancora in conversazione. Per gestire questo caso, [[LightHouse>>doc:Glossario.WebHome]] non può far altro che rispondere con un messaggio che pone il blocchetto **AudioRecordingManager** in uno stato non valido [[Invalid state>>||anchor="HInvalidstate"]]. Quindi per prevenire ed eliminare del tutto la possibilità che ciò avvenga, è buona norma far precedere **AudioRecordingManager** da un altro blocchetto di tipo **PlayMessage** contenente un secondo di silenzio.
	116	+Se si desiderasse registrare la chiamata a partire dal suo inizio, **AudioRecordingManager** andrebbe posto all'inizio del [[call flow>>doc:ifmhelpplatform.CallFlow.WebHome]]. Tuttavia è opportuno sottolineare che tra il momento in cui il canale IVR] viene effettivamente impegnato dalla chiamata e il momento in cui [[LightHouse>>doc:Glossario.WebHome]] riceve la notifica dell'evento e pone il [[canale IVR>>doc:MessengerConfigurator.WebHome]] in [[stato di conversazione>>doc:ifmhelpplatform.AgentiPhones.WebHome]], possono trascorrere alcuni attimi di ritardo provocati dall'infrastruttura di rete. In linea di massima ciò non ha alcun effetto reale, ma nel caso di una registrazione con **AudioRecordingManager**, [[LightHouse>>doc:Glossario.WebHome]] potrebbe ricevere una richiesta ([[Start Recording>>||anchor="HStartRecording"]]) per un [[canale IVR>>doc:MessengerConfigurator.WebHome]] formalmente non ancora in conversazione. Per gestire questo caso, [[LightHouse>>doc:Glossario.WebHome]] non può far altro che rispondere con un messaggio che pone il blocchetto **AudioRecordingManager** in uno stato non valido [[Invalid state>>||anchor="HInvalidstate"]]. Quindi per prevenire ed eliminare del tutto la possibilità che ciò avvenga, è buona norma far precedere **AudioRecordingManager** da un altro blocchetto di tipo **PlayMessage** contenente un secondo di silenzio.
117	117
118	118	=== Invalid state ===
119	119
120		-Un caso tipico di **Invalid state** è quello citato all'inizio del paragrafo [[Il call flow>>||anchor="HIlcallflow"]]. Infatti in un [[call flow>>doc:CallFlow.WebHome]] il primo blocchetto **AudioRecordingManager** **deve **essere sempre impostato su [[Start Recording>>||anchor="HStartRecording"]]; in caso contrario si avrà un **Invalid state**. Ma la condizione **Invalid state** si può realizzare anche in altre circostanze; un esempio su tutti: la chiusura della registrazione può avvenire in due occasioni:
	120	+Un caso tipico di **Invalid state** è quello citato all'inizio del paragrafo [[Il call flow>>||anchor="HIlcallflow"]]. Infatti in un [[call flow>>doc:ifmhelpplatform.CallFlow.WebHome]] il primo blocchetto **AudioRecordingManager** **deve **essere sempre impostato su [[Start Recording>>||anchor="HStartRecording"]]; in caso contrario si avrà un **Invalid state**. Ma la condizione **Invalid state** si può realizzare anche in altre circostanze; un esempio su tutti: la chiusura della registrazione può avvenire in due occasioni:
121	121
122	122	* conclusione della chiamata
123	123	* inserimento di un secondo blocchetto **AudioRecordingManager** impostato su [[Stop recording>>||anchor="HStoprecording"]].
124	124
125		-Il secondo caso tipicamente si realizza all'interno di [[call flow>>doc:CallFlow.WebHome]] complessi, ossia in presenza di servizi di vario genere. Ad esempio se il secondo blocchetto **AudioRecordingManager** fosse stato impostato per errore su [[Start Recording>>||anchor="HStartRecording"]] invece che su [[Stop recording>>||anchor="HStoprecording"]], [[LightHouse>>doc:Glossario.WebHome]] rileverebbe un'incoerenza nel dispositivo, di conseguenza il secondo blocchetto **AudioRecordingManager** verrebbe posto in **Invalid state**.
	125	+Il secondo caso tipicamente si realizza all'interno di [[call flow>>doc:ifmhelpplatform.CallFlow.WebHome]] complessi, ossia in presenza di servizi di vario genere. Ad esempio se il secondo blocchetto **AudioRecordingManager** fosse stato impostato per errore su [[Start Recording>>||anchor="HStartRecording"]] invece che su [[Stop recording>>||anchor="HStoprecording"]], [[LightHouse>>doc:Glossario.WebHome]] rileverebbe un'incoerenza nel dispositivo, di conseguenza il secondo blocchetto **AudioRecordingManager** verrebbe posto in **Invalid state**.
126	126
127		-In altre parole, **Invalid state** è necessario al fine di "intercettare" e governare eventuali errori nella configurazione del [[call flow>>doc:CallFlow.WebHome]], oppure per gestire fallimenti che non rientrano tra quelli previsti da **Failure**. In ultima analisi, il port **Invalid state** è in grado di garantire un'uscita ordinata e controllata del [[call flow>>doc:CallFlow.WebHome]].
	127	+In altre parole, **Invalid state** è necessario al fine di "intercettare" e governare eventuali errori nella configurazione del [[call flow>>doc:ifmhelpplatform.CallFlow.WebHome]], oppure per gestire fallimenti che non rientrano tra quelli previsti da **Failure**. In ultima analisi, il port **Invalid state** è in grado di garantire un'uscita ordinata e controllata del [[call flow>>doc:ifmhelpplatform.CallFlow.WebHome]].
128	128
129	129	== Configurazione di AudioRecordingManager in Compatibility Mode ==
130	130