MessengerCTI Manual

Introduction

Slican MessengerCTI.Desktop is software which purpose is to assist users of Slican PBX. Thanks to the graphic interface displayed on the computer screen, software allows for convenient access of telephone calls and other functions related to it. Software delivers additional features that allows to expand capabilities of desk phone. Software combines capabilities of controlling desk phone connected to PBX, for example choosing number, receiving calls and also application is able to function as standalone phone. Software also allows to: accessing PBX's phonebook, call history, status of phone and other users of MessengerCTI, text communication and sending or receiving SMS messages. Additionaly for new version of DPH.IP doorphone equipped with camera - video preview was added.

Application works with all types of phones connected to Slican PBX: CTS system phones, analog or VoIP phones. In the most recent firmware version of PBX(6.53 IPx, 1.11 NCP) MessengerCTI can work as standalone VOIP phone. Depending on type of used phone usage of application slightly differs. While using CTS system phone, device is integrated with software, calls can be controlled with turning on speakerphone(choosing number, connecting, picking up or disconnecting call). Users of analogue phones will benefit from this software because they'll gain access functions that aren't available on these types of devices.

Basic functionalities

Using cameras and DPH.IP doorphones

Introduction of DPH.IP doorphones that include cameras led to solution that allows display of video from these cameras. Functionality was added with MessengerCTI.Desktop. While connecting to doorphone from software video from camera will appear in new window on computer display. After picking up and finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door,gate, using dedicated button. Reverse is also true, calling doorphone or another telephone number associated with camera, display screen will show video from camera. This allow for temporary observation of surroundings 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.desktop user can preview video from camera of other manufacturers but those devices have to support video formats, codec compatible with VLC application libraries.

Attention

MessengerCTI.Desktop application was released mainly for displaying video from DPH.IP doorphones and and this time doesn't yet have all fuctionality of PhoneCTI application. Those options will be added gradually.

VoiP Client

MessengerCTI.Desktop can work as VoIP, concurrent phone connected to stationary desk phone(FXS,CTS,IP). User can decide on which device to pick up a call, phone or a computer - using it's integrated audio devices(sound card, microphone, speakers or external headphones). Since 1.11 version of NCP firmware application can be used as standalone SIP phone. For such configuration CTIuserPlus license is required.

Phone Book

Big advantage of software is simple and convenient access to contact from phone books and displaying them on computer screen. MessengerCTI.desktop can use only phone books from PBX. Contacts can be sorted according to user needs. Adding new suscribers and modification of existing entries can be done from CTS system phone or more conveniently, by using computer with MessengerCTI.dekstop or WebCTI. Modyfication of entry is possible 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 alongsid information about order, time of calls and number of missed calls from particular number.

Text messages

With use of MessengerCTI text information can be sent, from internal messenger(chat) through a computer network to another Messenger CTI.user, also as SMS message to another phone and from GSM phone. Chat can be accessed by all users of particular PBX and all PBX's linke to it by eSSL ver.2. This functionality is suitable for companies which obtained Slican PBX and doesn't allow use of public messenger applications because of security reasons.

Usage alongside mobile version

Application can be used alongside and synchronized to MessengerCTI.Mobile, Android version for mobile devices.

Minimum requirements

To install SLICAN MessengerCTI.dekstop application, following minimum requirements must be met:

• CPU Frequency - 800 mhz or higher
• Ram - 1 GB or more
• GPU- compatible with DirectX 9
• Operating System - Windows 7 or more recent

Application can be installed on computer which doesn't meet minimum requirements but it will run slowly or some option won't work correctly.

Installation of application

Usage of MessengerCTI.dekstop is licensed so purchasing appropriate license is required. Purchased code can be entered during configuration of PBX, code determines number of devices that can use software. Licensing doesn't affect software installation. Installation file of software can be downloaded from ServNET [1] and installed on computer. After installing, application should be properly configured by entering necessary PBX information to which software should be conencted: Settings - Connection.

Attention

If extension number entered in Settings-Connection tab doesn't have permissions to use Messenger.CTI application it won't be possible to connect to PBX and synchronize data.

Second stage(optional) consists of uploading to PBX prepared file containing MessengerCTI.Desktop application. It can be done by PBX administrator who has WebCTi administrator privileges. This action allows automatic updating of software on devices. Update has been described in seciont "Updating application"

Running application

MessengerCTI.Dekstop can be run just as any other Windows compatible software. In the program settings automatic start during launch of operating system can bet set. During start of program it is logging to PBX(according to settings set in Settings - Connection tab). AFter successfull login program data is synchronized with PBX data.

Updating application

Software update is automatic and user can't affect this process. Just like updating firmware of BPX, VoIP expansion card or REC card MessengerCTI.desktop is also updated(by PBX administrator). During each startup of program, program version is compared to version on PBX. If they differ, version from PBX is automaticly downloaded, installed and logged to PBX. Depending on version from PBX it may install newer or old version.

Available configurations

• Simultaneous operation of desk phone and application (application VoIP mode is turned off) - calling with phone, application - dailing up outgoing calls for phone(CTS, FXS, SIP) and picking up incoming calls for phone (CTS)
• Simultaneous operation of desk phone and application (application VoIP mode is turned on) independent choice of picking/dialing up call with phone or application.
• Autonomous application without desk phone (application VoIP mode on) - picking/dialing calls only with application.

