MessengerCTI.Mobile Manual - Revision history

Arturs at 13:54, 4 December 2023

2023-12-04T13:54:33Z

Arturs at 14:12, 21 December 2022

2022-12-21T14:12:36Z

Show changes

Arturs at 13:56, 20 December 2022

2022-12-20T13:56:43Z

Arturs at 10:53, 19 December 2022

2022-12-19T10:53:07Z

Arturs at 12:58, 13 December 2022

2022-12-13T12:58:24Z

Arturs at 11:08, 13 December 2022

2022-12-13T11:08:30Z

Arturs at 14:44, 12 December 2022

2022-12-12T14:44:04Z

Arturs at 13:32, 12 December 2022

2022-12-12T13:32:41Z

Arturs at 11:32, 12 December 2022

2022-12-12T11:32:42Z

Marekg: /* Minimum requirements */

2020-05-25T11:34:19Z

‎Minimum requirements

@@ Line 30: / Line 30: @@
 *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}}

@@ Line 354: / Line 354: @@
 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 phone number in '''Search''' field by using keyboard then touching lower right corner of keyboard
+* from '''Contacts''' tab- searching for contact name in '''Search''' field by using keyboard then touching lower right corner of keyboard
-<center>[[File:MessengerCTIM_out_ext1.png|750px]]</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>
-Connecting calls are displayed with call screen just like calls made using GSM. Application at first is connecting call to PBX dedicated number for '''MessengerCTI.Mobile''' users, configured by PBX administrator. Then PBX is connecting by transit to number chosen by '''MessengerCTI.Mobile'''. Due to that reason, required city line for PBX must be at least ISDN BRA.
+<center>
 ==Incoming calls==
-Incoming calls are displayed with popping up call window and ring tone configured in application notifications settings. Calls are received by sliding icon with green handset, if we want to reject call it can be done with sliding red handset. If additional handy numbers were set, call may be forwarded to them by sliding icon with handy number.
+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.
-Process of receiving incoming calls works by making a return call with GSM line to application access number defined by PBX administrator.
 <center>[[File:MessengerCTIM_incoming2.png|700px]]</center>
 Missed calls are displayed with icon [[File:MessengerCTIM_no_answer_qty.png|50px]]. Going to call history or calling back will clear information about amount of missed calls.
 ==Messages support==

← Older revision		Revision as of 10:53, 19 December 2022
Line 140:		Line 140:


−	<center>[[File:Messenger_wid_konf.jpg]]</center>	+	<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>

@@ Line 79: / Line 79: @@
 The application can also be used in parallel and synchronized with MessengerCTI.Desktop, i.e. the version for a computer with Windows.
 = Minimum requirements  =
@@ Line 141: / Line 137: @@
 * 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
@@ Line 159: / Line 159: @@
 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.
@@ Line 226: / Line 221: @@
 = Application structure =
 == Main window ==
-Main application windows give access to two tab:
+Main application windows give access to three tabs:
-* '''Last/Recent''' - history of calls, chat messages and users statuses.
+* '''Last''' - history of calls, chat messages and users statuses.
 * '''Contacts''' - access to PBX phone book with sorting options:favourites, internal, external.
-* login icon status with text status
+* '''CC''' - handling calls from Call Center queues, the ability to log in/out and call back
-* searching contacts
-* applications settings menu
+Additionally:
-<center>[[File:MessengerCTI_opis_new.png|800px]]</center>
+* App login status icon with default connection type
 == Icons meaning ==

@@ Line 142: / Line 142: @@
 After entering the data, confirm with the save and connect button
-===Other===
+<big>'''Calls'''</big>
-Configuring phone busy status depending on incoming call direction(GSM or CTI call):
+Options to activate the button on the headphones and the microphone gain level
-* during GSM talk, internal number will be busy
-* reject GSM when internal number is busy
-Solving issues with proper software operation:
-* debug - administrator option which is turned on on software vendor suggestion, for analysing issue logs.
-After turning on '''debug''' option additional '''Send logs''' field will appear in main menu. After choosing e-mail client, application logs will be sent to software manufacturer.
 == Services==
 Configuring application services related to connections/calls:
