Differenze tra le versioni di "Kalliope CTI Mobile"

Da Kalliope Wiki.
Jump to navigation Jump to search
 
(62 versioni intermedie di 8 utenti non mostrate)
Riga 1: Riga 1:
<languages />
<languages />
<translate>
<translate>
<!--T:107-->
<div class="noutonum" style="float: right">__TOC__</div>
<div class="noutonum" style="float: right">__TOC__</div>
==Introduzione== <!--T:1-->
==Introduzione== <!--T:1-->
<!--[[File:kcti_appstore.png|180x324px|right|thumb||KalliopeCTI su App Store]]-->
<!--[[File:kcti_appstore.png|180x324px|right|thumb||KalliopeCTI su App Store]]-->
Riga 8: Riga 10:
KalliopeCTI mobile app è un prodotto opzionale che permette di accedere ai servizi telefonici e di UC anche fuori dall'ufficio, semplicemente tramite il tuo numero di interno e utilizzando le linee aziendali.  
KalliopeCTI mobile app è un prodotto opzionale che permette di accedere ai servizi telefonici e di UC anche fuori dall'ufficio, semplicemente tramite il tuo numero di interno e utilizzando le linee aziendali.  


<!--T:82-->
Per garantire la stabilità e la migliore qualità della conversazione, KalliopeCTI mobile ti offre l’opportunità di scegliere come gestire le tue chiamate: in base alla disponibilità del traffico dati potrai decidere se utilizzare per la conversazione la rete GSM o usare l’app in modalità softphone.
Per garantire la stabilità e la migliore qualità della conversazione, KalliopeCTI mobile ti offre l’opportunità di scegliere come gestire le tue chiamate: in base alla disponibilità del traffico dati potrai decidere se utilizzare per la conversazione la rete GSM o usare l’app in modalità softphone.


KalliopeCTI mobile permette quindi di telefonare in tre modalità diverse::
<!--T:83-->
KalliopeCTI mobile permette quindi di telefonare in tre modalità diverse:
* '''''Click-to-call:''''' la chiamata viene gestita attraverso il telefono fisso associato all’interno
* '''''Click-to-call:''''' la chiamata viene gestita attraverso il telefono fisso associato all’interno
* '''''Call-back:''''' l’utente chiama da smartphone utilizzando le linee Kalliope
* '''''Call-back:''''' l’utente chiama da smartphone utilizzando le linee Kalliope
* '''''Softphone:''''' grazie all’integrazione di un motore telefonico SIP, lo smartphone si registrerà direttamente su KalliopePBX come un qualsiasi client IP.(<u>attualmente questa modalità è disponibile solo su iOS</u>)
* '''''Softphone:''''' grazie all’integrazione di un motore telefonico SIP, lo smartphone si registrerà direttamente su KalliopePBX come un qualsiasi client IP.