Other functionalities for example chat, sending and receiving SMS, displaying video from camera, accessing call history and phone book, configuring user status and Messenger aplication are available for each of the above configurations.

Application MessengerCTI.Mobile is intented for mobile devices with Android system, its description can be found HERE.

MessengerCTI.desktop with simultaneous configuration

Application with VoIP mode turned off.

Phone calls are made only using phone working alongside application. Application allows to:

• for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, intitianing dialing, dialing with phone speaker using CTS phone
• for incoming calls- displaying caller phone number in window or caller name from phone book of PBX, pickup up incoming call on speaker phone using CTS phone.

For user of FXS nad SIP phones picking up earphone is neccesary.

Application with VoIP mode turned ON.

Phone calls can are made with phone or with computer and application. Application allows to:

• for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, intitianing dialing, calling while using computer microphone and speakers or external headphones
• for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.

MessengerCTI.desktop working as standalone phone(only with NCP)

Application with VoIP mode turned on.

Phone calls are made only with computer and application. Standalone applications allows:

• for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, intitianing dialing, calling while using computer microphone and speakers or external headphones
• for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.

Program structure

Main window Main windows of MessengerCTI.Dekstop application contains interface which show information and allows access to chat windows and main functions.

Upper part of window:

• left side
• hyperlink to software version
• right side
• default window position button
• close - mimizing to tray button

Middle part of window:

• left side:
• changing application status button
• middle: program name,below - user status - field that can by user to provide additional urlop, for example to inform about vacation or being busy with project
• right side:
• searching (magnifying glass) - button/field for searching number or contact
• preferences - access to program settings

Lower part of window:

• access to tabs:
• contacts - phonebook from bx with sorting options
• recent - history of most recent calls and messages.

Status of application and user

MessengerCTI.Dekstop software allows to show current status of user with colored 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 automaticly. More information can be added through text status of user. User can choose different icons/symbol to set his status manually. Additionaly there is visual of ringing phone and or current phone call.

List of icons and symbols Chart presents list of icons available in Contacts and Recent tabs:

• green screen - for internal PBX users - different icon color represent current applications status. It can be set manually through main application window - icon green handset, also is set automaticly for Be right back status.
• grey lines - for public suscribers.
• green door - for DPH.IP doorphones connected to open/closed door sensor

Status of application and DPH.IP doorphones
Icon	Icon meaning
32px	PBX subscriber; MessengerCTI.Desktop application is running and and LOGGED INfrom subscriber computer. Clicking icon will allow to send text messeger, SMS or dial a call to another application user.
29px	PBX subscriber; Be right back set by user or application, delay time is definied in general settings of application.
32px	PBX subscriber; Do not disturb set by user
32px	PBX subscriber; Invisible set by user or application is logged of.
32px	PBX subscriber; application is logged in (application status and icon color can change with time), access with mobile application is on MessengerCTI.Mobile (blue smartphone icon)
32px	public subscriber; clicking icon will allow to send sms or dial call to choosen subscriber.
32px	doorphone; current door position - door closed, clicking icon will open door
32px	doorphone; door are opeh
32px	doorphone; alarm timer for open doors was set off

Chart 1: Meaning of icon status of application, users and doorphones.

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

Phone status and camera information
Icon	Icon meaning
28px	Phone is ringing
32px	During call
25px	Camera is associeted with phone or doorphone, clicking on icon will allow to preview camera video

Tabela 2: Icons displaying status of phone and camera

Preferences

Wybranie ikony Preferencje z głównego okna programu spowoduje wyświetlenie okna z ustawieniami programu. W każdej z zakładek dostępny jest przycisk z informacją "O programie" i przywrócenia domyślnego pozycji okna głównego 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.

Connection

In Connection field you must enter settings neccesary for application to connect:

Plik:MessengerCTI_polaczenie.png

Application login setting

To login, application must have correct settings configured by PBX administrator:

• subscriber number - extensions from PBX
• CTI access and password:
  • for IPx, MAC, CCT - ConfigMAN chart Subscribers/Settings CTI - CTI - access level i paswordPss
  • fo rNCP - ConfigWEB chart Extensions/Subscribers/CTI setting - CTI Access i Password
• PBX IP 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:

• Extension" 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 neccessary.
• server IP address - adres IP interfejsu sieciowego centrali. W przypadku logowania aplikacji spoza sieci centrali - adres IP rutera brzegowego (konieczne przekierowanie portów na ruterze 5529 TCP, 8100 - 8300 UDP dla IPx, 10000-30000 UDP dla NCP - na interfejs LAN centrali) IP address of PBX network port. In case of logging outside od PBX network, IP address of edge router(port forwarding on router is neccessary, 5529 TCP, 8100-8300 UDP for IPx, 10000-30000 UDP for NCP on PBX LAN interface).

After user will change his password, administrator no longer will have access to this passowrd. Application can be set to remember user password by checking field while login in, if field wasn't checked application will always ask for password during every login.

After proper configuration all of above fields, usinng "Connect" button will allow application to connect with PBX and synchronize phone book and other information related to that extension. "Successfull login" will apear in lower part of window.

If login credentials, configuration settings aren't correct or there are issue with network connection those error messages may appear:

• Wrong login or password. Check if correct login or password was used.
• Connecting to PBX alternating with
• No connection to PBX Check IP adress that was entered and check computer LAN connection.