-* DND: Do not Disturb
+* Default connection type - settings for making calls via GSM, VoIP or VoIP via WiFi
-* forwarding calls:all will be forwarded to chosen number when busy or doesn't answer(must be noted that at first number is given, then forwarding happens)
+* Global services for PBX:
-* silence application: silent mode
+** DND: Do not Disturb
-== My description ==
+** Internal no. busy when GSM talking
 Setting text status that will be visible to other MessengerCTI.Users or on screen of CTS-330 system phone.
 == About software ==
 Information about:
 * current software version
 * type of connected PBX
 * PBX firmware version
-* Own number: CTI account number(internal PBX extension)
+* own number: CTI account number(internal PBX extension)
-* Own comment: user comment made by administrator
+* own comment: user comment made by administrator
 == Updating application ==
 Application is applying updates automatically, user can set on or off automatic updates in similar manner to other Google play store applications on phone. If new softwar version will be available in Goole Play store it will automatically download or notify about recent version.
 = Application structure =

@@ Line 106: / Line 106: @@
 =Application installation =
-'''''MessengerCTI.Mobile''''' usage is licensed do purchasing of proper license is required. Purchased serial code is used during PBX configuration, serial code defines number of users that are able to use application. Application licensing doesn't interfere with installation. After installing application, it must be configured for connecting to PBX:  '''''Settings->Account''''' (described below).
+'''''MessengerCTI.Mobile''''' usage is licensed do purchasing of proper license is required. Purchased serial code is used during PBX configuration, serial code defines number of users that are able to use application. Application licensing doesn't interfere with installation.
 {{Attention!|
@@ Line 115: / Line 127: @@
 '''''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 upper right corner of application window. From drop down menu '''Settings''' menu can be chosen.<br>
+For proper communication between application and PBX, CTI account information and other functions must be configured properly. Configuration menu is placed in bottom  left corner of application window. From drop down menu '''Settings''' menu can be chosen.<br>
 Fields required for configuration can be found here:account, notifications, handy numbers.
-===Account===
 Configured with information configured by PBX administrator.:
 * Your telephone number: internal subscriber number(extensions) with access to CTI communication
 * password: CTI user password
-* advanced -> Transmission protocol port: port used for communication with PBX - by default set to TCP 5529
+* Host: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
-* Host: domain address or IP address of local PBX(public IP address for users outside LAN)
+* Encrypted transmission: encryption of the XML protocol
 ===Notifications===

← Older revision		Revision as of 13:32, 12 December 2022
Line 31:		Line 31:
	*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		*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}}		*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.
		+
		+
		+

@@ Line 29: / Line 29: @@
 {{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}}
+*For VoIP connections with application - domain address or fixed public IP address, eventually 5060 UDP port forwarded on edge router(signalisation), 10000 - 20000 UDP (RTP voice frames for NCP PBX), 8100 - 8300 UDP (RTP voice frames for IPx, MAC, CCT PBX)to PBX IP address if it is behind NAT on local network
 = Minimum requirements  =
@@ Line 46: / Line 48: @@
 * option of automatic regaining voice connection after reloging to network or changing IP
 * option of regulating microphone gain for VoIP calls
-}}<br>
+* opening the door using the context menu or widget is available only after starting the ACS system}}<br>
 {{Attention!|

@@ Line 35: / Line 35: @@
 For installing application minimum requirements must be met:
-* Android operating system - minimum version KitKat (4.4.4)
+* Android operating system
-* PBX and application must have access to internet
+** minimum version: KitKat 4.4.4
-Phone with lower version of operating system won't be able to install application.
+**  minimum recommended version: Nougat 7.0
 {{Attention!|