View source for MessengerCTI.Mobile Manual

<center>[[Plik:messenger_2.png|250px]]</center>
= Introduction=
'''MessengerCTI.Mobile''' Slican Software is mobile application dedicated for '''Android''' operating system, which allow to make incoming or outgoing calls, access to phone book, call history, view status of other subscribers and chat.<br>
Application can work together alongside desk phone and smartphone already in use by PBX subscriber. <br>

Application have advantage of being integrated with phone book saved in PBX. '''MessengerCTI.Mobile''' is using phone book stored in PBX but phone book entries can be modified only by using system phone or by computer with ''MessengerCTI.Desktop''' application or '''WebCTI'''. Additionaly '''MessengerCTI.Mobile''' Slican software operates as internal messenger-chat. Messenger can be use by all subscribers of particular PBX if required licenses are supplied.
<br>
==Application advantages==
* application available(for free) from Google Play store - only CTI.plus license applied to PBX is required
* phone book with access to subscribers availability(chat, phone status, text status)
* option of adding and removing subscribers from favorite group, synchronised with MessengerCTI.Desktop
* history of recent calls/messages sorted chronologically
* logging with phone simultaneously as desk phone or as separate MessengerCTI subscriber(NCP PBX only)
* chat/messenger
* chat history with phone call history
* voice calling through GSM(two connection options- capture or parrarel)
* flexible configuration of audio notifications
* access to PBX services configuration from phone
* rapid access number for fast call forwarding
* option of setting up busy status of desk phone if GSM is buy (on by default)
* option of setting up incoming call denying on GSM if desk phone is busy
* option of copying text from chat
* support of DualSim smartphone or two phones simultaneously (private or business)
* convenient access to opening door/gate if receiving call from doorphone DPH.IP or from context contacts menu
* additional desktop widget for fast access to open DPH.IP doorphone doors
* automatic delay of notifications for MessengerCTI.Mobile if desk phone or MessengerCTI.desktop is active 
* option of copying contact from local phone book to pbx phone book

{{Attention!| 
For proper operation MessengerCTI.Mobile and PBX must have permanent access to internet, fixed public IP address for PBX or forwarding port 5529 on edge router when PBX is on LAN behind NAT.}}

= Minimum requirements  =
'''''MessengerCTI.Mobile''''' application - is available to download from Google Play store.

For installing application minimum requirements must be met:
* Android operating system - maximum version 8(Oreo)
* PBX and application must have access to internet
Phone with higher version of operating system won't be able to install application. 

{{Attention!|
'''''MessengerCTI.Mobile''''' application works with IPx, MAC and CCT PBX with firmware version '''6.53''' or higher and NCP PBX'''1.11'''}}<br>

=Application installation =
'''''MessengerCTI.Mobile''''' usage is licensed do purchasing of proper license is required. Purchased serial code is used during PBX configuration, serial code defines number of users that are able to use application. Application licensing doesn't interfere with installation. After installing application, it must be configured for connecting to PBX:  '''''Settings->Account''''' (described below).

{{Attention!|
If extensions number chosen for application doesn't have access rights to '''''MEssengerCTI.Mobile''''' or PBX CTI account isn't configured properly for mobile application - connecting to PBX and synchronising data won't be possible.}}

== Starting application ==

'''''MessengerCTI.Mobile''''' application runs just like any other application working with Android operating system. During startup application is logging to PBX(according to setting from '''''Settings->Account''''' tab). After successful login synchronising between application and PBX starts(call history and chat history). 
== Configuring application==
For proper communication between application and PBX, CTI account information and other functions must be configured properly. Configuration menu is placed in upper right corner of application window. From drop down menu '''Settings''' menu can be chosen.<br>

Fields required for configuration can be found here:account, notifications, handy numbers.
===Account===
Configured with information configured by PBX administrator.:
* Your telephone number: internal subscriber number(extensions) with access to CTI communication
* password: CTI user password
* advanced -> Transmission protocol port: port used for communication with PBX - by default set to TCP 5529
* Host: domain address or IP address of local PBX(public IP address for users outside LAN) 

===Notifications===
Configuring call notifications:
* ringtone: ringtone from available ones can be chosen.
* missed call: notify about missed calls on status bar.
Configuring chat messages notifications:
* message tone: tone from available ones can be chosen.
===Handy numbers===
List of handy humbers available during active call, they can be user for fast forward to another number from handy list.

===Other===
Configuring phone busy status depending on incoming call direction(GSM or CTI call):
* during GSM talk, internal number will be busy
* reject GSM when internal number is busy
Solving issues with proper software operation:
* debug - administrator option which is turned on on software vendor suggestion, for analysing issue logs.
 After turning '''debug''' option additional '''Send logs''' field will appear in main menu. After choosing e-mail client, application logs will be sent to software vendor.

== Services==
Configuring application services related to connections/calls:
* DND: Do not Disturb
* forwarding calls:all will be forwarded to chosen number when busy or doesn't answer(must be noted that at first number is given, then forwarding happens)
* silence application: silent mode
== My description ==
Setting text status that will be visible to other MessengerCTI.Users or on screen of CTS-330 system phone.
== About software ==
Information about: 
* current software version
* type of connected PBX
* PBX firmware version
* Own number: CTI account number(internal PBX extension)
* Own comment: user comment made by administrator

== Updating application ==
Application is applying updates automatically, user can set on or off automatic updates in similar manner to other Google play store applications on phone. If new softwar version will be available in Goole Play store it will automatically download or notify about recent version.

= Application structure =
== Main window ==
Main application windows give access to two tab:
* '''Last/Recent''' - history of calls, chat messages and users statuses.
* '''Contacts''' - access to PBX phone book with sorting options:favourites, internal, external.
* login icon status with text status
* searching contacts
* applications settings menu 
<center>[[File:MessengerCTI_opis_new.png|800px]]</center>

== Icons meaning ==
'''''MessengerCTI.Mobile''''' gives users intuitive preview of telephone status with seperate icon for every contact or call history event. These icons allow to chose action, check call status or inform about error/issues.
=== Icons and symbols ===
"Last/recent" starting application windows is showing history of calls. Icons located here are:
* left side: application status of other MessengerCTI.Desktop/Mobile users or call history
* right side: information about call direction and message status<br>    

Table 1 describes meaning of particular icons informing about application status of other MessengerCTI.Desktop/Mobile users:
* PBX internal subscribers - icons showing status of logged application, touching icon allows to start chat or check call history
* DPH.IP doorphone - door position, touching icon allows to check history

  <center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Icon meaning
|-
|{{align|center}}|[[File:MessengerCTID_free.png|40px]]  ||user logged in
|-
|{{align|center}}|[[File:MessengerCTID_chat_zaraz_wracam1.png|37px]]  ||status: "Be right back" 
|-
|{{align|center}}|[[File:MessengerCTID_chat_busy1.png]]  ||status set by user "Do not disturb" 
|-
|{{align|center}}|[[File:MessengerCTID_chat_no_login.png|40px]]  ||user logged our, not available or status is set to "Hidden"
|-
|{{align|center}}|[[File:MessengerCTIMD_chat_free.png|40px]]  || Dekstop application status with configured Mobile version 
|-
|{{align|center}}|[[File:MessengerCTIM_chat_DND.png|40px]]  ||calls and messages history
|-
|{{align|center}}|[[File:MessengerCTIM_door_open.png|40px]]  ||DPH.IP doorphone: door open
|-
|{{align|center}}|[[File:MessengerCTIM_door_closed.png|40px]]  ||DPH.IP doorphone: door closed
|-
|}
'''''Table 1:''''' Icon shows status of application, users and doorphones.<br></center><br>

In case of phones being PBX extensions, icon will show phone status.
<center>

{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Icon meaning
|-
|{{align|center}}|[[File:MessengerCTIM_call.png|40px]]  ||number is busy
|-
|{{align|center}}|[[File:MessengerCTIM_ringing.png|40px]]  ||calling number or making outgoing call
|-
|{{align|center}}|[[File:MessengerCTIM_failure1.png|40px]]  ||number is not available or faulty
|-
|{{align|center}}|[[File:MessengerCTIM_DND.png|40px]]  ||DND service is on
|-
|}
'''''Table 2:''''' Icons displaying phone status<br></center>

Table 3 shows meaning of icons displaying calls status: 
<center>
{|{{prettytable}}
!{{Hl1}}|Icon !!{{Hl1}}| Icon meaning
|-
|{{align|center}}|[[File:MessengerCTIM_incom_call.png|40px]]  ||incoming call
|-
|{{align|center}}|[[File:MessengerCTIM_out_call.png|40px]]  ||outgoing call
|-
|{{align|center}}|[[File:MessengerCTIM_no_answer_qty.png|50px]]  ||new missed call
|-
|{{align|center}}|[[File:MessengerCTIM_no_answer.png|45px]]  ||missed call
|-
|}

'''''Table 3:''''' Icons displaying calls.<br></center>

Table 4 shows icons displaying message status:
<center>
{|{{prettytable}}
!{{Hl1}}|Icon !!{{Hl1}}| Icon meaning
|-
|{{align|center}}|[[File:MessengerCTIM_incom_chat.png|40px]]  ||Message received 
|-
|{{align|center}}|[[File:MessengerCTIM_out_chat.png|40px]]  ||Message sent, read
|-
|{{align|center}}|[[File:MessengerCTIM_no_answer_chat.png|50px]]  ||New message, received
|-
|{{align|center}}|[[File:MessengerCTIM_no_received_chat.png|45px]]  ||Message sent, not read
|-
|{{align|center}}|[[File:MessengerCTIM_send_read_chat_conf.png|40px]]  ||Message sent, read  - dialogue window view
|-
|{{align|center}}|[[File:MessengerCTIM_send_notread_chat_conf.png|40px]]  ||message sent, not read - dialogue window view
|-
|{{align|center}}|[[File:MessengerCTIM_send_unav_chat_conf.png|40px]]  ||Message sent to logged out user - dialogue window view
|-
|}
'''''Table 4:''''' Icons showing message status.<br></center>

Table 5 shows description of application errors and notifications. Notifications are visible under status icon.<center>
{|{{prettytable}}
!{{Hl1}}|Notification !!{{Hl1}}| Meaning
|-
|{{align|center}}|[[File:MessengerCTIM_no_internet.png]]  ||No connection: check network connection
|-
|{{align|center}}|[[File:MessengerCTIM_no_auth.png]]  || Wrong login or password: check account settings
|-
|{{align|center}}|[[File:MessengerCTIM_no_licen.png]]  || App not allowed in PBX: contact PBX administrator
|-
|}
'''''Table 5''''': Error icons meaning.
</center>

=Supporting messages and calls=
For call between two users necessary are:
* proper account configuration of application and PBX
* full connection between application and PBX(full data synchronisation of application with PBX) - application icon should have green color
* installed Slican system phone, VoIP or analog phone for IPx, MAC or NCP PBX or configured MessengerCTI subscriber((only NCP PBX)

==Making calls==
Two ways of making calls:
* from '''Contacts''' tab - choosing subscriber from particular group (if applicable), or from "All contacts" group. Call is made by touching contact tab, then choosing icon from drop down menu. 
<center>[[[[File:MessengerCTIM_outgoing.png|25px]]  
* from '''Contacts''' tab- searching for phone number in '''Search''' field by using keyboard then touching lower right corner of keyboard
<center>[[File:MessengerCTIM_out_ext1.png|700px]]</center>
* from '''Last/Recent''' - find subscriber which we had shared call(he called or we called him) and then make call by touching middle part of contact tab and choosing action from drop down menu
<center>[[File:MessengerCTIM_out_number1.png|750px]]</center>

Connecting calls are displayed with call screen just like calls made using GSM. Application at first is connecting call to PBX dedicated number for '''MessengerCTI.Mobile''' users, configured by PBX administrator. Then PBX is connecting by transit to number chosen by '''MessengerCTI.Mobile'''. Due to that reason, required city line for PBX must be at least ISDN BRA.

==Incoming calls==
Incoming calls are displayed with popping up call window and ring tone configured in application notifications settings. Calls are received by sliding icon with green handset, if we want to reject call it can be done with sliding red handset. If additional handy numbers were set, call may be forwarded to them by sliding icon with handy number.
Process of receving incoming calls works by making a return call with GSM line to application access number defined by PBX administrator.
<center>[[Plik:MessengerCTIM_incoming2.png|700px]]</center>

Missed calls are displayed with icon [[Fire:MessengerCTIM_no_answer_qty.png|50px]]. Going to call history or calling back will clear information about amount of missed calls.

==Messages support==
Application allows to send and receive text messages between MessengerCTI.Desktop/Mobile user (internal chat). To send message user status icon must be touched or from drop down menu and touching contact tab, then choosing '''chat'''.<br>
Receiving messages is displayed on notification bar by proper icon and defined ring tone.<br> 
If subscriber is using both versions of MessengerCTI, messages history is stored locally in '''''MessengerCTI.Dekstop''''' application.<br>
Below is example of chat window:

<center>[[Plik:MessengerCTIM_czat1.png|700px]]</center>

== Contacts==
Contacts tab allow to display and search for actions related  to particular contacts. Numbers from other groups can be accessed from drop down contact list grouped as:Zakładka kontakty umożliwia wyświetlanie i 
* favourites
* all groups
* all contacts
* internal
* external
* private
By default '''Favourites''' group is visible.
<center>[[Plik:MessengerCTIM_contacts1.png|300px]]</center>

== Historia połączeń ==
Domyślnie wybrana zakładka '''Ostatnie''' w oknie głównym programu wyświetla historię połączeń jak i wiadomości czat.<br> 
W historii każda pozycja oznacza co najmniej jedno połączenie lub wiadomość. Jeśli połączenie lub wiadomość pochodzi od tego samego użytkownika i jest ich więcej niż jedno, to przy odpowiedniej ikonie wyświetlana jest stosowna liczba. W każdej pozycji widoczny jest numer dzwoniącego, komentarz(jeśli jest on w książce numerów spoza centrali), czas i data realizacji połączenia.<br>
Jeśli w historii znajdują się nie przejrzane nieodebrane połączenia lub nieprzeczytane wiadomości to zakładka '''Ostatnie''' jest oznaczona czerwoną kropką.<br>
Z zakładki historii możliwe jest oddzwanianie lub wysyłanie wiadomości zwrotnych.

=Konfiguracja centrali Slican=
Do poprawnej współpracy aplikacji z centralą jest wymagane:
* odpowiednia licencja producenta
* specyficzna konfiguracja centrali
==Konfiguracja central IPx, CCT==
Za pomocą programu ConfgMAN:
* w menu '''''Globalne ustawienia->Globalne ustawienia/Pozostałe->ANo''''': skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji Abonenta menu '''''Abonenci->Abonenci/Ustawienia CTI
** '''AwdMbl''': włączyć zezwolenie na obsługę aplikacji
** '''MnNo''': skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja oraz ewentualnie drugi numer (dla telefonu z dual SIM) 
** '''IncC''': ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)
      
<font color=red>'''Minimalna wymagana wersja oprogramowania to: 6.53.'''</font>

==Konfiguracja centrali NCP==
Z poziomu aplikacji ConfigWEB
* w menu '''''Numery wewnętrzne->Ustawienia->Konfiguracja aplikacji CTI'''''" skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji abonenta SIP, FXS, CTS, Numer MessengerCTI w menu '''''Numery wewnętrzne->Abonenci->CTI ustawienia'''''
** skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja
** ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji i telefonu wewnętrznego central) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)
      
<font color=red>'''Minimalna wymagana wersja oprogramowania to: 1.11.'''</font>

=Przykłady zastosowań=
Aplikacja '''''MessengerCTI.Mobile''''' może być atrakcyjnym narzędziem dla tych firm, które posiadają pracowników mobilnych z wymogiem ciągłego dostępu telefonicznego jako numer wewnętrzny danego systemu telefonicznego.<br> 
Dobry przykładem mogą pracownicy:
* działu handlowego - z pracą w trybie mieszanym biuro <-> poza biurem
* działu serwisowego - z pracą ciągłą w terenie
* pracownicy zdalni - telepraca
* pracownicy mobilni - praca na dużym terenie (hale produkcyjne, obszary rozległe) - gdzie zasięg sieci typu WiFi lub DECT nie obejmuje takich obszarów.