Differenze tra le versioni di "Kalliope CTI Mobile"

Da Kalliope Wiki.
Jump to navigation Jump to search
 
(187 versioni intermedie di 10 utenti non mostrate)
Riga 1: Riga 1:
==Introduzione==
<languages />
L’app KalliopeCTI mobile è un prodotto complementare alle soluzioni KalliopePBX che permette agli utenti di accedere a una serie di servizi tra cui: consultazione delle rubriche e dello storico chiamate, avvio di una chiamata in modalità click-to-call o DISA, accesso alla voice-mail, risposta ad una chiamata, chat e altro ancora.
<translate>
<!--T:107-->
<div class="noutonum" style="float: right">__TOC__</div>


E’ possibile scaricare KalliopeCTI mobile direttamente dal Play Store o cliccando sul link di seguito: https://play.google.com/store/apps/details?id=it.netresults.kalliopeservice&hl=it
==Introduzione== <!--T:1-->
<!--[[File:kcti_appstore.png|180x324px|right|thumb||KalliopeCTI su App Store]]-->
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.  


[[File:Playstore.png|250x426px|destra|miniatura||KalliopeCTI su Play Store]]
<!--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.


Requisiti minimi:
<!--T:83-->
*Android 4.1 o superiore
KalliopeCTI mobile permette quindi di telefonare in tre modalità diverse:
*KalliopePBX con firmware 4.1.3 o superiore
* '''''Click-to-call:''''' la chiamata viene gestita attraverso il telefono fisso associato all’interno
*Licenza KalliopeCTI Pro o Phone
* '''''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.


==Primo avvio e configurazione==
<!--T:2-->
Al primo avvio dell’applicazione KalliopeCTI viene visualizzato un tutorial che guida l’utente attraverso le varie sezioni dell’applicazione.
È 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].


L’applicazione è navigabile grazie a una barra a doppio livello posizionata nella parte superiore dello schermo.
<!--T:108-->
[[File:Tutorial.png|250x426px|destra|miniatura||Tutorial]]
Visualizza l'informativa sul [https://www.kalliopepbx.com/images/NetResults_GDPR_-_Informativa_APP.21.03.pdf Trattamento dei dati personali degli utenti ]


[[File:Barrasup.png|300x46px|centro|Livello superiore]]
<!--T:103-->
'''Nota:''' Ad ogni interno è possibile associare <u>un solo</u> account KCTI Mobile.


Il livello superiore consente di accedere al menu di sistema contenente le seguenti voci:
<!--T:84-->
*Impostazioni: pannello di configurazione dell’applicazione
[[File:Playstore.png|180x408px]] [[File:Kcti appstore.png|180px]]
*Invia report: consente di inviare un report agli sviluppatori in caso di comportamenti anomali dell’app
*Casella vocale: accesso diretto ai messaggi presenti in voicemail
*Tutorial: avvia nuovamente il tutorial dell’app
*Info: fornisce informazioni sulla versione installata
*Esci: chiude l’applicazione.


Inoltre, 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.
== Configurazione preliminare: == <!--T:104-->
Cliccando sul simbolo della K è possibile connettersi/disconnettersi, lo stato di connessione è indicato dal colore del simbolo stesso (verde = connesso, grigio = non connesso).
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)  


[[File:Barrainf.png|300x46px|centro|Livello inferiore]]
<!--T:109-->
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)


ll livello inferiore consente la navigazione attraverso i tab principali dell’app:
<!--T:110-->
*Rubrica: contatti KalliopePBX e, se abilitato, contatti personali del device in uso
Vito che questi host possono risolvere nel tempo IP diversi, è raccomandato che non siano applicati filtri al traffico HTTPS uscente da KalliopePBX.
*Interni: lista degli interni KalliopePBX
*Storico chiamate: lista delle chiamata effettuate, ricevute e perse raggruppate per contatto
*Chat: conversazioni avviate con gli altri utenti Kalliope CTI, sia mobile che desktop.


===Impostazioni===
<!--T:111-->
Come prima cosa è necessario configurare alcuni semplici parametri dal menu Impostazioni:
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:
*Server: indirizzo IP della centrale KalliopePBX
* Google: https://firebase.google.com/docs/cloud-messaging/concept-options#messaging-ports-and-your-firewall
*Porta: 5039
* Apple: https://support.apple.com/en-ph/HT203609
*Username 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
*Connetti all’avvio, l’app si connette automaticamente all’avvio
*Connetti solo su Wi-Fi, l’app si connette solo quando si trova sotto copertura Wi-Fi
*Sincronizza contatti: se attivo, l’applicazione sincronizza i contatti KalliopePBX con quelli del device in uso
*Contatti da visualizzare: permette di scegliere le rubriche dalle quali importare i contatti.


==Rubrica e Interni==
<!--T:112-->
La schermata Rubrica, la prima icona a partire da sinistra, mostra tutti i contatti KalliopePBX, sia quelli aziendali che quelli personali.
'''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).  
[[File:Rubrica.png|300x46px|centro|Rubrica]]
Inoltre, selezionando l’apposita checkbox nelle Impostazioni, è possibile visualizzare in questa schermata anche i contatti salvati sul device sul quale è installata l’applicazione.
In corrispondenza di ogni contatto c’è un simbolo che indica la provenienza del contatto stesso (rubrica Kalliope, rubrica device, Outlook).
Cliccando sulle voci in rubrica compare un sottomenu con i seguenti elementi:
*Informazioni contatto
*Chiama in modalità click-to-call
*Chiama in modalità DISA + Callback
*Chiama usando la SIM del device
Per maggiori informazioni circa le diverse modalità di chiamata si faccia riferimento al capitolo 6. Gestione chiamate del presente manuale.


<!--T:105-->
'''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).


La schermata Interni è simile alla precedente con la differenza che gli elementi visualizzati sono gli interni (locali e remoti) registrati sul PBX.
<!--T:113-->
Per ogni interno viene visualizzato nome, cognome, numero e stato BLF.
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>
Lo stato dell’interno ammette quattro possibilità:
* [[Kalliope CTI Mobile Android|Manuale KalliopeCTI Mobile app Android]]
*Verde: disponibile
* [[Kalliope CTI Mobile IOS|Manuale KalliopeCTI Mobile app IOS]]
*Giallo: ringing
 
*Rosso: occupato
</translate>
*Grigio: non registrato
Cliccando sugli interni compare un sottomenu con i seguenti elementi:
*Informazioni interno
*Chiama in modalità click-to-call
*Chiama in modalità DISA + Callback
Dalla schermata informazioni interno è possibile avviare una conversazione con l’interno selezionato cliccando sul simbolo della chat posizionato in alto a destra.

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:

Estratto da "https://www.kalliope.com/wiki/index.php?title=Kalliope_CTI_Mobile&oldid=17894"