<!--T:2-->
<!--T:2-->
E’ possibile scaricare KalliopeCTI mobile direttamente da [https://play.google.com/store/apps/details?id=it.netresults.kalliopeservice PlayStore] e [https://itunes.apple.com/it/app/kalliope-cti/id1108203678?mt=8 App Store].
È possibile scaricare KalliopeCTI mobile direttamente da [https://play.google.com/store/apps/details?id=it.netresults.kalliopeservice PlayStore] e [https://itunes.apple.com/it/app/kalliope-cti/id1108203678?mt=8 App Store].


[[File:Playstore.png|180x408px]] [[File:Kcti appstore.png|180px]]
<!--T:108-->
Visualizza l'informativa sul [https://www.kalliopepbx.com/images/NetResults_GDPR_-_Informativa_APP.21.03.pdf Trattamento dei dati personali degli utenti ]


<!--T:3-->
<!--T:103-->
== Specifiche iOS: ==
'''Nota:''' Ad ogni interno è possibile associare <u>un solo</u> account KCTI Mobile.
* Richiede iOS 10.3 o versioni successive. Compatibile con iPhone, iPad e iPod touch.
* Lingue: Italiano, Inglese
* Prodotto disponibile solo se associato a un centralino VoIP KalliopePBX® V4
* Versione minima firmware KalliopePBX: 4.5.13
* Versione firmware KalliopePBX suggerita: 4.5.17+
* Integrazione delle librerie native CallKit di iOS per garantire sempre la raggiungibilità del softphone anche quando il terminale è in stand-by
* È richiesta una licenza KalliopeCTI Pro per l’utilizzo della sola modalità GSM™. Per l’utilizzo di entrambe le modalità, GSM™ e Softphone, è richiesta invece una licenza KalliopeCTI Phone.


===== NOTA =====
<!--T:84-->
'''La modalità softphone, disponibile attualmente solo per iOS, è in <u>versione beta</u> e attualmente presenta le seguenti limitazioni che non saranno presenti nella versione definitiva, in via di ultimazione:'''
[[File:Playstore.png|180x408px]] [[File:Kcti appstore.png|180px]]
* Non è possibile gestire più di una chiamata SIP alla volta.
* Il supporto al bluetooth deve essere perfezionato.
* Il SIP/TLS non è stato ancora abilitato
* La risoluzione del numero chiamante con i contatti presenti in rubrica non è ancora attiva
* La ripresa di una chiamata in pausa qualche volta può fallire
 
== Specifiche Android: ==
* Richiede Android 4.1 o superiore
* Lingue: Italiano, Inglese
* Prodotto disponibile solo se associato a un centralino VoIP KalliopePBX® V4
* Versione minima firmware KalliopePBX: 4.5.7
* Versione firmware KalliopePBX suggerita: 4.5.17+
* È richiesta una licenza KalliopeCTI Pro per l’utilizzo della sola modalità GSM™. <u>La modalità Softphone non è ancora disponibile su Android.</u>
 
<div style="clear:both"></div>
 
==Organizzazione della GUI== <!--T:5-->
Al primo avvio dell’applicazione KalliopeCTI è necessario andare a impostare i parametri di configurazione per consentire all'app di collegarsi a KalliopePBX.
 
 
<!--T:6-->
Cliccando sul simbolo [[File:Ios menu button.png|40px]] in alto a sinistra è possibile accedere al menu di sistema contenente le seguenti voci:
 
*'''Impostazioni''': pannello di configurazione dell’applicazione
*'''Voicemail''': accesso diretto ai messaggi presenti in voicemail
*'''Info''': fornisce informazioni sulla versione installata
*'''Invia report''': consente di inviare un report agli sviluppatori in caso di comportamenti anomali dell’app
*'''Tutorial''': avvia nuovamente il tutorial dell’app (<u>solo Android</u>)
*'''Esci''': chiude l’applicazione (<u>solo iOS</u>)
 
<!--T:7-->
La schermata principale dell'applicazione è mostrata di seguito (a sinistra Android e a destra iOS) ed è composta da una barra superiore e su iOS anche da una barra inferiore.
 
[[File:4rubrica.png|300px]]
[[File:Ios gui.png|330px]]
 
La barra di livello superiore indica il nome del tab che si sta visualizzando attualmente (in questo caso Rubrica), permette di fare ricerche all’interno di ogni tab e mostra lo stato di connessione dell’app tramite il simbolo della K in alto a destra. Qui di seguito è mostrata la barra di livello superiore (header) per Android (a sinistra) e per iOS (a destra).
 
[[File:Android header.png|300px|Header Android]] [[File:Ios header.png|290px|Header iOS]]
 
Lo stato di connessione è indicato dal colore del simbolo K che si trova in alto a destra:
* '''grigio''' = non connesso
* '''verde''' = connesso in modalità ''call-back''
* '''giallo (con la scritta phone)''' = connesso in modalità ''softphone'' (solo iOS)
 
Nella versione android l'header include anche la barra di navigazione tra le sezioni principali dell'app mentre nella versione iOS la barra di navigazione è posta in basso.
 
[[File:Ios footer.png|290px|Barra di navigazione iOS]]
 
In entrambi i casi la barra di navigazione consente di esplorare i tab principali dell’app:
*Tastierino: il tastierino numerico per la composizione dei numeri
*Rubrica: interni, rubrica KalliopePBX, contatti preferiti, e, se abilitato, contatti personali del device in uso
*Storico chiamate: lista delle chiamata effettuate, ricevute e perse raggruppate per contatto
*Chat: conversazioni avviate con gli altri utenti KalliopeCTI, sia mobile che desktop.
 
==Pannello Impostazioni== <!--T:13-->
Come prima cosa è necessario configurare alcuni semplici parametri dal pannello ''Impostazioni'' raggiungibile tramite il menu di sistema:
*'''Server''': indirizzo IP della centrale KalliopePBX
*'''Porta''': 5039
*'''Nome utente''' dell’utente GUI/CTI
*'''Password''' dell’utente GUI/CTI
*'''Suoneria''': utile per differenziare le chiamate in arrivo al numero cellulare da quelle in arrivo all’interno (<u>''solo Android''</u>)
*'''Sincronizza contatti Kalliope''': se attivo, l’applicazione sincronizza i contatti KalliopePBX con quelli del device in uso (<u>''solo Android''</u>)
*'''Scegli rubriche/Visualizza contatti del dispositivo''': permette di scegliere le rubriche dalle quali visualizzare i contatti.
*'''Softphone (Off/WiFi/On)''': permette di impostare la modalità dell'applicazione (<u>''solo iOS''</u>)
** '''''Off''''': l'app funziona forzatamente in modalità call-back. In questo caso è sufficiente la licenza KalliopeCTI Pro.
** '''''WiFi''''': l'app passerà automaticamente in modalità softphone qualora la connessione venga stabilita con una rete WiFi. Il passaggio allòa modalità softphone sarà possibile solo se all'utente di KalliopePBX è associata una licenza KalliopeCTI Phone.
** '''''On''''': l'app funziona forzatamente in modalità Softphone. In questo caso è sufficiente la licenza KalliopeCTI Phone.
 
[[File:Android settings.png|330px|Pannello settings Android]]
[[File:Ios_setting.png|330px|Pannello settings iOS]]
 
==Contatti== <!--T:14-->
[[File:4rubrica.png|250x428px|destra|miniatura||Contatti]]
La schermata ''Contatti'', seconda icona a partire da sinistra, mostra '''tutti i contatti KalliopePBX''', sia gli interni che le rubriche, posizionando in alto i contatti '''preferiti'''.
 
<!--T:15-->
Gli interni sono riconoscibili dalla presenza del campo '''BLF''' (cerchio colorato) e della '''chat presence''' (icona e stato).
 
<!--T:16-->
In corrispondenza di ogni contatto c’è un simbolo che indica la provenienza del contatto stesso (interno, rubrica Kalliope, rubrica device, Outlook, ''etc.'').
 
<!--T:17-->
Cliccando sui vari contatti compare un sottomenu con i seguenti elementi:
*'''Informazioni''' contatto
*Chiama in modalità '''[[#Click-to-call]]'''
*Chiama in modalità '''[[#Callback]]'''
*Chiama '''[[#Utilizzando direttamente la SIM del device]]'''
*Avvia '''[[#Instant Messaging]]'''
 
<!--T:18-->
Per maggiori informazioni circa le diverse modalità di chiamata si faccia riferimento alla sezione [[#Gestione chiamate|<i>Gestione chiamate</i>]] del presente manuale.
 
<!--T:19-->
Premendo sul titolo della schermata (default ''Contatti'') è possibile filtrare la rubrica come segue:
*'''Contatti''': mostra tutti i contatti
*'''Interni''': mostra soltanto gli interni di Kalliope
*'''Rubrica''': mostra soltanto i contatti della rubrica Kalliope e del dispositivo
 
===Dettagli=== <!--T:20-->
La '''schermata di dettaglio''' dei contatti mostra diverse informazioni relative al contatto selezionato, tra cui:
*nome
*cognome
*azienda
*numeri di telefono
*indirizzi e-mail
 
<!--T:21-->
Solo per gli interni vengono visualizzati anche la presence e lo stato BLF.
 
<!--T:22-->
Lo stato BLF ammette le seguenti possibilità:
*Verde: disponibile
*Giallo: ringing
*Rosso: occupato
*Grigio: non registrato
 
<!--T:23-->
Da questa schermata è possibile, inoltre, contrassegnare un contatto come '''preferito''' cliccando sul simbolo [[File:kcti_favourite_button.jpg|16px]] in alto a destra.
I contatti preferiti vengono visualizzati in alto nella lista ''Contatti''.
 
==Storico chiamate== <!--T:24-->
[[File:7recenti.png|250x415px|destra|miniatura||Storico chiamate]]
Questa sezione dell’app KalliopeCTI è dedicata al registro delle chiamate relative all’utente loggato.
 
<!--T:25-->
Le chiamate sono suddivise in:
*Chiamate uscenti
*Chiamate entranti
*Chiamate perse
 
<!--T:26-->
Le voci del registro sono raggruppate in base al contatto / numero chiamato o chiamante, il numero totale delle chiamate è mostrato tra parentesi.
 
<!--T:27-->
Cliccando sulla singola riga, si accede al dettaglio di tutte le chiamate riferite al contatto specifico, come mostrato in figura.
 
<!--T:28-->
Una notifica segnala, inoltre, la presenza di eventuali messaggi in [[#Casella vocale|voicemail]]; cliccando sulla notifica si accede direttamente alla propria casella di posta per l’ascolto e la gestione dei messaggi.
 
 
<!--T:29-->
Il dettaglio delle chiamate per contatto comprende tutte le chiamate, in ordine cronologico, da e verso quel contatto.
 
<!--T:30-->
Per ogni chiamata sono disponibili le seguenti informazioni:
*Tipo (entrante, uscente, persa)
*Data
*Ora
*Durata
 
<!--T:31-->
E’ possibile, inoltre, richiamare il contatto nelle modalità disponibili a seconda del tipo di contatto (interno o numero esterno).
 
==Casella vocale== <!--T:32-->
La casella vocale è accessibile dal menu di sistema e offre un accesso facile e immediato a tutti i messaggi ricevuti e conservati sul PBX o su uno storage remoto montato su Kalliope.
[[File:Voicemail.png|250x426px|destra|miniatura||Voicemail]]
Per ogni messaggio in voicemail viene indicato mittente, data, ora e durata.
 
<!--T:33-->
I messaggi non vengono salvati automaticamente sul device ma devono essere '''scaricati''' cliccando sull’apposito tasto in corrispondenza di ogni singolo messaggio.
 
<!--T:34-->
Una volta scaricato, sarà possibile riprodurre il messaggio direttamente sul device.
 
<!--T:35-->
L’app consente, inoltre, di gestire lo '''stato''' (letto, non letto, urgente) e la '''cancellazione''' dei messaggi. I messaggi possono essere cancellati dallo storage locale, dal quello remoto o da entrambi direttamente da app cliccando sul simbolo [[File:cestino1.png | 16x19px]].
 
<!--T:36-->
Per accedere al menu di gestione dei messaggi è sufficiente tenere premuto per pochi secondi su un messaggio e compariranno le opzioni di gestione come in figura.
[[File:Gestione messaggi voicemail.png|centro|Gestione messaggi voicemail]]
'''''NOTA''''': i messaggi inoltrati via mail e successivamente cancellati in automatico non vengono visualizzati in questa schermata.
<div style="clear:both"></div>
 
==Instant Messaging== <!--T:37-->
[[File:Chat.png|250x426px|destra|miniatura||Chat]]
KalliopeCTI offre un comodo servizio di chat e gestione della presence che permette di comunicare rapidamente con gli altri utenti Kalliope.
Per avviare una nuova conversazione è sufficiente cliccare sul contatto desiderato e sul simbolo della chat.
 
<!--T:38-->
All'interno della conversazione, KalliopeCTI notifica anche lo '''stato di invio''' dei messaggi inviati utilizzando le seguenti icone:
* [[File:Not sent.png | 15x15px]] - Non inviato
* [[File:Offline1.png| 15x15px]] - Inviato
* [[File:Delivered.png | 15x15px]] - Ricevuto
 
<!--T:39-->
'''''NOTA''''': i messaggi di chat che non è possibile inviare (poiché il CTI è offline) vengono schedulati e inviati al login successivo.
 
 
<!--T:40-->
Lo '''stato di presence''' può essere modificato su Android da qualsiasi tab cliccando sul simbolo della ruota dentata e successivamente sull’icona del servizio di presence (la prima dall’alto). Nella versione iOS lo stato di presence viene settato direttamente nel tab Chat.
 
<!--T:41-->
Oltre allo stato, l’utente può anche inserire un messaggio personalizzato che verrà visualizzato insieme alla presence.
 
<!--T:42-->
Gli stati disponibili sono:
* [[File:Disponibile.png | 15x15px]] - Disponibile
* [[File:Fuori.png | 15x15px]] - Fuori
* [[File:Occupato.png | 15x15px]] - Occupato
* [[File:Non-disponibile.png | 15x15px]] - Non disponibile
* [[File:Offline.png | 15x15px]] - Offline
 
==Gestione chiamate== <!--T:44-->
===Chiamate in ingresso in modalità Call-back (Android e iOS)===
[[File:9chiamataingresso.png|180px|destra|miniatura||Notifica chiamata in ingresso Call-back]]
In caso di chiamate in arrivo all’interno KalliopePBX inverà all’app mobile invia una notifica che mostrerà all'utente la schermata riportata in figura.
 
Tali notifiche arrivano anche ad app spenta dal momento che viene utilizzato il motore ufficiale di notifica dei corrispondenti sistemi operativi.
 
<!--T:45-->
Questa schermata permette di effettuare tre azioni:
*'''Slide verso il basso''': la chiamata viene ignorata, la notifica sul mobile viene silenziata e l’interno dell'utente continua a squillare
*'''Trasferisci su cellulare''': l’interno dell'utente smette di squillare e contestualmente Kalliope instaura una chiamata verso il numero di cellulare associato all'interno dall'amministratore di sistema nel pannello di configurazione degli [[AdminGuide:GUI:OperatingMenu:Extensions|interni]]. La chiamata arriverà quindi sulla SIM del mobile mostrando come mittente il numero geografico della linea associata a KalliopePBX. Rispondendo a tale chiamata si è messi direttamente in comunicazione con il chiamante. Questo inoltro di chiamata è del tutto trasparente al chiamante che per tutto il periodo di instaurazione della chiamata sentirà comunque il tono di squillo.
*'''Rifiuta''': la chiamata viene abbattuta dal centralino e, di conseguenza, anche l’interno smette di squillare.
 
===Chiamate in ingresso in modalità Softphone (solo iOS)===
[[File:Ios incomingCall.png|180px|destra|miniatura||Notifica chiamata in ingresso CallKit]]
In caso di chiamate in arrivo all’interno KalliopePBX invierà una notifica push CallKit che innescherà sul mobile la schermata standard di chiamata in arrivo come quella riportata in figura.
Tali notifiche arrivano anche ad app spenta garantendo la raggiungibilità dell'utente anche quando lo smartphone è in standby.
 
Questa schermata permette di effettuare tre azioni:
*'''Rifiuta''': la chiamata viene abbattuta dal centralino e, di conseguenza, anche l’interno smette di squillare.
*'''Accetta''': viene svegliata l'app KalliopeCTI in modalità softphone, viene mostrata la schermata "''Chiamata in corso''" e viene instaurata la chiamata SIP direttamente con l'app. Lo smartphone diventa a tutti gli effetti un interno del KalliopePBX.
 
[[File:App established call.png|200px|sinistra|Chiamata in corso in modalità softphone]]
La schermata "''Chiamata in corso''" riporta in altro il nome e numero del chiamante, e nella parte inferiore i tasti per le funzionalità disponibili sulla chiamata corrente:
* '''Pausa''': la chiamata viene messa in attesa. Il pulsante può essere utilizzato anche per riprendere dalla pausa la chiamata.
* '''Trasferimento chiamata''': effettua il trasferimento cieco della chiamata verso un altro numero (interno o esterno)
* '''Bluetooth''': attiva/disattiva l'auricolare bluetooth
* '''Vivavoce''': attiva/disattiva il vivavoce dello smartphone
* '''Tastierino''': attiva la schermata del tastierino numerico (ad esempio per navigare un [[AdminGuide:GUI:OperatingMenu:IVR|menu IVR]])
* '''Muto''': attiva/disattiva microfono dello smartphone
 
 
 
 
 
 
 
 
 
 
 
 
 
 
===Chiamate in uscita  in modalità Call-back (Android e iOS)=== <!--T:46-->
Per quanto riguarda le chiamate in uscita in modalità call-back, KalliopeCTI mobile app offre tre diverse modalità di setup di chiamata.
[[File:Chiamatauscita.png|centro]]
=====Click-to-call=====
La prima icona da sinistra permette di effettuare una chiamata in modalità click-to-call: il dispositivo fisso associato all’interno riceve una telefonata dal PBX il cui chiamante è c2c: numero chiamato. Rispondendo a tale chiamata viene instaurata una nuova telefonata verso il numero desiderato.
 
=====Callback===== <!--T:47-->
Il servizio di chiamata Callback permette di chiamare dal proprio dispositivo mobile utilizzando le linee del PBX. Premendo il tasto centrale della Figura 16, il PBX effettua una chiamata al numero cellulare associato all’interno, rispondendo e premendo il tasto 1 (come richiesto dalla voce guida) si è effettivamente messi in comunicazione con il numero desiderato.
 
=====Utilizzando direttamente la SIM del device===== <!--T:48-->
In questa modalità, la chiamata viene effettuata direttamente dalla SIM del dispositivo sul quale è installata l’app KalliopeCTI.
 
===Chiamate in uscita  in modalità Softphone (solo iOS)=== <!--T:46-->
Le chiamate in uscita in modalità softphone KalliopeCTI mobile app partono direttamente dall'app tramite protocollo SIP.
 
Restano disponibili le modalità di setup di chiamata [[#Click-to-call]] e [[#Utilizzando direttamente la SIM del device]] ma la modalità [[#Callback]] è sostituita dalla chiamata diretta tramite SIP.
 
Digitando il numero da chiamare direttamente dal tastierino numerico verrà instaurata una chiamata tramite SIP. Una volta innescata la chiamata comparirà automaticamente la schermata "''Chiamata in corso''" per la gestione dei servizi in chiamata.
 
==Tastierino numerico== <!--T:49-->
Oltre alla ricerca in rubrica, è possibile '''digitare il numero da chiamare''' con Kalliope direttamente nel tastierino all'interno dell'app KalliopeCTI. Durante la digitazione verranno mostrati dei suggerimenti disponibili per l''''autocompletamento¹''' del numero di telefono.<br/>
''In modalità call-back:''Premendo sul pulsante di chiamata sarà possibile scegliere quale modalità utilizzare tra quelle sopra elencate.
''In modalità softphone:''Premendo sul pulsante di chiamata verrà direttamente instaurata una chiamata SIP.
 
<!--T:50-->
'''''NOTA''''': Il tastierino di KalliopeCTI non inserisce il prefisso di uscita automaticamente. Sarà quindi necessario digitare il numero da chiamare come su un normale telefono fisso.<br/>
¹ <font style="font-size:12px">''funzionalità disponibile solo su Android.''</font>
 
==Servizi== <!--T:51-->
[[File:Servizicti.png|250x176px|destra|miniatura||Servizi]]
I servizi relativi all’app mobile KalliopeCTI sono accessibili su Android cliccando sul simbolo della ruota dentata nell’angolo in basso a destra. Nella versione iOS i servizi sono accessibili invece tramite il Menu di Sistema.
 
<!--T:52-->
Attualmente sono presenti tre servizi: presence (già visto in precedenza), inoltro incondizionato e fork to mobile.
 
===Inoltro Incondizionato=== <!--T:53-->
L’inoltro incondizionato permette di configurare un numero di interno verso il quale inoltrare automaticamente tutte le chiamate in arrivo (tale funzione vale solo per le chiamate dirette all’interno e non per quelle provenienti da gruppi o code).
 
<!--T:54-->
Questa funzione è utile quando non si è disponibili ma si vuole comunque ridirigere le chiamate in ingresso in modo che siano gestite.
 
<!--T:55-->
Per attivare il servizio di inoltro incondizionato è sufficiente cliccare sul simbolo della freccia, inserire il numero di interno verso il quale ridirigere le chiamate e salvare.
 
<!--T:56-->
Quando il servizio è attivo l’icona cambia colore e compare una notifica contenente il numero verso il quale è attivo l’inoltro.
 
<!--T:57-->
Per disattivare il servizio basta cliccare nuovamente sul simbolo della freccia.


===Fork to mobile=== <!--T:58-->
== Configurazione preliminare: == <!--T:104-->
Il Fork to mobile consiste nella distribuzione della chiamata diretta a un interno anche al numero mobile associato.
Per poter utilizzare l'app mobile KalliopeCTI è necessario predisporre le seguenti configurazioni:
* Nelle impostazioni "[[AdminGuide:BasicConcepts:Extensions_and_SIP_accounts|Account]]" abilitare la voce "KCTI Mobile App".
** '''NOTA''': deve essere abilitato all'uso dell'app mobile '''un solo account per interno'''.
* Assegnare una licenza KalliopeCTI all'utente secondo questa logica:
** Licenza KalliopeCTI Pro -> abilita l'uso dell'app mobile KalliopeCTI solo in modalità callback (GSM™)
** Licenza KalliopeCTI Phone -> abilita l'uso dell'app mobile KalliopeCTI sia in modalità softphone che callback
* Nello scenario in cui si voglia accedere con l'app mobile dall'esterno della rete aziendale è necessario pubblicare le seguenti porte del KalliopePBX ('''NOTA BENE''': Si raccomanda di '''non esporre il servizio SIP della centrale sul pubblico in modo diretto''', raggiungibile da IP arbitrari, ma di utilizzare un Session Border Controller in grado di proteggere adeguatamente la centrale dai tentativi di intrusione provenienti dall'esterno):
** Porta '''TCP 5039''' per i servizi CTI
** Porta '''TCP 5222''' per i servizi chat XMPP
** Porta '''UDP per il servizio SIP''' come configurata nel pannello "Impostazioni SIP" (solo nel caso di modalità softphone, valore di default '5060')
** Intervallo '''porte UDP 10000-20000''' per i flussi RTP (solo nel caso di modalità softphone)


<!--T:59-->
<!--T:109-->
Rispondendo dal dispositivo mobile l’interno smetterà di squillare e viceversa.
Inoltre '''è indispensabile che il KalliopePBX possa inviare i messaggi i server di push notification di Apple e Google''' e quindi dovrà essere garantita la raggiungibilità da parte del KalliopePBX dei seguenti indirizzi:
* iOS: '''api.push.apple.com''' (HTTPS, porta TCP/443)
* Android: '''fcm.googleapis.com''' (HTTPS, porta TCP/443)


<!--T:60-->
<!--T:110-->
Per attivare il servizio è sufficiente cliccare sulla relativa icona. Anche in questo caso, il colore dell’icona denota lo stato di attivazione del servizio.
Vito che questi host possono risolvere nel tempo IP diversi, è raccomandato che non siano applicati filtri al traffico HTTPS uscente da KalliopePBX.


==Privacy Policy== <!--T:61-->
<!--T:111-->
Inoltre, affinché i dispositivi mobili su cui è in esecuzione l'APP KalliopeCTI Mobile possano ricevere le notifiche, è necessario che questi siano connessi e raggiungibili dai servizi di invio. Per ulteriori informazioni sui flussi che devono essere garantiti, fare riferimento alla documentazione ufficiale di:
* Google: https://firebase.google.com/docs/cloud-messaging/concept-options#messaging-ports-and-your-firewall
* Apple: https://support.apple.com/en-ph/HT203609


===Connessione sicura=== <!--T:62-->
<!--T:112-->
Per poter offrire i propri servizi (es. telefonia, notifica in tempo reale, chat) Kalliope CTI deve poter comunicare con Kalliope PBX. Tale comunicazione viene effettuata attraverso una connessione criptata, così da rendere sicuro il trasferimento di dati personali e messaggi.
'''NOTA''': Per evitare comportamenti anomali nell'invio ai client delle notifiche di chiamata in arrivo/terminata è necessario che ciascun utente sia loggato su un solo device, perché ad ogni account SIP (e quindi utente associato) può essere associato un unico token Firebase (utilizzato per identificare il destinatario delle notifiche).  


===Contatti=== <!--T:63-->
<!--T:105-->
È possibile abilitare l'accesso di Kalliope CTI alla rubrica del dispositivo dell'utente. I dati dei contatti salvati dall'utente nel dispositivo saranno utilizzati esclusivamente all'interno dell'applicazione e perciò non verranno mai inviati a Kalliope PBX, né scambiati con altri utenti, salvo le informazioni necessarie per effettuare chiamate attraverso il PBX.
'''NOTA''': Nel caso in cui il servizio SIP della centrale sia esposto su un IP diverso da quello di connessione CTI, o su una porta diversa da quella standard (5060) è necessario impostare sul KalliopePBX uno o entrambi i seguenti placeholder personalizzati all'interno del pannello di Provisioning: '''%%_KPHONE_SIP_REGISTRAR_IP%%''' e '''%%_KPHONE_SIP_REGISTRAR_PORT%%''' . Questa configurazione è normalmente necessaria quando il servizio SIP viene esposto al pubblico tramite un Session Border Controller che utilizza un IP diverso da quello su cui è raggiungibile la centrale, mentre è non necessario se PBX e SBC sono nattati sullo stesso IP pubblico, ciascuno per le porte di sua competenza (TCP/5039 e TCP/5222 per le componenti CTI e Chat, verso Kalliope, e SIP + RTP per la fonia, verso l'SBC).


===Numero di telefono=== <!--T:64-->
<!--T:113-->
Per poter utilizzare le funzioni mobili di Kalliope CTI è necessario impostare il proprio numero di telefono nella pagina di configurazione di Kalliope PBX. Tale numero viene poi verificato da Kalliope CTI e confrontato con l'effettivo numero di telefono associato alla SIM inserita nel dispositivo.
Le informazioni dettagliate specifiche riguardo la configurazione e l'uso dell'app KalliopeCTI Mobile nei due sistemi operativi Android e IOS sono disponibili sulle seguenti pagine dedicate:<br>
* [[Kalliope CTI Mobile Android|Manuale KalliopeCTI Mobile app Android]]
* [[Kalliope CTI Mobile IOS|Manuale KalliopeCTI Mobile app IOS]]


===File=== <!--T:65-->
Kalliope CTI accede allo spazio di memoria del dispositivo per poter inviare dati diagnostici agli sviluppatori di Kalliope PBX via email. Tali dati vengono inviati soltanto attraverso l'azione dell'utente, tramite la voce “Invia report” del menu di Kalliope CTI.
</translate>
</translate>

Versione attuale delle 20:54, 25 set 2022

Altre lingue:

Introduzione

Per chi ha la necessità di essere sempre reperibile, Kalliope ha pensato l’app KalliopeCTI mobile per sistemi Android e iOS.

KalliopeCTI mobile app è un prodotto opzionale che permette di accedere ai servizi telefonici e di UC anche fuori dall'ufficio, semplicemente tramite il tuo numero di interno e utilizzando le linee aziendali.

Per garantire la stabilità e la migliore qualità della conversazione, KalliopeCTI mobile ti offre l’opportunità di scegliere come gestire le tue chiamate: in base alla disponibilità del traffico dati potrai decidere se utilizzare per la conversazione la rete GSM o usare l’app in modalità softphone.

KalliopeCTI mobile permette quindi di telefonare in tre modalità diverse:

  • Click-to-call: la chiamata viene gestita attraverso il telefono fisso associato all’interno
  • Call-back: l’utente chiama da smartphone utilizzando le linee Kalliope
  • Softphone: grazie all’integrazione di un motore telefonico SIP, lo smartphone si registrerà direttamente su KalliopePBX come un qualsiasi client IP.

È possibile scaricare KalliopeCTI mobile direttamente da PlayStore e App Store.

Visualizza l'informativa sul Trattamento dei dati personali degli utenti

Nota: Ad ogni interno è possibile associare un solo account KCTI Mobile.

Playstore.png Kcti appstore.png

Configurazione preliminare:

Per poter utilizzare l'app mobile KalliopeCTI è necessario predisporre le seguenti configurazioni:

  • Nelle impostazioni "Account" abilitare la voce "KCTI Mobile App".
    • NOTA: deve essere abilitato all'uso dell'app mobile un solo account per interno.
  • Assegnare una licenza KalliopeCTI all'utente secondo questa logica:
    • Licenza KalliopeCTI Pro -> abilita l'uso dell'app mobile KalliopeCTI solo in modalità callback (GSM™)
    • Licenza KalliopeCTI Phone -> abilita l'uso dell'app mobile KalliopeCTI sia in modalità softphone che callback
  • Nello scenario in cui si voglia accedere con l'app mobile dall'esterno della rete aziendale è necessario pubblicare le seguenti porte del KalliopePBX (NOTA BENE: Si raccomanda di non esporre il servizio SIP della centrale sul pubblico in modo diretto, raggiungibile da IP arbitrari, ma di utilizzare un Session Border Controller in grado di proteggere adeguatamente la centrale dai tentativi di intrusione provenienti dall'esterno):
    • Porta TCP 5039 per i servizi CTI
    • Porta TCP 5222 per i servizi chat XMPP
    • Porta UDP per il servizio SIP come configurata nel pannello "Impostazioni SIP" (solo nel caso di modalità softphone, valore di default '5060')
    • Intervallo porte UDP 10000-20000 per i flussi RTP (solo nel caso di modalità softphone)

Inoltre è indispensabile che il KalliopePBX possa inviare i messaggi i server di push notification di Apple e Google e quindi dovrà essere garantita la raggiungibilità da parte del KalliopePBX dei seguenti indirizzi:

  • iOS: api.push.apple.com (HTTPS, porta TCP/443)
  • Android: fcm.googleapis.com (HTTPS, porta TCP/443)

Vito che questi host possono risolvere nel tempo IP diversi, è raccomandato che non siano applicati filtri al traffico HTTPS uscente da KalliopePBX.

Inoltre, affinché i dispositivi mobili su cui è in esecuzione l'APP KalliopeCTI Mobile possano ricevere le notifiche, è necessario che questi siano connessi e raggiungibili dai servizi di invio. Per ulteriori informazioni sui flussi che devono essere garantiti, fare riferimento alla documentazione ufficiale di:

NOTA: Per evitare comportamenti anomali nell'invio ai client delle notifiche di chiamata in arrivo/terminata è necessario che ciascun utente sia loggato su un solo device, perché ad ogni account SIP (e quindi utente associato) può essere associato un unico token Firebase (utilizzato per identificare il destinatario delle notifiche).

NOTA: Nel caso in cui il servizio SIP della centrale sia esposto su un IP diverso da quello di connessione CTI, o su una porta diversa da quella standard (5060) è necessario impostare sul KalliopePBX uno o entrambi i seguenti placeholder personalizzati all'interno del pannello di Provisioning: %%_KPHONE_SIP_REGISTRAR_IP%% e %%_KPHONE_SIP_REGISTRAR_PORT%% . Questa configurazione è normalmente necessaria quando il servizio SIP viene esposto al pubblico tramite un Session Border Controller che utilizza un IP diverso da quello su cui è raggiungibile la centrale, mentre è non necessario se PBX e SBC sono nattati sullo stesso IP pubblico, ciascuno per le porte di sua competenza (TCP/5039 e TCP/5222 per le componenti CTI e Chat, verso Kalliope, e SIP + RTP per la fonia, verso l'SBC).

Le informazioni dettagliate specifiche riguardo la configurazione e l'uso dell'app KalliopeCTI Mobile nei due sistemi operativi Android e IOS sono disponibili sulle seguenti pagine dedicate: