Differenze tra le versioni di "Kalliope CTI Mobile"

Da Kalliope Wiki.
Jump to navigation Jump to search
 
(172 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-->
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)


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


[[File:Barrainf.png|300x46px|centro|Livello inferiore]]
<!--T:110-->
Vito che questi host possono risolvere nel tempo IP diversi, è raccomandato che non siano applicati filtri al traffico HTTPS uscente da KalliopePBX.


ll livello inferiore consente la navigazione attraverso i tab principali dell’app:
<!--T:111-->
*Rubrica: contatti KalliopePBX e, se abilitato, contatti personali del device in uso
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:
*Interni: lista degli interni KalliopePBX
* Google: https://firebase.google.com/docs/cloud-messaging/concept-options#messaging-ports-and-your-firewall
*Storico chiamate: lista delle chiamata effettuate, ricevute e perse raggruppate per contatto
* Apple: https://support.apple.com/en-ph/HT203609
*Chat: conversazioni avviate con gli altri utenti Kalliope CTI, sia mobile che desktop.


===Impostazioni===
<!--T:112-->
Come prima cosa è necessario configurare alcuni semplici parametri dal menu ''Impostazioni'':
'''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).  
*Server: indirizzo IP della centrale KalliopePBX
*Porta: 5039
*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:105-->
La schermata ''Rubrica'', la prima icona a partire da sinistra, mostra tutti i contatti KalliopePBX, sia quelli aziendali che quelli personali.
'''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).
[[File:Rubrica.png|250x426px|destra|miniatura||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).
<!--T:113-->
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]]


Cliccando sulle voci in rubrica compare un sottomenu con i seguenti elementi:
</translate>
*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 alla sezione ''Gestione chiamate del presente manuale''.
 
 
La schermata ''Interni'' è simile alla precedente con la differenza che gli elementi visualizzati sono gli interni (locali e remoti) registrati sul PBX.
 
Per ogni interno viene visualizzato nome, cognome, numero e stato BLF.
 
Lo stato dell’interno ammette quattro possibilità:
*Verde: disponibile
*Giallo: ringing
*Rosso: occupato
*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.
 
==Casella vocale==
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.
 
I messaggi non vengono salvati automaticamente sul device ma devono essere scaricati cliccando sull’apposito tasto in corrispondenza di ogni singolo messaggio.
 
Una volta scaricato, sarà possibile riprodurre il messaggio direttamente sul device.
 
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.
 
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.
 
==Chat e presence==
KalliopeCTI offre un comodo servizio di Instant Messaging e gestione della presence che permette di comunicare rapidamente con gli altri utenti Kalliope.
[[File:Chat.jpg|250x426px|destra|miniatura||Chat]]
Per avviare una nuova conversazione è necessario accedere alle informazioni del contatto desiderato e cliccare sul simbolo della chat in alto a destra.
 
Lo stato di presence può essere modificato da qualsiasi tab cliccando sul simbolo della ruota dentata e successivamente sull’icona del servizio di presence (la prima dall’alto).
 
Oltre allo stato, l’utente può anche inserire un messaggio personalizzato che verrà visualizzato insieme alla presence.
 
Gli stati disponibili sono:
*Online
*Disponibile
*Fuori
*Occupato
*Non disponibile
*Offline
 
==Gestione chiamate==
===Chiamate in ingresso===
In caso di chiamate in arrivo all’interno, sia dirette che attraverso gruppi e code, l’app mobile invia una notifica all’utente e mostra la schermata riportata in Figura.
 
Questa schermata permette di effettuare tre azioni:
*Slide verso il basso: la chiamata viene ignorata e l’interno continua a squillare
*Trasferisci su cellulare: l’interno smette d squillare e il PBX instaura una chiamata verso il numero di cellulare associato, l’app notifica il reale chiamante mentre la chiamata arriverà dal numero geografico del PBX. Rispondendo a tale chiamata si è messi direttamente in comunicazione con il chiamante.
*Rifiuta: la chiamata viene abbattuta dal centralino e, di conseguenza, anche l’interno smette di squillare.
 
===Chiamate in uscita===
Per quanto riguarda le chiamate in uscita, KalliopeCTI mobile offre tre diverse modalità di setup di chiamata.
 
# 1.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.
# 2.Callback + DISA
Il servizio di chiamata Callback + DISA 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.
# 3.Utilizzando la rete GSM del device
In questa modalità, la chiamata viene effettuata direttamente dalla SIM del dispositivo sul quale è installata l’app Kalliope CTI.

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"