Difference between revisions of "User:Leszekj"

From pubWiki-en
Jump to: navigation, search
(→‎Installing beta version)
 
(59 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
= Program structure=
+
= Aplication structure=
  
  
−
<center>[[File:messenger_2.png|250px]]</center>
+
<center>[[File:MessengerCTI.Mobile_1.07_Main_page_en.png|250px]]</center>
 +
 
 
= Introduction=
 
= 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>
+
'''MessengerCTI.Mobile''' Slican Software is mobile application dedicated for '''Android''' operating system. It integrates smartphone, computer and subscriber's desk phone. MessengerCTI.Mobile allows users making and receiving calls as PBX subscriber, transferring calls to another subscriber, using contact book, history of calls, conducting chat and text conferences, viewing phone and MessengerCTI status of other subscribers and transferring files.  
−
Application can work together alongside desk phone and smartphone already in use by PBX subscriber. <br>
+
Video image preview function is available for PBX that support DPH.IP doorphones equipped with camera. Application supports calls related to Call Center queues - PBX subscribers/ agents are mobile and independent of their permanent workplace. Functionally, MessengerCTI.Mobile is fully synchronized with MessengerCTI.Desktop, so regardless of version used (mobile, desktop) it always ensures work with up-to-date data.
  
−
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 advantages==
−
* application available(for free) from Google Play store - only CTI.plus license applied to PBX is required
+
* handling voice calls in VoIP mode both via GSM operator's Internet network (LTE, HSPA) and WiFi network
−
* phone book with access to subscribers availability(chat, phone status, text status)
+
* handling voice calls in GSM mode
−
* option of adding and removing subscribers from favorite group, synchronised with MessengerCTI.Desktop
+
* chat,  text conference and  text announcements
−
* history of recent calls/messages sorted chronologically
+
* voice conference
−
* logging with phone simultaneously as desk phone or as separate MessengerCTI subscriber(NCP PBX only)
+
* access to contact book with preview of other subscriber's availability status (chat, phone status, description, application)
−
* chat/messenger
+
* creating favorites group
−
* chat history with phone call history
+
* history of recent calls / chats - sorted chronologically
−
* voice calling through GSM(two connection options- capture or parallel)
+
* full synchronization with MessengerCTI.Desktop application
−
* flexible configuration of audio notifications
+
* logging in as parallel phone to deskphone or as separate MCTI subscriber (only in NCP PBX)
−
* access to PBX services configuration from phone
+
* possibility to copy text from / to chat
−
* rapid access number for fast call forwarding
+
* flexible configuration of sound and vibration notifications with possibility of using schedules
−
* option of setting up busy status of desk phone if GSM is buy (on by default)
+
* access to configuration of selected PBX services (FWD, DND)
−
* option of setting up incoming call denying on GSM if desk phone is busy
+
* quick reference numbers for fast call transfer
−
* option of copying text from chat
+
* ability to set desk phone busy if user's smartphone is busy (enabled by default)
−
* support of DualSim smartphone or two phones simultaneously (private or business)
+
* rejection calls on user's GSM smatphone if deskphone is busy
−
* convenient access to opening door/gate if receiving call from doorphone DPH.IP or from context contacts menu
+
* ability to use DualSIM smartphones or two phones at same time (business and private)
−
* additional desktop widget for fast access to open DPH.IP doorphone doors
+
* convenient door opening in case of calls from DPH.IP doorphone (from application connection window, contact context menu or desktop widget)
−
* automatic delay of notifications for MessengerCTI.Mobile if desk phone or MessengerCTI.desktop is active
+
* automatic notification delay mechanism MessengerCTI.Mobile if subscriber is active on desk phone or on MessengerCTI.Desktop application
−
* option of copying contact from local phone book to PBX phone book
+
* ability to copy contacts from PBX contact book to local smartphone book
 +
* sharing your own location
 +
* ability to transfer photos and files (drag & drop)
 +
* handy clipboard for sharing data between mobile and desktop application
 +
* support for emoticons
 +
* making calls from external number sources
 +
* available in Google Play store (free)
 +
 
 +
 
 +
{{Warning|
 +
For proper operation of application and calls, following are required:
 +
* permanent access to WiFi or Internet from smartphone with MessengerCTI.Mobile application
 +
* permanent access to LAN and Internet for PBX
 +
* if MessengerCTI.Mobile works via Internet - domain address or permanent public IP address of PBX, or if PBX is located in local network behind NAT - on edge router it is necessary to redirect some ports to its IP address. Description of port forwarding configuration is presented below in Ports and Protocols chapter
 +
* MessengerCTI.userPlus license per user at PBX
 +
* optional, depending on adopted configuration - license for VoIP subscribers in NCP or subscribers and VoIP channels in IPx, MAC, CCT exchanges
 +
* opening door using context menu or widget available only after starting ACS system
 +
}}
 +
 
 +
=Basic Features=
 +
Using smartphone, application user gains mobility and still has option of using PBX as internal subscriber.
 +
 
 +
===VoIP and GSM client===
 +
* '''MessengerCTI.Mobile''' - parallel telephone, associated with equipment of desk phone (FXS, CTS, SIP). Application can work as VoIP or GSM client. User decides on which device to answer call and make call - by desk phone or smartphone. Novelty is possibility of using application as standalone telephone in NCP (from firmware version 1.11). CTIuserPlus license is required for its correct operation.
 +
* '''Configuration in VoIP mode''' - basic configuration for using application. Both calls made and other information, e.g. about the caller's number, contacts in book, subscriber status, chats - are sent over IP network (WiFi, LTE/ HSPA Internet)
 +
* '''Configuration in GSM mode''' - it is most often used if access to IP network or Internet in given location is weak (insufficient for VoIP calls) or unstable. All information and signaling - are still sent via IP network (WiFi, LTE / HSPA), but calls themselves are carried out by GSM operator. With poor IP transmission quality, you should take into account that information may not always be displayed.
 +
 
 +
Switching between VoIP and GSM mode can be done by user from application configuration (if PBX is properly configured).
 +
 
 +
=== Phone Book ===
 +
Big advantage of software is simple and convenient access to contact from phone books and displaying them on computer screen. '''MessengerCTI.Mobile''' can use only phone books from PBX. Contacts can be sorted according to user needs. Adding new subscribers and modification of existing entries can be done from CTS system phone or more conveniently, by using computer with '''MessengerCTI.Desktop''' or '''WebCTI'''. Modification of entry is visible instantly after adding it. Access to phone book allows to simply search numbers of contacts user want to call. On other hand, during incoming calls computer displaying will be showing clear information about calling person.
 +
 
 +
=== Call History ===
 +
User has access to complete history of their calls, picked up and missed one. History is saved on Slican PBX. By using Messenger.CTI history can be displayed alongside information about order, time of calls and number of missed calls from particular number.
 +
 
 +
=== CallCenter (NCP PBX)===
 +
In conjunction with NCP for Call Center agents, queue handling functionality has been introduced. It allows agents to log in to them, view status, call back lost and abandoned calls, and turn on status of temporary work breaks.
 +
 
 +
=== Text messages ===
 +
By MessengerCTI text information can be sent, from internal messenger (chat) through computer network to another person with '''MessengerCTI.Desktop''' or '''MessengerCTI.Mobile'''. Chat can be used by all subscribers of given PBX and other PBX linked with eSSL ver.2 system. This functionality is especially attractive for those companies which, having Slican PBXes, do not allow use of public communicators for security reasons. To ensure parallel access from various devices (computer, smartphone), chat history is saved directly in PBX and synchronized with MessengerCTI applications on ongoing basis. An extension of this functionality is possibility of conducting chat with many users simultaneously, i.e. so-called text conference.
 +
 
 +
===Text and voice conferences===
 +
Functionality that allows to PBX messages / talk simultaneously with many users
 +
 
 +
===Uploading files===
 +
It is possible to send files, e.g. photos, documents, between users of MessengerCTI application (desktop, mobile)
 +
 
 +
===Location sharing===
 +
Due to mobility - user can turn on selected people observation of his location. Authorized person gains ability to observe its location.
 +
 
 +
=== Using cameras and DPH.IP doorphones ===
 +
Introduction to sale of DPH.IP doorphones that include cameras allowed to solution that allows display of video from these cameras. Functionality was added with '''MessengerCTI.Mobile'''. While connecting to doorphone from software video from camera will appear in new window on computer display. After starting call and next finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door, gate, barrier using dedicated button. Reverse is also true, calling to doorphone or another telephone associated with camera, computer display will show video from their cameras. This allow for temporary observation of neighborhood of installed camera, for example person we are calling. There is also option of watching video from any camera without making call, just using application icon. Thanks to '''MessengerCTI.Mobile''' user can preview video from camera of other manufacturers, but those devices have to support video formats, codec compatible with VLC application libraries.
  
−
{{Attention!|
+
=== Works with desktop version ===
−
*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.
+
Application can be used alongside and synchronized to '''MessengerCTI.Desktop''', that is version for computer with Windows.
−
*For VoIP connections with application - domain address or fixed public IP address, eventually 5060 UDP port forwarded on edge router(signalisation), 10000 - 20000 UDP (RTP voice frames for NCP PBX), 8100 - 8300 UDP (RTP voice frames for IPx, MAC, CCT PBX)to PBX IP address if it is behind NAT on local network}}
+
  
 
= Minimum requirements  =
 
= Minimum requirements  =
−
'''''MessengerCTI.Mobile''''' application - is available to download from Google Play store.
+
'''MessengerCTI.Mobile''' application is freely available - it can be downloaded from Google Play store..
  
 
For installing application minimum requirements must be met:
 
For installing application minimum requirements must be met:
 
* Android operating system
 
* Android operating system
−
** minimum version: KitKat 4.4.4
+
** minimum version: Android 6.0 Marshmallow
−
** minimum recommended version: Nougat 7.0
+
** minimum recommended version: Nougat 7.0
 
** PBX and application must have access to internet
 
** PBX and application must have access to internet
−
Phone with lower version of operating system then 4.4.4 won't be able to install application.  
+
Phone with lower version of operating system then 6.0 won't be able to install application.  
  
 
{{Attention!|
 
{{Attention!|
Line 48: Line 97:
 
* better call stability
 
* better call stability
 
* option of automatic regaining voice connection after reloging to network or changing IP
 
* option of automatic regaining voice connection after reloging to network or changing IP
−
* option of regulating microphone gain for VoIP calls
+
* option of ajusting microphone gain for VoIP calls
 
}}<br>
 
}}<br>
  
−
{{Attention!|
+
{{Warning|
−
'''''MessengerCTI.Mobile''''' application works with IPx, MAC and CCT PBX with firmware version '''6.53''' or higher and NCP PBX'''1.11'''<br>
+
'''MessengerCTI.Mobile''' application works with IPx, MAC and CCT PBX with firmware version '''6.53''' or higher and NCP PBX '''1.11'''<br>
 
VoIP with application is supported for IPx, MAC and CCT with firmware '''6.54''' and NCP firmware '''1.12'''}}<br>
 
VoIP with application is supported for IPx, MAC and CCT with firmware '''6.54''' and NCP firmware '''1.12'''}}<br>
  
 
=Application installation =
 
=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).
+
'''''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!|
+
 
 +
During installation, you are prompted to provide some permissions. They may vary depending on Android version and phone type. You can approve all of them or select only those related to functionalities that will be used:
 +
* Camera - for scanning QR code (configuration) and taking and sending photos
 +
* Location - to share your location
 +
* Microphone - for making VoIP calls
 +
* Internal memory - for saving photos, transferring files and using clipboard
 +
* Phone - for using application in GSM mode
 +
* Contacts - for copying contacts to local phone database (used only in some versions of application)
 +
* Displaying above other applications - should be made, available so that you can answer call correctly when application is, for example: deep sleep
 +
* Disable battery optimization - Battery optimization for app must be disabled to prevent it from going into deep sleep
 +
 
 +
 
 +
{{Warning |
 
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.}}
 
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 ==
+
= Starting application =
  
−
'''''MessengerCTI.Mobile''''' application runs just like any other application working on 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).  
+
'''''MessengerCTI.Mobile''''' application runs just like any other application working on 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==
 
== 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>
+
For proper communication between application and PBX, CTI account information and other functions must be configured properly. Configuration menu is placed in bottom left 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.
+
Fields required for configuration can be found here: account, notifications, handy numbers.
 +
 
 +
==Settings==
 
===Account===
 
===Account===
−
Configured with information configured by PBX administrator.:
+
Configured with information configured by PBX administrator:
−
* Your telephone number: internal subscriber number(extensions) with access to CTI communication
+
* Your telephone number: internal subscriber number (extensions) with access to CTI communication
−
* password: CTI user password
+
* Password: CTI user password
−
* advanced -> Transmission protocol port: port used for communication with PBX - by default set to TCP 5529
+
* Host: port: domain or public IP address of PBX for users outside network or private IP address for users of local network, signaling protocol port: port for communication with PBX - by default TCP 5529
−
* Host: domain address or IP address of local PBX(public IP address for users outside LAN)  
+
* Transmission encoded: XML Protocol Encryption
 +
* Self-signed certificate
 +
* Read data from QRCode: instead of manual configuration - ability to scan QR code sent from NCP to user's e-mail box when configuring CTI settings or from WebCTI website
 +
* Advanced/Port signaling protocol: communication port PBX - default for PBX is TCP 5529
 +
 
 +
 
 +
<center>[[File:MessengerCTI.Desktop_1.07_Account_configuration_en.png |600px]]</center>
 +
 
 +
Using QRcode from WebCTI -> My subscriber account or link to code sent to user's e-mail address (only in NCP PBX with properly configured e-mail client)
 +
 
 +
 
 +
<center>[[File:MessengerCTI.Desktop_1.07_Account_QRcode_en.png |1000px]]</center>
 +
 
 +
===Calls===
 +
Options for activating headset button and microphone gain level
 +
 
 +
<center>[[File:MessengerCTI.Desktop_1.07_Settings_Calls_en.png|270px]]</center>
 +
 
 +
 
 +
===Call Center===
 +
Possibility to activate up to 4 login/ logout buttons and agent breaks related to Call Center queues
 +
 
 +
<center>[[File:MessengerCTI.Desktop_1.07_Settings_Call_center_en.png|270px]]</center>
  
−
===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 numbers available during active call, they can be user for fast forward to another number from handy list.
 
  
 
===Other===
 
===Other===
−
Configuring phone busy status depending on incoming call direction(GSM or CTI call):
+
Pozostałe ustawienia aplikacji widoczne są na załączonej grafice.
−
* during GSM talk, internal number will be busy
+
 
−
* reject GSM when internal number is busy
+
'''Debug''' option - turned on at request of software vendor (Slican) - is related to solving problems with correct operation of application
−
Solving issues with proper software operation:
+
 
−
* debug - administrator option which is turned on on software vendor suggestion, for analysing issue logs.
+
Enabling option causes that in tab '''About''' additional field appears '''''Send logs via email'''''. We choose e-mail client from which we will send application logs for analysis on Slican side.
−
After turning on '''debug''' option additional '''Send logs''' field will appear in main menu. After choosing e-mail client, application logs will be sent to software manufacturer.
+
 
 +
<center>[[File:MessengerCTI.Desktop_1.07_Settings_Other_en.png|520px]]</center>
 +
 
 +
== Services ==
 +
Calls services configuration:
 +
* Default connection type - settings for making calls via GSM, VoIP or VoIP over WiFi
 +
* Global services for PBX:
 +
** DND - do not disturb
 +
** Deskphone is busy when GSM is talking - during call on GSM phone - primary phone (deskphone) and thus MessnegerCTI.mobile application is not supposed to ring during incoming calls (test functionality, it does not work with every GSM phone)
 +
** FWD - call forwarding settings: all, busy or no answer
 +
 
 +
== My desription ==
 +
Setting your own comment, which will be visible to other users of MessengerCTI application (desktop and mobile) and on screen of CTS-330 system phone
 +
 
 +
==Notifications==
 +
'''Configuring incoming call notifications:'''
 +
* ringtone: selecting one from list available in application with option to mute it after specified time
 +
* turn off ringing after x seconds - setting optimal length of ringing time
 +
* vibration when ringing
 +
* notification schedule for call ringtone - set weekly active use plan (ringtone in selected time ranges)
 +
 
 +
 
 +
'''Configuring missed calls notifications:'''
 +
* notify about missed call - if missed call happens, MessengerCTI icon with option to preview message will appear on Android notification bar, in upper part of smartphone screen
 +
 
 +
 
 +
'''Configuring chat message notifications:'''
 +
* notify about chat messages - enable notifications
 +
* message tone: selecting one from the list available in application
 +
* vibration on message
 +
* notification schedule for chat message - set weekly active use plan (notifications in selected time ranges)
 +
 
 +
 
 +
'''Notifications based on activity on other devices::'''
 +
 
 +
Functionality that allows to enable intelligent response to incoming call/notifications of MessengerCTI.mobile application. It introduces 10-second delay notification MessengerCTI.mobile relative to ringing associated phone (usually deskphone).
 +
 
 +
After starting MessengerCTI.mobile - desk phone and application will ring simultaneously during incoming call. If we answer first to desk phone, application will "remember" that we nearby phone and will delay ringing application during next call.
 +
 
 +
 
 +
It ceases to apply when:
 +
* we will not answer call
 +
* we will pick up call with MessengerCTI.Mobie
 +
 
 +
==Quick transfer==
 +
List of 3 most important user reference numbers (extensions or outside from PBX) displayed during call for easy call transfer.
  
−
== Services==
+
== About==
−
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:  
 
Information about:  
−
* current software version
+
* Own number: PBX ext. number to which application is logged in
−
* type of connected PBX
+
* Own comment: subscriber comment
 +
* Current application version
 +
* Type and number of connected PBX
 
* PBX firmware version
 
* PBX firmware version
−
* Own number: CTI account number(internal PBX extension)
+
* XML encoding
−
* Own comment: user comment made by administrator
+
* Battery optimization
 +
* Privacy policy
 +
* Used libraries
 +
* Link to send application logs
  
 
== Updating application ==
 
== 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 is updated automatically and user can its course in accordance with settings of automatic updates of given phone application for Google account holders. If new version appears in Google Play Store, newer version will be automatically downloaded or notified.
  
 
= Application structure =
 
= Application structure =
 
== Main window ==
 
== Main window ==
−
Main application windows give access to two tab:
+
Main application windows give access to following tabs:
−
* '''Last/Recent''' - history of calls, chat messages and users statuses.
+
* '''Last''' - window related to history of calls and sent messages along with subscriber status in PBX
−
* '''Contacts''' - access to PBX phone book with sorting options:favourites, internal, external.
+
* '''Contacts''' - access to PBX phone book with sorting options: favourites, internal, external.
−
* login icon status with text status
+
* '''CC''' - handling calls from Call Center queues, possibility to log in/ out and call back
−
* searching contacts
+
 
−
* applications settings menu
+
 
−
<center>[[File:MessengerCTI_opis_new.png|800px]]</center>
+
Additionally:
 +
* Application login status icon with default connection type
 +
* Configuration menu - application and service settings
 +
* Silence ringtone - silence ringtone and app notifications immediately
 +
* Clipboard - for sharing files, photos, data between mobile and desktop application
 +
* Search - searching contacts by name and number
 +
* Creating conference
 +
* Keyboard - selection digits of target number
 +
<center>[[File:MessengerCTI.Mobile_1.07_Main_page_description_en.png|800px]]</center>
  
 
== Icons meaning ==
 
== 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.
 
'''''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 ===
 
=== Icons and symbols ===
−
"Last/recent" starting application windows is showing history of calls. Icons located here are:
+
Application startup window - [[File:MessengerCTI.mobile 1.07 Last_Contacts_CC_en.png]] - shows history of last calls.
−
* 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:
+
This view includes following icons:
−
* PBX internal subscribers - icons showing status of logged application, touching icon allows to start chat or check call history
+
* on left: application status of MessengerCTI.Mobile user
−
* DPH.IP doorphone - door position, touching icon allows to check history
+
* right: informing about phone call or message status
 +
 
 +
Table 1 presents description of meaning of individual icons informing about application status of other MessengerCTI.Desktop/ Mobile users:
 +
* for PBX internal subscribers - icons symbolizing application's login status, touching status icon allows you to start chat or check call history
 +
* for DPH.IP doorphones - current position of door, and by touching icon symbolizing door, you can enter history
 +
* for contacts from outside PBX - checking call history
  
 
   <center>
 
   <center>
 
{|{{prettytable}}
 
{|{{prettytable}}
−
!{{Hl1}}|Ikona !!{{Hl1}}| Icon meaning
+
!{{Hl1}}|Icon !!{{Hl1}}| Icon meaning
 
|-
 
|-
 
|{{align|center}}|[[File:MessengerCTID_free.png|40px]]  ||user logged in
 
|{{align|center}}|[[File:MessengerCTID_free.png|40px]]  ||user logged in
Line 141: Line 273:
 
|{{align|center}}|[[File:MessengerCTID_chat_busy1.png]]  ||status set by user "Do not disturb"  
 
|{{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:MessengerCTID_chat_no_login.png|40px]]  ||user logged out, not available or status is set to "Hidden"
 
|-
 
|-
 
|{{align|center}}|[[File:MessengerCTIMD_chat_free.png|40px]]  || Desktop application status with configured Mobile version  
 
|{{align|center}}|[[File:MessengerCTIMD_chat_free.png|40px]]  || Desktop application status with configured Mobile version  
Line 227: Line 359:
 
For call between two users necessary are:
 
For call between two users necessary are:
 
* proper account configuration of application and PBX
 
* 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
+
* 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)
+
* installed Slican system phone, VoIP or analog phone for IPx, CCT, MAC, NCP PBX or configured MCTI subscriber (only NCP PBX)
  
 
==Making calls==
 
==Making calls==
−
Two ways of making calls:
+
You can make calls in several ways:
−
* 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.
+
# from '''Contacts''' tab - select subscriber from appropriate group (if such in PBX contacts are created) or directly from All contacts group. Call is made by tapping contact and then selecting '''Dial''' icon [[File: MessengerCTIM outgoing.png |25px]] from drop-down menu
−
* from '''Contacts''' tab- searching for phone number in '''Search''' field by using keyboard then touching lower right corner of keyboard
+
# from '''Last''' tab - you find from history we are interested in contacting subscriber (we had conversation with him, he called us or made call to him, we sent or received message from him). Call is made by tapping contact and then selecting '''Dial''' icon [[File: MessengerCTIM outgoing.png | 25px]] from drop-down menu
−
<center>[[File:MessengerCTIM_out_ext1.png|750px]]</center>
+
# in '''Search''' field by entering telephone number or subscriber's name directly from keypad, and then by tapping green receiver on right side
−
* 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
+
# from numeric keypad opened in lower right corner of '''Last''' tab
−
<center>[[File:MessengerCTIM_out_number1.png|570px]]</center>
+
# from another source of numbers, e.g. website, google calendar
  
−
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.
+
'''Screenshots presenting different types of connection are below'''
  
−
==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 receiving incoming calls works by making a return call with GSM line to application access number defined by PBX administrator.
 
−
<center>[[File:MessengerCTIM_incoming2.png|700px]]</center>
 
  
−
Missed calls are displayed with icon [[File:MessengerCTIM_no_answer_qty.png|50px]]. Going to call history or calling back will clear information about amount of missed calls.
+
<center>
 +
[[File:MessengerCTI.Mobile 1.07 Outgoing call en.png|250px]]
 +
[[File:MessengerCTI.Mobile 1.07 Outgoing call2 en.png.png|250px]]
 +
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
 +
[[File:MessengerCTI.Mobile 1.07 Outgoing call3 en.png|250px]]
 +
[[File:MessengerCTI.Mobile 1.07 Outgoing call4 en.png|250px]]
 +
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
 +
[[File:MessengerCTI.Mobile 1.08 Outgoing foreign call en.png|257px]]
 +
</center>
  
−
==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>[[File:MessengerCTIM_czat1.png|700px]]</center>
+
'''VoIP mode''' - basic configuration for using 'application. Both calls made and other information, e.g. about caller's number, contacts, subscriber status, chats - are sent over IP network (WiFi, Internet - HSPA, LTE)
  
−
== Contacts==
+
'''GSM mode''' - it is most often used if access to IP network or Internet in given location is weak (insufficient for VoIP calls) or unstable. All information and signaling - are still sent via IP network (WiFi, Internet - HSPA, LTE), but calls themselves are carried out by GSM operator. With poor IP transmission quality, you should take into account that information may not always be displayed.
−
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:
+
−
* favourites
+
−
* all groups
+
−
* all contacts
+
−
* internal
+
−
* external
+
−
* private
+
−
By default '''Favourites''' group is visible.
+
−
<center>[[File:MessengerCTIM_contacts1.png|300px]]</center>
+
  
−
== Call history ==
+
Switching between VoIP and GSM mode can be done by user from application level (if PBX is properly configured).
−
By default '''Last/Recent''' tab will be visible and showing calls and chat messages history.<br>
+
−
In history every position is at least one call or message. If there is more then one call/message and they come from sam user, on their icon number will be displayed. Every position is displaying caller number, commentary(if number is from phone book outside PBX), time and date of call.<br>
+
−
If in history there are missed calls or messages, '''Last/Recent''' field will be marked with red dot.<br>
+
−
History tab allows to call back or reply to messages.
+
  
−
=Configuring Slican PBX=
 
−
For proper communication between application and PBX are required:
 
−
* correct manufacturer license
 
−
* specific PBX configuration
 
−
==IPx, CCT PBX configuration==
 
−
With ConfigMan software:
 
−
# Inside '''''Themes''''' tab and then '''''Global settings->Global settings/Remain''''': 
 
−
## '''ANo''':configure access number that application will chose for making call to PBX and setting up incoming call
 
−
## '''Adr''' - public host name or PBX IP address for connecting to application(for VoIP calls with application)
 
−
# Inside Subscribers menu, '''''Tables''''' then  '''''Subscribers->Subscribers/CTI settings:
 
−
## '''AwdMbl''': allow access to MessengerCTI.Mobile application
 
−
## '''AwdGSM''': allows to connect phone calls through GSM network
 
−
## '''IncC''': setting up method of how application connects incoming calls:
 
−
### Call pickup - picking up incoming call with application means making outgoing call with GSM phone to number from '''ANo'' field inside ''''' Global settings/Remain'''''
 
−
### Parrallel calling - incoming calls to GSM phone from number set in '''ANo'''field inside ''''' Global settings/Remain'''''
 
−
## '''MnNo''': configure GSM phone access number, on which application is installed, optionally configure second number(for dual SIM phones)
 
−
## '''SecNo''': second GSM phone number with installed application(optional, for dual SIM phones)
 
  
 +
'''Presented connection details on smartphone display differ depending on calls setting mode. VoIP call looks different than GSM call due to necessity to use native phone dialer.'''
  
−
For application to work with each settings, these fields parameters must be set:
+
'''Example of outgoing call made in VoIP mode:'''
−
* VoIP network: 1.2, 2.1
+
−
* GSM network: 1.1, 2.1, 2.2, 2.2.1, 2.2.2, 2.3 and 2.3.1 or 2.3.2
+
−
     
+
−
<font color=red>'''Minimum PBX firmware version - 6.53, for VoIP - 6.54'''</font>
+
  
−
==NCP PBX configuration==
+
<center>
−
From ConfigWEB application:
+
[[File:MessengerCTI.Mobile 1.07 Outgoing VoIP call1 en.png|250px]]
−
* '''''Extensions->Settings->CTI application settings''''' menu, configure access number that application will use to call to PBX and make accept incoming call
+
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
−
* in subscriber editing for SIP, FXS, CTS, Messenger CTI number in menu '''''Extensions->Subscribers->CTI settings'''''
+
[[File:MessengerCTI.Mobile 1.07 Outgoing VoIP call2 en.png|250px]]
−
** configure GSM phone access number which will have installed application
+
[[File:MessengerCTI.Mobile 1.07 Outgoing VoIP call3 en.png|250px]]
−
** set up type of handling incoming calls: call pickup (only application is ringing up) or parallel calling(application and internal phone is ringing up)
+
</center>
−
     
+
−
<font color=red>'''Minimum software version is: 1.11.'''</font>
+
  
−
From ConfigWEB application:
 
−
# '''''Extensions->Settings->CTI application settings''''' menu, configure
 
−
## Public host name or PBX IP address for XML Slican protocol - domain name or IP address for exchanging/synchronisation information and data between application and PBX
 
−
## Public host name or PBX IP address for VoIP calls  - domain name or IP address for for configuring VoIP calls
 
−
## PBX number for GSM calls - which will call GSM phone with installed application to call PBX or PBX to phone and set up call (if GSM network mode is configured)
 
−
# configure subscribers for SIP,FXS, CTS, MCTI with ''''''Extensions/Subscribers/CTI Settings/ MessengerCTI.Mobile'''''
 
−
## Allow access to MessengerCTI.Mobile application
 
−
## if using GSM network allow phone calls handling using GSM
 
−
### set up GSM phone access number for device with installed application
 
−
### set up second GSM phone number with installed applicatio (optional, for dual SIM devices)
 
−
## set up incoming calls handling
 
−
### call pickup - picking up incoming call with application is achievied by GSM phone making outgoing call to number set in '''''Extensions/ Settings/ CTI applications settings / MessengerCTI''''
 
−
### Parallel calling - incoming call to GSM phone from number set with '''''Extensions/ Settings/ CTI applications settings / MessengerCTI''''
 
  
 +
'''Example of outgoing call made in GSM mode:'''
  
−
For application to work, these fields must be set:
+
<center>
−
* VoIP: 1.1, 1.2, 2.1
+
[[File:MessengerCTI.Mobile 1.07 Outgoing GSM call1 en.png|250px]]
−
* GSM: 1.1, 1.3, 2.1, 2.2, 2.2.1, 2.2.2, 2.3 and 2.3.1 or 2.3.2
+
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
 +
[[File:MessengerCTI.Mobile 1.07 Outgoing GSM call2 en.png|250px]]
 +
[[File:MessengerCTI.Mobile 1.07 Outgoing GSM call3 en.png|250px]]
 +
</center>
  
−
     
+
==Incoming calls==
−
<font color=red>'''Minimum PBX firmware version - 1.11, for VoIP - 1.12'''</font>
+
Incoming call is signaled visually by pop-up call window and acoustically with bell configured in notification settings. Calls are answered (depending on whether display phone was turned off or not) by moving middle icon towards green handset or by pressing green one. If call is to be rejected, move icon towards red handset or by pressing red one.
  
−
=Use cases examples=
 
−
'''''MessengerCTI.Mobile''''' application is useful tool for companies that employ mobile workers which requires constant access to phone with internal number of phone system. <br>
 
−
These employees can be a good example:
 
−
* sales department - working in different locations, office <-> outside office
 
−
* service support - constant fieldwork
 
−
* remote worker - remote work
 
−
* mobile worker - working on vast area(production halls, vast areas) -where Wifi or DECT network range won't be adequate
 
  
−
=Installing beta version=
+
We can redirect incoming call to another person. You can do it before answering call or during call (with or without notification):
−
"Beta" version contains new functionalities which will be added in next production version but not all of planned functions are implemented. This version also cointains fixes for error submited for earlier versions. It was initialy tested.<br>
+
* immediately - by pressing button with '''Quick transfer''' contact, or
−
To install beta version:<br>
+
* dialing number from list of contacts or recent calls
−
- If on the phone MessengerCTI is installed, uinstall it.<br>
+
−
- log to Google Play as application tester<br>
+
−
In this case:
+
−
Log in from computer or phone web browser to your Google account. If you hav more then account it is important to log into account which was used to configure your phone.<br>
+
−
Click this link:
+
−
[https://play.google.com/apps/testing/com.slican.messengercti beta version registration]<br>
+
−
When you will see this info:<br>
+
−
[[File:google_beta.jpg]]<br>
+
−
Click BLUE BUTTON to sign up for testing<br>
+
−
Going back to phone configuration: <br>
+
−
- Because Google Play updates can be delayed, it is recommend to turn of Play Store application before installing MessengerCTI.<br>
+
−
- Clicking on shortcut will start Play Store again. Search for MessengerCTI application. It is recommended to search also for Slican due to many other application using "messenger" word in their naming.<br>
+
−
- Install application.<br>
+
−
- Configure according to manual.j<br>
+
−
Use beta version features.
+
  
  
−
=--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------=
+
During call, user can mute microphone and/or turn on speakerphone mode.
  
−
= Program structure  =
 
−
==Main window==
 
−
Main windows of MessengerCTI.Desktop application contains interface which show information and allows access to chat windows and main functions.
 
−
<center>[[File:MessengerCTI_1.07_main_window.PNG]]</center>
 
  
−
===Top panel===
+
'''Presented connection details on smartphone display differ depending on calls setting mode. VoIP call looks different than GSM call due to necessity to use native phone dialer.'''
  
−
[[File:MessengerCTI.Desktop_1.07_main_window_-_upper.png]]
+
'''Example of incoming call made in VoIP mode '''
  
−
* hyperlink to software version
+
Connection setup and conversation are carried out entirely via IP network (WiFi or Internet LTE / HSPA)
−
* application name
+
−
* default window position button
+
−
* close - minimizing to tray button
+
  
 +
<center>
 +
[[File:MessengerCTI.mobile 1.07 Incoming VoIP call1 en.png|250px]]
 +
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
 +
[[File:MessengerCTI.mobile 1.07 Incoming VoIP call2 en.png|250px]]
 +
</center>
  
−
[[File:MessengerCTIDesktop_1.07_main_window_-_middle1.png]]
 
−
* changing application status button
 
−
* user name from Contacts
 
−
* description - editable comment field set by user that allows him to add additional descriptive information, e.g. inform about upcoming or being on vacation, about dealing with selected project
 
  
 +
'''Example of incoming call made in GSM (Call pickup mode)'''
  
−
[[File:MessengerCTIDesktop_1.07_main_window_-_middle2.png]]
+
This mode is based on following:
−
* keyboard - button to open keyboard for dialing numbers with computer mouse
+
* connection for user is incoming connection from Slican PBX (information about connection is sent to smartphone and MessengerCTI application via IP network - WiFi or LTE/HSPA Internet)
 +
* physically, MessengerCTI application initiates outgoing call from user's smartphone to PBX (by GSM provider) and joins connection there, e.g. internal or external
  
−
[[File:MessengerCTI.Desktop_1.07_keyboard_en.png]]
+
In call '''pickup mode''', application user has more possibilities to manage connection than in '''parallel calling''' mode
−
* magnifier/search - button / field for searching for number or subscriber's name
+
  
 +
During call, GSM dialer window with MessengerCTI application "badge" appears.
  
−
[[File:MessengerCTI.Desktop_1.07_main_window_lower.PNG]]
+
<center>
−
* access to tabs:
+
[[File:MessengerCTI.mobile 1.07 Incoming GSM call1 pickup mode en.png|250px]]
−
** Recent - history of most recent calls and messages
+
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
−
** Contacts - phonebook from PBX with sorting options
+
[[File:MessengerCTI.mobile 1.07 Incoming GSM call2 pickup mode en.png|250px]]
 +
</center>
  
−
* red dot - information:
 
−
** about missed calls
 
−
** about calls to be called back in CallCenter
 
  
−
===Bottom panel===
+
'''Example of incoming call made in GSM (Parallel calling mode)'''
−
[[File:MessengerCTI.Desktop_1.07_bottom_panel_en.png]]
+
−
* preferences - access to program settings
+
−
* add contact
+
−
* add to clipboard - sending messages and files between user MessengerCTI.Desktop and MessengerCTI.Mobile
+
−
* creating text conference
+
−
* ACC - subscriber's account login
+
−
* DND - configuration/ activation of "Do Not Disturb" service
+
−
* FWD - configuration/ activation of "Forward" service
+
−
* change size of window
+
  
−
== Status of application and user ==
+
In parallel calling mode, information about caller (via IP network - WiFi, Internet LTE/HSPA) and connection setup (by GSM provider) are initiated in parallel by Slican PBX. During dialing and conversation, GSM dialer window with the MessengerCTI application "badge" appears.
−
'''MessengerCTI.Dekstop''' software allows to show current status of user with coloured symbol and display it inside applications of other users. Applications status is informing about user availability, depending on user actions status can be changed by him or application can change it automatically. More information can be added through text status of user. User can choose different icons/symbol to set his status manually. Additionally there is graphic informing about ringing phone or current call.
+
−
 
+
−
===List of icons and symbols===
+
−
Chart presents list of icons available in '''Contacts''' and '''Recent''' tabs:
+
−
 
+
−
* [[File:MessengerCTI_tv_green.png | 32px]]  - for internal PBX users - different icon color represent current applications status. It can be set manually through main application window, by icon [[File:MessengerCTI_free.png]], also is set automatically for '''Be right back''' status.
+
−
* [[File:MessengerCTI_history.png | 32px]] - for public subscribers.
+
−
* [[File:MessengerCTI_close_door.png | 32px]] - for DPH.IP doorphones connected to open/closed door sensor
+
−
 
+
−
{|{{prettytable}}
+
−
!{{Hl3}} colspan="2" | Status of application and DPH.IP doorphones
+
−
|-
+
−
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning
+
−
|-
+
−
|{{align|center}}|[[File:MessengerCTI_tv_green.png | 32px]]  ||PBX subscriber; '''MessengerCTI.Desktop''' application is running '''and and LOGGED IN'''from subscriber computer. Clicking icon will allow to send text messeger, SMS or dial a call to another application user.
+
−
|-
+
−
|{{align|center}}|[[File:MessengerCTI_chat_tv_yellow.png | 29px]]  ||PBX subscriber; '''Be right back''' set by user or application, delay time is definied in general settings of application.
+
−
|-
+
−
|{{align|center}}|[[File:MessengerCTI_tv_red.png‎ | 32px]]  ||PBX subscriber;  '''Do not disturb''' set by user
+
−
|-
+
−
|{{align|center}}|[[File:MessengerCTI_tv_grey.png | 32px]]  ||PBX subscriber; '''Invisible''' set by user or application is logged off.
+
−
|-
+
−
|{{align|center}}|[[File:MessengerCTI_tvtel_green.png | 32px]]  ||PBX subscriber; application is logged in (application status and icon colour can change with time), access with mobile application is on '''MessengerCTI.Mobile''' (blue smartphone icon)
+
−
|-
+
−
|{{align|center}}|[[File:MessengerCTI_history.png | 32px]]  ||public subscriber; clicking icon will allow to send SMS or dial call to chosen subscriber.
+
−
|-
+
−
|{{align|center}}|[[File:MessengerCTI_close_door.png | 32px]]  ||doorphone; current door position - door closed, clicking icon will open door
+
−
|-
+
−
|{{align|center}}|[[File:MessengerCTI_open_door.png | 32px]]  ||doorphone; door are open
+
−
|-
+
−
|{{align|center}}|[[File:MessengerCTI_alarm_open_door.png | 32px]]  ||doorphone; alarm timer for open doors was set off
+
−
|-
+
−
|}
+
−
'''''Chart 1:''''' Meaning of icon status of application, users and doorphones.<br>
+
−
 
+
−
 
+
−
Chart is showing list if icon that appear on the left side of subscriber name in tab '''Contacts''' and '''Recent'''. Internal phone will have status icon being displayed
+
  
 
<center>
 
<center>
−
{|{{prettytable}}
+
[[File:MessengerCTI.mobile 1.07 Incoming GSM call1 parallel mode en.png|250px]]
−
!{{Hl3}} colspan="2" | Phone status and camera information
+
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
−
|-
+
[[File:MessengerCTI.mobile 1.07 Incoming GSM call2 parallel mode en.png|250px]]
−
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning
+
−
|-
+
−
|{{align|center}}|[[File:MessengerCTI_bell_red.png | 28px]]  ||Phone is ringing
+
−
|-
+
−
|{{align|center}}|[[File:MessengerCTI_phone_red.png | 32px]] || During call
+
−
|-
+
−
|{{align|center}}|[[File:MessengerCTI_phone_DND.png | 32px]] || DND service is enabled
+
−
|-
+
−
|{{align|center}}|[[File:MessengerCTI_camera.png | 25px]] ||Camera is associeted with phone or doorphone, clicking on icon will allow to preview camera video
+
−
|-
+
−
|}
+
 
</center>
 
</center>
−
<center>'''''Tabela 2:''''' Icons displaying status of phone and camera</center>
 
  
−
== Preferences==
 
  
−
Clicking '''Preferences''' icon in main program window will display window with program settings. In every tab there is available button with info "About software" and reseting default window position.
+
In call history, missed call is symbolized in application with icon [[File:MessengerCTIM_no_answer_qty.png|50px]]. Going to '''Last''' tab or callback call clears information about number of missed calls.
  
−
=== Connection===
+
==Calls to Call Center queue==
−
In  '''''Connection''''' field you must enter settings neccesary for application to connect:
+
Tab - [[File:MessengerCTI.mobile 1.07 Last Contacts CC 3.png|250px]] - allows you to handle calls directed to Call Center queues
  
−
<center>[[File:MessengerCTI.Desktop_1.07_connection_en.PNG | 700px]]</center>
 
  
−
'''Application login setting'''
+
User who is agent of Call Center queue, in CC tab, can program up to 4 individual buttons, e.g. logging in / logging out from selected queue, switching on  break.
  
−
To login, application must have correct settings configured by PBX administrator:  
+
With button help, user can perform appropriate activities:
−
* subscriber number - extension from PBX
+
* if he is permanently logged in to given queue, button is permanently green at appropriate queue (it does not respond to touch)
−
* CTI access and password:
+
* if he logs in / out of queue - he uses appropriate button to log in and out and button changes color from black and white to green
−
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/CTI settings''' - '''CTI - access level to CTI''' and '''Pss - Password'''
+
* if he go on break at work - he uses button whose color changes from black - white to yellow
−
** for NCP - '''ConfigWEB''' chart '''Extensions/Subscribers/CTI setting''' - '''Access to CTI''' and '''Password'''
+
−
* Server address - PBX network settings
+
−
CTI access level determines what options are available to application:
+
−
* CTI.user - MessengerCTI without VoIP and camera preview
+
−
* CTI.userPlus - MessengerCTI with VoIP and camera preview
+
  
  
−
These connections settings must be filled:
+
If user belongs to several queues, he can independently, using tabs, switch preview of each of them (status of available agents, number of waiting in queue, list of call-back subscribers)
−
* '''Subscribers number" field -  extension number for which '''MessengerCTI.Dekstop''' will login.
+
−
* '''Password''' field - defined CTI password (may contain from 4 to 16 characters, excluding ";" or "~"). After first application login to PBX password change may be necessary. Password can be remembered in application by putting tag in appropriate field (on right side of the password); if tag is not inserted, application will ask for it every time you log in.
+
−
* '''Server''' - IP address of PBX network interface. In case of application logging outside PBX network - IP address of edge router (port forwarding on router is necessary)
+
  
−
After correct configuration all of above fields, using "Connect" button will allow application to Connect with PBX and synchronize phone book and other information related to that extension. "Login successful" will apear in lower part of window.
+
If user calls back to person displayed in List, he independently decides whether given calls was successful (there are situations when voicemail is reported, called back carries out another conversation, destination subscriber is out of network range, temporarily lacks time, etc.)
  
  
−
If login credentials, configuration settings aren't correct or there are issue with network connection those error messages may appear:
+
Call to Call Center queue is displayed as normal incoming call. If there are unreaded missed calls in tab, a red dot is displayed next to '''CC''' tab.
−
* ''Wrong login or password. Check if correct login or password was used''
+
−
* ''Connecting to PBX'' alternating with:
+
−
* ''No connection to PBX'' Check  IP address that was entered and check computer LAN connection
+
  
  
−
In order to facilitate configuration of application, functionality of generating configuration files sent to user's e-mail box has been introduced in NCP PBX. After receiving e-mail, simply use ''From file'' button to select  right file and application will log in to NCP automatically.
+
<center>
 +
[[File:MessengerCTI.mobile 1.07 CC queue1 en.png|250px]]
 +
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
 +
[[File:MessengerCTI.mobile 1.07 CC queue2 en.png|250px]]
 +
</center>
  
 +
==Chat==
 +
Application allow to send and receive text messages between MessengerCTI.Desktop/ Mobile application user (internal chat).
  
−
In case of problems with application - its stability, functionality, logging, etc. - after detailed description of irregularities, you can submit report using ''Send Logs'' button.
+
To send message, click:
 +
* application status icon [[File: MessengerCTIMD_chat_free.png | 20px]] on left side or message/chat icon on right side of username
 +
* in username and from pop-up menu, select option '''Chat/History'''
  
−
===General===
+
Receiving new message is signaled by sound signal, information on bar/ in the notification window and appropriate icon next to username in call history.
  
−
<center>[[File:MessengerCTI.Desktop_1.07_General_en.png | 700px]]</center>
+
If user uses both MessengerCTI.Mobile and Desktop versions, history of messages between aplications is synchronized.
  
  
−
This window allows to configure settings defining how program works and startup options.
+
Sample message exchange dialog:
−
Available settings:
+
−
*Auto start on System startup - automatic start of application.
+
−
*Start minimized -  application will run hidden in system task bar.
+
−
*Set "Be right back" state after x minutes - status icon will change automatically, informing about user being away from computer after defined time
+
−
*Show call window automatically on incoming call - Enables/ disables popup window when there is an incoming call
+
−
*Choose shortcut for application window - changes application from Windows task bar to desktop and vice versa
+
−
*Choose shortcut for answer/finish call - answer call/ end call with selected keyboard shortcut
+
−
*Use media Play/ Pause button on Headphones to answer/finish cal
+
−
*Choose double click and Enter function (for contact or number):
+
−
**show call window - choice windows is displayed with options - number, phone call, opening chat/SMS window, closing current window
+
−
**call primary number - automatic number dialling
+
−
**show chat window - opens text chat window
+
−
*Return window position - return to previous window position
+
−
*Set this window position as default - allows to set up default application's window potion on screen
+
−
*Clear application data - deletes all application configuration data, attachments, history
+
  
−
===Notifications===
+
<center>
−
These setting allow to set up audio notifications informing about incoming calls,  messages and audio setting of computer audio devices.
+
[[File:MessengerCTI.mobile 1.08 Chat en.png|250px]]
 +
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
 +
[[File:MessengerCTI.mobile 1.07 Chat en.png|250px]]
 +
</center>
  
  
−
<center>[[File:MessengerCTI.Desktop_1.07_Notifications_en.png | 700px]]</center>
+
You can also use standard emoticons in your messages (including text conferences and text announcements described in section below). By clicking on '''Type your message''' field or while typing text, with keyboard activated, special key is available - opening access to emoticons.
  
−
===VoIP===
 
  
−
*Enable VoIP on when available - allows application to work as VoIP client (VoIP phone). Advanced VoIP settings also allow to connect application with PBX on non-standard ports (e.g. from Internet to client's edge router, MAC PBX)
+
<center>
 +
[[File:MessengerCTI.Mobile 1.08 Chat Emoticons 1 en.png|250px]]
 +
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
 +
[[File:MessengerCTI.Mobile 1.08 Chat Emoticons 2 en.png|250px]]
 +
</center>
  
−
<center>[[File:MessengerCTI.Desktop_1.07_VoIP_en.png | 700px]]</center>
+
==Text and voice conference==
  
−
===CallCenter===
+
'''Conference preparation:'''
 +
* on taskbar, select icon [[File:MessengerCTI.mobile_1.07_Taskbar_-_conference en.png|250px]]
 +
* give name
 +
* select and accept participants
  
−
This window allows to configure some options related to agent's handling of CallCenter queues, e.g. buttons for logging in to one, many, all queues, buttons for agent breaks
 
  
−
<center>[[File:MessengerCTI.Desktop_1.07_Call_Center_en.png | 700px]]</center>
+
<center>
 +
[[File:MessengerCTI.mobile 1.08 Conference1 en.png|250px]]
 +
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
 +
[[File:MessengerCTI.mobile 1.07 Conference2 en.png|250px]]
 +
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
 +
[[File:MessengerCTI.mobile 1.07 Conference3 en.png|250px]]
 +
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
 +
[[File:MessengerCTI.mobile 1.07 Conference5 en.png|250px]]
 +
</center>
  
−
===Services management===
 
  
−
This window allows to configure Forwardings and DND services
+
'''Announcement preparation:'''
  
−
<center>[[File:MessengerCTI.Desktop_1.07_Services_en.png| 800px]]</center>
+
An announcement is specific form of conference. It is used to send information unilaterally to many users, without possibility of interaction on their part.
  
 +
Preparing announcement is similar to other conferences (text and voice). When creating it, instead of '''Conference type: Normal''' we choose '''Announcement''' type.
  
−
==Dialing and picking up calls==
 
−
To make phone call between two users, particular hardware, software and proper configuration must be supplied:
 
−
*Slican PBX
 
−
*computer with installed and configured MessengerCTI.Desktop software
 
−
**software logged to PBX with subscriber extension (Settings tab, Connection field)
 
−
*analog, VoIP or Slican system phone
 
−
*for video preview - DPH.IP doorphone with camera or phone associated with external camera (not applicable VoIP phones with integrated camera)
 
  
−
Making and answering phone call can be done using computer mouse and computer screen. Conversation (transmission of acoustics) between subscribers takes place using phone connected to PBX associated with MessengerCTI.Desktop or can be done with application itself - if it's running in VoIP mode.
+
<center>
 +
[[File:MessengerCTI.Mobile 1.08 Announcement en.png|250px]]
 +
</center>
  
−
After dialing required subscriber number from MessengerCTI and initiating connection - in case of:
 
−
* CTS system telephone - PBX will activate acoustics on it in hands-free mode and establish call to destination subscriber
 
−
* VoIP and analogue telephone - PBX will automatically call back telephone first (notify caller that it is ready for call) and, after picking up handset, it will establish call
 
−
* MessengerCTI in VoIP mode (MCTI) - will automatically establish call
 
  
−
==='''Dialing calls to particular number'''===
+
'''Start conference:'''
−
<center>[[File:MessengerCTI.Desktop_1.07_outgoing_call_en.png.png | 400px]]</center>
+
* '''in case of text conference''' - go to main application window and LAST tab, then click on created conference
  
  
−
Making calls can be realised in few different way. Depending on how configured are general setting on application - option "Set double click function".
+
<center>
−
* from '''Contacts''' tab
+
[[File:MessengerCTI.mobile 1.08 Conference 4 en.png|250px]]
−
**choose subscriber from proper group (from drop-down list - if it exist) or from group "All contacts" by double clicking on number or contact
+
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
−
**right-click on subscriber from proper group (from drop-down list - if it exist) and then select one of his numbers (associated with contact details)
+
[[File:MessengerCTI.mobile 1.08 Conference 5 en.png|250px]]
−
**clicking on one of icons next to selected contact: [[File:MessengerCTI_tv_green.png | 32px]]  [[File:MessengerCTI_history.png | 32px]] [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]]  [[File:MessengerCTI_missed_calls.PNG  | 32px]]   [[File:MessengerCTI_messege.PNG | 32px]]  [[File:MessengerCTI_messege1.PNG | 32px]]  and then, after opening '''''Messages window''''' --> '''''Call button'''''
+
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
−
*using numeric keypad of application
+
[[File:MessengerCTI.mobile 1.07 Conference6 en.png|250px]]
−
*'''Search''' field - by enter telephone number directly using computer keyboard, then click on green icon handset associated with field
+
</center>
−
*'''Recent''' tab - call history:
+
−
**we find subscriber call with whom we had contact (he called us or we called him) and then we make call by double clicking on his number or contact
+
−
**right-click on call from/ to subscriber with whom we had contact and then select one of his numbers (related to contact details)
+
−
**clicking on one of icon by past call [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]] [[File:MessengerCTI_missed_calls.PNG  | 32px]]  [[File:MessengerCTI_messege.PNG | 32px]]  [[File:MessengerCTI_messege1.PNG | 32px]] and then, after opening '''''Messages window''''' --> '''''Call button'''''
+
  
  
−
In version 1.03, possibility of selecting digits in DTMF was introduced. This may be applicable in case of a call to Hotline, where you can navigate through menu on active acoustics.
+
* '''in case of voice conference''' - go to main application window and LAST tab, then click on created conference
  
  
−
Exemplary scheme of making call from MessengerCTI directly to another subscriber:
+
<center>
−
<center>[[File:MessengerCTI.Desktop_1.07_outgoing_call_pptx_en.png | 1100px]]</center>
+
[[File:MessengerCTI.mobile 1.08 Conference 4 en.png|250px]]
 +
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
 +
[[File:MessengerCTI.mobile 1.08 Conference 8 en.png|250px]]
 +
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
 +
[[File:MessengerCTI.mobile 1.07 Conference7 en.png|250px]]
 +
</center>
  
  
−
Exemplary scheme of making call from Messenger to hotline:
+
* '''in case of advertisement''' - go to main application window and LAST tab, then click on created advertisement
−
<center>[[File:MessengerCTI.Desktop_1.07_outgoing_call_DISA_pptx_en.png | 1100px]]</center>
+
  
  
−
==='''Incoming calls'''===
+
<center>
 +
[[File:MessengerCTI.mobile 1.08 Announcement 1 en.png|250px]]
 +
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
 +
[[File:MessengerCTI.mobile 1.08 Announcement 2 en.png|250px]]
 +
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
 +
[[File:MessengerCTI.mobile 1.08 Announcement 3 en.png|250px]]
 +
</center>
  
−
<center>[[File:MessengerCTI.Desktop_1.07_incoming_call_en.png]]</center>
 
−
Calls are displayed on computer screen with pop-up window, ringing application and ringing phone. Depending on applied configuration call can be answered, rejected and/ or transferred using application or phone. It is also possible to send text or SMS message back.
 
  
−
==='''Connecting to camera video preview'''===
+
'''Edit conference:'''
−
Connecting to/from DPH.IP with integrated camera or associated phone or external IP camera(doesn't apply to VoIP phone with integrated cameras)will display automatically new window on computer screen. Connecting to doorphone allows to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.
+
* in Participants tab, click [[File: MessengerCTI.mobile 1.07 Conference - edition.png | 40px]]
 +
* changes to settings are possible both when the conference is inactive and during its duration
 +
* available actions are shown in the graphic below
 +
<center>
 +
[[File:MessengerCTI.mobile 1.07 Conference8 en.png|250px]]
 +
</center>
  
−
<center>[[File:MessengerCTI.Desktop_1.07_incoming_call_doorphone_en.png]]</center>
+
=Additional features=
  
 +
==Uploading files and photos==
 +
This functionality is used to exchange files, documents and photos between different users of MessengerCTI application (mobile and desktop)
  
 +
User in '''Contacts''' or '''Last''' tab clicks on application status [[File:MessengerCTI.mobile 1.07 Send file1 en.png |250px]] another user, knocks on sign '''+''' next to field '''''Type your message''''', selects one of available options:
 +
* '''''Attach file'''''
 +
* '''''Attach picture'''''
 +
* '''''Take a photo'''''
 +
then points to file or takes photo and confirms
  
−
===Transfering calls - version 1.07===
+
<center>
−
Call can be transfered by choosing contact or number from: Recent or Contacts.
+
[[File:MessengerCTI.mobile 1.07 Send file en.png|250px]]
−
* "blind transfer" - without checking target extensions state
+
</center>
−
<center>[[File:MessengerCTI.Desktop_1.07_blind_transfer_pptx_en.png | 1200px]]</center>
+
  
 +
==Clipboard==
 +
'''Clipboard''' - it is used to exchange messages, documents and files between Mobile and Desktop versions of user's MessengerCTI application.
  
−
* no announcing - check target extension state without announcing
+
To start it, tap icon  [[File:MessengerCTI.mobile 1.07 Bar clipboard en.png|250px]] and next:
−
<center>[[File:MessengerCTI.Desktop_1.07_transfer_no_announcing_pptx_en.png | 1400px]]</center>
+
* in field '''''Type your message''''' type text, or
 +
* tap '''+''' next field '''''Type your message''''' and select one of available options:
 +
** '''''Attach file'''''
 +
** '''''Attach picture'''''
 +
** '''''Take a photo'''''
 +
and then select file or take a photo and confirm
  
 +
<center>
 +
[[File:MessengerCTI.mobile 1.07 Clipboard en.png|250px]]
 +
</center>
  
−
* with annoucing - check target extension state with announcing
+
==Send location==
−
<center>[[File:MessengerCTI.Desktop_1.07_transfer_with_announcing_pptx_en.png  | 1400px]]</center>
+
  
−
==Sending messages==
+
There is possibility to observe location between MessengerCTI.Mobile users (only with consent of person being watched):
−
Application allow sending and receiving text messages between application users (internal chat) or by SMS. Message can be sent using [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] or by typing GSM number in search field of main application window. If in PBX phone book there is GSM number associated with extension number, user sending message can choose between chat message or SMS.
+
* '''User A asks User B for location permission''' (he has several variants to choose from)
 +
* User B approves request
 +
* User A receives link to google maps with current location of User B
  
  
−
Functionalities that can be implemented through chat window:
+
<center>
−
*running text chats between users of MessengerCTI application (desktop and mobile) of same PBX and linked PBX
+
[[File:MessengerCTI.mobile 1.07 Location1 en.png|250px]]
−
*sending and receiving SMS
+
[[File:MessengerCTI.mobile 1.07 Location2 en.png|250px]]
−
*file transfer (using paperclip button or drag and drop method)
+
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
−
*viewing history calls with given user
+
[[File:MessengerCTI.mobile 1.07 Location3 en.png|350px]]
−
*listen to call recordings from calls made (if you have appropriate permissions)
+
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
 +
[[File:MessengerCTI.mobile 1.07 Location4 en.png|250px]]
 +
[[File:MessengerCTI.mobile 1.07 Location5 en.png|250px]]
 +
</center>
  
−
Receving new message is signalised on Windows system task bar with two icons alternating [[File:MessengerCTI_free.png | 32px]], [[File:MessengerCTI_mail.png | 32px]] and popping up [[File:MessengerCTI_new_message.png]].
 
  
−
Messages history is available through hyper link '''Load previous'''. It is stored on computer local hard drive.
+
or:
 +
* '''User B decides to send location to User A'''
 +
* User B in Contacts or Last tab clicks on status of User A application, knocks on '''+''' sign next to '''Type your message''' field and then selects '''Send location''' option
 +
* User A receives link to google maps with current location of User B
  
−
<center>[[File:MessengerCTI.Desktop_1.07_Window_Chat_SMS_en.png]]</center>
 
  
−
==Searching data==
+
<center>
−
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Recents''' and '''Contacts''' tab in '''Search''':
+
[[File:MessengerCTI.mobile 1.07 Location6 en.png|250px]]
 +
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
 +
[[File:MessengerCTI.mobile 1.07 Location7 en.png|250px]]
 +
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
 +
[[File:MessengerCTI.mobile 1.07 Location4 en.png|250px]]
 +
[[File:MessengerCTI.mobile 1.07 Location5 en.png|250px]]
 +
</center>
  
 +
==Contacts==
 +
'''Contacts''' tab - [[File:MessengerCTI.mobile_1.07_Contacts_en.png|250px]] - allows to view and perform selected actions related to contact. Contacts can be grouped. Access to numbers from other groups can be obtained by expanding list:
 +
* Favourites
 +
* All groups
 +
* All contacts
 +
* Internal
 +
* External
 +
* Private
 +
* plus user-created groups
  
−
<center>[[File:MessengerCTI.Desktop_1.07_Search_field_en.png]]</center>
+
By default, group '''Favorites''' is visible
  
−
During entering characters/signs in search field, software automatically searches in database. Entries found in subscribers group displayed on left field side will be displayed under it. Entries from other group are classified as '''Suggested'''.
 
  
−
== Contacts==
+
<center>
−
This field allows for searching, displaying, customising and running actions related to contact. By default '''Favourites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.
+
[[File:MessengerCTI.mobile 1.07 Contacts2 en.png|250px]]
−
 
+
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
−
<center>[[File:MessengerCTI.Desktop_1.07_Contacts_field_en.png]]</center>
+
[[File:MessengerCTI.mobile 1.07 Contacts3 en.png|250px]]
−
 
+
</center>
−
Adding contacts is possible:
+
  
−
* from search field - entering number and adding it with green handset icon
+
Adding contact to your favorites:
−
* from '''Contacts''' or '''Recent''' tab - right clicking on connection
+
  
−
From contact list we gain access to:
+
In '''Contacts''' tab we hold name of selected subscriber. Confirm when prompted with option '''''Add contact to favorites'''''
−
*favourites
+
−
*all contacts
+
−
*extensions
+
−
*created subscriber groups
+
−
*public contacts
+
−
*private contacts
+
  
 
== Call history ==
 
== Call history ==
−
Choosing '''Recent''' tab - in main program window will display call history of currently logged extension to '''''MessengerCTI.Desktop'''''. Window will look like this.
+
Default tab - [[File: MessengerCTI.mobile 1.07 Call History1 en.png|250px]] - displays history of calls and messages.
  
 +
Each entry in tab signifies at least one call or message. If there were more calls (missed) or messages (unread) from same user, his entry is highlighted (bold) and number calls/messages is displayed in as red dot next to relevant icon.
  
−
<center>[[File:MessengerCTI.Desktop_1.07_Recents_field_en.png]]</center>
 
  
−
History is displaying all calls associated with logged in extension. Each list segment represents at least one call or message. If same subscriber(number)called/send message more then once, contact status icon will show that number. Each segment is showing caller number, his text status(for outgoing calls - chosen number and text status), length of call or call date and time. For extensions call status is also displayed. Beside text information each line have icon status for each call:
+
Each field shows (from left):
 +
* application status icon, icon that user is not using application or door station status
 +
* name (if saved in phonebook)
 +
* caller number
 +
* icon indicating phone call or text message
 +
* date or time when call was made
  
−
[[File:MessengerCTI_outgoing_calls.PNG | 32px]]
+
If tab contains unread missed calls or unread messages, red dot is displayed next to ''' Last '''. From tab it is possible to call back or send back messages. By tapping on username, we go to detailed history of calls and messages.
−
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.
+
  
−
[[File:MessengerCTI_incoming_calls.PNG | 32px]]
+
<center>[[File:MessengerCTI.mobile 1.07 Call History2 en.png|250px]]</center>
−
Downward arrow for incoming call that was picked up.
+
  
−
[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]
+
=Configuring Slican PBX=
−
Turned arrow for missed incoming calls, digit is showing number of these calls.
+
For proper communication between application and PBX are required:
 +
* correct manufacturer license
 +
* specific PBX configuration
 +
==IPx, CCT PBX configuration==
 +
With ConfigMan software:
 +
# Inside '''''Global settings->Global settings/Remain''''' tab: 
 +
## '''ANo''':configure access number that application will chose for making call to PBX and setting up incoming call
 +
## '''Adr''': public host name or PBX IP address for connecting to application (for VoIP calls with application)
 +
# Inside '''Subscribers''' menu, '''''Tables''''' then  '''''Subscribers->Subscribers/CTI settings''''':
 +
## '''AwdMbl''': allow access to MessengerCTI.Mobile application
 +
## '''AwdGSM''': allows to connect phone calls through GSM network
 +
## '''IncC''': setting up method of how application connects incoming calls:
 +
### Call pickup - picking up incoming call with application means making outgoing call with GSM phone to number from '''ANo''' field inside '''''Global settings/Remain'''''
 +
### Parrallel calling - incoming calls to GSM phone from number set in '''ANo''' field inside ''''' Global settings/Remain'''''
 +
## '''MnNo''': configure GSM phone access number, on which application is installed, optionally configure second number (for dual SIM phones)
 +
## '''SecNo''': second GSM phone number with installed application (optional, for dual SIM phones)
  
−
[[File:MessengerCTI_messege.PNG | 32px]]  [[File:MessengerCTI_messege1.PNG | 32px]] [[File:MessengerCTI_message_amount.PNG | 32px]]
 
−
Arrow with listed lines or text bubble for text chat or sent SMS. Digit is showing number of missed messages.
 
−
If history contains missed calls or unread messages icon in '''Recent''' field will be in colour red.
 
  
−
From History window call can be dialled or messages be send to chosen users by right clicking on subscribers text status
+
For application to work with each settings, these fields parameters must be set:
−
, clicking on icons [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] and [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]]  [[File:MessengerCTI_missed_calls.PNG  | 32px]]  [[File:MessengerCTI_messege.PNG | 32px]]  [[File:MessengerCTI_messege1.PNG | 32px]]. If internal subscriber have other number listed in their phone book, choice can be made between them. For internal subscribers there is option of editing, deleting contact and deleting from favourite list.
+
* VoIP network: 1.2, 2.1
 +
* GSM network: 1.1, 2.1, 2.2, 2.3, 2.3.1 or 2.3.2, 2.4 (plus possibly 2.5)
 +
     
 +
<font color=red>'''Minimum PBX firmware version - 6.53, for VoIP - 6.54'''</font>
  
 +
==NCP PBX configuration==
 +
From ConfigWEB application:
 +
# '''''Extensions/ Settings->Informations about CTI settings for subscribers and applications''''' menu, configure:
 +
## Public host name or PBX IP address for XML Slican protocol - domain name or IP address for exchanging/synchronisation information and data between application and PBX
 +
## Public host name or PBX IP address for VoIP calls  - domain name or IP address for configuring VoIP calls
 +
## PBX number for GSM calls - which will call GSM phone with installed application to call PBX or PBX to application and set up call (in configuration with support for connections via GSM network)
 +
# configure subscribers for SIP, FXS, CTS, MCTI with '''''Extensions/Subscribers-> Subscriber/CTI Settings/MessengerCTI.Mobile'''''
 +
## Allow access to MessengerCTI.Mobile application
 +
## if using GSM network allow phone calls handling using GSM
 +
### set up GSM phone access number for device with installed application
 +
### set up second GSM phone number with installed applicatio (optional, for dual SIM devices)
 +
## set up incoming calls handling
 +
### call pickup - picking up incoming call with application is achievied by GSM phone making outgoing call to number set in '''''Extensions/ Settings/ Informations about CTI settings for subscribers and applications/ Phone number to call this PABX using GSM connection'''''
 +
### Parallel calling - incoming call to GSM phone from number set with '''''Extensions/ Settings/ Informations about CTI settings for subscribers and applications/ Phone number to call this PABX using GSM connection'''''
  
−
== Clipboard ==
 
  
−
Clipboard is used to transfer messages/ information/ files between MessengerCTI.desktop and MessengerCTI.mobile of same user. When you put file in one application, it automatically appears in other application.
+
For application to work, these fields must be set:
−
 
+
* VoIP: 1.1, 1.2, 2.1
−
<center>[[File:MessengerCTI.Desktop_1.07_Clipboard_tab_en.png]]</center>
+
* GSM: 1.1, 1.3, 2.1, 2.2, 2.2.1, 2.2.2, 2.3 and 2.3.1 or 2.3.2
−
 
+
−
 
+
−
== Text conference ==
+
−
 
+
−
Functionality introduced for simultaneous exchange text messages between multiple users. User calling '' conference '' selects users to attend. After approval list, message is automatically sent to each of them. After joining conference, sent message is delivered to each user. Each user sees both information exchange and other users participating in conference.
+
−
 
+
−
 
+
−
<center>[[File:MessengerCTI.Desktop_1.07_Text_conference_tab_en.png]]</center>
+
−
 
+
−
 
+
−
== Recall another user's account ==
+
−
 
+
−
This functionality was introduced for users working in same place at different times (e.g. shift work) and using same phones and computers. Logging in with your own account number allows you to later correctly settle each employee's tasks and working time.
+
−
 
+
−
<center>[[File:MessengerCTI.Desktop_1.07_Account_tab_en.png]]</center>
+
−
 
+
−
 
+
−
=MessengerCTI.Desktop for Call Center agents=
+
−
From NCP 1.12 firmware NCP and MessengerCTI.Desktop version 1.02, application includes features for servicing Call Center queues. For application user which have Call Center permissions set in PBX - Windows system tool bar will have additional icon '''Agents status''' and additional tab '''CC''' in application itself.
+
−
 
+
−
 
+
−
Application state icons:  
+
−
* application logged: [[File:MessengerCTI.Desktop_log_in.png | 40px]]
+
−
* application state: '''Be right back''' [[File:MessengerCTI.Desktop_brb.png | 40px]]
+
−
 
+
−
Red dot by application state informs about unanswered call or message waiting for user.
+
−
 
+
−
 
+
−
Agents state icons:
+
−
* agent logged to queue: [[File:MessengerCTI.Desktop_agent_log_in.png | 40px]]
+
−
* agent pause: [[File:MessengerCTI.Desktop_agent_pause.png | 40px]]
+
−
* agent logged out of queue: [[File:MessengerCTI.Desktop_agent_log_out.png | 40px]]
+
−
Red dot by agent state icons informs about calls unanswered by CC agents.
+
−
 
+
−
 
+
−
'''CC''' tab within application, depending on configuration is showing:
+
−
* up to 4 programmed buttons with present state for current agent: '''Log in/out of CC queue''' and '''Turn on/off agent pause'''
+
−
* serviced queues with amount of logged agents and waiting calls
+
−
* Callback list - numbers/contacts to call back
+
−
 
+
−
 
+
−
<center>[[File:MessengerCTI.Desktop_1.07_Call_back_tab_en.png]]</center>
+
−
 
+
−
When using callback list, additional window will apear allowing to make call and field to confirm if call was successfull.
+
−
 
+
−
 
+
−
To properly configure '''CC''' tab, '''Call Center''' sections within application preferences must be set up.
+
−
 
+
−
<center>[[File:MessengerCTI.Desktop_1.07_Call_Center_en.png]]</center>
+
−
 
+
−
 
+
−
=Licensing=
+
−
==IPX, MAC, CCT PBX==
+
−
MessengerCTI.Desktop application:
+
−
* ALWAYS MUST be associated with subscriber port, analogue, system or VoIP; for subscriber ports standard licensing applies - for associating with VoIP port, 1 VoIP for subscriber license is necessary.
+
−
* for configuration using VoIP functionality (working as parallel phone) there isn't need to associate application with VoIP port, it is application functionality, it can be associated with any type of subscriber port
+
−
* calls made form application in VoIP mode are using VoIP channels just like other VoIP devices
+
−
* MessengerCTI.Desktop configured without VoIP and camera preview access - CTIuser license is required
+
−
* MessengerCTI.Desktop configured with VoIP and camera preview access - CTIuserPlus license is required
+
−
 
+
−
==NCP PBX==
+
−
MessengerCTI.Desktop:
+
−
* CAN be associated with any subscriber port - analogue, system or VoIP; each subscriber port is treated as 1 user from Base license, additionally while associating application with VoIP port 1 NCP.VoIPuser license is neccesary
+
−
** for configuration using VoIP functionality (working as parallel phone) there isn't need to associate application with VoIP port, it is application functionality, it can be associated with any type of subscriber port
+
−
** MessengerCTI.Desktop configured without VoIP and camera preview access - NCP.CTIuser license is required
+
−
** MessengerCTI.Desktop configured with VoIP and camera preview access - NCP.CTIuserPlus license is required
+
−
* MessengerCTI.Desktop as standalone subscriber - MCTI (not associated with subscriber port):
+
−
** MessengerCTI.Desktop with VoIP funcionality and camera preview access - NCP.VoIPuser and NCP.CTIuserPlus licenses are required
+
−
 
+
−
 
+
−
=One user and few different numbers=
+
−
Sometimes one computer use must operate with few different extensions numbers. On workstation (computer) use of "instance" is neccesary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create seperate configuration.
+
−
 
+
−
* default location of program instalation is:  C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe
+
−
** if program can't be found in default location, Windows search option or through Start Menu. For Windows 10, open Start Menu, search for Slican directory, in directory look for MessengerCTI, right click -> More/ Open File Location - program icon will appear, right click -> Properties/Shortcut/Target
+
−
* create program shortcut on desktop
+
−
* in shortcut properties add instance - Properties/Shortcut/Target: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''
+
−
* create as many copies of shortcut as needer for user, in each next one change instance digit for next number, for example: '''-instance 2''', '''-instance 3''', ...
+
−
* while running aplication from shortcuts we can configure each one seperatly for different numbers
+
  
 +
     
 +
<font color=red>'''Minimum PBX firmware version - 1.11, for VoIP - 1.12'''</font>
  
−
=Ports and protocols=
+
=Ports and protocols =
−
Default port numbers and types of protocols used by PBX for purpose of providing selected services of MessengerCTI application.
+
Default port numbers and protocol types used by PBX for purposes of providing selected services of MessengerCTI.Mobile application.
  
 
'''Basic:'''
 
'''Basic:'''
−
* signaling
+
* signalization
 
** 5529 TCP - application signaling (XML)
 
** 5529 TCP - application signaling (XML)
−
** 5543 TCP - signaling in mode with enabled encryption tag (XML)
+
** 5543 TCP - signaling in enabled encryption tag mode (XML)
 
* VoIP calls
 
* VoIP calls
 
** 5060 UDP - SIP signaling (for VoIP calls)
 
** 5060 UDP - SIP signaling (for VoIP calls)
−
** 8100 - 8300 UDP - acoustics - for IPx, CCT, MAC PBX
+
** 8100 - 8300 UDP - acoustic - for IPx, CCT, MAC PBX
−
** 10000 - 20000 UDP - acoustics - for NCP PBX
+
** 10000 - 20000 UDP - acoustic - for NCP PBX
  
 
'''Additional:'''
 
'''Additional:'''
−
* file transfer - NCP only (clipboard, between users):
+
* file transfer - only NCP (clipboard, between users):
−
** 443 TCP - file transmission without encryption tag enabled (transmission is still HTTPS encrypted)
+
** 443 TCP - file transfer without encryption tag enabled (transmission is still HTTPS encrypted)
−
** 5543 TCP - file transmission in mode with enabled encryption tag
+
** 5543 TCP - file transfer of files with encryption tag enabled
 
* image transmission from DPH.IP doorphone camera
 
* image transmission from DPH.IP doorphone camera
−
** location of link to camera in PBX:
+
** link to camera in PBX location of:
−
*** NCP: Extensions/ Devices/ Cameras
+
*** NCP: Extensions/Devices/Cameras
−
*** IPx, MAC, CCT: Peripherals/ Cameras
+
*** IPx, MAC, CCT: Pheripherals/Cameras
−
** during connection, PBX sends camera link to MessengerCTI application: rtsp://IP_addr_camera:554/login_password_additional_information
+
** During a call, PBX sends camera link to application MessengerCTI: rtsp://IP_address_camera:554/login_password_additional_information
  
  
−
'''Example for NCP for MessengerCTI working from outside PBX IP network (configuration in ConfigWEB):'''
+
'''Example for NCP for MessengerCTI working from outside NCP IP network (configuration in ConfigWEB):'''
−
* XML signaling, VoIP, file transmission - Extensions/ Settings/ Informations about CTI settings for subscribers and applications tab
+
* XML signaling, VoIP, file transfer - Extensions/Settings/Informations about CTI settings for subscribers and applications tab
−
* sending image from camera (link to camera, linking camera with DPH.IP) - tab Extensions/ Devices/ Cameras
+
* image transmission from camera (camera link, camera link to DPH.IP) - Extensions/Devices/Cameras tab
  
  
 
'''Sample configuration data:'''
 
'''Sample configuration data:'''
−
* IP PBX address: 192.168.0.10
+
* PBX IP address: 192.168.0.10
−
* public IP router address: 222.0.0.1
+
* router public IP address: 222.0.0.1
 
* domain address: company_name.com
 
* domain address: company_name.com
−
* IP camera address: 192.168.0.20
+
* camera IP address: 192.168.0.20
 
* ports used to redirect individual services on router: 55xx
 
* ports used to redirect individual services on router: 55xx
  
Line 819: Line 797:
  
 
'''VoIP calls (signaling)'''
 
'''VoIP calls (signaling)'''
−
* MessengerCTI --> 222.0.0.1:5556 --> 192.168.0.10:5060
+
* MessengerCTI --> 222.0.0.1:5556 --> 192.168.0.10:5060, or
 
* MessengerCTI --> company_name.com:5556 --> 192.168.0.10:5060
 
* MessengerCTI --> company_name.com:5556 --> 192.168.0.10:5060
  
−
'''VoIP calls (acoustics)'''
+
'''VoIP calls (acoustic)'''
−
* MessengerCTI --> 222.0.0.1:10000 - 222.0.0.1:20000 --> 192.168.0.10:10000 - 192.168.0.10:20000
+
* MessengerCTI --> 222.0.0.1:10000 - 222.0.0.1:20000 --> 192.168.0.10:10000 - 192.168.0.10:20000, or
 
* MessengerCTI --> company_name.com:10000 - company_name.com:20000 --> 192.168.0.10:10000 - 192.168.0.10:20000
 
* MessengerCTI --> company_name.com:10000 - company_name.com:20000 --> 192.168.0.10:10000 - 192.168.0.10:20000
  
Line 834: Line 812:
 
* MessengerCTI --> company_name.com:5559 --> 192.168.0.10:5543
 
* MessengerCTI --> company_name.com:5559 --> 192.168.0.10:5543
  
−
'''Image transferring from DPH.IP camera'''
+
'''Image transmission from DPH.IP camera'''
−
* MessengerCTI --> router --> camera
+
* MessengerCTI --> ruter --> camera
−
* MessengerCTI --> 222.0.0.1:5560 --> 192.168.0.20:554
+
* MessengerCTI --> 222.0.0.1:5560 --> 192.168.0.20:554, or
−
* MessengerCTI --> company_name.com:5560 --> 192.168.0.20:554.
+
* MessengerCTI --> company_name.com:5560 --> 192.168.0.20:554
  
−
 
+
=Operation in local network and outside local network without changing MessengerCTI configuration=
−
=Operation of MessengerCTI.Desktop in local network and outside network without changing configuration=
+
If MessengerCTI.desktop or MessengerCTI.mobile application user is on move, his IP network source may change (np. LAN <--> Internet LTE, HSPA <--> LAN, work <--> travel <--> home) it may results need to change application configuration, i.e. change IP address of PBX from local to public or vice versa (situation does not take place if user uses LTE/HSPA internet only)
−
Changing network source by MessengerCTI.desktop or MessengerCTI.mobile user (e.g. LAN <--> Internet <--> LAN, workplace <--> travel <--> home) always entails need to change application configuration, i.e. change IP address of PBX from local to public or vice versa.
+
  
  
 
In order to simplify operation and configuration of MessengerCTI application, you can use functionality offered by many network routers.
 
In order to simplify operation and configuration of MessengerCTI application, you can use functionality offered by many network routers.
−
It allows device with MessengerCTI (computer, smartphone) connect to PBX, regardless of whether it is in local network (LAN, WiFi) or outside it (other sub-networks, Internet, GSM-LTE). In routers, this functionality is called NAT hairpinning, NAT loopback or NAT reflection. It allows access to PBX service via public IP address, regardless of range of network user is currently in.
+
It allows device with MessengerCTI (notebook, smartphone) to connect to PBX, regardless of whether it is in local network (LAN, WiFi) or outside it (other sub-networks, Internet, GSM-LTE). In routers, this functionality is called NAT hairpinning, NAT loopback or NAT reflection. It enables access to service via public IP address, regardless of range of network user is currently in.
  
  
 
Sample network:
 
Sample network:
−
* router's public address (WAN on router): decimal address - 203.0.113.1 or domain address - voip.xxxxxx.com
+
* router's public address (router's WAN): decimal address - 203.0.113.1 or domain address - voip.xxxxxx.com
−
* router's local address (LAN on router, gateway): 192.168.1.1
+
* router's local address (router's LAN, gateway): 192.168.1.1
−
* LAN PBX address (NCP, IPx, MAC, CCT): 192.168.1.2
+
* PBX address (NCP, IPx, MAC, CCT) in LAN network: 192.168.1.2
−
* LAN IP address user's notebook with MessengerCTI.Desktop or smartphone with MessengerCTI.Mobile: 192.168.1.100
+
* user's notebook address with MessengerCTI.Desktop or smartphone with MessengerCTI.Mobile in LAN: 192.168.1.100
  
 +
If MessengerCTI from notebook/ smartphone from local network - IP address 192.168.1.100 - send packets to public address 203.0.113.1 (voip.xxxxxx.com), packets are routed to default gateway - 192.168.1.1 (router) by default. NAT hairpinning router detects that 203.0.113.1 (voip.xxxxxx.com) is address of its WAN interface and treats packets as if it were coming to that interface. Determines destination for those packets based on DNAT (port forwarding) rules. If packets have been sent to port 5529 (for VoIP: 5060, 8100-8300 for IPx, 10,000 - 20,000 for NCP) and there is DNAT rule for this port directed to 192.168.1.2, then PBX receives packets at this address.
  
−
If MessengerCTI on notebook/ smartphone from local network IP: 192.168.1.100 sends packets to public address 203.0.113.1 (voip.xxxxxx.com), packets are routed to default gateway - 192.168.1.1 (router). NAT hairpinning router detects that 203.0.113.1 (voip.xxxxxx.com) is address of its WAN interface and treats that packets as if it came from that interface. Determines destination for this packets based on DNAT rules (port forwarding). If packets has been sent to port 5529 (for VoIP: 5060, 8100-8300 IPx, 10,000 - 20,000 NCP) and there is DNAT rule for this port directed to 192.168.1.2, then PBX receives packets at this address.
 
  
 +
If appropriate DNAT rules exist, address translation is performed - router rewrites source local IP address in packets to public address. Notebook/ smartphone (192.168.1.100) sends packets, and PBX (192.168.1.2) receives it as coming from 203.0.113.1. When PBX responds, process is same as for notebook/ smartphone. In this way, two-way communication between notebook/ smartphone in LAN via public IP address is possible.
  
−
If appropriate DNAT rules exist, address translation is performed - router rewrites source local IP address in within packet to public address. Notebook/ smartphone (192.168.1.100) sends packets, but PBX (192.168.1.2) receives it as coming from 203.0.113.1. When PBX responds, process is same as for notebook/ smartphone. In this way, two-way communication between notebook/ smartphone in LAN via a public IP address is possible.
+
=Use cases examples=
 +
'''''MessengerCTI.Mobile''''' application is useful tool for companies that employ mobile workers which requires constant access to phone with internal number of phone system. <br>
 +
These employees can be a good example:
 +
* sales department - working in different locations, office <-> outside office
 +
* service support - constant fieldwork
 +
* remote worker - remote work
 +
* mobile worker - working on vast area(production halls, vast areas) -where Wifi or DECT network range won't be adequate
  
 +
=Installing beta version=
 +
"Beta" version contains new functionalities which will be added in next production version but not all of planned functions are implemented. This version also cointains fixes for error submited for earlier versions. It was initialy tested.
 +
 +
Becoming beta tester and installing "BETA" version of MessengerCTI.mobile application can be done via '''Play Store''' application or by activating appropriate link on ServNET server:
 +
 +
 +
#Activating access to '''BETA''' app from '''Play Store''' app:
 +
* run and log in to [[File:Play Store.png.jpg|50px]]
 +
* in application search field enter '''slican messengercti'''
 +
* click on name of MessengerCTI application, after opening new one, find text '''Join the beta testing program''', click on appropriate field
 +
* after a while, MessengerCTI (beta) description and Update button will appear
 +
 +
<center>
 +
[[File:MessengerCTI.mobile 1.08 Beta.png|250px]]
 +
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
 +
[[File:MessengerCTI.mobile 1.08 Beta1.png|250px]]
 +
[[File:MessengerCTI.mobile 1.07 Pusty.png|50px]]
 +
[[File:MessengerCTI.mobile 1.08 Beta2.png|250px]]
 +
</center>
 +
 +
 +
# Activation of access to '''BETA''' application from ServNET server or http link:
 +
In this case:
 +
* log in from your computer or phone browser to your Google account. If you have more than one Google account, it's important to sign in to the account that's set up on your phone
 +
* log in to server [https://slican.pl/servnet/pliki/servnet/#P190 ServNET and select link associated with description of MessengerCTI.Mobile (beta version)], or
 +
* click following link: [https://play.google.com/apps/testing/com.slican.messengercti Beta Registration]
 +
 +
On www page you will see the following information:
 +
 +
 +
<center>[[File:Google beta en.png]]</center>
 +
 +
 +
Click button '''BECOME A TESTER''' to sign up for testing
 +
 +
 +
Going back to phone configuration: <br>
 +
* because Google Play updates can be delayed, it is recommend to turn of Play Store application before installing MessengerCTI
 +
* clicking on shortcut will start Play Store again. Search for MessengerCTI application. It is recommended due to the large number of available ''Messenger''' applications, it is worth adding the name '''Slican''' to the search
 +
* install upgrade application
 +
* configure according to manual
  
−
If no DNAT rules are active, router will discard packets. In this case, it may return an ICMP Destination Unreachable reply.
+
We're excited about new features that are only available to select person.
−
=---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------=
+

Latest revision as of 14:41, 20 February 2023

Aplication structure

MessengerCTI.Mobile 1.07 Main page en.png

Introduction

MessengerCTI.Mobile Slican Software is mobile application dedicated for Android operating system. It integrates smartphone, computer and subscriber's desk phone. MessengerCTI.Mobile allows users making and receiving calls as PBX subscriber, transferring calls to another subscriber, using contact book, history of calls, conducting chat and text conferences, viewing phone and MessengerCTI status of other subscribers and transferring files. Video image preview function is available for PBX that support DPH.IP doorphones equipped with camera. Application supports calls related to Call Center queues - PBX subscribers/ agents are mobile and independent of their permanent workplace. Functionally, MessengerCTI.Mobile is fully synchronized with MessengerCTI.Desktop, so regardless of version used (mobile, desktop) it always ensures work with up-to-date data.

Application advantages

  • handling voice calls in VoIP mode both via GSM operator's Internet network (LTE, HSPA) and WiFi network
  • handling voice calls in GSM mode
  • chat, text conference and text announcements
  • voice conference
  • access to contact book with preview of other subscriber's availability status (chat, phone status, description, application)
  • creating favorites group
  • history of recent calls / chats - sorted chronologically
  • full synchronization with MessengerCTI.Desktop application
  • logging in as parallel phone to deskphone or as separate MCTI subscriber (only in NCP PBX)
  • possibility to copy text from / to chat
  • flexible configuration of sound and vibration notifications with possibility of using schedules
  • access to configuration of selected PBX services (FWD, DND)
  • quick reference numbers for fast call transfer
  • ability to set desk phone busy if user's smartphone is busy (enabled by default)
  • rejection calls on user's GSM smatphone if deskphone is busy
  • ability to use DualSIM smartphones or two phones at same time (business and private)
  • convenient door opening in case of calls from DPH.IP doorphone (from application connection window, contact context menu or desktop widget)
  • automatic notification delay mechanism MessengerCTI.Mobile if subscriber is active on desk phone or on MessengerCTI.Desktop application
  • ability to copy contacts from PBX contact book to local smartphone book
  • sharing your own location
  • ability to transfer photos and files (drag & drop)
  • handy clipboard for sharing data between mobile and desktop application
  • support for emoticons
  • making calls from external number sources
  • available in Google Play store (free)


Warning!

For proper operation of application and calls, following are required:

  • permanent access to WiFi or Internet from smartphone with MessengerCTI.Mobile application
  • permanent access to LAN and Internet for PBX
  • if MessengerCTI.Mobile works via Internet - domain address or permanent public IP address of PBX, or if PBX is located in local network behind NAT - on edge router it is necessary to redirect some ports to its IP address. Description of port forwarding configuration is presented below in Ports and Protocols chapter
  • MessengerCTI.userPlus license per user at PBX
  • optional, depending on adopted configuration - license for VoIP subscribers in NCP or subscribers and VoIP channels in IPx, MAC, CCT exchanges
  • opening door using context menu or widget available only after starting ACS system


Basic Features

Using smartphone, application user gains mobility and still has option of using PBX as internal subscriber.

VoIP and GSM client

  • MessengerCTI.Mobile - parallel telephone, associated with equipment of desk phone (FXS, CTS, SIP). Application can work as VoIP or GSM client. User decides on which device to answer call and make call - by desk phone or smartphone. Novelty is possibility of using application as standalone telephone in NCP (from firmware version 1.11). CTIuserPlus license is required for its correct operation.
  • Configuration in VoIP mode - basic configuration for using application. Both calls made and other information, e.g. about the caller's number, contacts in book, subscriber status, chats - are sent over IP network (WiFi, LTE/ HSPA Internet)
  • Configuration in GSM mode - it is most often used if access to IP network or Internet in given location is weak (insufficient for VoIP calls) or unstable. All information and signaling - are still sent via IP network (WiFi, LTE / HSPA), but calls themselves are carried out by GSM operator. With poor IP transmission quality, you should take into account that information may not always be displayed.

Switching between VoIP and GSM mode can be done by user from application configuration (if PBX is properly configured).

Phone Book

Big advantage of software is simple and convenient access to contact from phone books and displaying them on computer screen. MessengerCTI.Mobile can use only phone books from PBX. Contacts can be sorted according to user needs. Adding new subscribers and modification of existing entries can be done from CTS system phone or more conveniently, by using computer with MessengerCTI.Desktop or WebCTI. Modification of entry is visible instantly after adding it. Access to phone book allows to simply search numbers of contacts user want to call. On other hand, during incoming calls computer displaying will be showing clear information about calling person.

Call History

User has access to complete history of their calls, picked up and missed one. History is saved on Slican PBX. By using Messenger.CTI history can be displayed alongside information about order, time of calls and number of missed calls from particular number.

CallCenter (NCP PBX)

In conjunction with NCP for Call Center agents, queue handling functionality has been introduced. It allows agents to log in to them, view status, call back lost and abandoned calls, and turn on status of temporary work breaks.

Text messages

By MessengerCTI text information can be sent, from internal messenger (chat) through computer network to another person with MessengerCTI.Desktop or MessengerCTI.Mobile. Chat can be used by all subscribers of given PBX and other PBX linked with eSSL ver.2 system. This functionality is especially attractive for those companies which, having Slican PBXes, do not allow use of public communicators for security reasons. To ensure parallel access from various devices (computer, smartphone), chat history is saved directly in PBX and synchronized with MessengerCTI applications on ongoing basis. An extension of this functionality is possibility of conducting chat with many users simultaneously, i.e. so-called text conference.

Text and voice conferences

Functionality that allows to PBX messages / talk simultaneously with many users

Uploading files

It is possible to send files, e.g. photos, documents, between users of MessengerCTI application (desktop, mobile)

Location sharing

Due to mobility - user can turn on selected people observation of his location. Authorized person gains ability to observe its location.

Using cameras and DPH.IP doorphones

Introduction to sale of DPH.IP doorphones that include cameras allowed to solution that allows display of video from these cameras. Functionality was added with MessengerCTI.Mobile. While connecting to doorphone from software video from camera will appear in new window on computer display. After starting call and next finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door, gate, barrier using dedicated button. Reverse is also true, calling to doorphone or another telephone associated with camera, computer display will show video from their cameras. This allow for temporary observation of neighborhood of installed camera, for example person we are calling. There is also option of watching video from any camera without making call, just using application icon. Thanks to MessengerCTI.Mobile user can preview video from camera of other manufacturers, but those devices have to support video formats, codec compatible with VLC application libraries.

Works with desktop version

Application can be used alongside and synchronized to MessengerCTI.Desktop, that is version for computer with Windows.

Minimum requirements

MessengerCTI.Mobile application is freely available - it can be downloaded from Google Play store..

For installing application minimum requirements must be met:

  • Android operating system
    • minimum version: Android 6.0 Marshmallow
    • minimum recommended version: Nougat 7.0
    • PBX and application must have access to internet

Phone with lower version of operating system then 6.0 won't be able to install application.

Attention!

While using for VoIP calls we recommended Android version 7.0 or higher due:

  • better call stability
  • option of automatic regaining voice connection after reloging to network or changing IP
  • option of ajusting microphone gain for VoIP calls

Warning!

MessengerCTI.Mobile application works with IPx, MAC and CCT PBX with firmware version 6.53 or higher and NCP PBX 1.11
VoIP with application is supported for IPx, MAC and CCT with firmware 6.54 and NCP firmware 1.12


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).


During installation, you are prompted to provide some permissions. They may vary depending on Android version and phone type. You can approve all of them or select only those related to functionalities that will be used:

  • Camera - for scanning QR code (configuration) and taking and sending photos
  • Location - to share your location
  • Microphone - for making VoIP calls
  • Internal memory - for saving photos, transferring files and using clipboard
  • Phone - for using application in GSM mode
  • Contacts - for copying contacts to local phone database (used only in some versions of application)
  • Displaying above other applications - should be made, available so that you can answer call correctly when application is, for example: deep sleep
  • Disable battery optimization - Battery optimization for app must be disabled to prevent it from going into deep sleep


Warning!

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 on 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 bottom left corner of application window. From drop down menu Settings menu can be chosen.

Fields required for configuration can be found here: account, notifications, handy numbers.

Settings

Account

Configured with information configured by PBX administrator:

  • Your telephone number: internal subscriber number (extensions) with access to CTI communication
  • Password: CTI user password
  • Host: port: domain or public IP address of PBX for users outside network or private IP address for users of local network, signaling protocol port: port for communication with PBX - by default TCP 5529
  • Transmission encoded: XML Protocol Encryption
  • Self-signed certificate
  • Read data from QRCode: instead of manual configuration - ability to scan QR code sent from NCP to user's e-mail box when configuring CTI settings or from WebCTI website
  • Advanced/Port signaling protocol: communication port PBX - default for PBX is TCP 5529


MessengerCTI.Desktop 1.07 Account configuration en.png

Using QRcode from WebCTI -> My subscriber account or link to code sent to user's e-mail address (only in NCP PBX with properly configured e-mail client)


MessengerCTI.Desktop 1.07 Account QRcode en.png

Calls

Options for activating headset button and microphone gain level

MessengerCTI.Desktop 1.07 Settings Calls en.png


Call Center

Possibility to activate up to 4 login/ logout buttons and agent breaks related to Call Center queues

MessengerCTI.Desktop 1.07 Settings Call center en.png


Other

Pozostałe ustawienia aplikacji widoczne są na załączonej grafice.

Debug option - turned on at request of software vendor (Slican) - is related to solving problems with correct operation of application

Enabling option causes that in tab About additional field appears Send logs via email. We choose e-mail client from which we will send application logs for analysis on Slican side.

MessengerCTI.Desktop 1.07 Settings Other en.png

Services

Calls services configuration:

  • Default connection type - settings for making calls via GSM, VoIP or VoIP over WiFi
  • Global services for PBX:
    • DND - do not disturb
    • Deskphone is busy when GSM is talking - during call on GSM phone - primary phone (deskphone) and thus MessnegerCTI.mobile application is not supposed to ring during incoming calls (test functionality, it does not work with every GSM phone)
    • FWD - call forwarding settings: all, busy or no answer

My desription

Setting your own comment, which will be visible to other users of MessengerCTI application (desktop and mobile) and on screen of CTS-330 system phone

Notifications

Configuring incoming call notifications:

  • ringtone: selecting one from list available in application with option to mute it after specified time
  • turn off ringing after x seconds - setting optimal length of ringing time
  • vibration when ringing
  • notification schedule for call ringtone - set weekly active use plan (ringtone in selected time ranges)


Configuring missed calls notifications:

  • notify about missed call - if missed call happens, MessengerCTI icon with option to preview message will appear on Android notification bar, in upper part of smartphone screen


Configuring chat message notifications:

  • notify about chat messages - enable notifications
  • message tone: selecting one from the list available in application
  • vibration on message
  • notification schedule for chat message - set weekly active use plan (notifications in selected time ranges)


Notifications based on activity on other devices::

Functionality that allows to enable intelligent response to incoming call/notifications of MessengerCTI.mobile application. It introduces 10-second delay notification MessengerCTI.mobile relative to ringing associated phone (usually deskphone).

After starting MessengerCTI.mobile - desk phone and application will ring simultaneously during incoming call. If we answer first to desk phone, application will "remember" that we nearby phone and will delay ringing application during next call.


It ceases to apply when:

  • we will not answer call
  • we will pick up call with MessengerCTI.Mobie

Quick transfer

List of 3 most important user reference numbers (extensions or outside from PBX) displayed during call for easy call transfer.

About

Information about:

  • Own number: PBX ext. number to which application is logged in
  • Own comment: subscriber comment
  • Current application version
  • Type and number of connected PBX
  • PBX firmware version
  • XML encoding
  • Battery optimization
  • Privacy policy
  • Used libraries
  • Link to send application logs

Updating application

Application is updated automatically and user can its course in accordance with settings of automatic updates of given phone application for Google account holders. If new version appears in Google Play Store, newer version will be automatically downloaded or notified.

Application structure

Main window

Main application windows give access to following tabs:

  • Last - window related to history of calls and sent messages along with subscriber status in PBX
  • Contacts - access to PBX phone book with sorting options: favourites, internal, external.
  • CC - handling calls from Call Center queues, possibility to log in/ out and call back


Additionally:

  • Application login status icon with default connection type
  • Configuration menu - application and service settings
  • Silence ringtone - silence ringtone and app notifications immediately
  • Clipboard - for sharing files, photos, data between mobile and desktop application
  • Search - searching contacts by name and number
  • Creating conference
  • Keyboard - selection digits of target number
MessengerCTI.Mobile 1.07 Main page description en.png

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

Application startup window - MessengerCTI.mobile 1.07 Last Contacts CC en.png - shows history of last calls.

This view includes following icons:

  • on left: application status of MessengerCTI.Mobile user
  • right: informing about phone call or message status

Table 1 presents description of meaning of individual icons informing about application status of other MessengerCTI.Desktop/ Mobile users:

  • for PBX internal subscribers - icons symbolizing application's login status, touching status icon allows you to start chat or check call history
  • for DPH.IP doorphones - current position of door, and by touching icon symbolizing door, you can enter history
  • for contacts from outside PBX - checking call history
Icon Icon meaning
MessengerCTID free.png user logged in
MessengerCTID be right back.png status: "Be right back"
MessengerCTID chat busy1.png status set by user "Do not disturb"
MessengerCTID chat no login.png user logged out, not available or status is set to "Hidden"
MessengerCTIMD chat free.png Desktop application status with configured Mobile version
MessengerCTIM chat DND.png calls and messages history
MessengerCTIM door open.png DPH.IP doorphone: door open
MessengerCTIM door closed.png DPH.IP doorphone: door closed
Table 1: Icon shows status of application, users and doorphones.

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

Ikona Icon meaning
MessengerCTIM call.png number is busy
MessengerCTIM ringing.png calling number or making outgoing call
MessengerCTIM failure1.png number is not available or faulty
MessengerCTIM DND.png DND service is on
Table 2: Icons displaying phone status

Table 3 shows meaning of icons displaying calls status:

Icon Icon meaning
MessengerCTIM incom call.png incoming call
MessengerCTIM out call.png outgoing call
MessengerCTIM no answer qty.png new missed call
MessengerCTIM no answer.png missed call
Table 3: Icons displaying calls.

Table 4 shows icons displaying message status:

Icon Icon meaning
MessengerCTIM incom chat.png Message received
MessengerCTIM out chat.png Message sent, read
MessengerCTIM no answer chat.png New message, received
MessengerCTIM no received chat.png Message sent, not read
MessengerCTIM send read chat conf.png Message sent, read - dialogue window view
MessengerCTIM send notread chat conf.png message sent, not read - dialogue window view
MessengerCTIM send unav chat conf.png Message sent to logged out user - dialogue window view
Table 4: Icons showing message status.
Table 5 shows description of application errors and notifications. Notifications are visible under status icon.
Notification Meaning
MessengerCTIM no internet.png No connection: check network connection
MessengerCTIM no auth.png Wrong login or password: check account settings
MessengerCTIM no licen.png App not allowed in PBX: contact PBX administrator

Table 5: Error icons meaning.

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, CCT, MAC, NCP PBX or configured MCTI subscriber (only NCP PBX)

Making calls

You can make calls in several ways:

  1. from Contacts tab - select subscriber from appropriate group (if such in PBX contacts are created) or directly from All contacts group. Call is made by tapping contact and then selecting Dial icon MessengerCTIM outgoing.png from drop-down menu
  2. from Last tab - you find from history we are interested in contacting subscriber (we had conversation with him, he called us or made call to him, we sent or received message from him). Call is made by tapping contact and then selecting Dial icon MessengerCTIM outgoing.png from drop-down menu
  3. in Search field by entering telephone number or subscriber's name directly from keypad, and then by tapping green receiver on right side
  4. from numeric keypad opened in lower right corner of Last tab
  5. from another source of numbers, e.g. website, google calendar

Screenshots presenting different types of connection are below


MessengerCTI.Mobile 1.07 Outgoing call en.png MessengerCTI.Mobile 1.07 Outgoing call2 en.png.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.Mobile 1.07 Outgoing call3 en.png MessengerCTI.Mobile 1.07 Outgoing call4 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.Mobile 1.08 Outgoing foreign call en.png


VoIP mode - basic configuration for using 'application. Both calls made and other information, e.g. about caller's number, contacts, subscriber status, chats - are sent over IP network (WiFi, Internet - HSPA, LTE)

GSM mode - it is most often used if access to IP network or Internet in given location is weak (insufficient for VoIP calls) or unstable. All information and signaling - are still sent via IP network (WiFi, Internet - HSPA, LTE), but calls themselves are carried out by GSM operator. With poor IP transmission quality, you should take into account that information may not always be displayed.

Switching between VoIP and GSM mode can be done by user from application level (if PBX is properly configured).


Presented connection details on smartphone display differ depending on calls setting mode. VoIP call looks different than GSM call due to necessity to use native phone dialer.

Example of outgoing call made in VoIP mode:

MessengerCTI.Mobile 1.07 Outgoing VoIP call1 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.Mobile 1.07 Outgoing VoIP call2 en.png MessengerCTI.Mobile 1.07 Outgoing VoIP call3 en.png


Example of outgoing call made in GSM mode:

MessengerCTI.Mobile 1.07 Outgoing GSM call1 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.Mobile 1.07 Outgoing GSM call2 en.png MessengerCTI.Mobile 1.07 Outgoing GSM call3 en.png

Incoming calls

Incoming call is signaled visually by pop-up call window and acoustically with bell configured in notification settings. Calls are answered (depending on whether display phone was turned off or not) by moving middle icon towards green handset or by pressing green one. If call is to be rejected, move icon towards red handset or by pressing red one.


We can redirect incoming call to another person. You can do it before answering call or during call (with or without notification):

  • immediately - by pressing button with Quick transfer contact, or
  • dialing number from list of contacts or recent calls


During call, user can mute microphone and/or turn on speakerphone mode.


Presented connection details on smartphone display differ depending on calls setting mode. VoIP call looks different than GSM call due to necessity to use native phone dialer.

Example of incoming call made in VoIP mode

Connection setup and conversation are carried out entirely via IP network (WiFi or Internet LTE / HSPA)

MessengerCTI.mobile 1.07 Incoming VoIP call1 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.07 Incoming VoIP call2 en.png


Example of incoming call made in GSM (Call pickup mode)

This mode is based on following:

  • connection for user is incoming connection from Slican PBX (information about connection is sent to smartphone and MessengerCTI application via IP network - WiFi or LTE/HSPA Internet)
  • physically, MessengerCTI application initiates outgoing call from user's smartphone to PBX (by GSM provider) and joins connection there, e.g. internal or external

In call pickup mode, application user has more possibilities to manage connection than in parallel calling mode

During call, GSM dialer window with MessengerCTI application "badge" appears.

MessengerCTI.mobile 1.07 Incoming GSM call1 pickup mode en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.07 Incoming GSM call2 pickup mode en.png


Example of incoming call made in GSM (Parallel calling mode)

In parallel calling mode, information about caller (via IP network - WiFi, Internet LTE/HSPA) and connection setup (by GSM provider) are initiated in parallel by Slican PBX. During dialing and conversation, GSM dialer window with the MessengerCTI application "badge" appears.

MessengerCTI.mobile 1.07 Incoming GSM call1 parallel mode en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.07 Incoming GSM call2 parallel mode en.png


In call history, missed call is symbolized in application with icon MessengerCTIM no answer qty.png. Going to Last tab or callback call clears information about number of missed calls.

Calls to Call Center queue

Tab - MessengerCTI.mobile 1.07 Last Contacts CC 3.png - allows you to handle calls directed to Call Center queues


User who is agent of Call Center queue, in CC tab, can program up to 4 individual buttons, e.g. logging in / logging out from selected queue, switching on break.

With button help, user can perform appropriate activities:

  • if he is permanently logged in to given queue, button is permanently green at appropriate queue (it does not respond to touch)
  • if he logs in / out of queue - he uses appropriate button to log in and out and button changes color from black and white to green
  • if he go on break at work - he uses button whose color changes from black - white to yellow


If user belongs to several queues, he can independently, using tabs, switch preview of each of them (status of available agents, number of waiting in queue, list of call-back subscribers)

If user calls back to person displayed in List, he independently decides whether given calls was successful (there are situations when voicemail is reported, called back carries out another conversation, destination subscriber is out of network range, temporarily lacks time, etc.)


Call to Call Center queue is displayed as normal incoming call. If there are unreaded missed calls in tab, a red dot is displayed next to CC tab.


MessengerCTI.mobile 1.07 CC queue1 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.07 CC queue2 en.png

Chat

Application allow to send and receive text messages between MessengerCTI.Desktop/ Mobile application user (internal chat).

To send message, click:

  • application status icon MessengerCTIMD chat free.png on left side or message/chat icon on right side of username
  • in username and from pop-up menu, select option Chat/History

Receiving new message is signaled by sound signal, information on bar/ in the notification window and appropriate icon next to username in call history.

If user uses both MessengerCTI.Mobile and Desktop versions, history of messages between aplications is synchronized.


Sample message exchange dialog:

MessengerCTI.mobile 1.08 Chat en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.07 Chat en.png


You can also use standard emoticons in your messages (including text conferences and text announcements described in section below). By clicking on Type your message field or while typing text, with keyboard activated, special key is available - opening access to emoticons.


MessengerCTI.Mobile 1.08 Chat Emoticons 1 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.Mobile 1.08 Chat Emoticons 2 en.png

Text and voice conference

Conference preparation:

  • on taskbar, select icon MessengerCTI.mobile 1.07 Taskbar - conference en.png
  • give name
  • select and accept participants


MessengerCTI.mobile 1.08 Conference1 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.07 Conference2 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.07 Conference3 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.07 Conference5 en.png


Announcement preparation:

An announcement is specific form of conference. It is used to send information unilaterally to many users, without possibility of interaction on their part.

Preparing announcement is similar to other conferences (text and voice). When creating it, instead of Conference type: Normal we choose Announcement type.


MessengerCTI.Mobile 1.08 Announcement en.png


Start conference:

  • in case of text conference - go to main application window and LAST tab, then click on created conference


MessengerCTI.mobile 1.08 Conference 4 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.08 Conference 5 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.07 Conference6 en.png


  • in case of voice conference - go to main application window and LAST tab, then click on created conference


MessengerCTI.mobile 1.08 Conference 4 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.08 Conference 8 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.07 Conference7 en.png


  • in case of advertisement - go to main application window and LAST tab, then click on created advertisement


MessengerCTI.mobile 1.08 Announcement 1 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.08 Announcement 2 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.08 Announcement 3 en.png


Edit conference:

  • in Participants tab, click MessengerCTI.mobile 1.07 Conference - edition.png
  • changes to settings are possible both when the conference is inactive and during its duration
  • available actions are shown in the graphic below

MessengerCTI.mobile 1.07 Conference8 en.png

Additional features

Uploading files and photos

This functionality is used to exchange files, documents and photos between different users of MessengerCTI application (mobile and desktop)

User in Contacts or Last tab clicks on application status MessengerCTI.mobile 1.07 Send file1 en.png another user, knocks on sign + next to field Type your message, selects one of available options:

  • Attach file
  • Attach picture
  • Take a photo

then points to file or takes photo and confirms

MessengerCTI.mobile 1.07 Send file en.png

Clipboard

Clipboard - it is used to exchange messages, documents and files between Mobile and Desktop versions of user's MessengerCTI application.

To start it, tap icon MessengerCTI.mobile 1.07 Bar clipboard en.png and next:

  • in field Type your message type text, or
  • tap + next field Type your message and select one of available options:
    • Attach file
    • Attach picture
    • Take a photo

and then select file or take a photo and confirm

MessengerCTI.mobile 1.07 Clipboard en.png

Send location

There is possibility to observe location between MessengerCTI.Mobile users (only with consent of person being watched):

  • User A asks User B for location permission (he has several variants to choose from)
  • User B approves request
  • User A receives link to google maps with current location of User B


MessengerCTI.mobile 1.07 Location1 en.png MessengerCTI.mobile 1.07 Location2 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.07 Location3 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.07 Location4 en.png MessengerCTI.mobile 1.07 Location5 en.png


or:

  • User B decides to send location to User A
  • User B in Contacts or Last tab clicks on status of User A application, knocks on + sign next to Type your message field and then selects Send location option
  • User A receives link to google maps with current location of User B


MessengerCTI.mobile 1.07 Location6 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.07 Location7 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.07 Location4 en.png MessengerCTI.mobile 1.07 Location5 en.png

Contacts

Contacts tab - MessengerCTI.mobile 1.07 Contacts en.png - allows to view and perform selected actions related to contact. Contacts can be grouped. Access to numbers from other groups can be obtained by expanding list:

  • Favourites
  • All groups
  • All contacts
  • Internal
  • External
  • Private
  • plus user-created groups

By default, group Favorites is visible


MessengerCTI.mobile 1.07 Contacts2 en.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.07 Contacts3 en.png

Adding contact to your favorites:

In Contacts tab we hold name of selected subscriber. Confirm when prompted with option Add contact to favorites

Call history

Default tab - MessengerCTI.mobile 1.07 Call History1 en.png - displays history of calls and messages.

Each entry in tab signifies at least one call or message. If there were more calls (missed) or messages (unread) from same user, his entry is highlighted (bold) and number calls/messages is displayed in as red dot next to relevant icon.


Each field shows (from left):

  • application status icon, icon that user is not using application or door station status
  • name (if saved in phonebook)
  • caller number
  • icon indicating phone call or text message
  • date or time when call was made

If tab contains unread missed calls or unread messages, red dot is displayed next to Last . From tab it is possible to call back or send back messages. By tapping on username, we go to detailed history of calls and messages.

MessengerCTI.mobile 1.07 Call History2 en.png

Configuring Slican PBX

For proper communication between application and PBX are required:

  • correct manufacturer license
  • specific PBX configuration

IPx, CCT PBX configuration

With ConfigMan software:

  1. Inside Global settings->Global settings/Remain tab:
    1. ANo:configure access number that application will chose for making call to PBX and setting up incoming call
    2. Adr: public host name or PBX IP address for connecting to application (for VoIP calls with application)
  2. Inside Subscribers menu, Tables then Subscribers->Subscribers/CTI settings:
    1. AwdMbl: allow access to MessengerCTI.Mobile application
    2. AwdGSM: allows to connect phone calls through GSM network
    3. IncC: setting up method of how application connects incoming calls:
      1. Call pickup - picking up incoming call with application means making outgoing call with GSM phone to number from ANo field inside Global settings/Remain
      2. Parrallel calling - incoming calls to GSM phone from number set in ANo field inside Global settings/Remain
    4. MnNo: configure GSM phone access number, on which application is installed, optionally configure second number (for dual SIM phones)
    5. SecNo: second GSM phone number with installed application (optional, for dual SIM phones)


For application to work with each settings, these fields parameters must be set:

  • VoIP network: 1.2, 2.1
  • GSM network: 1.1, 2.1, 2.2, 2.3, 2.3.1 or 2.3.2, 2.4 (plus possibly 2.5)

Minimum PBX firmware version - 6.53, for VoIP - 6.54

NCP PBX configuration

From ConfigWEB application:

  1. Extensions/ Settings->Informations about CTI settings for subscribers and applications menu, configure:
    1. Public host name or PBX IP address for XML Slican protocol - domain name or IP address for exchanging/synchronisation information and data between application and PBX
    2. Public host name or PBX IP address for VoIP calls - domain name or IP address for configuring VoIP calls
    3. PBX number for GSM calls - which will call GSM phone with installed application to call PBX or PBX to application and set up call (in configuration with support for connections via GSM network)
  2. configure subscribers for SIP, FXS, CTS, MCTI with Extensions/Subscribers-> Subscriber/CTI Settings/MessengerCTI.Mobile
    1. Allow access to MessengerCTI.Mobile application
    2. if using GSM network allow phone calls handling using GSM
      1. set up GSM phone access number for device with installed application
      2. set up second GSM phone number with installed applicatio (optional, for dual SIM devices)
    3. set up incoming calls handling
      1. call pickup - picking up incoming call with application is achievied by GSM phone making outgoing call to number set in Extensions/ Settings/ Informations about CTI settings for subscribers and applications/ Phone number to call this PABX using GSM connection
      2. Parallel calling - incoming call to GSM phone from number set with Extensions/ Settings/ Informations about CTI settings for subscribers and applications/ Phone number to call this PABX using GSM connection


For application to work, these fields must be set:

  • VoIP: 1.1, 1.2, 2.1
  • GSM: 1.1, 1.3, 2.1, 2.2, 2.2.1, 2.2.2, 2.3 and 2.3.1 or 2.3.2


Minimum PBX firmware version - 1.11, for VoIP - 1.12

Ports and protocols

Default port numbers and protocol types used by PBX for purposes of providing selected services of MessengerCTI.Mobile application.

Basic:

  • signalization
    • 5529 TCP - application signaling (XML)
    • 5543 TCP - signaling in enabled encryption tag mode (XML)
  • VoIP calls
    • 5060 UDP - SIP signaling (for VoIP calls)
    • 8100 - 8300 UDP - acoustic - for IPx, CCT, MAC PBX
    • 10000 - 20000 UDP - acoustic - for NCP PBX

Additional:

  • file transfer - only NCP (clipboard, between users):
    • 443 TCP - file transfer without encryption tag enabled (transmission is still HTTPS encrypted)
    • 5543 TCP - file transfer of files with encryption tag enabled
  • image transmission from DPH.IP doorphone camera
    • link to camera in PBX location of:
      • NCP: Extensions/Devices/Cameras
      • IPx, MAC, CCT: Pheripherals/Cameras
    • During a call, PBX sends camera link to application MessengerCTI: rtsp://IP_address_camera:554/login_password_additional_information


Example for NCP for MessengerCTI working from outside NCP IP network (configuration in ConfigWEB):

  • XML signaling, VoIP, file transfer - Extensions/Settings/Informations about CTI settings for subscribers and applications tab
  • image transmission from camera (camera link, camera link to DPH.IP) - Extensions/Devices/Cameras tab


Sample configuration data:

  • PBX IP address: 192.168.0.10
  • router public IP address: 222.0.0.1
  • domain address: company_name.com
  • camera IP address: 192.168.0.20
  • ports used to redirect individual services on router: 55xx


XML signaling:

  • MessengerCTI --> router --> NCP
  • MessengerCTI --> 222.0.0.1:5555 --> 192.168.0.10:5529, or
  • MessengerCTI --> company_name.com:5555 --> 192.168.0.10:5529

XML signaling with encryption tag enabled:

  • MessengerCTI --> 222.0.0.1:5558 --> 192.168.0.10:5543, or
  • MessengerCTI --> company_name.com:5558 --> 192.168.0.10:5543

VoIP calls (signaling)

  • MessengerCTI --> 222.0.0.1:5556 --> 192.168.0.10:5060, or
  • MessengerCTI --> company_name.com:5556 --> 192.168.0.10:5060

VoIP calls (acoustic)

  • MessengerCTI --> 222.0.0.1:10000 - 222.0.0.1:20000 --> 192.168.0.10:10000 - 192.168.0.10:20000, or
  • MessengerCTI --> company_name.com:10000 - company_name.com:20000 --> 192.168.0.10:10000 - 192.168.0.10:20000

File transfer:

  • MessengerCTI --> 222.0.0.1:5557 --> 192.168.0.10:443, or
  • MessengerCTI --> company_name.com:5557 --> 192.168.0.10:443

File transfer with encryption tag enabled:

  • MessengerCTI --> 222.0.0.1:5559 --> 192.168.0.10:5543, or
  • MessengerCTI --> company_name.com:5559 --> 192.168.0.10:5543

Image transmission from DPH.IP camera

  • MessengerCTI --> ruter --> camera
  • MessengerCTI --> 222.0.0.1:5560 --> 192.168.0.20:554, or
  • MessengerCTI --> company_name.com:5560 --> 192.168.0.20:554

Operation in local network and outside local network without changing MessengerCTI configuration

If MessengerCTI.desktop or MessengerCTI.mobile application user is on move, his IP network source may change (np. LAN <--> Internet LTE, HSPA <--> LAN, work <--> travel <--> home) it may results need to change application configuration, i.e. change IP address of PBX from local to public or vice versa (situation does not take place if user uses LTE/HSPA internet only)


In order to simplify operation and configuration of MessengerCTI application, you can use functionality offered by many network routers. It allows device with MessengerCTI (notebook, smartphone) to connect to PBX, regardless of whether it is in local network (LAN, WiFi) or outside it (other sub-networks, Internet, GSM-LTE). In routers, this functionality is called NAT hairpinning, NAT loopback or NAT reflection. It enables access to service via public IP address, regardless of range of network user is currently in.


Sample network:

  • router's public address (router's WAN): decimal address - 203.0.113.1 or domain address - voip.xxxxxx.com
  • router's local address (router's LAN, gateway): 192.168.1.1
  • PBX address (NCP, IPx, MAC, CCT) in LAN network: 192.168.1.2
  • user's notebook address with MessengerCTI.Desktop or smartphone with MessengerCTI.Mobile in LAN: 192.168.1.100

If MessengerCTI from notebook/ smartphone from local network - IP address 192.168.1.100 - send packets to public address 203.0.113.1 (voip.xxxxxx.com), packets are routed to default gateway - 192.168.1.1 (router) by default. NAT hairpinning router detects that 203.0.113.1 (voip.xxxxxx.com) is address of its WAN interface and treats packets as if it were coming to that interface. Determines destination for those packets based on DNAT (port forwarding) rules. If packets have been sent to port 5529 (for VoIP: 5060, 8100-8300 for IPx, 10,000 - 20,000 for NCP) and there is DNAT rule for this port directed to 192.168.1.2, then PBX receives packets at this address.


If appropriate DNAT rules exist, address translation is performed - router rewrites source local IP address in packets to public address. Notebook/ smartphone (192.168.1.100) sends packets, and PBX (192.168.1.2) receives it as coming from 203.0.113.1. When PBX responds, process is same as for notebook/ smartphone. In this way, two-way communication between notebook/ smartphone in LAN via public IP address is possible.

Use cases examples

MessengerCTI.Mobile application is useful tool for companies that employ mobile workers which requires constant access to phone with internal number of phone system.
These employees can be a good example:

  • sales department - working in different locations, office <-> outside office
  • service support - constant fieldwork
  • remote worker - remote work
  • mobile worker - working on vast area(production halls, vast areas) -where Wifi or DECT network range won't be adequate

Installing beta version

"Beta" version contains new functionalities which will be added in next production version but not all of planned functions are implemented. This version also cointains fixes for error submited for earlier versions. It was initialy tested.

Becoming beta tester and installing "BETA" version of MessengerCTI.mobile application can be done via Play Store application or by activating appropriate link on ServNET server:


  1. Activating access to BETA app from Play Store app:
  • run and log in to Play Store.png.jpg
  • in application search field enter slican messengercti
  • click on name of MessengerCTI application, after opening new one, find text Join the beta testing program, click on appropriate field
  • after a while, MessengerCTI (beta) description and Update button will appear

MessengerCTI.mobile 1.08 Beta.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.08 Beta1.png MessengerCTI.mobile 1.07 Pusty.png MessengerCTI.mobile 1.08 Beta2.png


  1. Activation of access to BETA application from ServNET server or http link:

In this case:

On www page you will see the following information:


Google beta en.png


Click button BECOME A TESTER to sign up for testing


Going back to phone configuration:

  • because Google Play updates can be delayed, it is recommend to turn of Play Store application before installing MessengerCTI
  • clicking on shortcut will start Play Store again. Search for MessengerCTI application. It is recommended due to the large number of available Messenger' applications, it is worth adding the name Slican to the search
  • install upgrade application
  • configure according to manual

We're excited about new features that are only available to select person.

Retrieved from "https://pubwiki.slican.com/index.php?title=User:Leszekj&oldid=8335"