pubWiki-en - User contributions [en]

MessengerCTI.Mobile Manual

2023-12-04T13:54:33Z

Arturs:

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

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.
 
==Application advantages==
* application available(for free) from Google Play store - only CTI.plus license applied to PBX is required
* phone book with access to subscribers availability(chat, phone status, text status)
* option of adding and removing subscribers from favorite group, synchronised with MessengerCTI.Desktop
* history of recent calls/messages sorted chronologically
* logging with phone simultaneously as desk phone or as separate MessengerCTI subscriber(NCP PBX only)
* chat/messenger
* chat history with phone call history
* voice calling through GSM(two connection options- capture or parallel)
* flexible configuration of audio notifications
* access to PBX services configuration from phone
* rapid access number for fast call forwarding
* option of setting up busy status of desk phone if GSM is buy (on by default)
* option of setting up incoming call denying on GSM if desk phone is busy
* option of copying text from chat
* support of DualSim smartphone or two phones simultaneously (private or business)
* convenient access to opening door/gate if receiving call from doorphone DPH.IP or from context contacts menu
* additional desktop widget for fast access to open DPH.IP doorphone doors
* automatic delay of notifications for MessengerCTI.Mobile if desk phone or MessengerCTI.desktop is active
* option of copying contact from local phone book to PBX phone book

{{Attention!|
*For proper operation MessengerCTI.Mobile and PBX must have permanent access to Internet, fixed public IP address for PBX or forwarding port 5529 on edge router when PBX is on LAN behind NAT.
*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
*A full version of the Android system is required on the phone (limited versions of the system - Android GO edition - used in budget smartphones, e.g. Motorola E13, do not allow the MessengerCTI application to be granted full permissions - it is necessary to use ADB software to configure the phone)
*opening the door using the context menu or widget is available only after starting the ACS system}}

= Basic functionalities =
Using a smartphone, the application user gains mobility and still has the option of using the PBX as an internal subscriber.

<big>''' VoIP and GSM client '''</big>
'''''MessengerCTI.Mobile'''''parallel telephone, associated with the desk telephone equipment, landline (FXS, CTS, SIP). The application can work as a VoIP or GSM client. The user decides on which device to answer the call and make the call - phone or smartphone. A new feature is the ability to use the application as a standalone phone in NCP PBXes (from PBX firmware version 1.11). The CTIuserPlus license is required for its proper operation.

'''''Configuration in VoIP mode''''' - basic configuration for using the application. Both conducted calls and other information, e.g. about the caller's number, contacts in the directory, subscriber statuses, chats - are sent via the IP network (WiFi, Internet LTE/HSPA)

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

Switching between VoIP and GSM mode can be performed by the user from the application level (provided that he has the appropriate configuration on the PBX).

<big>'''Contact book'''</big>

A great advantage of the software is easy and convenient access to contacts from the PBX telephone books and displaying them on the user's smartphone. MessengerCTI.Mobile uses only the books stored in the PBX. Contacts can be grouped according to user requirements. Entering new subscribers and modifying existing entries can be made both from the system phone and in a more convenient way, from a computer - MessengerCTI.Desktop or WebCTI. The modification is visible immediately after its introduction. Access to the directory allows you to easily and conveniently search for the number of the person you want to call in the database. On the other hand, during incoming calls, clear information about the caller is displayed on the smartphone screen.

<big>'''Call history'''</big>
The user of the program has access to the history of all his calls, both received and missed. It is saved in the Slican central. Using MessengerCTI, you can display it, obtain information about the order of calls, date and time of their execution, as well as about the sum of missed calls made from the same number.

<big>'''CallCenter'''</big>
In conjunction with NCP PBXes for Call Center agents, the functionality of handling queues has been introduced. It allows e.g. logging in to one of them, viewing its status, answering and making calls, calling back lost and abandoned calls, enabling the status of temporary breaks in work.

<big>'''Text messages'''</big>

Using MessengerCTI.Mobile, you can send text information - from an internal communicator (chat) via a computer network - to another person who has MessengerCTI.Desktop or MessengerCTI.Mobile. The chat can be used by all subscribers of a given PBX and PBXes linked to it with the eSSL ver.2 system. This functionality is particularly attractive for those companies that, having Slican exchanges, do not allow the use of public messengers for security reasons. To ensure parallel access from different devices (computer, smartphone), chat history is saved directly in the PBX and synchronized with the MessengerCTI applications on an ongoing basis. An extension of this functionality is the ability to chat with many users at the same time, i.e. the so-called text conference.

<big>'''Text and voice conferencing'''</big>

A functionality that allows you to exchange messages / talk to many users at the same time.

<big>'''File transfer'''</big>
Between MessengerCTI application users (desktop, mobile) it is possible to send files, e.g. photos, documents

<big>'''Location Sharing'''</big>

Due to mobility - the user can make the observation of his location available to selected people. An authorized person gains the ability to observe its location.

<big>'''Support for cameras and DPH.IP doorphone'''</big>

The introduction of DPH.IP doorphones with camera support for sale forced the creation of an option for displaying video images from them. Such a possibility was introduced in the MessengerCTI.Mobile application. In the case of a connection from the doorphone to the application user, the image from his camera appears in the window. After receiving and carrying out the call, and without the need to talk to the person at the doorphone, only after visual identification, you can open the door, gate or barrier using a special button. Also in the opposite direction, when calling the doorphone or any other extension number associated with the camera, the image from the camera appears on the monitor screen. This allows for temporary observation of the surroundings of the installed camera, e.g. the person we are calling. It is also possible to select and observe the image from any camera without the need to make a connection, just by indicating the associated icon in the application. Using MessengerCTI.Mobile it is also possible to use cameras from other manufacturers, but they must support video formats and codecs compatible with VLC application libraries. Opening the door using the context menu or widget is available only after starting the ACS system.

<big>'''Works with the desktop version'''</big>

The application can also be used in parallel and synchronized with MessengerCTI.Desktop, i.e. the version for a computer with Windows.

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

For installing application minimum requirements must be met:
* Android operating system
** minimum version: KitKat 4.4.4
** minimum recommended version: Nougat 7.0
** 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.

{{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 regulating microphone gain for VoIP calls
* opening the door using the context menu or widget is available only after starting the ACS system}} 

{{Attention!|
'''''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.
During the installation, you are prompted to provide some permissions and change phone settings. They may differ, depending on the Android version and phone type. You can accept them all or select only those related to the functionalities that will be used:
* Camera - for scanning the QR code and taking and sending photos
* Location - to share the location
* Microphone - for making calls in VoIP mode
* Internal storage - for saving photos, transferring files and using the clipboard
* Telephone - to use the application in GSM mode
* Contacts - for copying contacts to the local phone database (only used in some versions of the application)
* Displaying above other applications - should be made available so that you can answer the call correctly when the application is, for example, dormant
* Disable battery optimization - Battery optimization for the app must be disabled to prevent it from going into deep sleep

After installing application, it must be configured for connecting to PBX: '''''Settings->Account''''' (described below).

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

== Starting application ==

'''''MessengerCTI.Mobile''''' application runs just like any other application working 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. 

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

<big>'''Account'''</big>
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 address or IP address of local PBX(public IP address for users outside LAN) : port used for communication with PBX - by default set to TCP 5529
* Encrypted transmission: encryption of the XML protocol
* Self-signed certificate
* Read data from QRCode: instead of manual configuration - the ability to scan the QRcode sent to the user's e-mail box when configuring the CTI settings in the NCP PBX or from the WebCTI website
After entering the data, confirm with the save and connect button

<center>[[File:Messenger_wid_konf.jpg|800px]]</center>

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

<center>[[File:MessengerCTI.mobile_1.07_WebCTI.png|800px]]</center>

<big>'''Calls'''</big>
Options to activate the button on the headphones and the microphone gain level

<center>[[File:calls.jpg|230px]]</center>

<big>'''Call center'''</big>
Ability to run up to 4 login/logout buttons and agent breaks related to Call Center queues

<center>[[File:cc.jpg|230px]]</center>

<big>'''Other'''</big>

Other application settings are shown in the attached graphic.

<center>[[File:other.jpg|230px]]</center>

The Debug option - enabled at the request of the software supplier - is related to solving problems with the correct operation of the application

When this option is enabled, an additional Send logs by email field appears in the About tab. We choose the mail client from which we will send the application logs for analysis on the manufacturer's side.

=== Services===
Configuring application services related to connections/calls:
* Default connection type - settings for making calls via GSM, VoIP or VoIP via WiFi
* Global services for PBX:
** DND: Do not Disturb
** Internal no. busy when GSM talking
** FWD - call forwarding settings: all, when busy or when no answer

=== My description ===
Setting text status that will be visible to other MessengerCTI.Users or on screen of CTS-330 system phone.

===Notifications===
<big>'''Configuring incoming call notifications'''</big>

* ringtone: selection of one from the list available in the application with the option of muting it after a certain period of time
* ringtone vibration
* missed call bar notification
* schedule of notifications for the call ringer - the ability to set a weekly plan of active use (turning on ringing at certain times)

<big>'''Configure chat message notifications'''</big>
* message sound: choose one from the list available in the application
* wibracje przy wiadomości
* notification in the bar about a new chat message
* notification schedule for messages - the ability to set a weekly plan of active use (turn on notifications at specific times)

<big>'''Notification delay'''</big>
A functionality that allows you to delay the ringing signal of the mobile application by 15 seconds in relation to the ringtone of the phone associated with it (usually landline).

After launching MessengerCTI.mobile - the landline phone and the application will ring simultaneously during an incoming call. If we are the first to answer the phone, the application will "remember" that we are in its vicinity and will delay its ringing during the next call.
It ceases to apply when:
* we will not answer the call
* we will answer the call with the application

<big>'''Fast forwarding'''</big>
A list of the 3 most important user numbers (external and external) displayed during a call for simple call transfer.

=== About software ===
Information about:
* current software version
* type of connected PBX
* PBX firmware version
* own number: CTI account number(internal PBX extension)
* own comment: user comment made by administrator
* link to send application logs

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

= Application structure =
== Main window ==
Main application windows give access to three tabs:
* '''Last''' - history of calls, chat messages and users statuses.
* '''Contacts''' - access to PBX phone book with sorting options:favourites, internal, external.
* '''CC''' - handling calls from Call Center queues, the ability to log in/out and call back

Additionally:
* App login status icon with default connection type
* Configuration menu - application and service settings
* Mute ringtone - instantly mute the ringtone and app notifications
* Clipboard - for sharing data between the mobile and desktop application
* Search engine - searching for a contact by name and number
* Creating a conference
* Keypad - select the target number

<center>[[File:Messenger eng opis.jpg]]</center>

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

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

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

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

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

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

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

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

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

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

==Making calls==
Two ways of making calls:
* from '''Contacts''' tab - choosing subscriber from particular group (if applicable), or from "All contacts" group. Call is made by touching contact tab, then choosing icon from drop down menu.
* from '''Contacts''' tab- searching for contact name in '''Search''' field by using keyboard then touching lower right corner of keyboard

<center>
[[File:szuk.jpg|210px]]
[[File:MessengerCTIM_out_ext1.png|790px]]
</center>
* from '''Last/Recent''' - find subscriber which we had shared call(he called or we called him) and then make call by touching middle part of contact tab and choosing action from drop down menu
<center>[[File:MessengerCTIM_out_number1.png|570px]]</center>
* from '''Search field''' tab- searching for phone number in '''Search''' field by by typing the phone number directly from the keyboard, and then tapping the green receiver on the right

<center>
[[File:szu_num.jpg|230px]]</center>

'''Configuration in VoIP''' mode - basic configuration for using the application. Both conducted calls and other information, e.g. about the caller's number, contacts in the directory, subscriber statuses, chats - are sent via the IP network (WiFi, Internet - HSPA, LTE)

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

Switching between VoIP and GSM mode can be performed by the user from the application level (provided that he has the appropriate configuration on the PBX). Due to that reason, required city line for PBX must be at least ISDN BRA.
'''The presented connection details on the smartphone display differ depending on the mode of its connection. The connection looks different in VoIP mode than in GSM mode due to the need to use the native telephone dialer. An example of an outgoing call made in VoIP configuration.'''
<center>
[[File:voipout1.jpg|233px]]
[[File:voipout2.jpg|230px]]
</center>
'''Outgoing call made in VoIP configuration.'''

<center>
[[File:gsmout1.jpg|230px]]
[[File:gsmout2.jpg|230px]]
</center>

==Incoming calls==
Incoming calls are displayed with a call popup and ringtone configured in the app's notification settings. Calls are answered by moving the icon with the green handset, if the phone was turned off, or by pressing the green button. If we want to reject the call, it can be done by moving the red handset or pressing the red button. If additional pop-up numbers have been set, the call can be forwarded to them by moving the icon with the pop-up number. The process of accepting incoming calls in the GSM mode consists in making a return call via the GSM line to the application access number defined by the PBX administrator.

<center>[[File:MessengerCTIM_incoming2.png|700px]]</center>

You can direct an incoming call to another person. This can be done before answering the call or during it (with or without notification):
* instantly - by pressing the button with a quick contact, or
* select a number from your contacts list or recent calls

During a conversation, the user has the option of muting the microphone and/or turning on the loudspeaker mode.

'''The presented connection details on the smartphone display differ depending on the mode of its connection. The connection looks different in VoIP mode than in GSM mode (due to the need to use the phone's native dialer)'''

'''An example of an incoming call made in VoIP configuration'''

<center>
[[File:in1.jpg|230px]]
[[File:in2.jpg|230px]]
[[File:in3.jpg|230px]]
</center>
Connection setup and conversation are carried out entirely over the IP network (WiFi or LTE/HSPA Internet)

'''An example of an incoming call made in the GSM configuration (in the call interception mode)'''

This mode consists in the following:

The call for the user is an incoming call, but from the Slican PBX it is sent to the phone and the MessengerCTI application via the IP network - WiFi or Internet LTE/HSPA information about the incoming call and the MessengerCTI application initiates an outgoing call from the user's phone to the PBX (via the GSM operator) and there it joins a call, e.g. internal or from the city

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

During the conversation, the phone's GSM dialer window appears with the "tag" of the MessengerCTI application.

<center>
[[File:in1.jpg|230px]]
[[File:in2.jpg|230px]]
[[File:ingsm1.jpg|230px]]
[[File:ingsm2.jpg|230px]]
</center>

'''An example of an incoming call made in GSM configuration (in parallel calling mode)'''

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

<center>
[[File:gsmrownolegle.jpg|230px]]
[[File:ingsm1.jpg|230px]]
[[File:ingsm2.jpg|230px]]
</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.

==Calls to the Call Center Queue==

Tab [[File:cc1.jpg|230px]]- allows you to handle calls directed to Call Center queues

The user who is an agent of the Call Center queue, in the CC tab, has the option of programming up to 4 individual buttons - login / logout from the selected queue, activation of the break.

With their help, he can perform the following actions:

* if he is permanently logged in to a given queue, then the button is permanently green in the appropriate queue (does not respond to touch)
* if he logs in/out to the queue - he logs in and out using the appropriate button and the button itself changes color from black and white to green
* if he goes on a break - it is with the help of a button whose color changes from black - white to yellow

If the user belongs to several queues, he or she can independently switch the preview of each of them using tabs (status of available agents, number of waiting in the queue, list of subscribers to be called back). If the user calls back to the person displayed in the List, he or she decides whether the call was successful (there are situations when the voicemail is answered, the caller is on another call, is out of network coverage, temporarily has no time, etc.)

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

<center>
[[File:callcenter1.jpg|230px]]
[[File:callcenter2.jpg|232px]]
</center>

==Messages support==
Application allows to send and receive text messages between MessengerCTI.Desktop/Mobile user (internal chat).

To send a message, click:

* the [[File:MessengerCTIMD_chat_free.png|25px]] application status icon to the left or the message/chat icon to the right of the username
* in the username and from the pop-up menu select Chat/History

Receiving messages is displayed on notification bar by proper icon and defined ring tone. 
If subscriber is using both versions of MessengerCTI, messages history is stored locally in '''''MessengerCTI.Dekstop''''' application. 
Below is example of chat window:

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

==Text and voice conference==

'''Conference preparation:'''
* select the icon on the taskbar [[Plik:MessengerCTI.mobile 1.07 Pasek zadań - konferencja.png|250px]]
* giving a name
* selecting and accepting participants

<center>
[[File:MessengerCTI.mobile_1.07_Konferencja.jpg|230px]]
[[File:MessengerCTI.mobile_1.07_Konferencja_2.jpg|230px]]
[[File:MessengerCTI.mobile_1.07_Konferencja_4.jpg|230px]]
</center>

'''Start of the conference:'''
* in the case of a text conference - go to the '''TALK''' tab (graphic on the left)
* in the case of a voice conference - press the green receiver (graphic on the right)
<center>
[[File:MessengerCTI.mobile_1.07_Konferencja_3.jpg|230px]]
[[File:MessengerCTI.mobile_1.07_Konferencja_g%C5%82osowa_5.jpg|230px]]
[[File:MessengerCTI.mobile_1.07_Konferencja_g%C5%82osowa_6.jpg|230px]]
</center>
'''Conference edition:'''
* in the Participants tab, click [[File:MessengerCTI.mobile_1.07_Conference_-_edition.png|40px]]
* changes to the settings are possible both when the conference is inactive and during its duration
* the available actions are shown in the graphic below
<center>
[[File:MessengerCTI.mobile_1.07_Konferencja_g%C5%82osowa_7.jpg|230px]]
</center>

=Additional features=
==Uploading files and photos==
The functionality is used to exchange files, documents and photos between different users of the MessengerCTI application (mobile and desktop)
In the Contacts or Recents tab, the User clicks on the status of the other User's MessengerCTI [[File:MessengerCTIMD_chat_free.png|30px]] application, taps the + sign next to the Enter message field, selects one of the available options:
* Attach file
* Attach picture
* Take a foto
then selects a file or takes a photo and confirms
<center>
[[File:MessengerCTI.mobile_1.07_Lokalizacja_5.jpg|230px]]
</center>

==Clipboard==
The clipboard is used to exchange messages, documents and files between the Mobile and Desktop versions of the user's MessengerCTI application.
To initiate it, tap the icon [[File:MessengerCTI.mobile_1.07_Pasek_zadan_-_schowek.png|30px]] and then:
* in the Enter message field, enter text, or
* tap + next to the Enter message field and select one of the available options:
* Attach file
* Attach picture
* Take a foto
then selects a file or takes a photo and confirms
<center>
[[File:MessengerCTI.mobile_1.07_Lokalizacja_5.jpg|230px]]
</center>

==Location==
Between MessengerCTI.Mobile users it is possible to observe the location (only with the consent of the observed person):
* '''User A asks User B for location permission''' (there are several variants to choose from)
* User B approves the request
* User A receives a link to google maps with the current location of User B
<center>
[[File:MessengerCTI.mobile_lokalizacja_1.jpg|230px]]
[[File:MessengerCTI.mobile_lokalizacja_2.jpg|234px]]
[[File:MessengerCTI.mobile_lokalizacja_3.jpg|230px]]
[[File:MessengerCTI.mobile_lokalizacja_4.jpg|225px]]
</center>
or:
* User B decides to send the location to User A
* User B in the Contacts or Recents tab clicks on the status of User A's application, taps on the "+" sign next to the Enter message field and then selects the Send location option
* User A receives a link to google maps with the current location of User B
<center>
[[File:MessengerCTI.mobile_lokalizacja_5.jpg|230px]]
[[File:MessengerCTI.mobile_lokalizacja_6.jpg|230px]]
[[File:MessengerCTI.mobile_lokalizacja_7.jpg|223px]]
</center>

== Contacts==
Contacts tab [[File:MessengerCTI.mobile_1.07_ostatnie_Kontakty_cc_2.jpg|223px]] 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
* groups created by the user personally
The Favorites group is visible by default

By default '''Favourites''' group is visible.
<center>[[File:MessengerCTIM_contacts1.png|300px]]</center>
Adding a contact to favorites:
In the Contacts tab, hold down the name of the selected subscriber. When prompted with the option to add contact to favorites, confirm.

== Call history ==
By default '''Last/Recent''' tab [[File:MessengerCTI.mobile_1.07_ostatnie.jpg|223px]] will be visible and showing calls and chat messages history.
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:
* application status icon, icon that the given user is not using the application or doorphone status
* caller number
* commentary(if number is from phone book outside PBX)
* time and date of call
* icon indicating a phone call or text message

If in history there are missed calls or messages, '''Last/Recent''' field will be marked with red dot. 
History tab allows to call back or reply to messages.

<center>
[[File:MessengerCTI.mobile_1.07_ostatnie_2.jpg|230px]]
</center>

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

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.2.1, 2.2.2, 2.3 and 2.3.1 or 2.3.2

'''Minimum PBX firmware version - 6.53, for VoIP - 6.54'''

==NCP PBX configuration==
From ConfigWEB application:
* '''''Extensions->Settings->CTI application settings''''' menu, configure access number that application will use to call to PBX and make accept incoming call
* in subscriber editing for SIP, FXS, CTS, Messenger CTI number in menu '''''Extensions->Subscribers->CTI settings'''''
** configure GSM phone access number which will have installed application
** set up type of handling incoming calls: call pickup (only application is ringing up) or parallel calling(application and internal phone is ringing up)

'''Minimum software version is: 1.11.'''

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''''

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=

'''Basic:'''
* signaling
** 5529 TCP - Application Signaling (XML)
** 5543 TCP - signaling in the mode with enabled encryption tag (XML)
* VoIP calls
** 5060 UDP - SIP signaling (for calls in VoIP mode)
** 8100 - 8300 UDP - acoustics - for IPx, CCT, MAC PBXes
** 10000 - 20000 UDP - acoustics - for NCP exchanges

'''Additional :'''
* file transfer - only NCP exchanges (clipboard, between users):
** 443 TCP - file transmission without encryption tag enabled (transmission is nevertheless encrypted with HTTPS)
** 5543 TCP - file transmission in the mode with the encryption flag turned on
* image transmission from the DPH.IP doorphone camera
** location of the link to the camera in the control panel:
*** NCP: Extensions/Devices/Cameras
*** IPx, MAC, CCT: Peripherals/Cameras
** during the connection, the PBX sends the camera link to the MessengerCTI application: rtsp://kamery_IP_address:554/login_password_information_additional

'''Example for NCP PBX for MessengerCTI working outside PBX IP network (configuration in ConfigWEB):'''
* XML signaling, VoIP, file transmission - tab Extensions/Settings/Information on CTI settings for subscribers and applications
* sending image from the camera (link to the camera, linking the camera with DPH.IP) - tab Extensions/Devices/Cameras

'''Example configuration data:'''
* PBX IP address: 192.168.0.10
* public IP address of the router: 222.0.0.1
* domain address: firm_name.pl
* camera IP address: 192.168.0.20
* ports used to redirect individual services on the router: 55xx

'''XML Signaling:'''
* MessengerCTI --> router --> NCP
* MessengerCTI --> 222.0.0.1:5555 --> 192.168.0.10:5529, or
* MessengerCTI --> company_name.pl: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.pl:5558 --> 192.168.0.10:5543

'''VoIP calls (signaling)'''
* MessengerCTI --> 222.0.0.1:5556 --> 192.168.0.10:5060
* MessengerCTI --> company_name.pl:5556 --> 192.168.0.10:5060

'''VoIP calls (acoustics)'''
* MessengerCTI --> 222.0.0.1:10000 - 222.0.0.1:20000 --> 192.168.0.10:10000 - 192.168.0.10:20000
* MessengerCTI --> company_name.pl:10000 - company_name.pl: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.pl:5557 --> 192.168.0.10:443

'''File transmission with encryption tag enabled:'''
* MessengerCTI --> 222.0.0.1:5559 --> 192.168.0.10:5543, or
* MessengerCTI --> company_name.pl:5559 --> 192.168.0.10:5543

'''Uploading image from DPH.IP camera'''
* MessengerCTI --> router --> camera
* MessengerCTI --> 222.0.0.1:5560 --> 192.168.0.20:554
* MessengerCTI --> company_name.pl:5560 --> 192.168.0.20:554

=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

=Working in the local network and outside the local network without changing the MessengerCTI configuration=
Changing the network source by the MessengerCTI.desktop or MessengerCTI.mobile user (e.g. LAN <--> Internet <--> LAN, work <--> travel <--> home) always entails changing the configuration of the application, i.e. changing the IP address of the PBX from local to public or vice versa (this situation does not occur if the user only uses LTE/HSPA internet).

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

Example network:
* public address of the router (WAN on the router): address in the decimal system - 203.0.113.1 or domain address - voip.xxxxxx.pl
* local address of the router (LAN on the router, gateway): 192.168.1.1
* PBX address (NCP, IPx, MAC, CCT) in the LAN network: 192.168.1.2
* address of the user's laptop from MessengerCTI.desktop or smartphone from MessengerCTI.Mobile in the LAN: 192.168.1.100

If MessengerCTI from a laptop/smartphone from the local network from the address 192.168.1.100 sends a packet to the public address 203.0.113.1 (voip.xxxxxx.pl), the packet is normally directed to the default gateway - 192.168.1.1 (router). The hairpinning NAT router detects that 203.0.113.1 (voip.xxxxxx.pl) is the address of its WAN interface and treats the packet as if it originated from that interface. Determines the destination for this packet based on DNAT (port forwarding) rules. If the packet was sent to port 5529 (for VoIP: 5060, 8100-8300 for IPx, 10,000 - 20,000 for NCP) and there is a DNAT rule for this port directed to 192.168.1.2, then the PBX receives the packet at this address.

If appropriate DNAT rules exist, address translation is performed - the router rewrites the source local IP address in the packet to a public address. The laptop/smartphone (192.168.1.100) sends the packet, but the central office (192.168.1.2) receives it as coming from 203.0.113.1. When the control panel answers, the process is identical to the laptop/smartphone. In this way, bi-directional communication between a laptop/smartphone in the LAN via a public IP address is possible.

=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. 
To install beta version: 
- If on the phone MessengerCTI is installed, uinstall it. 
- log to Google Play as application tester 
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. 
Click this link:
[https://play.google.com/apps/testing/com.slican.messengercti beta version registration] 
When you will see this info: 
[[File:google_beta.jpg]] 
Click BLUE BUTTON 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 to search also for Slican due to many other application using "messenger" word in their naming. 
- Install application. 
- Configure according to manual.j 
Use beta version features.

MessengerCTI.desktop Manual

2023-05-09T09:14:17Z

Arturs: /* New features in version 1.09 */

=MessengerCTI.desktop ver. 1.09=
==New features in version 1.09==
* Manually and automatically copying the caller's number to the clipboard
* New chat type - Announcements
* Built-in image viewer, quick preview and viewer of all files with a given person
* Encrypted connection in communication with the control panel
* Added information about currently viewed day when scrolling chat
* Introduced "New" header informing since there is new content that has not yet been read
* Allowed to send messages over 3000 characters
* View sent message details (sent and read date)
* Changes in the handling of sending Enter messages (ctrl, shift-Enter, numeric keypad)
* Ability to enable subscriber availability notification (phone or chat)
* Added information about who is writing in group chat
* Ability to password lock access to configuration and application services
* Introducing the ability to send emoticons in chat and SMS
* Supports the ability to remotely (ConfigWEB) delete call history and chat
* Chat spell checker for Polish language
* Preview of the entire CC queue list for callback,
* The ability to copy an image to the clipboard in the preview window,
* Easier work with many chat tabs open at the same time

= 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. Computer 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. Additionally 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, analogue 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). On FXS and SIP phones, these activities always involve physically picking up phone handset. Nevertheless, users of FXS phones will undoubtedly benefit the most, because they gain access to functions completely unavailable for this class of phones.

= Basic Features =
=== 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.Desktop. 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.Desktop user can preview video from camera of other manufacturers, but those devices have to support video formats, codec compatible with VLC application libraries.

=== VoIP Client===
MessengerCTI.Desktop can work as VoIP, parallel phone connected to desk phone (FXS,CTS,IP). User can decide on which device to pick up a call, phone or computer - using its 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 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 ===
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 PBXs linked 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.

=== Listening to recordings ===
Each user with appropriate permissions can listen to call recordings. In this way, it makes it independent from need to use RecordMAN.client application

===Signaling encryption (NCP PBX)===
In order to increase security of sending sensitive data, possibility of enabling encryption has been introduced. XML signaling stream is encrypted. (SIP acoustics and signaling are not encrypted)

===File transfer (NCP PBX)===
Possibility of sending files, documents, photos between users of MessengerCTI application has been introduced. Additionally, user can use clipboard to synchronize their files between MessengerCTI.Desktop and Mobile version

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

= Minimum requirements =
To install SLICAN MessengerCTI.Desktop 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.

{{Warning|
'''MessengerCTI.Desktop''' application works with IPx, MAC and CCT PBX with firmware 6.53 or newer, or NCP PBX with firmware 1.11, however, the operation of some new functionalities is related to the PBX firmware and the full functionality of the application is available only for the latest version of the PBX firmware}}

= Installation of application =
Usage of '''MessengerCTI.Desktop''' 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 [http://slican.pl/servnet/servneten/] and installed on Windows computer. After installing, application should be properly configured by entering necessary PBX information to which software should be connected:
''Settings - Connection'' with PBX.

{{Warning|
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 section "Updating application"

== Running application ==
'''MessengerCTI.Desktop''' can be run just as any other Windows compatible software. In 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 successful 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 automatically 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 - dialing 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 application are available for each of above configurations.

Application '''MessengerCTI.Mobile''' is intended for mobile devices with Android system, its description can be found HERE (manual in progress).

== '''MessengerCTI.Desktop''' with parallel setup ==

===Application with VoIP mode turned OFF===

Phone calls (transmitting acoustic) are made only using phone working alongside application. Application allow to:
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating 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 and SIP phones picking up handset is necessary.

<center>[[File:MessengerCTI.Desktop_without_VoIP.png |800px]]</center>

===Application with VoIP mode turned ON===

Phone calls can be made with phone or with computer and application. Application allow to:
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating 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.

<center>[[File:MessengerCTI.Desktop_with_phone_2.png |800px]]</center>

== '''MessengerCTI.Desktop''' working as deskphone (with NCP only)==

===Application with VoIP mode turned ON===

Phone calls are made only with computer and application. Standalone applications allow:
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating 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.

<center>[[File:MessengerCTI.Desktop_without_phone.png |800px]]</center>

= Application structure =
==Main window==
Main windows of MessengerCTI.Desktop application contains interface which show information and allow access to chat windows and main functions.
<center>[[File:MessengerCTI_1.07_main_window.PNG]]</center>

===Top panel===

[[File:MessengerCTI.Desktop_1.07_main_window_-_upper.png]]

* hyperlink to software version
* application name
* default window position button
* close - minimizing to tray button

[[File:MessengerCTIDesktop_1.07_main_window_-_middle1.png]]
* changing application status button
* user name from Contacts
* description - editable comment field set by user that allow him to add additional descriptive information, e.g. inform about upcoming or being on vacation, about dealing with selected project

[[File:MessengerCTIDesktop_1.07_main_window_-_middle2.png]]
* keyboard - button to open keyboard for dialing numbers with computer mouse

[[File:MessengerCTI.Desktop_1.07_keyboard_en.png]]
* magnifier/search - button / field for searching for number or subscriber's name

[[File:MessengerCTI.Desktop_1.07_main_window_lower.PNG]]
* access to tabs:
** Recent - history of most recent calls and messages
** Contacts - phonebook from PBX with sorting options

* red dot - information:
** about missed calls
** about calls to be called back in CallCenter

===Bottom panel===
[[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 ==
'''MessengerCTI.Dekstop''' software allow 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 message, 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 defined 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. 

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>
{|{{prettytable}}
!{{Hl3}} colspan="2" | Phone status and camera information
|-
!{{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 associated with phone or doorphone, clicking on icon will allow to preview camera video
|-
|}
</center>
<center>'''''Chart 2:''''' Icons displaying status of phone and camera</center>

== Settings==

Selecting '''Open settings''' icon [[File:MessengerCTI.Desktop_1.07_ Settings_en.png]] in main program window will display window with program settings. In every tab there is available button with info '''''About''''' software with information about version application and link to user's '''''WebCTI''''' account.

=== Connection===
In '''''Connection''''' field you must enter settings necessary for application to connect:

<center>[[File:MessengerCTI.Desktop_1.07_connection_en.PNG | 700px]]</center>

'''Application login setting'''

To login, application must have correct settings configured by PBX administrator:
* subscriber number - extension from PBX
* CTI access and password:
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/CTI settings''' - '''CTI - access level to CTI''' and '''Pss - Password'''
** 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:
* '''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 appear 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 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.

In case of problems with application - its stability, functionality, logging, etc. - after detailed description of irregularities, you can submit report using ''Send Logs'' button.

===General===

<center>[[File:MessengerCTI.Desktop_1.07_General_en.png | 700px]]</center>

This window allow to configure settings defining how program works and startup options.
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 call
*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 dialing
**show chat window - opens text chat window
*Return window position - return to previous window position
*Set this window position as default - allow to set up default application's window potion on screen
*Clear application data - deletes all application configuration data, attachments, history

===Notifications===
These setting allow to set up audio notifications informing about incoming calls, messages and audio setting of computer audio devices.

<center>[[File:MessengerCTI.Desktop_1.07_Notifications_en.png | 700px]]</center>

===VoIP===

*Enable VoIP on when available - allow 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.Desktop_1.07_VoIP_en.png | 700px]]</center>

===CallCenter===

This window allow 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>

===Services management===

This window allow to configure Forwarding and DND services

<center>[[File:MessengerCTI.Desktop_1.07_Services_en.png| 800px]]</center>

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

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'''===
<center>[[File:MessengerCTI.Desktop_1.07_outgoing_call_en.png.png | 400px]]</center>

Making calls can be realized in few different way. Depending on how configured are general setting on application - option "Set double click function".
* from '''Contacts''' tab
**choose subscriber from proper group (from drop-down list - if it exist) or from group "All contacts" by double clicking on number or contact
**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)
**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'''''
*using numeric keypad of application
*'''Search''' field - by enter telephone number directly using computer keyboard, then click on green icon handset associated with field
*'''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.

Exemplary scheme of making call from MessengerCTI directly to another subscriber:
<center>[[File:MessengerCTI.Desktop_1.07_outgoing_call_pptx_en.png | 1100px]]</center>

Exemplary scheme of making call from Messenger to hotline:
<center>[[File:MessengerCTI.Desktop_1.07_outgoing_call_DISA_pptx_en.png | 1100px]]</center>

==='''Incoming calls'''===

<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'''===
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 allow to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.

<center>[[File:MessengerCTI.Desktop_1.07_incoming_call_doorphone_en.png]]</center>

==='''Transferring calls - version 1.07'''===
Call can be transferred by choosing contact or number from: Recent or Contacts.
* "blind transfer" - without checking target extensions state
<center>[[File:MessengerCTI.Desktop_1.07_blind_transfer_pptx_en.png | 1200px]]</center>

* no announcing - check target extension state without announcing
<center>[[File:MessengerCTI.Desktop_1.07_transfer_no_announcing_pptx_en.png | 1400px]]</center>

* with announcing - check target extension state with announcing
<center>[[File:MessengerCTI.Desktop_1.07_transfer_with_announcing_pptx_en.png | 1400px]]</center>

==Sending messages==
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.

Functionalities that can be implemented through chat window:
*running text chats between users of MessengerCTI application (desktop and mobile) of same PBX and linked PBX
*sending and receiving SMS
*file transfer (using paperclip button or drag and drop method)
*viewing history calls with given user
*listen to call recordings from calls made (if you have appropriate permissions)

Receiving new message is signalized 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.

<center>[[File:MessengerCTI.Desktop_1.07_Window_Chat_SMS_en.png]]</center>

==Searching data==
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Recents''' and '''Contacts''' tab in '''Search''':

<center>[[File:MessengerCTI.Desktop_1.07_Search_field_en.png]]</center>

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==
This field allows for searching, displaying, customizing and running actions related to contact. By default '''Favorites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.

<center>[[File:MessengerCTI.Desktop_1.07_Contacts_field_en.png]]</center>

Adding contacts is possible:

* from search field - entering number and adding it with green handset icon
* from '''Contacts''' or '''Recent''' tab - right clicking on connection

From contact list we gain access to:
*favorites
*all contacts
*extensions
*created subscriber groups
*public contacts
*private contacts

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

<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:

[[File:MessengerCTI_outgoing_calls.PNG | 32px]]
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.

[[File:MessengerCTI_incoming_calls.PNG | 32px]]
Downward arrow for incoming call that was picked up.

[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]
Turned arrow for missed incoming calls, digit is showing number of these calls.

[[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
, 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 favorite list.

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

<center>[[File:MessengerCTI.Desktop_1.07_Clipboard_tab_en.png]]</center>

== 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 appear allowing to make call and field to confirm if call was successful.

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 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
** 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 functionality 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 necessary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create separate configuration.

* default location of program installation 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 application from shortcuts we can configure each one separately for different numbers

=Ports and protocols=
Default port numbers and types of protocols used by PBX for purpose of providing selected services of MessengerCTI application.

'''Basic:'''
* signaling
** 5529 TCP - application signaling (XML)
** 5543 TCP - signaling in mode with enabled encryption tag (XML)
* VoIP calls
** 5060 UDP - SIP signaling (for VoIP calls)
** 8100 - 8300 UDP - acoustics - for IPx, CCT, MAC PBX
** 10000 - 20000 UDP - acoustics - for NCP PBX

'''Additional:'''
* file transfer - NCP only (clipboard, between users):
** 443 TCP - file transmission without encryption tag enabled (transmission is still HTTPS encrypted)
** 5543 TCP - file transmission in mode with enabled encryption tag
* image transmission from DPH.IP doorphone camera
** location of link to camera in PBX:
*** NCP: Extensions/ Devices/ Cameras
*** IPx, MAC, CCT: Peripherals/ Cameras
** during connection, PBX sends camera link to MessengerCTI application: rtsp://IP_addr_camera:554/login_password_additional_information

'''Example for NCP for MessengerCTI working from outside PBX IP network (configuration in ConfigWEB):'''
* XML signaling, VoIP, file transmission - Extensions/ Settings/ Information about CTI settings for subscribers and applications tab
* sending image from camera (link to camera, linking camera with DPH.IP) - tab Extensions/ Devices/ Cameras

'''Sample configuration data:'''
* IP PBX address: 192.168.0.10
* public IP router address: 222.0.0.1
* domain address: company_name.com
* IP camera 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
* MessengerCTI --> company_name.com:5556 --> 192.168.0.10:5060

'''VoIP calls (acoustics)'''
* MessengerCTI --> 222.0.0.1:10000 - 222.0.0.1: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

'''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 transferring from DPH.IP camera'''
* MessengerCTI --> router --> camera
* MessengerCTI --> 222.0.0.1:5560 --> 192.168.0.20:554
* MessengerCTI --> company_name.com:5560 --> 192.168.0.20:554.

=Operation of MessengerCTI.Desktop in local network and outside network without changing configuration=
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.
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.

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

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 those packets as if it came from that interface. Determines destination for these packets based on DNAT rules (port forwarding). If packets have 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 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.

If no DNAT rules are active, router will discard packets. In this case, it may return an ICMP Destination Unreachable reply.

Main Page

2023-01-19T13:04:20Z

Arturs: /* Software */

{{titled_frame|
|title-font-size=200%
|title-align=center
|image=
|title=Slican '''PUB'''lic '''WIKI''' in '''EN'''glish
|text= '''KNOWLEDGE BASE OF SLICAN PRODUCTS USRES - ENJOY READING'''
}}

=News=
{{titled_frame|
|title-font-size=200%
|title-align=center
|image=File:news_4.png
|title=Important news
|text=
* [[MessengerCTI.desktop_v_1.07_Manual | '''MessengerCTI.Desktop Manual''' - new desktop version for Windows]]
* [[MessengerCTI.mobile_v_1.07_Manual | '''MessengerCTI.Mobile Manual''' - new mobile version for Android]]
* [[CTS-220_WiFi | WiFi support for CTS-220 phones]]
* [[Slican_Device_Config | Slican Device Config - new configuration tool for DPH.IP doorphones, cameras and AUD.IP devices]]
* [[Slican_audio_system | Audio.IP - new sound and broadcast system]]
* [http://pubwiki.slican.com/index.php/DPH.IP_doorphone New doorphones and card readers - DPH.IP series]
* [http://pubwiki.slican.com/index.php/NCP_technical_data New PBX - NCP-PBX]
* [[VoIP_account_in_CM_6.30_en | The change in the configuration of VoIP accounts in software version 6.30!]]
}}

=NCP-PBX=
{{titled_frame|
|title-font-size=200%
|title-align=center
|image=File:CM400_swicth_GW.png
|title=NCP IPPBX
|text=

* [[NCP technical data| NCP-PBX informations]]
* [[NCP technical specification|Technical specification]]
* [[Media:NCP_services.pdf|Services description]]
}}

={{Bialy|NCP Switch}}=
{{titled_frame|
|title-font-size=200%
|title-align=center
|image=File:Switch_NCPSW242S_P150.png|50px
|title= NCP Switch
|text=
* [[Switch_NCP-SW242S| Switch NCP-SW242S and NCP-SW242S.P150 Information]]
}}

=IPL-0256=
{{Bialy|IPL-0256}}
{{titled_frame|
|title-font-size=200%
|title-align=center
|image=File:IPL_both.jpg
|title=Slican IPL-256 telecommunication server
|text=

* [[IPL Technical_information | IPL-256 information]]
* [[IPL manual | Instruction Manual]]
* [[Software | Supported applications]]
}}

=IPM-032=
{{Bialy|IPM-032}}
{{titled_frame|
|title-font-size=200%
|title-align=center
|image=File:IPM-032 obie.jpg
|title=Slican IPM-032 telecommunication server
|text=
* [[IPM Technical information| IPM-032 information]]
* [[IPM instruction manual | Instruction Manual]]
* [[Software | Supported applications]]
}}

=IPU-14=
{{Bialy|IPU-14}}
{{titled_frame
|title-font-size=200%
|title-align=center
|image=File:IPU_front_small.png
|title=Slican IPU-14 telecommunication server
|text=

* [[IPU_technical_information/IPU_technical_information| IPU-14 information]]
* [[IPU manual | Instruction manual]]
* [[Software | Supported applications]]
}}

=IPS-08=
{{titled_frame|
|title-font-size=200%
|title-align=center
|image=File:ITS Rzut small.jpg
|title=Slican IPS-08 Telecommunication server
|text=

* [[Dane_techniczne_centrali_IPS-08/IPS Technical information| IPS-08 information]]
* [[IPS manual | Instruction Manual]]
* [[Software | Supported applications]]
* [[IPS_firmware | IPS-08 firmware]]
}}

=ITS=
{{titled_frame|
|title-font-size=200%
|title-align=center
|image=File:ITS Rzut small.jpg
|title=Slican ITS
|text=

* [[Slican ITS | ITS - information]]
* [[ITS Instruction manual]]
* [[ITS - PBX firmware]]
* [[Slican ITS#Models| ITS Models ]]
* [[Slican_ITS_View#Terminals_View| ITS Terminals]]
}}

={{Bialy|Slican phones}}=
{{titled_frame|
|title-font-size=200%
|title-align=center
|image=File:all_phones.png|330px
|title=Slican phones
|text=

* [[CTS-102 - information|CTS-102.CL CTS-102.HT CTS-102.IP - Instruction manual]]
* [[CTS-202 - information|CTS-202.CL CTS-202.BT CTS-202.IP CTS-203.IP-PoE - Instruction manual]]
* [[CTS-220 information|CTS-220 - Instruction manual]]
* [[CTS-330 information|CTS-330/CTS-330.IP - Information]]
* [[XL-2023ID - information|XL-2023ID - Instruction manual]]
* [[VPS - VoIP phones]]
}}

={{Bialy| Slican Audio system}}=
{{titled_frame|
|title-font-size=200%
|title-align=center
|image=File:Audio.png|330px
|title=Slican Audio system
|text=

* [[Slican_audio_system| Slican Audio system]]
* [[CTS-220.IP-GNM_Instruction_manual | CTS-220.IP-GNM Instruction manual ]]
}}

={{Bialy|Doorphone PBX and doorphone systems}}=
{{titled_frame|
|title-font-size=200%
|title-align=center
|image=Image:Bramofony.jpg‎
|title= Doorphone PBX and doorphone systems
|text=

* [[DPH 1- and 2-button doorphone_v1_02|DPH.AB - 1- and 2- button doorphones]]
* [[DPH 16-button doorphone_v1_02|DPH.AB - 16-button doorphone]]
* [[DPH.IP doorphone|DPH.IP doorphones]]
* [[Case cover KS.C93N-INOX]]
* [[Case cover KS.C93P-INOX]]
* [[Case cover KS.C120N-INOX]]
* [[HAS-3000 - Instruction manual]]
* [[HAS-3032 - Instruction manual]]
* [[Uniphone | Uniphone - extension of Slican HAS doorphone system]]
}}

={{Bialy|Other products}}=
{{titled_frame|
|title-font-size=200%
|title-align=center
|image=Image:MAB_1101_S.jpg
|title=Other products
|text=

* [[MAB-1101 information]]
* [[MAB-1101 Instruction manual]]
* [[MSB-1102 Instruction manual]]
* [[Installation_Elements | Installation elements - patchpanels and cable clamping shelfs]]
}}

=DECT system=
{{titled_frame|
|title-font-size=200%
|title-align=center
|image=File:DECT.PNG
|title=System DECT
|text=

* [[Opinion concerning Slican DECT-IP system]]
* [[FAQ - DECT]]
}}

=Software=
{{titled_frame|
|title-font-size=200%
|title-align=center
|image=File:Billingman.jpg
|title=Computer software
|text=
* [[WebCTI|WebCTI Instruction manual]]
* [[MessengerCTI.desktop_Manual|MessengerCTI.Desktop Manual - text messenger, phone supporting tool, doorphone access, camera video preview]]
* [[MessengerCTI.Mobile_Manual|MessengerCTI.Mobile Manual- mobile verson of MessengerCTI for Android operating system devices]]
* [[PhoneCTI|PhoneCTI Instruction manual]]

* [[RecordMAN.client|RecordMAN.client Instruction manual]] - application to maintain recordings (downloading, playing, searching) stored using embedded recording systems working in CCT-1668, CXS-0424, MAC-6400, IPL-0256, IPM-032, IPU-14.
* [[SenderSMS_manual|SenderSMS Instruction manual]] - application for sending/receiving group SMS messages
* [[RecordMAN.server|RecordMAN.server Instruction manual]] - application to automatic downloading recording from PBX.
* [[TouchCTI Instruction manual|TouchCTI]] - application to computer maintaining incoming calls using touch screen
* [[BillingMAN_Instruction_manual |BillingMAN]] - application for call charges maintaining
* [[TAPI]] - driver for cooperating Slican servers with external applications ex. MS Outlook
}}

=VoIP=
{{titled_frame|
|title-font-size=200%
|title-align=center
|image=File:VoIP_Slican_Wiki.png
|title=VoIP in Slican
|text=
* [[VoIP call quality | VoIP call quality]]
* [[Skype_in_Slican_server |How to configure Skype for cooperation with Slican server?]]
}}

=Withdrawn products=
{{titled_frame|
|title-font-size=200%
|title-align=center
|image=File:CXS 300px.jpg
|title=Withdrawn products
|text=
[[Product withdrawn from production]]
}}

MessengerCTI.desktop Manual

2023-01-19T13:02:37Z

Arturs: Created page with "=MessengerCTI.desktop ver. 1.09= ==New features in version 1.09== * Manually and automatically copying the caller's number to the clipboard * New chat type - Announcements * B..."

=MessengerCTI.desktop ver. 1.09=
==New features in version 1.09==
* Manually and automatically copying the caller's number to the clipboard
* New chat type - Announcements
* Built-in image viewer, quick preview and viewer of all files with a given person
* Encrypted connection in communication with the control panel
* Added information about currently viewed day when scrolling chat
* Introduced "New" header informing since there is new content that has not yet been read
* Allowed to send messages over 3000 characters
* View sent message details (sent and read date)
* Changes in the handling of sending Enter messages (ctrl, shift-Enter, numeric keypad)
* Ability to enable subscriber availability notification (phone or chat)
* Added information about who is writing in group chat
* Ability to password lock access to configuration and application services
* Introducing the ability to send emoticons in chat and SMS
* Supports the ability to remotely (ConfigWEB) delete call history and chat
* Chat spell checker for Polish language

= 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. Computer 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. Additionally 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, analogue 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). On FXS and SIP phones, these activities always involve physically picking up phone handset. Nevertheless, users of FXS phones will undoubtedly benefit the most, because they gain access to functions completely unavailable for this class of phones.

= Basic Features =
=== 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.Desktop. 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.Desktop user can preview video from camera of other manufacturers, but those devices have to support video formats, codec compatible with VLC application libraries.

=== VoIP Client===
MessengerCTI.Desktop can work as VoIP, parallel phone connected to desk phone (FXS,CTS,IP). User can decide on which device to pick up a call, phone or computer - using its 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 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 ===
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 PBXs linked 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.

=== Listening to recordings ===
Each user with appropriate permissions can listen to call recordings. In this way, it makes it independent from need to use RecordMAN.client application

===Signaling encryption (NCP PBX)===
In order to increase security of sending sensitive data, possibility of enabling encryption has been introduced. XML signaling stream is encrypted. (SIP acoustics and signaling are not encrypted)

===File transfer (NCP PBX)===
Possibility of sending files, documents, photos between users of MessengerCTI application has been introduced. Additionally, user can use clipboard to synchronize their files between MessengerCTI.Desktop and Mobile version

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

= Minimum requirements =
To install SLICAN MessengerCTI.Desktop 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.

{{Warning|
'''MessengerCTI.Desktop''' application works with IPx, MAC and CCT PBX with firmware 6.53 or newer, or NCP PBX with firmware 1.11, however, the operation of some new functionalities is related to the PBX firmware and the full functionality of the application is available only for the latest version of the PBX firmware}}

= Installation of application =
Usage of '''MessengerCTI.Desktop''' 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 [http://slican.pl/servnet/servneten/] and installed on Windows computer. After installing, application should be properly configured by entering necessary PBX information to which software should be connected:
''Settings - Connection'' with PBX.

{{Warning|
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 section "Updating application"

== Running application ==
'''MessengerCTI.Desktop''' can be run just as any other Windows compatible software. In 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 successful 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 automatically 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 - dialing 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 application are available for each of above configurations.

Application '''MessengerCTI.Mobile''' is intended for mobile devices with Android system, its description can be found HERE (manual in progress).

== '''MessengerCTI.Desktop''' with parallel setup ==

===Application with VoIP mode turned OFF===

Phone calls (transmitting acoustic) are made only using phone working alongside application. Application allow to:
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating 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 and SIP phones picking up handset is necessary.

<center>[[File:MessengerCTI.Desktop_without_VoIP.png |800px]]</center>

===Application with VoIP mode turned ON===

Phone calls can be made with phone or with computer and application. Application allow to:
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating 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.

<center>[[File:MessengerCTI.Desktop_with_phone_2.png |800px]]</center>

== '''MessengerCTI.Desktop''' working as deskphone (with NCP only)==

===Application with VoIP mode turned ON===

Phone calls are made only with computer and application. Standalone applications allow:
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating 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.

<center>[[File:MessengerCTI.Desktop_without_phone.png |800px]]</center>

= Application structure =
==Main window==
Main windows of MessengerCTI.Desktop application contains interface which show information and allow access to chat windows and main functions.
<center>[[File:MessengerCTI_1.07_main_window.PNG]]</center>

===Top panel===

[[File:MessengerCTI.Desktop_1.07_main_window_-_upper.png]]

* hyperlink to software version
* application name
* default window position button
* close - minimizing to tray button

[[File:MessengerCTIDesktop_1.07_main_window_-_middle1.png]]
* changing application status button
* user name from Contacts
* description - editable comment field set by user that allow him to add additional descriptive information, e.g. inform about upcoming or being on vacation, about dealing with selected project

[[File:MessengerCTIDesktop_1.07_main_window_-_middle2.png]]
* keyboard - button to open keyboard for dialing numbers with computer mouse

[[File:MessengerCTI.Desktop_1.07_keyboard_en.png]]
* magnifier/search - button / field for searching for number or subscriber's name

[[File:MessengerCTI.Desktop_1.07_main_window_lower.PNG]]
* access to tabs:
** Recent - history of most recent calls and messages
** Contacts - phonebook from PBX with sorting options

* red dot - information:
** about missed calls
** about calls to be called back in CallCenter

===Bottom panel===
[[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 ==
'''MessengerCTI.Dekstop''' software allow 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 message, 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 defined 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. 

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>
{|{{prettytable}}
!{{Hl3}} colspan="2" | Phone status and camera information
|-
!{{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 associated with phone or doorphone, clicking on icon will allow to preview camera video
|-
|}
</center>
<center>'''''Chart 2:''''' Icons displaying status of phone and camera</center>

== Settings==

Selecting '''Open settings''' icon [[File:MessengerCTI.Desktop_1.07_ Settings_en.png]] in main program window will display window with program settings. In every tab there is available button with info '''''About''''' software with information about version application and link to user's '''''WebCTI''''' account.

=== Connection===
In '''''Connection''''' field you must enter settings necessary for application to connect:

<center>[[File:MessengerCTI.Desktop_1.07_connection_en.PNG | 700px]]</center>

'''Application login setting'''

To login, application must have correct settings configured by PBX administrator:
* subscriber number - extension from PBX
* CTI access and password:
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/CTI settings''' - '''CTI - access level to CTI''' and '''Pss - Password'''
** 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:
* '''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 appear 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 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.

In case of problems with application - its stability, functionality, logging, etc. - after detailed description of irregularities, you can submit report using ''Send Logs'' button.

===General===

<center>[[File:MessengerCTI.Desktop_1.07_General_en.png | 700px]]</center>

This window allow to configure settings defining how program works and startup options.
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 call
*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 dialing
**show chat window - opens text chat window
*Return window position - return to previous window position
*Set this window position as default - allow to set up default application's window potion on screen
*Clear application data - deletes all application configuration data, attachments, history

===Notifications===
These setting allow to set up audio notifications informing about incoming calls, messages and audio setting of computer audio devices.

<center>[[File:MessengerCTI.Desktop_1.07_Notifications_en.png | 700px]]</center>

===VoIP===

*Enable VoIP on when available - allow 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.Desktop_1.07_VoIP_en.png | 700px]]</center>

===CallCenter===

This window allow 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>

===Services management===

This window allow to configure Forwarding and DND services

<center>[[File:MessengerCTI.Desktop_1.07_Services_en.png| 800px]]</center>

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

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'''===
<center>[[File:MessengerCTI.Desktop_1.07_outgoing_call_en.png.png | 400px]]</center>

Making calls can be realized in few different way. Depending on how configured are general setting on application - option "Set double click function".
* from '''Contacts''' tab
**choose subscriber from proper group (from drop-down list - if it exist) or from group "All contacts" by double clicking on number or contact
**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)
**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'''''
*using numeric keypad of application
*'''Search''' field - by enter telephone number directly using computer keyboard, then click on green icon handset associated with field
*'''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.

Exemplary scheme of making call from MessengerCTI directly to another subscriber:
<center>[[File:MessengerCTI.Desktop_1.07_outgoing_call_pptx_en.png | 1100px]]</center>

Exemplary scheme of making call from Messenger to hotline:
<center>[[File:MessengerCTI.Desktop_1.07_outgoing_call_DISA_pptx_en.png | 1100px]]</center>

==='''Incoming calls'''===

<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'''===
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 allow to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.

<center>[[File:MessengerCTI.Desktop_1.07_incoming_call_doorphone_en.png]]</center>

==='''Transferring calls - version 1.07'''===
Call can be transferred by choosing contact or number from: Recent or Contacts.
* "blind transfer" - without checking target extensions state
<center>[[File:MessengerCTI.Desktop_1.07_blind_transfer_pptx_en.png | 1200px]]</center>

* no announcing - check target extension state without announcing
<center>[[File:MessengerCTI.Desktop_1.07_transfer_no_announcing_pptx_en.png | 1400px]]</center>

* with announcing - check target extension state with announcing
<center>[[File:MessengerCTI.Desktop_1.07_transfer_with_announcing_pptx_en.png | 1400px]]</center>

==Sending messages==
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.

Functionalities that can be implemented through chat window:
*running text chats between users of MessengerCTI application (desktop and mobile) of same PBX and linked PBX
*sending and receiving SMS
*file transfer (using paperclip button or drag and drop method)
*viewing history calls with given user
*listen to call recordings from calls made (if you have appropriate permissions)

Receiving new message is signalized 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.

<center>[[File:MessengerCTI.Desktop_1.07_Window_Chat_SMS_en.png]]</center>

==Searching data==
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Recents''' and '''Contacts''' tab in '''Search''':

<center>[[File:MessengerCTI.Desktop_1.07_Search_field_en.png]]</center>

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==
This field allows for searching, displaying, customizing and running actions related to contact. By default '''Favorites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.

<center>[[File:MessengerCTI.Desktop_1.07_Contacts_field_en.png]]</center>

Adding contacts is possible:

* from search field - entering number and adding it with green handset icon
* from '''Contacts''' or '''Recent''' tab - right clicking on connection

From contact list we gain access to:
*favorites
*all contacts
*extensions
*created subscriber groups
*public contacts
*private contacts

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

<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:

[[File:MessengerCTI_outgoing_calls.PNG | 32px]]
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.

[[File:MessengerCTI_incoming_calls.PNG | 32px]]
Downward arrow for incoming call that was picked up.

[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]
Turned arrow for missed incoming calls, digit is showing number of these calls.

[[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
, 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 favorite list.

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

<center>[[File:MessengerCTI.Desktop_1.07_Clipboard_tab_en.png]]</center>

== 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 appear allowing to make call and field to confirm if call was successful.

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 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
** 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 functionality 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 necessary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create separate configuration.

* default location of program installation 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 application from shortcuts we can configure each one separately for different numbers

=Ports and protocols=
Default port numbers and types of protocols used by PBX for purpose of providing selected services of MessengerCTI application.

'''Basic:'''
* signaling
** 5529 TCP - application signaling (XML)
** 5543 TCP - signaling in mode with enabled encryption tag (XML)
* VoIP calls
** 5060 UDP - SIP signaling (for VoIP calls)
** 8100 - 8300 UDP - acoustics - for IPx, CCT, MAC PBX
** 10000 - 20000 UDP - acoustics - for NCP PBX

'''Additional:'''
* file transfer - NCP only (clipboard, between users):
** 443 TCP - file transmission without encryption tag enabled (transmission is still HTTPS encrypted)
** 5543 TCP - file transmission in mode with enabled encryption tag
* image transmission from DPH.IP doorphone camera
** location of link to camera in PBX:
*** NCP: Extensions/ Devices/ Cameras
*** IPx, MAC, CCT: Peripherals/ Cameras
** during connection, PBX sends camera link to MessengerCTI application: rtsp://IP_addr_camera:554/login_password_additional_information

'''Example for NCP for MessengerCTI working from outside PBX IP network (configuration in ConfigWEB):'''
* XML signaling, VoIP, file transmission - Extensions/ Settings/ Information about CTI settings for subscribers and applications tab
* sending image from camera (link to camera, linking camera with DPH.IP) - tab Extensions/ Devices/ Cameras

'''Sample configuration data:'''
* IP PBX address: 192.168.0.10
* public IP router address: 222.0.0.1
* domain address: company_name.com
* IP camera 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
* MessengerCTI --> company_name.com:5556 --> 192.168.0.10:5060

'''VoIP calls (acoustics)'''
* MessengerCTI --> 222.0.0.1:10000 - 222.0.0.1: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

'''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 transferring from DPH.IP camera'''
* MessengerCTI --> router --> camera
* MessengerCTI --> 222.0.0.1:5560 --> 192.168.0.20:554
* MessengerCTI --> company_name.com:5560 --> 192.168.0.20:554.

=Operation of MessengerCTI.Desktop in local network and outside network without changing configuration=
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.
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.

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

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 those packets as if it came from that interface. Determines destination for these packets based on DNAT rules (port forwarding). If packets have 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 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.

If no DNAT rules are active, router will discard packets. In this case, it may return an ICMP Destination Unreachable reply.

MessengerCTI.Mobile Manual

2022-12-21T14:12:36Z

Arturs:

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

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.
 
==Application advantages==
* application available(for free) from Google Play store - only CTI.plus license applied to PBX is required
* phone book with access to subscribers availability(chat, phone status, text status)
* option of adding and removing subscribers from favorite group, synchronised with MessengerCTI.Desktop
* history of recent calls/messages sorted chronologically
* logging with phone simultaneously as desk phone or as separate MessengerCTI subscriber(NCP PBX only)
* chat/messenger
* chat history with phone call history
* voice calling through GSM(two connection options- capture or parallel)
* flexible configuration of audio notifications
* access to PBX services configuration from phone
* rapid access number for fast call forwarding
* option of setting up busy status of desk phone if GSM is buy (on by default)
* option of setting up incoming call denying on GSM if desk phone is busy
* option of copying text from chat
* support of DualSim smartphone or two phones simultaneously (private or business)
* convenient access to opening door/gate if receiving call from doorphone DPH.IP or from context contacts menu
* additional desktop widget for fast access to open DPH.IP doorphone doors
* automatic delay of notifications for MessengerCTI.Mobile if desk phone or MessengerCTI.desktop is active
* option of copying contact from local phone book to PBX phone book

{{Attention!|
*For proper operation MessengerCTI.Mobile and PBX must have permanent access to Internet, fixed public IP address for PBX or forwarding port 5529 on edge router when PBX is on LAN behind NAT.
*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
*opening the door using the context menu or widget is available only after starting the ACS system}}

= Basic functionalities =
Using a smartphone, the application user gains mobility and still has the option of using the PBX as an internal subscriber.

<big>''' VoIP and GSM client '''</big>
'''''MessengerCTI.Mobile'''''parallel telephone, associated with the desk telephone equipment, landline (FXS, CTS, SIP). The application can work as a VoIP or GSM client. The user decides on which device to answer the call and make the call - phone or smartphone. A new feature is the ability to use the application as a standalone phone in NCP PBXes (from PBX firmware version 1.11). The CTIuserPlus license is required for its proper operation.

'''''Configuration in VoIP mode''''' - basic configuration for using the application. Both conducted calls and other information, e.g. about the caller's number, contacts in the directory, subscriber statuses, chats - are sent via the IP network (WiFi, Internet LTE/HSPA)

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

Switching between VoIP and GSM mode can be performed by the user from the application level (provided that he has the appropriate configuration on the PBX).

<big>'''Contact book'''</big>

A great advantage of the software is easy and convenient access to contacts from the PBX telephone books and displaying them on the user's smartphone. MessengerCTI.Mobile uses only the books stored in the PBX. Contacts can be grouped according to user requirements. Entering new subscribers and modifying existing entries can be made both from the system phone and in a more convenient way, from a computer - MessengerCTI.Desktop or WebCTI. The modification is visible immediately after its introduction. Access to the directory allows you to easily and conveniently search for the number of the person you want to call in the database. On the other hand, during incoming calls, clear information about the caller is displayed on the smartphone screen.

<big>'''Call history'''</big>
The user of the program has access to the history of all his calls, both received and missed. It is saved in the Slican central. Using MessengerCTI, you can display it, obtain information about the order of calls, date and time of their execution, as well as about the sum of missed calls made from the same number.

<big>'''CallCenter'''</big>
In conjunction with NCP PBXes for Call Center agents, the functionality of handling queues has been introduced. It allows e.g. logging in to one of them, viewing its status, answering and making calls, calling back lost and abandoned calls, enabling the status of temporary breaks in work.

<big>'''Text messages'''</big>

Using MessengerCTI.Mobile, you can send text information - from an internal communicator (chat) via a computer network - to another person who has MessengerCTI.Desktop or MessengerCTI.Mobile. The chat can be used by all subscribers of a given PBX and PBXes linked to it with the eSSL ver.2 system. This functionality is particularly attractive for those companies that, having Slican exchanges, do not allow the use of public messengers for security reasons. To ensure parallel access from different devices (computer, smartphone), chat history is saved directly in the PBX and synchronized with the MessengerCTI applications on an ongoing basis. An extension of this functionality is the ability to chat with many users at the same time, i.e. the so-called text conference.

<big>'''Text and voice conferencing'''</big>

A functionality that allows you to exchange messages / talk to many users at the same time.

<big>'''File transfer'''</big>
Between MessengerCTI application users (desktop, mobile) it is possible to send files, e.g. photos, documents

<big>'''Location Sharing'''</big>

Due to mobility - the user can make the observation of his location available to selected people. An authorized person gains the ability to observe its location.

<big>'''Support for cameras and DPH.IP doorphone'''</big>

The introduction of DPH.IP doorphones with camera support for sale forced the creation of an option for displaying video images from them. Such a possibility was introduced in the MessengerCTI.Mobile application. In the case of a connection from the doorphone to the application user, the image from his camera appears in the window. After receiving and carrying out the call, and without the need to talk to the person at the doorphone, only after visual identification, you can open the door, gate or barrier using a special button. Also in the opposite direction, when calling the doorphone or any other extension number associated with the camera, the image from the camera appears on the monitor screen. This allows for temporary observation of the surroundings of the installed camera, e.g. the person we are calling. It is also possible to select and observe the image from any camera without the need to make a connection, just by indicating the associated icon in the application. Using MessengerCTI.Mobile it is also possible to use cameras from other manufacturers, but they must support video formats and codecs compatible with VLC application libraries. Opening the door using the context menu or widget is available only after starting the ACS system.

<big>'''Works with the desktop version'''</big>

The application can also be used in parallel and synchronized with MessengerCTI.Desktop, i.e. the version for a computer with Windows.

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

For installing application minimum requirements must be met:
* Android operating system
** minimum version: KitKat 4.4.4
** minimum recommended version: Nougat 7.0
** 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.

{{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 regulating microphone gain for VoIP calls
* opening the door using the context menu or widget is available only after starting the ACS system}} 

{{Attention!|
'''''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.
During the installation, you are prompted to provide some permissions and change phone settings. They may differ, depending on the Android version and phone type. You can accept them all or select only those related to the functionalities that will be used:
* Camera - for scanning the QR code and taking and sending photos
* Location - to share the location
* Microphone - for making calls in VoIP mode
* Internal storage - for saving photos, transferring files and using the clipboard
* Telephone - to use the application in GSM mode
* Contacts - for copying contacts to the local phone database (only used in some versions of the application)
* Displaying above other applications - should be made available so that you can answer the call correctly when the application is, for example, dormant
* Disable battery optimization - Battery optimization for the app must be disabled to prevent it from going into deep sleep

After installing application, it must be configured for connecting to PBX: '''''Settings->Account''''' (described below).

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

== Starting application ==

'''''MessengerCTI.Mobile''''' application runs just like any other application working 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. 

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

<big>'''Account'''</big>
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 address or IP address of local PBX(public IP address for users outside LAN) : port used for communication with PBX - by default set to TCP 5529
* Encrypted transmission: encryption of the XML protocol
* Self-signed certificate
* Read data from QRCode: instead of manual configuration - the ability to scan the QRcode sent to the user's e-mail box when configuring the CTI settings in the NCP PBX or from the WebCTI website
After entering the data, confirm with the save and connect button

<center>[[File:Messenger_wid_konf.jpg|800px]]</center>

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

<center>[[File:MessengerCTI.mobile_1.07_WebCTI.png|800px]]</center>

<big>'''Calls'''</big>
Options to activate the button on the headphones and the microphone gain level

<center>[[File:calls.jpg|230px]]</center>

<big>'''Call center'''</big>
Ability to run up to 4 login/logout buttons and agent breaks related to Call Center queues

<center>[[File:cc.jpg|230px]]</center>

<big>'''Other'''</big>

Other application settings are shown in the attached graphic.

<center>[[File:other.jpg|230px]]</center>

The Debug option - enabled at the request of the software supplier - is related to solving problems with the correct operation of the application

When this option is enabled, an additional Send logs by email field appears in the About tab. We choose the mail client from which we will send the application logs for analysis on the manufacturer's side.

=== Services===
Configuring application services related to connections/calls:
* Default connection type - settings for making calls via GSM, VoIP or VoIP via WiFi
* Global services for PBX:
** DND: Do not Disturb
** Internal no. busy when GSM talking
** FWD - call forwarding settings: all, when busy or when no answer

=== My description ===
Setting text status that will be visible to other MessengerCTI.Users or on screen of CTS-330 system phone.

===Notifications===
<big>'''Configuring incoming call notifications'''</big>

* ringtone: selection of one from the list available in the application with the option of muting it after a certain period of time
* ringtone vibration
* missed call bar notification
* schedule of notifications for the call ringer - the ability to set a weekly plan of active use (turning on ringing at certain times)

<big>'''Configure chat message notifications'''</big>
* message sound: choose one from the list available in the application
* wibracje przy wiadomości
* notification in the bar about a new chat message
* notification schedule for messages - the ability to set a weekly plan of active use (turn on notifications at specific times)

<big>'''Notification delay'''</big>
A functionality that allows you to delay the ringing signal of the mobile application by 15 seconds in relation to the ringtone of the phone associated with it (usually landline).

After launching MessengerCTI.mobile - the landline phone and the application will ring simultaneously during an incoming call. If we are the first to answer the phone, the application will "remember" that we are in its vicinity and will delay its ringing during the next call.
It ceases to apply when:
* we will not answer the call
* we will answer the call with the application

<big>'''Fast forwarding'''</big>
A list of the 3 most important user numbers (external and external) displayed during a call for simple call transfer.

=== About software ===
Information about:
* current software version
* type of connected PBX
* PBX firmware version
* own number: CTI account number(internal PBX extension)
* own comment: user comment made by administrator
* link to send application logs

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

= Application structure =
== Main window ==
Main application windows give access to three tabs:
* '''Last''' - history of calls, chat messages and users statuses.
* '''Contacts''' - access to PBX phone book with sorting options:favourites, internal, external.
* '''CC''' - handling calls from Call Center queues, the ability to log in/out and call back

Additionally:
* App login status icon with default connection type
* Configuration menu - application and service settings
* Mute ringtone - instantly mute the ringtone and app notifications
* Clipboard - for sharing data between the mobile and desktop application
* Search engine - searching for a contact by name and number
* Creating a conference
* Keypad - select the target number

<center>[[File:Messenger eng opis.jpg]]</center>

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

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

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

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

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

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

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

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

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

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

==Making calls==
Two ways of making calls:
* from '''Contacts''' tab - choosing subscriber from particular group (if applicable), or from "All contacts" group. Call is made by touching contact tab, then choosing icon from drop down menu.
* from '''Contacts''' tab- searching for contact name in '''Search''' field by using keyboard then touching lower right corner of keyboard

<center>
[[File:szuk.jpg|210px]]
[[File:MessengerCTIM_out_ext1.png|790px]]
</center>
* from '''Last/Recent''' - find subscriber which we had shared call(he called or we called him) and then make call by touching middle part of contact tab and choosing action from drop down menu
<center>[[File:MessengerCTIM_out_number1.png|570px]]</center>
* from '''Search field''' tab- searching for phone number in '''Search''' field by by typing the phone number directly from the keyboard, and then tapping the green receiver on the right

<center>
[[File:szu_num.jpg|230px]]</center>

'''Configuration in VoIP''' mode - basic configuration for using the application. Both conducted calls and other information, e.g. about the caller's number, contacts in the directory, subscriber statuses, chats - are sent via the IP network (WiFi, Internet - HSPA, LTE)

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

Switching between VoIP and GSM mode can be performed by the user from the application level (provided that he has the appropriate configuration on the PBX). Due to that reason, required city line for PBX must be at least ISDN BRA.
'''The presented connection details on the smartphone display differ depending on the mode of its connection. The connection looks different in VoIP mode than in GSM mode due to the need to use the native telephone dialer. An example of an outgoing call made in VoIP configuration.'''
<center>
[[File:voipout1.jpg|233px]]
[[File:voipout2.jpg|230px]]
</center>
'''Outgoing call made in VoIP configuration.'''

<center>
[[File:gsmout1.jpg|230px]]
[[File:gsmout2.jpg|230px]]
</center>

==Incoming calls==
Incoming calls are displayed with a call popup and ringtone configured in the app's notification settings. Calls are answered by moving the icon with the green handset, if the phone was turned off, or by pressing the green button. If we want to reject the call, it can be done by moving the red handset or pressing the red button. If additional pop-up numbers have been set, the call can be forwarded to them by moving the icon with the pop-up number. The process of accepting incoming calls in the GSM mode consists in making a return call via the GSM line to the application access number defined by the PBX administrator.

<center>[[File:MessengerCTIM_incoming2.png|700px]]</center>

You can direct an incoming call to another person. This can be done before answering the call or during it (with or without notification):
* instantly - by pressing the button with a quick contact, or
* select a number from your contacts list or recent calls

During a conversation, the user has the option of muting the microphone and/or turning on the loudspeaker mode.

'''The presented connection details on the smartphone display differ depending on the mode of its connection. The connection looks different in VoIP mode than in GSM mode (due to the need to use the phone's native dialer)'''

'''An example of an incoming call made in VoIP configuration'''

<center>
[[File:in1.jpg|230px]]
[[File:in2.jpg|230px]]
[[File:in3.jpg|230px]]
</center>
Connection setup and conversation are carried out entirely over the IP network (WiFi or LTE/HSPA Internet)

'''An example of an incoming call made in the GSM configuration (in the call interception mode)'''

This mode consists in the following:

The call for the user is an incoming call, but from the Slican PBX it is sent to the phone and the MessengerCTI application via the IP network - WiFi or Internet LTE/HSPA information about the incoming call and the MessengerCTI application initiates an outgoing call from the user's phone to the PBX (via the GSM operator) and there it joins a call, e.g. internal or from the city

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

During the conversation, the phone's GSM dialer window appears with the "tag" of the MessengerCTI application.

<center>
[[File:in1.jpg|230px]]
[[File:in2.jpg|230px]]
[[File:ingsm1.jpg|230px]]
[[File:ingsm2.jpg|230px]]
</center>

'''An example of an incoming call made in GSM configuration (in parallel calling mode)'''

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

<center>
[[File:gsmrownolegle.jpg|230px]]
[[File:ingsm1.jpg|230px]]
[[File:ingsm2.jpg|230px]]
</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.

==Calls to the Call Center Queue==

Tab [[File:cc1.jpg|230px]]- allows you to handle calls directed to Call Center queues

The user who is an agent of the Call Center queue, in the CC tab, has the option of programming up to 4 individual buttons - login / logout from the selected queue, activation of the break.

With their help, he can perform the following actions:

* if he is permanently logged in to a given queue, then the button is permanently green in the appropriate queue (does not respond to touch)
* if he logs in/out to the queue - he logs in and out using the appropriate button and the button itself changes color from black and white to green
* if he goes on a break - it is with the help of a button whose color changes from black - white to yellow

If the user belongs to several queues, he or she can independently switch the preview of each of them using tabs (status of available agents, number of waiting in the queue, list of subscribers to be called back). If the user calls back to the person displayed in the List, he or she decides whether the call was successful (there are situations when the voicemail is answered, the caller is on another call, is out of network coverage, temporarily has no time, etc.)

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

<center>
[[File:callcenter1.jpg|230px]]
[[File:callcenter2.jpg|232px]]
</center>

==Messages support==
Application allows to send and receive text messages between MessengerCTI.Desktop/Mobile user (internal chat).

To send a message, click:

* the [[File:MessengerCTIMD_chat_free.png|25px]] application status icon to the left or the message/chat icon to the right of the username
* in the username and from the pop-up menu select Chat/History

Receiving messages is displayed on notification bar by proper icon and defined ring tone. 
If subscriber is using both versions of MessengerCTI, messages history is stored locally in '''''MessengerCTI.Dekstop''''' application. 
Below is example of chat window:

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

==Text and voice conference==

'''Conference preparation:'''
* select the icon on the taskbar [[Plik:MessengerCTI.mobile 1.07 Pasek zadań - konferencja.png|250px]]
* giving a name
* selecting and accepting participants

<center>
[[File:MessengerCTI.mobile_1.07_Konferencja.jpg|230px]]
[[File:MessengerCTI.mobile_1.07_Konferencja_2.jpg|230px]]
[[File:MessengerCTI.mobile_1.07_Konferencja_4.jpg|230px]]
</center>

'''Start of the conference:'''
* in the case of a text conference - go to the '''TALK''' tab (graphic on the left)
* in the case of a voice conference - press the green receiver (graphic on the right)
<center>
[[File:MessengerCTI.mobile_1.07_Konferencja_3.jpg|230px]]
[[File:MessengerCTI.mobile_1.07_Konferencja_g%C5%82osowa_5.jpg|230px]]
[[File:MessengerCTI.mobile_1.07_Konferencja_g%C5%82osowa_6.jpg|230px]]
</center>
'''Conference edition:'''
* in the Participants tab, click [[File:MessengerCTI.mobile_1.07_Conference_-_edition.png|40px]]
* changes to the settings are possible both when the conference is inactive and during its duration
* the available actions are shown in the graphic below
<center>
[[File:MessengerCTI.mobile_1.07_Konferencja_g%C5%82osowa_7.jpg|230px]]
</center>

=Additional features=
==Uploading files and photos==
The functionality is used to exchange files, documents and photos between different users of the MessengerCTI application (mobile and desktop)
In the Contacts or Recents tab, the User clicks on the status of the other User's MessengerCTI [[File:MessengerCTIMD_chat_free.png|30px]] application, taps the + sign next to the Enter message field, selects one of the available options:
* Attach file
* Attach picture
* Take a foto
then selects a file or takes a photo and confirms
<center>
[[File:MessengerCTI.mobile_1.07_Lokalizacja_5.jpg|230px]]
</center>

==Clipboard==
The clipboard is used to exchange messages, documents and files between the Mobile and Desktop versions of the user's MessengerCTI application.
To initiate it, tap the icon [[File:MessengerCTI.mobile_1.07_Pasek_zadan_-_schowek.png|30px]] and then:
* in the Enter message field, enter text, or
* tap + next to the Enter message field and select one of the available options:
* Attach file
* Attach picture
* Take a foto
then selects a file or takes a photo and confirms
<center>
[[File:MessengerCTI.mobile_1.07_Lokalizacja_5.jpg|230px]]
</center>

==Location==
Between MessengerCTI.Mobile users it is possible to observe the location (only with the consent of the observed person):
* '''User A asks User B for location permission''' (there are several variants to choose from)
* User B approves the request
* User A receives a link to google maps with the current location of User B
<center>
[[File:MessengerCTI.mobile_lokalizacja_1.jpg|230px]]
[[File:MessengerCTI.mobile_lokalizacja_2.jpg|234px]]
[[File:MessengerCTI.mobile_lokalizacja_3.jpg|230px]]
[[File:MessengerCTI.mobile_lokalizacja_4.jpg|225px]]
</center>
or:
* User B decides to send the location to User A
* User B in the Contacts or Recents tab clicks on the status of User A's application, taps on the "+" sign next to the Enter message field and then selects the Send location option
* User A receives a link to google maps with the current location of User B
<center>
[[File:MessengerCTI.mobile_lokalizacja_5.jpg|230px]]
[[File:MessengerCTI.mobile_lokalizacja_6.jpg|230px]]
[[File:MessengerCTI.mobile_lokalizacja_7.jpg|223px]]
</center>

== Contacts==
Contacts tab [[File:MessengerCTI.mobile_1.07_ostatnie_Kontakty_cc_2.jpg|223px]] 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
* groups created by the user personally
The Favorites group is visible by default

By default '''Favourites''' group is visible.
<center>[[File:MessengerCTIM_contacts1.png|300px]]</center>
Adding a contact to favorites:
In the Contacts tab, hold down the name of the selected subscriber. When prompted with the option to add contact to favorites, confirm.

== Call history ==
By default '''Last/Recent''' tab [[File:MessengerCTI.mobile_1.07_ostatnie.jpg|223px]] will be visible and showing calls and chat messages history.
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:
* application status icon, icon that the given user is not using the application or doorphone status
* caller number
* commentary(if number is from phone book outside PBX)
* time and date of call
* icon indicating a phone call or text message

If in history there are missed calls or messages, '''Last/Recent''' field will be marked with red dot. 
History tab allows to call back or reply to messages.

<center>
[[File:MessengerCTI.mobile_1.07_ostatnie_2.jpg|230px]]
</center>

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

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.2.1, 2.2.2, 2.3 and 2.3.1 or 2.3.2

'''Minimum PBX firmware version - 6.53, for VoIP - 6.54'''

==NCP PBX configuration==
From ConfigWEB application:
* '''''Extensions->Settings->CTI application settings''''' menu, configure access number that application will use to call to PBX and make accept incoming call
* in subscriber editing for SIP, FXS, CTS, Messenger CTI number in menu '''''Extensions->Subscribers->CTI settings'''''
** configure GSM phone access number which will have installed application
** set up type of handling incoming calls: call pickup (only application is ringing up) or parallel calling(application and internal phone is ringing up)

'''Minimum software version is: 1.11.'''

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''''

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=

'''Basic:'''
* signaling
** 5529 TCP - Application Signaling (XML)
** 5543 TCP - signaling in the mode with enabled encryption tag (XML)
* VoIP calls
** 5060 UDP - SIP signaling (for calls in VoIP mode)
** 8100 - 8300 UDP - acoustics - for IPx, CCT, MAC PBXes
** 10000 - 20000 UDP - acoustics - for NCP exchanges

'''Additional :'''
* file transfer - only NCP exchanges (clipboard, between users):
** 443 TCP - file transmission without encryption tag enabled (transmission is nevertheless encrypted with HTTPS)
** 5543 TCP - file transmission in the mode with the encryption flag turned on
* image transmission from the DPH.IP doorphone camera
** location of the link to the camera in the control panel:
*** NCP: Extensions/Devices/Cameras
*** IPx, MAC, CCT: Peripherals/Cameras
** during the connection, the PBX sends the camera link to the MessengerCTI application: rtsp://kamery_IP_address:554/login_password_information_additional

'''Example for NCP PBX for MessengerCTI working outside PBX IP network (configuration in ConfigWEB):'''
* XML signaling, VoIP, file transmission - tab Extensions/Settings/Information on CTI settings for subscribers and applications
* sending image from the camera (link to the camera, linking the camera with DPH.IP) - tab Extensions/Devices/Cameras

'''Example configuration data:'''
* PBX IP address: 192.168.0.10
* public IP address of the router: 222.0.0.1
* domain address: firm_name.pl
* camera IP address: 192.168.0.20
* ports used to redirect individual services on the router: 55xx

'''XML Signaling:'''
* MessengerCTI --> router --> NCP
* MessengerCTI --> 222.0.0.1:5555 --> 192.168.0.10:5529, or
* MessengerCTI --> company_name.pl: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.pl:5558 --> 192.168.0.10:5543

'''VoIP calls (signaling)'''
* MessengerCTI --> 222.0.0.1:5556 --> 192.168.0.10:5060
* MessengerCTI --> company_name.pl:5556 --> 192.168.0.10:5060

'''VoIP calls (acoustics)'''
* MessengerCTI --> 222.0.0.1:10000 - 222.0.0.1:20000 --> 192.168.0.10:10000 - 192.168.0.10:20000
* MessengerCTI --> company_name.pl:10000 - company_name.pl: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.pl:5557 --> 192.168.0.10:443

'''File transmission with encryption tag enabled:'''
* MessengerCTI --> 222.0.0.1:5559 --> 192.168.0.10:5543, or
* MessengerCTI --> company_name.pl:5559 --> 192.168.0.10:5543

'''Uploading image from DPH.IP camera'''
* MessengerCTI --> router --> camera
* MessengerCTI --> 222.0.0.1:5560 --> 192.168.0.20:554
* MessengerCTI --> company_name.pl:5560 --> 192.168.0.20:554

=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

=Working in the local network and outside the local network without changing the MessengerCTI configuration=
Changing the network source by the MessengerCTI.desktop or MessengerCTI.mobile user (e.g. LAN <--> Internet <--> LAN, work <--> travel <--> home) always entails changing the configuration of the application, i.e. changing the IP address of the PBX from local to public or vice versa (this situation does not occur if the user only uses LTE/HSPA internet).

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

Example network:
* public address of the router (WAN on the router): address in the decimal system - 203.0.113.1 or domain address - voip.xxxxxx.pl
* local address of the router (LAN on the router, gateway): 192.168.1.1
* PBX address (NCP, IPx, MAC, CCT) in the LAN network: 192.168.1.2
* address of the user's laptop from MessengerCTI.desktop or smartphone from MessengerCTI.Mobile in the LAN: 192.168.1.100

If MessengerCTI from a laptop/smartphone from the local network from the address 192.168.1.100 sends a packet to the public address 203.0.113.1 (voip.xxxxxx.pl), the packet is normally directed to the default gateway - 192.168.1.1 (router). The hairpinning NAT router detects that 203.0.113.1 (voip.xxxxxx.pl) is the address of its WAN interface and treats the packet as if it originated from that interface. Determines the destination for this packet based on DNAT (port forwarding) rules. If the packet was sent to port 5529 (for VoIP: 5060, 8100-8300 for IPx, 10,000 - 20,000 for NCP) and there is a DNAT rule for this port directed to 192.168.1.2, then the PBX receives the packet at this address.

If appropriate DNAT rules exist, address translation is performed - the router rewrites the source local IP address in the packet to a public address. The laptop/smartphone (192.168.1.100) sends the packet, but the central office (192.168.1.2) receives it as coming from 203.0.113.1. When the control panel answers, the process is identical to the laptop/smartphone. In this way, bi-directional communication between a laptop/smartphone in the LAN via a public IP address is possible.

=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. 
To install beta version: 
- If on the phone MessengerCTI is installed, uinstall it. 
- log to Google Play as application tester 
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. 
Click this link:
[https://play.google.com/apps/testing/com.slican.messengercti beta version registration] 
When you will see this info: 
[[File:google_beta.jpg]] 
Click BLUE BUTTON 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 to search also for Slican due to many other application using "messenger" word in their naming. 
- Install application. 
- Configure according to manual.j 
Use beta version features.

File:Cc.jpg

2022-12-21T14:04:55Z

Arturs: Arturs uploaded a new version of File:Cc.jpg

File:MessengerCTI.mobile 1.07 ostatnie 2.jpg

2022-12-21T13:44:34Z

Arturs:

File:MessengerCTI.mobile 1.07 ostatnie.jpg

2022-12-21T13:28:52Z

Arturs:

File:MessengerCTI.mobile 1.07 ostatnie Kontakty cc 2.jpg

2022-12-21T13:23:49Z

Arturs:

File:MessengerCTI.mobile 1.07 ostatnie Kontakty cc 2.png

2022-12-21T13:17:34Z

Arturs:

File:MessengerCTI.mobile lokalizacja 7.jpg

2022-12-21T13:04:55Z

Arturs:

File:MessengerCTI.mobile lokalizacja 6.jpg

2022-12-21T13:04:33Z

Arturs:

File:MessengerCTI.mobile lokalizacja 5.jpg

2022-12-21T13:04:22Z

Arturs:

File:MessengerCTI.mobile lokalizacja 4.jpg

2022-12-21T12:59:03Z

Arturs:

File:MessengerCTI.mobile lokalizacja 3.jpg

2022-12-21T12:58:50Z

Arturs:

File:MessengerCTI.mobile lokalizacja 2.jpg

2022-12-21T12:58:36Z

Arturs:

File:MessengerCTI.mobile lokalizacja 1.jpg

2022-12-21T12:57:56Z

Arturs:

File:MessengerCTI.mobile 1.07 Pasek zadan - schowek.png

2022-12-21T11:44:54Z

Arturs:

File:MessengerCTI.mobile 1.07 Lokalizacja 5.jpg

2022-12-21T11:15:09Z

Arturs:

File:MessengerCTI.mobile 1.07 Konferencja głosowa 7.jpg

2022-12-21T10:41:00Z

Arturs:

File:MessengerCTI.mobile 1.07 Konferencja głosowa 6.jpg

2022-12-21T10:40:50Z

Arturs:

File:MessengerCTI.mobile 1.07 Konferencja głosowa 5.jpg

2022-12-21T10:40:39Z

Arturs:

File:MessengerCTI.mobile 1.07 Konferencja 4.jpg

2022-12-21T10:40:28Z

Arturs:

File:MessengerCTI.mobile 1.07 Konferencja 3.jpg

2022-12-21T10:40:15Z

Arturs:

File:MessengerCTI.mobile 1.07 Konferencja 2.jpg

2022-12-21T10:40:01Z

Arturs:

File:MessengerCTI.mobile 1.07 Konferencja.jpg

2022-12-21T10:39:47Z

Arturs:

File:Callcenter2.jpg

2022-12-21T09:55:24Z

Arturs:

File:Callcenter1.jpg

2022-12-21T09:55:10Z

Arturs:

File:Cc.jpg

2022-12-20T14:23:43Z

Arturs: Arturs uploaded a new version of File:Cc.jpg

File:Cc.jpg

2022-12-20T14:21:24Z

Arturs: Arturs uploaded a new version of File:Cc.jpg

MessengerCTI.Mobile Manual

2022-12-20T13:56:43Z

Arturs:

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

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.
 
==Application advantages==
* application available(for free) from Google Play store - only CTI.plus license applied to PBX is required
* phone book with access to subscribers availability(chat, phone status, text status)
* option of adding and removing subscribers from favorite group, synchronised with MessengerCTI.Desktop
* history of recent calls/messages sorted chronologically
* logging with phone simultaneously as desk phone or as separate MessengerCTI subscriber(NCP PBX only)
* chat/messenger
* chat history with phone call history
* voice calling through GSM(two connection options- capture or parallel)
* flexible configuration of audio notifications
* access to PBX services configuration from phone
* rapid access number for fast call forwarding
* option of setting up busy status of desk phone if GSM is buy (on by default)
* option of setting up incoming call denying on GSM if desk phone is busy
* option of copying text from chat
* support of DualSim smartphone or two phones simultaneously (private or business)
* convenient access to opening door/gate if receiving call from doorphone DPH.IP or from context contacts menu
* additional desktop widget for fast access to open DPH.IP doorphone doors
* automatic delay of notifications for MessengerCTI.Mobile if desk phone or MessengerCTI.desktop is active
* option of copying contact from local phone book to PBX phone book

{{Attention!|
*For proper operation MessengerCTI.Mobile and PBX must have permanent access to Internet, fixed public IP address for PBX or forwarding port 5529 on edge router when PBX is on LAN behind NAT.
*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
*opening the door using the context menu or widget is available only after starting the ACS system}}

= Basic functionalities =
Using a smartphone, the application user gains mobility and still has the option of using the PBX as an internal subscriber.

<big>''' VoIP and GSM client '''</big>
'''''MessengerCTI.Mobile'''''parallel telephone, associated with the desk telephone equipment, landline (FXS, CTS, SIP). The application can work as a VoIP or GSM client. The user decides on which device to answer the call and make the call - phone or smartphone. A new feature is the ability to use the application as a standalone phone in NCP PBXes (from PBX firmware version 1.11). The CTIuserPlus license is required for its proper operation.

'''''Configuration in VoIP mode''''' - basic configuration for using the application. Both conducted calls and other information, e.g. about the caller's number, contacts in the directory, subscriber statuses, chats - are sent via the IP network (WiFi, Internet LTE/HSPA)

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

Switching between VoIP and GSM mode can be performed by the user from the application level (provided that he has the appropriate configuration on the PBX).

<big>'''Contact book'''</big>

A great advantage of the software is easy and convenient access to contacts from the PBX telephone books and displaying them on the user's smartphone. MessengerCTI.Mobile uses only the books stored in the PBX. Contacts can be grouped according to user requirements. Entering new subscribers and modifying existing entries can be made both from the system phone and in a more convenient way, from a computer - MessengerCTI.Desktop or WebCTI. The modification is visible immediately after its introduction. Access to the directory allows you to easily and conveniently search for the number of the person you want to call in the database. On the other hand, during incoming calls, clear information about the caller is displayed on the smartphone screen.

<big>'''Call history'''</big>
The user of the program has access to the history of all his calls, both received and missed. It is saved in the Slican central. Using MessengerCTI, you can display it, obtain information about the order of calls, date and time of their execution, as well as about the sum of missed calls made from the same number.

<big>'''CallCenter'''</big>
In conjunction with NCP PBXes for Call Center agents, the functionality of handling queues has been introduced. It allows e.g. logging in to one of them, viewing its status, answering and making calls, calling back lost and abandoned calls, enabling the status of temporary breaks in work.

<big>'''Text messages'''</big>

Using MessengerCTI.Mobile, you can send text information - from an internal communicator (chat) via a computer network - to another person who has MessengerCTI.Desktop or MessengerCTI.Mobile. The chat can be used by all subscribers of a given PBX and PBXes linked to it with the eSSL ver.2 system. This functionality is particularly attractive for those companies that, having Slican exchanges, do not allow the use of public messengers for security reasons. To ensure parallel access from different devices (computer, smartphone), chat history is saved directly in the PBX and synchronized with the MessengerCTI applications on an ongoing basis. An extension of this functionality is the ability to chat with many users at the same time, i.e. the so-called text conference.

<big>'''Text and voice conferencing'''</big>

A functionality that allows you to exchange messages / talk to many users at the same time.

<big>'''File transfer'''</big>
Between MessengerCTI application users (desktop, mobile) it is possible to send files, e.g. photos, documents

<big>'''Location Sharing'''</big>

Due to mobility - the user can make the observation of his location available to selected people. An authorized person gains the ability to observe its location.

<big>'''Support for cameras and DPH.IP doorphone'''</big>

The introduction of DPH.IP doorphones with camera support for sale forced the creation of an option for displaying video images from them. Such a possibility was introduced in the MessengerCTI.Mobile application. In the case of a connection from the doorphone to the application user, the image from his camera appears in the window. After receiving and carrying out the call, and without the need to talk to the person at the doorphone, only after visual identification, you can open the door, gate or barrier using a special button. Also in the opposite direction, when calling the doorphone or any other extension number associated with the camera, the image from the camera appears on the monitor screen. This allows for temporary observation of the surroundings of the installed camera, e.g. the person we are calling. It is also possible to select and observe the image from any camera without the need to make a connection, just by indicating the associated icon in the application. Using MessengerCTI.Mobile it is also possible to use cameras from other manufacturers, but they must support video formats and codecs compatible with VLC application libraries. Opening the door using the context menu or widget is available only after starting the ACS system.

<big>'''Works with the desktop version'''</big>

The application can also be used in parallel and synchronized with MessengerCTI.Desktop, i.e. the version for a computer with Windows.

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

For installing application minimum requirements must be met:
* Android operating system
** minimum version: KitKat 4.4.4
** minimum recommended version: Nougat 7.0
** 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.

{{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 regulating microphone gain for VoIP calls
* opening the door using the context menu or widget is available only after starting the ACS system}} 

{{Attention!|
'''''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.
During the installation, you are prompted to provide some permissions and change phone settings. They may differ, depending on the Android version and phone type. You can accept them all or select only those related to the functionalities that will be used:
* Camera - for scanning the QR code and taking and sending photos
* Location - to share the location
* Microphone - for making calls in VoIP mode
* Internal storage - for saving photos, transferring files and using the clipboard
* Telephone - to use the application in GSM mode
* Contacts - for copying contacts to the local phone database (only used in some versions of the application)
* Displaying above other applications - should be made available so that you can answer the call correctly when the application is, for example, dormant
* Disable battery optimization - Battery optimization for the app must be disabled to prevent it from going into deep sleep

After installing application, it must be configured for connecting to PBX: '''''Settings->Account''''' (described below).

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

== Starting application ==

'''''MessengerCTI.Mobile''''' application runs just like any other application working 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. 

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

<big>'''Account'''</big>
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 address or IP address of local PBX(public IP address for users outside LAN) : port used for communication with PBX - by default set to TCP 5529
* Encrypted transmission: encryption of the XML protocol
* Self-signed certificate
* Read data from QRCode: instead of manual configuration - the ability to scan the QRcode sent to the user's e-mail box when configuring the CTI settings in the NCP PBX or from the WebCTI website
After entering the data, confirm with the save and connect button

<center>[[File:Messenger_wid_konf.jpg|800px]]</center>

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

<center>[[File:MessengerCTI.mobile_1.07_WebCTI.png|800px]]</center>

<big>'''Calls'''</big>
Options to activate the button on the headphones and the microphone gain level

<big>'''Call center'''</big>
Ability to run up to 4 login/logout buttons and agent breaks related to Call Center queues

<big>'''Other'''</big>

Other application settings are shown in the attached graphic.

The Debug option - enabled at the request of the software supplier - is related to solving problems with the correct operation of the application

When this option is enabled, an additional Send logs by email field appears in the About tab. We choose the mail client from which we will send the application logs for analysis on the manufacturer's side.

=== Services===
Configuring application services related to connections/calls:
* Default connection type - settings for making calls via GSM, VoIP or VoIP via WiFi
* Global services for PBX:
** DND: Do not Disturb
** Internal no. busy when GSM talking
** FWD - call forwarding settings: all, when busy or when no answer

=== My description ===
Setting text status that will be visible to other MessengerCTI.Users or on screen of CTS-330 system phone.

===Notifications===
<big>'''Configuring incoming call notifications'''</big>

* ringtone: selection of one from the list available in the application with the option of muting it after a certain period of time
* ringtone vibration
* missed call bar notification
* schedule of notifications for the call ringer - the ability to set a weekly plan of active use (turning on ringing at certain times)

<big>'''Configure chat message notifications'''</big>
* message sound: choose one from the list available in the application
* wibracje przy wiadomości
* notification in the bar about a new chat message
* notification schedule for messages - the ability to set a weekly plan of active use (turn on notifications at specific times)

<big>'''Notification delay'''</big>
A functionality that allows you to delay the ringing signal of the mobile application by 15 seconds in relation to the ringtone of the phone associated with it (usually landline).

After launching MessengerCTI.mobile - the landline phone and the application will ring simultaneously during an incoming call. If we are the first to answer the phone, the application will "remember" that we are in its vicinity and will delay its ringing during the next call.
It ceases to apply when:
* we will not answer the call
* we will answer the call with the application

<big>'''Fast forwarding'''</big>
A list of the 3 most important user numbers (external and external) displayed during a call for simple call transfer.

=== About software ===
Information about:
* current software version
* type of connected PBX
* PBX firmware version
* own number: CTI account number(internal PBX extension)
* own comment: user comment made by administrator
* link to send application logs

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

= Application structure =
== Main window ==
Main application windows give access to three tabs:
* '''Last''' - history of calls, chat messages and users statuses.
* '''Contacts''' - access to PBX phone book with sorting options:favourites, internal, external.
* '''CC''' - handling calls from Call Center queues, the ability to log in/out and call back

Additionally:
* App login status icon with default connection type
* Configuration menu - application and service settings
* Mute ringtone - instantly mute the ringtone and app notifications
* Clipboard - for sharing data between the mobile and desktop application
* Search engine - searching for a contact by name and number
* Creating a conference
* Keypad - select the target number

<center>[[File:Messenger eng opis.jpg]]</center>

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

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

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

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

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

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

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

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

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

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

==Making calls==
Two ways of making calls:
* from '''Contacts''' tab - choosing subscriber from particular group (if applicable), or from "All contacts" group. Call is made by touching contact tab, then choosing icon from drop down menu.
* from '''Contacts''' tab- searching for contact name in '''Search''' field by using keyboard then touching lower right corner of keyboard

<center>
[[File:szuk.jpg|210px]]
[[File:MessengerCTIM_out_ext1.png|790px]]
</center>
* from '''Last/Recent''' - find subscriber which we had shared call(he called or we called him) and then make call by touching middle part of contact tab and choosing action from drop down menu
<center>[[File:MessengerCTIM_out_number1.png|570px]]</center>
* from '''Search field''' tab- searching for phone number in '''Search''' field by by typing the phone number directly from the keyboard, and then tapping the green receiver on the right

<center>
[[File:szu_num.jpg|230px]]</center>

'''Configuration in VoIP''' mode - basic configuration for using the application. Both conducted calls and other information, e.g. about the caller's number, contacts in the directory, subscriber statuses, chats - are sent via the IP network (WiFi, Internet - HSPA, LTE)

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

Switching between VoIP and GSM mode can be performed by the user from the application level (provided that he has the appropriate configuration on the PBX). Due to that reason, required city line for PBX must be at least ISDN BRA.
'''The presented connection details on the smartphone display differ depending on the mode of its connection. The connection looks different in VoIP mode than in GSM mode due to the need to use the native telephone dialer. An example of an outgoing call made in VoIP configuration.'''
<center>
[[File:voipout1.jpg|233px]]
[[File:voipout2.jpg|230px]]
</center>
'''Outgoing call made in VoIP configuration.'''

<center>
[[File:gsmout1.jpg|230px]]
[[File:gsmout2.jpg|230px]]
</center>

==Incoming calls==
Incoming calls are displayed with a call popup and ringtone configured in the app's notification settings. Calls are answered by moving the icon with the green handset, if the phone was turned off, or by pressing the green button. If we want to reject the call, it can be done by moving the red handset or pressing the red button. If additional pop-up numbers have been set, the call can be forwarded to them by moving the icon with the pop-up number. The process of accepting incoming calls in the GSM mode consists in making a return call via the GSM line to the application access number defined by the PBX administrator.

<center>[[File:MessengerCTIM_incoming2.png|700px]]</center>

You can direct an incoming call to another person. This can be done before answering the call or during it (with or without notification):
* instantly - by pressing the button with a quick contact, or
* select a number from your contacts list or recent calls

During a conversation, the user has the option of muting the microphone and/or turning on the loudspeaker mode.

'''The presented connection details on the smartphone display differ depending on the mode of its connection. The connection looks different in VoIP mode than in GSM mode (due to the need to use the phone's native dialer)'''

'''An example of an incoming call made in VoIP configuration'''

<center>
[[File:in1.jpg|230px]]
[[File:in2.jpg|230px]]
[[File:in3.jpg|230px]]
</center>
Connection setup and conversation are carried out entirely over the IP network (WiFi or LTE/HSPA Internet)

'''An example of an incoming call made in the GSM configuration (in the call interception mode)'''

This mode consists in the following:

The call for the user is an incoming call, but from the Slican PBX it is sent to the phone and the MessengerCTI application via the IP network - WiFi or Internet LTE/HSPA information about the incoming call and the MessengerCTI application initiates an outgoing call from the user's phone to the PBX (via the GSM operator) and there it joins a call, e.g. internal or from the city

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

During the conversation, the phone's GSM dialer window appears with the "tag" of the MessengerCTI application.

<center>
[[File:in1.jpg|230px]]
[[File:in2.jpg|230px]]
[[File:ingsm1.jpg|230px]]
[[File:ingsm2.jpg|230px]]
</center>

'''An example of an incoming call made in GSM configuration (in parallel calling mode)'''

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

<center>
[[File:gsmrownolegle.jpg|230px]]
[[File:ingsm1.jpg|230px]]
[[File:ingsm2.jpg|230px]]
</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.

==Calls to the Call Center Queue==

Tab [[File:cc1.jpg|230px]]- allows you to handle calls directed to Call Center queues

==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'''. 
Receiving messages is displayed on notification bar by proper icon and defined ring tone. 
If subscriber is using both versions of MessengerCTI, messages history is stored locally in '''''MessengerCTI.Dekstop''''' application. 
Below is example of chat window:

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

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

== Call history ==
By default '''Last/Recent''' tab will be visible and showing calls and chat messages history. 
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. 
If in history there are missed calls or messages, '''Last/Recent''' field will be marked with red dot. 
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)

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.2.1, 2.2.2, 2.3 and 2.3.1 or 2.3.2

'''Minimum PBX firmware version - 6.53, for VoIP - 6.54'''

==NCP PBX configuration==
From ConfigWEB application:
* '''''Extensions->Settings->CTI application settings''''' menu, configure access number that application will use to call to PBX and make accept incoming call
* in subscriber editing for SIP, FXS, CTS, Messenger CTI number in menu '''''Extensions->Subscribers->CTI settings'''''
** configure GSM phone access number which will have installed application
** set up type of handling incoming calls: call pickup (only application is ringing up) or parallel calling(application and internal phone is ringing up)

'''Minimum software version is: 1.11.'''

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''''

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'''

=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. 
To install beta version: 
- If on the phone MessengerCTI is installed, uinstall it. 
- log to Google Play as application tester 
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. 
Click this link:
[https://play.google.com/apps/testing/com.slican.messengercti beta version registration] 
When you will see this info: 
[[File:google_beta.jpg]] 
Click BLUE BUTTON 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 to search also for Slican due to many other application using "messenger" word in their naming. 
- Install application. 
- Configure according to manual.j 
Use beta version features.

File:Cc1.jpg

2022-12-20T13:53:54Z

Arturs:

File:Cc.jpg

2022-12-20T13:40:09Z

Arturs: Arturs uploaded a new version of File:Cc.jpg

File:Cc.jpg

2022-12-20T13:36:59Z

Arturs: Arturs uploaded a new version of File:Cc.jpg

File:Gsmrownolegle.jpg

2022-12-20T13:23:13Z

Arturs:

File:Ingsm2.jpg

2022-12-20T13:14:53Z

Arturs:

File:Ingsm1.jpg

2022-12-20T13:14:35Z

Arturs:

File:In3.jpg

2022-12-20T12:45:19Z

Arturs:

File:In2.jpg

2022-12-20T12:45:00Z

Arturs:

File:In1.jpg

2022-12-20T12:44:47Z

Arturs:

File:Gsmout2.jpg

2022-12-20T11:59:58Z

Arturs:

File:Gsmout1.jpg

2022-12-20T11:59:43Z

Arturs:

File:Voipout2.jpg

2022-12-20T11:59:17Z

Arturs:

File:Voipout1.jpg

2022-12-20T11:59:05Z

Arturs:

File:Szu num.jpg

2022-12-20T11:09:59Z

Arturs:

File:Szuk.jpg

2022-12-20T10:57:32Z

Arturs: Arturs uploaded a new version of File:Szuk.jpg

File:Szuk.jpg

2022-12-20T10:57:05Z

Arturs:

File:Calls.jpg

2022-12-19T13:07:41Z

Arturs: Arturs uploaded a new version of File:Calls.jpg

File:Calls.jpg

2022-12-19T13:00:52Z

Arturs: Arturs uploaded a new version of File:Calls.jpg

File:Cc.jpg

2022-12-19T12:48:44Z

Arturs: