http://pubwiki.slican.com/api.php?action=feedcontributions&user=Marekg&feedformat=atompubWiki-en - User contributions [en]2024-03-28T17:02:56ZUser contributionsMediaWiki 1.26.0http://pubwiki.slican.com/index.php?title=CTS-220_information&diff=7916CTS-220 information2020-09-17T11:19:31Z<p>Marekg: </p>
<hr />
<div>{{NoTitle}}<br />
{{title_main| <br />
|title-font-size=200%<br />
|title-align=center<br />
|title= CTS-220 manual}}<br />
<br />
<br />
<center> <b>System phones<br />
Slican CTS-220.CL<br />
<br />
Slican CTS-220.IP<br />
<br />
[[File:CTS220_black.jpg|350px]][[File:CTS220_grey.jpg|350px]]<br />
<br />
User manual release 1.0</b></center><br />
<br />
<center>'''SLICAN Sp. z o.o.'''</center><br />
<br />
<center>[http://www.slican.com/ www.slican.com] </center><br />
<br />
<center>e-mail: [mailto:office@slican.pl office@slican.pl]</center><br />
<br />
<br />
<center>„The manufacturer reserves the right to introduce changes to the product without prior notice.”</center><br />
<br />
<br />
<center>Date of last modification: 17.09.2020</center><br />
<br />
{{Warning| System phone CTS-220 works with NCP-PBX, IPL-256, IPM-032, IPU-14, IPS-08 and MAC-6400. For proper work in IPx, MAC-6400 and CCT-1668, 6.50 PBX firmware or higher is needed. NCP-PBX requires 1.06 firmware version or higher. Additional power supply is needed when connecting additional expanding consoles.<br />
WiFi is supported since firmware 1.12 NCP and 6.54 IPx, MAC, CCT.<br />
<br />
Bluetooth module since phone is available to buy. Due to interference of WiFi and Bluetooth modules, modules can't be used at same time.}}<br />
<br />
Slican CTS-220.CL/IP is a business system phone for companies requiring advanced phone systems and efective call and contacts managing. It's equipped with high quality LCD display, that ensures perfect readability in different lightning conditions. Phone's profile is generated and stored within PBX memmory - thanks to which, using it is possible immediately after connecting, without complicated and time-consuming programming.<br />
<br />
Great audio quality and simplicity of operation makes this phone ideal for everyday work. Programmable keys allows unlimited, individual creation of functions, services or handy list of contacts.<br />
<br />
The phone looks great on your desk. Light and ergonomic handset and optimal lenght od headset cord makes it a unrepleaceable partner in every day work. CTS-220 allows cooperation with headset (wired or wireless) or loudspeaker.<br />
<br />
==[[Parametry Techniczne CTS220| Technical parameters]]==<br />
<br />
==[[CTS220 build and equipment| Build and equipment]]==<br />
<br />
==[[CTS-220 phone settings| Phone settings]]==<br />
<br />
==[[CTS-220 keys and call history| Calling, history and BLF]]==<br />
<br />
==[[CTS-220 phonebook| Phonebook]]==<br />
<br />
==[[CTS-220 system services| Using system services]]==<br />
<br />
==[[Zasilacze CTS_en| CTS power supply]]==<br />
<br />
==[[Wymogi_bezpieczenstwa_CTS_en| Safety Requirements and Certificate of Conformity for CTS devices]]==<br />
<br />
==[[CTS-220 BT|Connecting Bluetooth headset to CTS-220]]==<br />
<br />
==[[CTS-220_WiFi|Work within WiFi wireless network]]==<br />
<br><br />
[[Main_Page | Return to Main Page]]</div>Marekghttp://pubwiki.slican.com/index.php?title=CTS-220_WiFi&diff=7915CTS-220 WiFi2020-09-17T11:02:38Z<p>Marekg: </p>
<hr />
<div>CTS-220.IP phones suport optional WiFi module (WIFI1MOD). Module expands phone features to connecting to wireless WiFi network. Module is installed for standard phone by authorized service company<br />
<br />
<br />
{{Warning|<br />
For proper operation of CTS-220.IP phones with WiFi modules, network based on hardware from reputable vendors. Using WiFi network to transmit voice in real time isn’t as immune to signal interference like over wired network. From user point of view, proper operation of computer within network doesn’t guarantee voice transmition with good quality. Calls and voice quality depends elements, eg: network load (long and short term overload), interference between networks, loosing and changing packets order – when retransmission doesn’t work, excessive jitter.<br />
<br />
Due to interference, bluetooth and WiFi modules can’t be used at same time.}}<br />
<br />
<br />
=Configuration=<br />
<br />
* VoIP menu/Network settings:<br />
** By default, out of the box phone network interface are configured as DHCP clients, IP address will set up automatically <br />
** IP address configuration can be changed, same with VLAN, QoS (if phone is connected with LAN interface second configuration isn’t required)<br />
<br />
<br />
After disconnecting Lan cable and WiFi that isn’t configured, information will pop up <br />
No connection/ Set WiFi parameters<br />
<br />
* Menu/ WiFi Search/ Add/ WPS mode<br />
** Search – search for available network, after selecting network enter password <br />
** Add – enter SSID of network, after confirming enter password<br />
** WPS mode - enable WPS using access point<br />
<br />
In Search/Add mode, during entering password characters are encrypted. After pressing * (asterisk) on keypad will change to displaying character. Changing letter size is possible # (hash)<br />
<br />
<br />
After successfuly connnecting to network, information about choosing VoIP server (PBX), which phone should connect too<br />
* VoIP Menu/ VoIP server <br />
** Auto or enter IP address manually<br />
<br />
<br />
After configuration check network status in Status menu.<br />
<br />
<br />
[[CTS-220_information| Return to Instruction manual]]</div>Marekghttp://pubwiki.slican.com/index.php?title=CTS-220_WiFi&diff=7914CTS-220 WiFi2020-09-17T11:01:58Z<p>Marekg: /* Configuration */</p>
<hr />
<div>CTS-220.IP phones suport optional WiFi module (WIFI1MOD). Module expands phone features to connecting to wireless WiFi network. Module is installed for standard phone by authorized service company<br />
<br />
<br />
{{Warning|<br />
For proper operation of CTS-220.IP phones with WiFi modules, network based on hardware from reputable vendors. Using WiFi network to transmit voice in real time isn’t as immune to signal interference like over wired network. From user point of view, proper operation of computer within network doesn’t guarantee voice transmition with good quality. Calls and voice quality depends elements, eg: network load (long and short term overload), interference between networks, loosing and changing packets order – when retransmission doesn’t work, excessive jitter.<br />
<br />
Due to interference, bluetooth and WiFi modules can’t be used at same time.}}<br />
<br />
<br />
=Configuration=<br />
<br />
* VoIP menu/Network settings:<br />
** By default, out of the box phone network interface are configured as DHCP clients, IP address will set up automatically <br />
** IP address configuration can be changed, same with VLAN, QoS (if phone is connected with LAN interface second configuration isn’t required)<br />
<br />
<br />
After disconnecting Lan cable and WiFi that isn’t configured, information will pop up <br />
No connection/ Set WiFi parameters<br />
<br />
* Menu/ WiFi Search/ Add/ WPS mode<br />
** Search – search for available network, after selecting network enter password <br />
** Add – enter SSID of network, after confirming enter password<br />
** WPS mode - enable WPS using access point<br />
<br />
In Search/Add mode, during entering password characters are encrypted. After pressing * (asterisk) on keypad will change to displaying character. Changing letter size is possible # (hash)<br />
<br />
<br />
After successfuly connnecting to network, information about choosing VoIP server (PBX), which phone should connect too<br />
* VoIP Menu/ VoIP server <br />
** Auto or enter IP address manually<br />
<br />
<br />
After configuration check network status in Status menu.<br />
<br />
<br />
<br />
[[Instrukcja_obsługi_CTS-220| Powrót do instrukcji]]</div>Marekghttp://pubwiki.slican.com/index.php?title=CTS-220_WiFi&diff=7913CTS-220 WiFi2020-09-17T10:59:23Z<p>Marekg: Created page with "CTS-220.IP phones suport optional WiFi module (WIFI1MOD). Module expands phone features to connecting to wireless WiFi network. Module is installed for standard phone by auth..."</p>
<hr />
<div>CTS-220.IP phones suport optional WiFi module (WIFI1MOD). Module expands phone features to connecting to wireless WiFi network. Module is installed for standard phone by authorized service company<br />
<br />
<br />
{{Warning|<br />
For proper operation of CTS-220.IP phones with WiFi modules, network based on hardware from reputable vendors. Using WiFi network to transmit voice in real time isn’t as immune to signal interference like over wired network. From user point of view, proper operation of computer within network doesn’t guarantee voice transmition with good quality. Calls and voice quality depends elements, eg: network load (long and short term overload), interference between networks, loosing and changing packets order – when retransmission doesn’t work, excessive jitter.<br />
<br />
Due to interference, bluetooth and WiFi modules can’t be used at same time.}}<br />
<br />
<br />
=Configuration=<br />
<br />
* VoIP menu/Network settings:<br />
** By default, out of the box phone network interface are configured as DHCP clients, IP address will set up automatically <br />
** IP address configuration can be changed, same with VLAN, QoS (if phone is connected with LAN interface second configuration isn’t required)<br />
<br />
<br />
After disconnecting Lan cable and WiFi that isn’t configured, information will pop up <br />
No connection/ Set WiFi parameters<br />
<br />
* Menu/ WiFi Search/ Add/ WPS mode<br />
** Search – search for available network, after selecting network enter password <br />
** Add –enter SSID of network, after confirming enter password<br />
** WPS mode - enable WPS using access point<br />
<br />
In Search/Add mode, during entering password characters are encrypted. After pressing * (asterisk) on keypad will change to displaying character. Changing letter size is possible # (hash)<br />
<br />
<br />
After successfuly connnecting to network, information about choosing VoIP server (PBX), which phone should connect too<br />
* VoIP Menu/ VoIP server <br />
** Auto or enter IP address manually<br />
<br />
<br />
After configuration check network status in Status menu.<br />
<br />
<br />
<br />
[[Instrukcja_obsługi_CTS-220| Powrót do instrukcji]]</div>Marekghttp://pubwiki.slican.com/index.php?title=CTS-220_information&diff=7912CTS-220 information2020-09-17T10:22:34Z<p>Marekg: </p>
<hr />
<div>{{NoTitle}}<br />
{{title_main| <br />
|title-font-size=200%<br />
|title-align=center<br />
|title= CTS-220 manual}}<br />
<br />
<br />
<center> <b>System phones<br />
Slican CTS-220.CL<br />
<br />
Slican CTS-220.IP<br />
<br />
[[File:CTS220_black.jpg|350px]][[File:CTS220_grey.jpg|350px]]<br />
<br />
User manual release 1.0</b></center><br />
<br />
<center>'''SLICAN Sp. z o.o.'''</center><br />
<br />
<center>[http://www.slican.com/ www.slican.com] </center><br />
<br />
<center>e-mail: [mailto:office@slican.pl office@slican.pl]</center><br />
<br />
<br />
<center>„The manufacturer reserves the right to introduce changes to the product without prior notice.”</center><br />
<br />
<br />
<center>Date of last modification: 15.09.2016 </center><br />
<br />
{{Warning| System phone CTS-220 works with NCP-PBX, IPL-256, IPM-032, IPU-14, IPS-08 and MAC-6400. For proper work in IPx, MAC-6400 and CCT-1668, 6.50 PBX firmware or higher is needed. NCP-PBX requires 1.06 firmware version or higher. Additional power supply is needed when connecting additional expanding consoles.<br />
WiFi is supported since firmware 1.12 NCP and 6.54 IPx, MAC, CCT.<br />
<br />
Bluetooth module since phone is available to buy. Due to interference of WiFi and Bluetooth modules, modules can't be used at same time.}}<br />
<br />
Slican CTS-220.CL/IP is a business system phone for companies requiring advanced phone systems and efective call and contacts managing. It's equipped with high quality LCD display, that ensures perfect readability in different lightning conditions. Phone's profile is generated and stored within PBX memmory - thanks to which, using it is possible immediately after connecting, without complicated and time-consuming programming.<br />
<br />
Great audio quality and simplicity of operation makes this phone ideal for everyday work. Programmable keys allows unlimited, individual creation of functions, services or handy list of contacts.<br />
<br />
The phone looks great on your desk. Light and ergonomic handset and optimal lenght od headset cord makes it a unrepleaceable partner in every day work. CTS-220 allows cooperation with headset (wired or wireless) or loudspeaker.<br />
<br />
==[[Parametry Techniczne CTS220| Technical parameters]]==<br />
<br />
==[[CTS220 build and equipment| Build and equipment]]==<br />
<br />
==[[CTS-220 phone settings| Phone settings]]==<br />
<br />
==[[CTS-220 keys and call history| Calling, history and BLF]]==<br />
<br />
==[[CTS-220 phonebook| Phonebook]]==<br />
<br />
==[[CTS-220 system services| Using system services]]==<br />
<br />
==[[Zasilacze CTS_en| CTS power supply]]==<br />
<br />
==[[Wymogi_bezpieczenstwa_CTS_en| Safety Requirements and Certificate of Conformity for CTS devices]]==<br />
<br />
==[[CTS-220 BT|Connecting Bluetooth headset to CTS-220]]==<br />
<br />
==[[CTS-220_WiFi|Work within WiFi wireless network]]==<br />
<br><br />
[[Main_Page | Return to Main Page]]</div>Marekghttp://pubwiki.slican.com/index.php?title=Zasilacze_CTS_en&diff=7911Zasilacze CTS en2020-09-17T10:16:56Z<p>Marekg: </p>
<hr />
<div>{{NoTitle}}<br />
{{title_main| <br />
|title-font-size=200%<br />
|title-align=center<br />
|title= CTS power supply}}<br />
<br />
<br />
<br />
In some cases of using system phones, its recommended or even required to plug additional power supply, which improve or allow to work of the phone.<br />
Table below describes the types of power supplies used for CTS system phones.<br />
<br />
{{Warning| To power up Slican system phones, use only dedicated power supply (12V/1.4A). As emergency other STABILIZED power supply with those paremeters can be used. Failure to comply can cause damage to the phone ! ! !.}}<br />
<br />
<br />
{| {{Prettytable}}<br />
!{{Hl2}}|*<br />
!{{Hl2}}|System phone model<br />
!{{Hl2}}|36V/160mA<br> power supply<br />
!{{Hl2}}|12V/1,25A RJ11<br> power supply<br />
!{{Hl2}}|12V/1,25A<br />
!{{Hl2}}|PoE<br />
|-<br />
|1<br />
|CTS-102.HT<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|2<br />
|CTS-102.CL<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|3<br />
|CTS-102.IP<br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|4<br />
|CTS-202.CL<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|5<br />
|CTS-202.BT<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|6<br />
|CTS-203.CLBT<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|7<br />
|CTS-202.IP<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|-<br />
|8<br />
|CTS-203.IP<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|-<br />
|9<br />
|CTS-232>2 consoles<br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|10<br />
|CTS-330.CL<br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|11<br />
|CTS-330.IP<br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|-<br />
|12<br />
|CTS-220.CL<br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|13<br />
|CTS-220.IP<br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|-<br />
|14<br />
|Konsole CTS-338<br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>is using phone power</center><br />
|<center>is using phone power</center><br />
|}<br />
<br />
=CTS.IP phone PoE power=<br />
CTS-220.IP meet standard 802.3af (class 0). They can be powered (along with consoles) from devices with PoE (Power over Ethernet) – powered from Ethernet Network. Examples:Slican PoE card, PoE switch, Power injector devices.<br />
<br />
CTS102.IP phone doesn't meet 802.3 standard. Despite that it can be powered from ethernet passively, within voltage of 36-48V DC.<br />
<br />
For specific case splitter Slican UTS-1C2T can be used to power phone passively. Connecting DC power supply with 36-57V voltage to DC input (any polarisation, power adequate for connected device) and phone to LAN/PoE input, we can power phone directly from Ethernet network.<br />
<br />
<b>Example:</b><br />
<br />
[[File:UTS 1C2T.png | 600px]]<br />
----<br />
[[CTS-330 information| Return to Instruction manual]]</div>Marekghttp://pubwiki.slican.com/index.php?title=File:UTS_1C2T.png&diff=7910File:UTS 1C2T.png2020-09-17T10:06:48Z<p>Marekg: </p>
<hr />
<div></div>Marekghttp://pubwiki.slican.com/index.php?title=Zasilacze_CTS_en&diff=7909Zasilacze CTS en2020-09-17T10:06:31Z<p>Marekg: /* CTS.IP phone PoE power */</p>
<hr />
<div>{{NoTitle}}<br />
{{title_main| <br />
|title-font-size=200%<br />
|title-align=center<br />
|title= CTS power supply}}<br />
<br />
<br />
<br />
In some cases of using system phones, its recommended or even required to plug additional power supply, which improve or allow to work of the phone.<br />
Table below describes the types of power supplies used for CTS system phones.<br />
<br />
{{Warning| To power up Slican system phones, use only dedicated power supply (12V/1.4A). As emergency other STABILIZED power supply with those paremeters can be used. Failure to comply can cause damage to the phone ! ! !.}}<br />
<br />
<br />
{| {{Prettytable}}<br />
!{{Hl2}}|*<br />
!{{Hl2}}|System phone model<br />
!{{Hl2}}|36V/160mA<br> power supply<br />
!{{Hl2}}|12V/1,25A RJ11<br> power supply<br />
!{{Hl2}}|12V/1,25A<br />
!{{Hl2}}|PoE<br />
|-<br />
|1<br />
|CTS-102.HT<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|2<br />
|CTS-102.CL<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|3<br />
|CTS-102.IP<br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|4<br />
|CTS-202.CL<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|5<br />
|CTS-202.BT<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|6<br />
|CTS-203.CLBT<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|7<br />
|CTS-202.IP<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|-<br />
|8<br />
|CTS-203.IP<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|-<br />
|9<br />
|CTS-232>2 consoles<br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|10<br />
|CTS-330.CL<br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|11<br />
|CTS-330.IP<br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|-<br />
|12<br />
|CTS-220.CL<br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|13<br />
|CTS-220.IP<br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|}<br />
<br />
=CTS.IP phone PoE power=<br />
CTS-220.IP meet standard 802.3af (class 0). They can be powered (along with consoles) from devices with PoE (Power over Ethernet) – powered from Ethernet Network. Examples:Slican PoE card, PoE switch, Power injector devices.<br />
<br />
CTS102.IP phone doesn't meet 802.3 standard. Despite that it can be powered from ethernet passively, within voltage of 36-48V DC.<br />
<br />
For specific case splitter Slican UTS-1C2T can be used to power phone passively. Connecting DC power supply with 36-57V voltage to DC input (any polarisation, power adequate for connected device) and phone to LAN/PoE input, we can power phone directly from Ethernet network.<br />
<br />
<b>Example:</b><br />
<br />
[[File:UTS 1C2T.png | 600px]]<br />
----<br />
[[CTS-330 information| Return to Instruction manual]]</div>Marekghttp://pubwiki.slican.com/index.php?title=Zasilacze_CTS_en&diff=7908Zasilacze CTS en2020-09-17T09:51:17Z<p>Marekg: </p>
<hr />
<div>{{NoTitle}}<br />
{{title_main| <br />
|title-font-size=200%<br />
|title-align=center<br />
|title= CTS power supply}}<br />
<br />
<br />
<br />
In some cases of using system phones, its recommended or even required to plug additional power supply, which improve or allow to work of the phone.<br />
Table below describes the types of power supplies used for CTS system phones.<br />
<br />
{{Warning| To power up Slican system phones, use only dedicated power supply (12V/1.4A). As emergency other STABILIZED power supply with those paremeters can be used. Failure to comply can cause damage to the phone ! ! !.}}<br />
<br />
<br />
{| {{Prettytable}}<br />
!{{Hl2}}|*<br />
!{{Hl2}}|System phone model<br />
!{{Hl2}}|36V/160mA<br> power supply<br />
!{{Hl2}}|12V/1,25A RJ11<br> power supply<br />
!{{Hl2}}|12V/1,25A<br />
!{{Hl2}}|PoE<br />
|-<br />
|1<br />
|CTS-102.HT<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|2<br />
|CTS-102.CL<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|3<br />
|CTS-102.IP<br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|4<br />
|CTS-202.CL<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|5<br />
|CTS-202.BT<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|6<br />
|CTS-203.CLBT<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|7<br />
|CTS-202.IP<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|-<br />
|8<br />
|CTS-203.IP<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|-<br />
|9<br />
|CTS-232>2 consoles<br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|10<br />
|CTS-330.CL<br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|11<br />
|CTS-330.IP<br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|-<br />
|12<br />
|CTS-220.CL<br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|13<br />
|CTS-220.IP<br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|}<br />
<br />
=CTS.IP phone PoE power=<br />
<br />
<br />
<br />
----<br />
[[CTS-330 information| Return to Instruction manual]]</div>Marekghttp://pubwiki.slican.com/index.php?title=Zasilacze_CTS_en&diff=7907Zasilacze CTS en2020-09-17T09:50:44Z<p>Marekg: </p>
<hr />
<div>{{NoTitle}}<br />
{{title_main| <br />
|title-font-size=200%<br />
|title-align=center<br />
|title= CTS power supply}}<br />
<br />
<br />
<br />
In some cases of using system phones, its recommended or even required to plug additional power supply, which improve or allow to work of the phone.<br />
Table below describes the types of power supplies used for CTS system phones.<br />
<br />
{{Warning| To power up Slican system phones, use only dedicated power supply (12V/1.4A). As emergency other STABILIZED power supply with those paremeters can be used. Failure to comply can cause damage to the phone ! ! !.}}<br />
<br />
<br />
{| {{Prettytable}}<br />
!{{Hl2}}|*<br />
!{{Hl2}}|System phone model<br />
!{{Hl2}}|36V/160mA<br> power supply<br />
!{{Hl2}}|12V/1,25A RJ11<br> power supply<br />
!{{Hl2}}|12V/1,25A<br />
!{{Hl2}}|PoE<br />
|-<br />
|1<br />
|CTS-102.HT<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|2<br />
|CTS-102.CL<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|3<br />
|CTS-102.IP<br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|4<br />
|CTS-202.CL<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|5<br />
|CTS-202.BT<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|6<br />
|CTS-203.CLBT<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|7<br />
|CTS-202.IP<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|-<br />
|8<br />
|CTS-203.IP<br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|-<br />
|9<br />
|CTS-232>2 consoles<br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|10<br />
|CTS-330.CL<br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|11<br />
|CTS-330.IP<br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|-<br />
|12<br />
|CTS-220.CL<br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{No}}</center><br />
|-<br />
|13<br />
|CTS-220.IP<br />
|<center>{{No}}</center><br />
|<center>{{No}}</center><br />
|<center>{{Ok}}</center><br />
|<center>{{Ok}}</center><br />
|}<br />
<br />
<br />
<br />
----<br />
[[CTS-330 information| Return to Instruction manual]]</div>Marekghttp://pubwiki.slican.com/index.php?title=CTS-220_information&diff=7906CTS-220 information2020-09-17T08:53:20Z<p>Marekg: </p>
<hr />
<div>{{NoTitle}}<br />
{{title_main| <br />
|title-font-size=200%<br />
|title-align=center<br />
|title= CTS-220 manual}}<br />
<br />
<br />
<center> <b>System phones<br />
Slican CTS-220.CL<br />
<br />
Slican CTS-220.IP<br />
<br />
[[File:CTS220_black.jpg|350px]][[File:CTS220_grey.jpg|350px]]<br />
<br />
User manual release 1.0</b></center><br />
<br />
<center>'''SLICAN Sp. z o.o.'''</center><br />
<br />
<center>[http://www.slican.com/ www.slican.com] </center><br />
<br />
<center>e-mail: [mailto:office@slican.pl office@slican.pl]</center><br />
<br />
<br />
<center>„The manufacturer reserves the right to introduce changes to the product without prior notice.”</center><br />
<br />
<br />
<center>Date of last modification: 15.09.2016 </center><br />
<br />
{{Warning| System phone CTS-220 works with NCP-PBX, IPL-256, IPM-032, IPU-14, IPS-08 and MAC-6400. For proper work in IPx, MAC-6400 and CCT-1668, 6.50 PBX firmware or higher is needed. NCP-PBX requires 1.06 firmware version or higher. Additional power supply is needed when connecting additional expanding consoles.<br />
WiFi is supported since firmware 1.12 NCP and 6.54 IPx, MAC, CCT.<br />
<br />
Bluetooth module since phone is available to buy. Due to interference of WiFi and Bluetooth modules, modules can't be used at same time.}}<br />
<br />
Slican CTS-220.CL/IP is a business system phone for companies requiring advanced phone systems and efective call and contacts managing. It's equipped with high quality LCD display, that ensures perfect readability in different lightning conditions. Phone's profile is generated and stored within PBX memmory - thanks to which, using it is possible immediately after connecting, without complicated and time-consuming programming.<br />
<br />
Great audio quality and simplicity of operation makes this phone ideal for everyday work. Programmable keys allows unlimited, individual creation of functions, services or handy list of contacts.<br />
<br />
The phone looks great on your desk. Light and ergonomic handset and optimal lenght od headset cord makes it a unrepleaceable partner in every day work. CTS-220 allows cooperation with headset (wired or wireless) or loudspeaker.<br />
<br />
==[[Parametry Techniczne CTS220| Technical parameters]]==<br />
<br />
==[[CTS220 build and equipment| Build and equipment]]==<br />
<br />
==[[CTS-220 phone settings| Phone settings]]==<br />
<br />
==[[CTS-220 keys and call history| Calling, history and BLF]]==<br />
<br />
==[[CTS-220 phonebook| Phonebook]]==<br />
<br />
==[[CTS-220 system services| Using system services]]==<br />
<br />
==[[Zasilacze CTS_en| CTS power supply]]==<br />
<br />
==[[Wymogi_bezpieczenstwa_CTS_en| Safety Requirements and Certificate of Conformity for CTS devices]]==<br />
<br />
==[[CTS-220 BT|Connecting Bluetooth headset to CTS-220]]==<br />
<br><br />
[[Main_Page | Return to Main Page]]</div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI.Mobile_Manual&diff=7865MessengerCTI.Mobile Manual2020-05-25T11:34:19Z<p>Marekg: /* Minimum requirements */</p>
<hr />
<div><center>[[File:messenger_2.png|250px]]</center><br />
= Introduction=<br />
'''MessengerCTI.Mobile''' Slican Software is mobile application dedicated for '''Android''' operating system, which allow to make incoming or outgoing calls, access to phone book, call history, view status of other subscribers and chat.<br><br />
Application can work together alongside desk phone and smartphone already in use by PBX subscriber. <br><br />
<br />
Application have advantage of being integrated with phone book saved in PBX. '''MessengerCTI.Mobile''' is using phone book stored in PBX but phone book entries can be modified only by using system phone or by computer with ''MessengerCTI.Desktop'' application or '''WebCTI'''. Additionaly '''MessengerCTI.Mobile''' Slican software operates as internal messenger-chat. Messenger can be use by all subscribers of particular PBX if required licenses are supplied.<br />
<br><br />
==Application advantages==<br />
* application available(for free) from Google Play store - only CTI.plus license applied to PBX is required<br />
* phone book with access to subscribers availability(chat, phone status, text status)<br />
* option of adding and removing subscribers from favorite group, synchronised with MessengerCTI.Desktop<br />
* history of recent calls/messages sorted chronologically<br />
* logging with phone simultaneously as desk phone or as separate MessengerCTI subscriber(NCP PBX only)<br />
* chat/messenger<br />
* chat history with phone call history<br />
* voice calling through GSM(two connection options- capture or parallel)<br />
* flexible configuration of audio notifications<br />
* access to PBX services configuration from phone<br />
* rapid access number for fast call forwarding<br />
* option of setting up busy status of desk phone if GSM is buy (on by default)<br />
* option of setting up incoming call denying on GSM if desk phone is busy<br />
* option of copying text from chat<br />
* support of DualSim smartphone or two phones simultaneously (private or business)<br />
* convenient access to opening door/gate if receiving call from doorphone DPH.IP or from context contacts menu<br />
* additional desktop widget for fast access to open DPH.IP doorphone doors<br />
* automatic delay of notifications for MessengerCTI.Mobile if desk phone or MessengerCTI.desktop is active <br />
* option of copying contact from local phone book to PBX phone book<br />
<br />
{{Attention!| <br />
*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.<br />
*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}}<br />
<br />
= Minimum requirements =<br />
'''''MessengerCTI.Mobile''''' application - is available to download from Google Play store.<br />
<br />
For installing application minimum requirements must be met:<br />
* Android operating system<br />
** minimum version: KitKat 4.4.4<br />
** minimum recommended version: Nougat 7.0<br />
** PBX and application must have access to internet<br />
Phone with lower version of operating system then 4.4.4 won't be able to install application. <br />
<br />
{{Attention!|<br />
While using for VoIP calls we recommended Android version 7.0 or higher due:<br />
* better call stability<br />
* option of automatic regaining voice connection after reloging to network or changing IP<br />
* option of regulating microphone gain for VoIP calls<br />
}}<br><br />
<br />
{{Attention!|<br />
'''''MessengerCTI.Mobile''''' application works with IPx, MAC and CCT PBX with firmware version '''6.53''' or higher and NCP PBX'''1.11'''<br><br />
VoIP with application is supported for IPx, MAC and CCT with firmware '''6.54''' and NCP firmware '''1.12'''}}<br><br />
<br />
=Application installation =<br />
'''''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).<br />
<br />
{{Attention!|<br />
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.}}<br />
<br />
== Starting application ==<br />
<br />
'''''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). <br />
== Configuring application==<br />
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><br />
<br />
Fields required for configuration can be found here:account, notifications, handy numbers.<br />
===Account===<br />
Configured with information configured by PBX administrator.:<br />
* Your telephone number: internal subscriber number(extensions) with access to CTI communication<br />
* password: CTI user password<br />
* advanced -> Transmission protocol port: port used for communication with PBX - by default set to TCP 5529<br />
* Host: domain address or IP address of local PBX(public IP address for users outside LAN) <br />
<br />
===Notifications===<br />
Configuring call notifications:<br />
* ringtone: ringtone from available ones can be chosen.<br />
* missed call: notify about missed calls on status bar.<br />
Configuring chat messages notifications:<br />
* message tone: tone from available ones can be chosen.<br />
===Handy numbers===<br />
List of handy numbers available during active call, they can be user for fast forward to another number from handy list.<br />
<br />
===Other===<br />
Configuring phone busy status depending on incoming call direction(GSM or CTI call):<br />
* during GSM talk, internal number will be busy<br />
* reject GSM when internal number is busy<br />
Solving issues with proper software operation:<br />
* debug - administrator option which is turned on on software vendor suggestion, for analysing issue logs.<br />
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.<br />
<br />
== Services==<br />
Configuring application services related to connections/calls:<br />
* DND: Do not Disturb<br />
* 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)<br />
* silence application: silent mode<br />
== My description ==<br />
Setting text status that will be visible to other MessengerCTI.Users or on screen of CTS-330 system phone.<br />
== About software ==<br />
Information about: <br />
* current software version<br />
* type of connected PBX<br />
* PBX firmware version<br />
* Own number: CTI account number(internal PBX extension)<br />
* Own comment: user comment made by administrator<br />
<br />
== Updating application ==<br />
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.<br />
<br />
= Application structure =<br />
== Main window ==<br />
Main application windows give access to two tab:<br />
* '''Last/Recent''' - history of calls, chat messages and users statuses.<br />
* '''Contacts''' - access to PBX phone book with sorting options:favourites, internal, external.<br />
* login icon status with text status<br />
* searching contacts<br />
* applications settings menu <br />
<center>[[File:MessengerCTI_opis_new.png|800px]]</center><br />
<br />
== Icons meaning ==<br />
'''''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.<br />
=== Icons and symbols ===<br />
"Last/recent" starting application windows is showing history of calls. Icons located here are:<br />
* left side: application status of other MessengerCTI.Desktop/Mobile users or call history<br />
* right side: information about call direction and message status<br> <br />
<br />
Table 1 describes meaning of particular icons informing about application status of other MessengerCTI.Desktop/Mobile users:<br />
* PBX internal subscribers - icons showing status of logged application, touching icon allows to start chat or check call history<br />
* DPH.IP doorphone - door position, touching icon allows to check history<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl1}}|Ikona !!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTID_free.png|40px]] ||user logged in<br />
|-<br />
|{{align|center}}|[[File:MessengerCTID_be_right_back.png|37px]] ||status: "Be right back" <br />
|-<br />
|{{align|center}}|[[File:MessengerCTID_chat_busy1.png]] ||status set by user "Do not disturb" <br />
|-<br />
|{{align|center}}|[[File:MessengerCTID_chat_no_login.png|40px]] ||user logged our, not available or status is set to "Hidden"<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIMD_chat_free.png|40px]] || Desktop application status with configured Mobile version <br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_chat_DND.png|40px]] ||calls and messages history<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_door_open.png|40px]] ||DPH.IP doorphone: door open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_door_closed.png|40px]] ||DPH.IP doorphone: door closed<br />
|-<br />
|}<br />
'''''Table 1:''''' Icon shows status of application, users and doorphones.<br></center><br><br />
<br />
In case of phones being PBX extensions, icon will show phone status.<br />
<center><br />
<br />
{|{{prettytable}}<br />
!{{Hl1}}|Ikona !!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_call.png|40px]] ||number is busy<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_ringing.png|40px]] ||calling number or making outgoing call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_failure1.png|40px]] ||number is not available or faulty<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_DND.png|40px]] ||DND service is on<br />
|-<br />
|}<br />
'''''Table 2:''''' Icons displaying phone status<br></center><br />
<br />
Table 3 shows meaning of icons displaying calls status: <br />
<center><br />
{|{{prettytable}}<br />
!{{Hl1}}|Icon !!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_incom_call.png|40px]] ||incoming call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_out_call.png|40px]] ||outgoing call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_answer_qty.png|50px]] ||new missed call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_answer.png|45px]] ||missed call<br />
|-<br />
|}<br />
<br />
'''''Table 3:''''' Icons displaying calls.<br></center><br />
<br />
Table 4 shows icons displaying message status:<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl1}}|Icon !!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_incom_chat.png|40px]] ||Message received <br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_out_chat.png|40px]] ||Message sent, read<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_answer_chat.png|50px]] ||New message, received<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_received_chat.png|45px]] ||Message sent, not read<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_send_read_chat_conf.png|40px]] ||Message sent, read - dialogue window view<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_send_notread_chat_conf.png|40px]] ||message sent, not read - dialogue window view<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_send_unav_chat_conf.png|40px]] ||Message sent to logged out user - dialogue window view<br />
|-<br />
|}<br />
'''''Table 4:''''' Icons showing message status.<br></center><br />
<br />
Table 5 shows description of application errors and notifications. Notifications are visible under status icon.<center><br />
{|{{prettytable}}<br />
!{{Hl1}}|Notification !!{{Hl1}}| Meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_internet.png]] ||No connection: check network connection<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_auth.png|236px]] || Wrong login or password: check account settings<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_licen.png|236px]] || App not allowed in PBX: contact PBX administrator<br />
|-<br />
|}<br />
'''''Table 5''''': Error icons meaning.<br />
</center><br />
<br />
=Supporting messages and calls=<br />
For call between two users necessary are:<br />
* proper account configuration of application and PBX<br />
* full connection between application and PBX(full data synchronisation of application with PBX) - application icon should have green color<br />
* installed Slican system phone, VoIP or analog phone for IPx, MAC or NCP PBX or configured MessengerCTI subscriber((only NCP PBX)<br />
<br />
==Making calls==<br />
Two ways of making calls:<br />
* 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. <br />
* from '''Contacts''' tab- searching for phone number in '''Search''' field by using keyboard then touching lower right corner of keyboard<br />
<center>[[File:MessengerCTIM_out_ext1.png|750px]]</center><br />
* 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<br />
<center>[[File:MessengerCTIM_out_number1.png|570px]]</center><br />
<br />
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.<br />
<br />
==Incoming calls==<br />
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.<br />
Process of receiving incoming calls works by making a return call with GSM line to application access number defined by PBX administrator.<br />
<center>[[File:MessengerCTIM_incoming2.png|700px]]</center><br />
<br />
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.<br />
<br />
==Messages support==<br />
Application allows to send and receive text messages between MessengerCTI.Desktop/Mobile user (internal chat). To send message user status icon must be touched or from drop down menu and touching contact tab, then choosing '''chat'''.<br><br />
Receiving messages is displayed on notification bar by proper icon and defined ring tone.<br> <br />
If subscriber is using both versions of MessengerCTI, messages history is stored locally in '''''MessengerCTI.Dekstop''''' application.<br><br />
Below is example of chat window:<br />
<br />
<center>[[File:MessengerCTIM_czat1.png|700px]]</center><br />
<br />
== Contacts==<br />
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: <br />
* favourites<br />
* all groups<br />
* all contacts<br />
* internal<br />
* external<br />
* private<br />
By default '''Favourites''' group is visible.<br />
<center>[[File:MessengerCTIM_contacts1.png|300px]]</center><br />
<br />
== Call history ==<br />
By default '''Last/Recent''' tab will be visible and showing calls and chat messages history.<br><br />
In history every position is at least one call or message. If there is more then one call/message and they come from sam user, on their icon number will be displayed. Every position is displaying caller number, commentary(if number is from phone book outside PBX), time and date of call.<br><br />
If in history there are missed calls or messages, '''Last/Recent''' field will be marked with red dot.<br><br />
History tab allows to call back or reply to messages.<br />
<br />
=Configuring Slican PBX=<br />
For proper communication between application and PBX are required:<br />
* correct manufacturer license<br />
* specific PBX configuration<br />
==IPx, CCT PBX configuration==<br />
With ConfigMan software:<br />
# Inside '''''Themes''''' tab and then '''''Global settings->Global settings/Remain''''': <br />
## '''ANo''':configure access number that application will chose for making call to PBX and setting up incoming call<br />
## '''Adr''' - public host name or PBX IP address for connecting to application(for VoIP calls with application)<br />
# Inside Subscribers menu, '''''Tables''''' then '''''Subscribers->Subscribers/CTI settings:<br />
## '''AwdMbl''': allow access to MessengerCTI.Mobile application<br />
## '''AwdGSM''': allows to connect phone calls through GSM network<br />
## '''IncC''': setting up method of how application connects incoming calls:<br />
### Call pickup - picking up incoming call with application means making outgoing call with GSM phone to number from '''ANo'' field inside ''''' Global settings/Remain''''' <br />
### Parrallel calling - incoming calls to GSM phone from number set in '''ANo'''field inside ''''' Global settings/Remain'''''<br />
## '''MnNo''': configure GSM phone access number, on which application is installed, optionally configure second number(for dual SIM phones)<br />
## '''SecNo''': second GSM phone number with installed application(optional, for dual SIM phones)<br />
<br />
<br />
For application to work with each settings, these fields parameters must be set:<br />
* VoIP network: 1.2, 2.1<br />
* GSM network: 1.1, 2.1, 2.2, 2.2.1, 2.2.2, 2.3 and 2.3.1 or 2.3.2<br />
<br />
<font color=red>'''Minimum PBX firmware version - 6.53, for VoIP - 6.54'''</font><br />
<br />
==NCP PBX configuration==<br />
From ConfigWEB application:<br />
* '''''Extensions->Settings->CTI application settings''''' menu, configure access number that application will use to call to PBX and make accept incoming call <br />
* in subscriber editing for SIP, FXS, CTS, Messenger CTI number in menu '''''Extensions->Subscribers->CTI settings'''''<br />
** configure GSM phone access number which will have installed application<br />
** set up type of handling incoming calls: call pickup (only application is ringing up) or parallel calling(application and internal phone is ringing up)<br />
<br />
<font color=red>'''Minimum software version is: 1.11.'''</font><br />
<br />
From ConfigWEB application:<br />
# '''''Extensions->Settings->CTI application settings''''' menu, configure<br />
## 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<br />
## Public host name or PBX IP address for VoIP calls - domain name or IP address for for configuring VoIP calls<br />
## 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)<br />
# configure subscribers for SIP,FXS, CTS, MCTI with ''''''Extensions/Subscribers/CTI Settings/ MessengerCTI.Mobile'''''<br />
## Allow access to MessengerCTI.Mobile application<br />
## if using GSM network allow phone calls handling using GSM<br />
### set up GSM phone access number for device with installed application<br />
### set up second GSM phone number with installed applicatio (optional, for dual SIM devices)<br />
## set up incoming calls handling<br />
### 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'''' <br />
### Parallel calling - incoming call to GSM phone from number set with '''''Extensions/ Settings/ CTI applications settings / MessengerCTI'''' <br />
<br />
<br />
For application to work, these fields must be set:<br />
* VoIP: 1.1, 1.2, 2.1<br />
* 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<br />
<br />
<br />
<font color=red>'''Minimum PBX firmware version - 1.11, for VoIP - 1.12'''</font><br />
<br />
=Use cases examples=<br />
'''''MessengerCTI.Mobile''''' application is useful tool for companies that employ mobile workers which requires constant access to phone with internal number of phone system. <br> <br />
These employees can be a good example:<br />
* sales department - working in different locations, office <-> outside office<br />
* service support - constant fieldwork<br />
* remote worker - remote work<br />
* mobile worker - working on vast area(production halls, vast areas) -where Wifi or DECT network range won't be adequate<br />
<br />
=Installing beta version=<br />
"Beta" version contains new functionalities which will be added in next production version but not all of planned functions are implemented. This version also cointains fixes for error submited for earlier versions. It was initialy tested.<br><br />
To install beta version:<br><br />
- If on the phone MessengerCTI is installed, uinstall it.<br><br />
- log to Google Play as application tester<br><br />
In this case:<br />
Log in from computer or phone web browser to your Google account. If you hav more then account it is important to log into account which was used to configure your phone.<br><br />
Click this link:<br />
[https://play.google.com/apps/testing/com.slican.messengercti beta version registration]<br><br />
When you will see this info:<br><br />
[[File:google_beta.jpg]]<br><br />
Click BLUE BUTTON to sign up for testing<br><br />
Going back to phone configuration: <br><br />
- Because Google Play updates can be delayed, it is recommend to turn of Play Store application before installing MessengerCTI.<br><br />
- Clicking on shortcut will start Play Store again. Search for MessengerCTI application. It is recommended to search also for Slican due to many other application using "messenger" word in their naming.<br><br />
- Install application.<br><br />
- Configure according to manual.j<br><br />
Use beta version features.</div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI_Manual&diff=7864MessengerCTI Manual2020-02-13T14:13:26Z<p>Marekg: /* NCP PBX */</p>
<hr />
<div>= Introduction =<br />
Slican '''MessengerCTI.Desktop''' is software which purpose is to assist users of Slican PBX. Thanks to the graphic interface displayed on the computer screen, software allows for convenient access of telephone calls and other functions related to it. Software delivers additional features that allows to expand capabilities of desk phone. Software combines capabilities of controlling desk phone connected to PBX, for example choosing number, receiving calls and also application is able to function as standalone phone. Software also allows to: accessing PBX's phonebook, call history, status of phone and other users of MessengerCTI, text communication and sending or receiving SMS messages. Additionally for new version of DPH.IP doorphone equipped with camera - video preview was added.<br />
<br />
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). Users of analogue phones will benefit from this software because they'll gain access to functions that aren't available on these types of devices.<br />
<br />
= Basic functionalities =<br />
<br />
=== Using cameras and DPH.IP doorphones ===<br />
<br />
Introduction of DPH.IP doorphones that include cameras led to solution that allows display of video from these cameras. Functionality was added with MessengerCTI.Desktop. While connecting to doorphone from software video from camera will appear in new window on computer display. After picking up and finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door,gate, using dedicated button. Reverse is also true, calling doorphone or another telephone number associated with camera, display screen will show video from camera. This allow for temporary observation of surroundings of installed camera, for example person we are calling. There is also option of watching video from any camera without making call, just using application icon. Thanks to MessengerCTI.Desktop user can preview video from camera of other manufacturers but those devices have to support video formats, codec compatible with VLC application libraries.<br />
<br />
{{Attention!|<br />
MessengerCTI.Desktop application was released mainly for displaying video from DPH.IP doorphones and and this time doesn't yet have all fuctionality of PhoneCTI application. Those options will be added gradually}}<br />
<br />
=== VoiP Client===<br />
<br />
MessengerCTI.Desktop can work as VoIP, concurrent phone connected to stationary desk phone(FXS,CTS,IP). User can decide on which device to pick up a call, phone or a computer - using it's integrated audio devices(sound card, microphone, speakers or external headphones). Since 1.11 version of NCP firmware application can be used as standalone SIP phone. For such configuration CTIuserPlus license is required.<br />
<br />
<br />
=== Phone Book ===<br />
<br />
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 possible instantly after adding it. Access to phone book allows to simply search numbers of contacts user want to call. On other hand, during incoming calls computer displaying will be showing clear information about calling person.<br />
<br />
=== Call History ===<br />
<br />
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.<br />
<br />
=== Text messages ===<br />
<br />
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.<br />
<br />
=== Usage alongside mobile version ===<br />
<br />
Application can be used alongside and synchronized to MessengerCTI.Mobile, Android version for mobile devices.<br />
<br />
<br />
= Minimum requirements =<br />
To install SLICAN MessengerCTI.Desktop application, following minimum requirements must be met:<br />
*CPU Frequency - 800 mhz or higher<br />
*Ram - 1 GB or more<br />
*GPU- compatible with DirectX 9 <br />
*Operating System - Windows 7 or more recent<br />
<br />
Application can be installed on computer which doesn't meet minimum requirements but it will run slowly or some option won't work correctly.<br />
{{Attention!|<br />
'''MessengerCTI.Desktop''' application works with IPx, Mac and CCT PBX with firmware 6.52 or newer, or NCP PBX with firmware 1.10}}<br />
<br />
= Installation of application =<br />
<br />
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 computer. After installing, application should be properly configured by entering necessary PBX information to which software should be conencted:<br />
Settings - Connection.<br />
{{Attention!|<br />
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.}}<br />
<br />
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"<br />
<br />
== Running application ==<br />
<br />
MessengerCTI.Dekstop can be run just as any other Windows compatible software. In the program settings automatic start during launch of operating system can bet set. During start of program it is logging to PBX(according to settings set in Settings - Connection tab). After successful login program data is synchronized with PBX data.<br />
<br />
== Updating application ==<br />
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 <br />
compared to version on PBX. If they differ, version from PBX is automaticly downloaded, installed and logged to PBX. Depending on version from PBX it may install newer or old version.<br />
<br />
= Available configurations =<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned off) - calling with phone, application - dialling up outgoing calls for phone(CTS, FXS, SIP) and picking up incoming calls for phone (CTS)<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned on) independent choice of picking/dialing up call with phone or application.<br />
*Autonomous application without desk phone (application VoIP mode on) - picking/dialling calls only with application.<br />
<br />
Other functionalities for example chat, sending and receiving SMS, displaying video from camera, accessing call history and phone book, configuring user status and Messenger aplication are available for each of the above configurations.<br />
<br />
Application '''MessengerCTI.Mobile''' is intended for mobile devices with Android system, its description can be found HERE(manual in progress).<br />
<br />
== '''MessengerCTI.Desktop''' with simultaneous configuration ==<br />
<br />
===Application with VoIP mode turned OFF.===<br />
<br />
Phone calls are made only using phone working alongside application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, dialling with phone speaker using CTS phone<br />
*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.<br />
<br />
For user of FXS nad SIP phones picking up earphone is necessary.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_VoIP.png |800px]]</center><br />
<br />
===Application with VoIP mode turned ON.===<br />
<br />
Phone calls can are made with phone or with computer and application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_with_phone.png |800px]]</center><br />
<br />
== '''MessengerCTI.Desktop''' working as standalone phone (only with NCP)==<br />
<br />
===Application with VoIP mode turned on.===<br />
<br />
Phone calls are made only with computer and application. Standalone applications allows:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_phone.png |800px]]</center><br />
<br />
= Program structure =<br />
==Main window==<br />
Main windows of MessengerCTI.Desktop application contains interface which show information and allows access to chat windows and main functions.<br />
<center>[[File:MessengerCTI_main_window.PNG]]</center><br />
===Upper part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_-_main_window_-_upper.png]]<br />
*left side<br />
**hyperlink to software version<br />
<br />
*right side<br />
**default window position button<br />
**close - minimizing to tray button<br />
<br />
===Middle part of window:===<br />
<br />
[[File:MessengerCTIDesktop_-_main_window_-_middle.png]]<br />
*left side:<br />
**changing application status button<br />
<br />
*middle: program name,below - user status - field that can by user to provide additional urlop, for example to inform about vacation or being busy with project<br />
<br />
*right side:<br />
**searching (magnifying glass) - button/field for searching number or contact<br />
**preferences - access to program settings<br />
<br />
===Lower part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_main_window_lower.PNG]]<br />
*access to tabs:<br />
**contacts - phonebook from bx with sorting options<br />
**recent - history of most recent calls and messages.<br />
<br />
== Status of application and user ==<br />
'''MessengerCTI.Dekstop''' software allows to show current status of user with coloured symbol and display it inside applications of other users. Applications status is informing about user availability, depending on user actions status can be changed by him or application can change it automatically. More information can be added through text status of user. User can choose different icons/symbol to set his status manually. Additionally there is graphic informing about ringing phone or current call.<br />
<br />
===List of icons and symbols===<br />
Chart presents list of icons available in '''Contacts''' and '''Recent''' tabs:<br />
<br />
* [[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.<br />
* [[File:MessengerCTI_history.png | 32px]] - for public subscribers.<br />
* [[File:MessengerCTI_close_door.png | 32px]] - for DPH.IP doorphones connected to open/closed door sensor<br />
<br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Status of application and DPH.IP doorphones<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_green.png | 32px]] ||PBX subscriber; '''MessengerCTI.Desktop''' application is running '''and and LOGGED IN'''from subscriber computer. Clicking icon will allow to send text messeger, SMS or dial a call to another application user.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_chat_tv_yellow.png | 29px]] ||PBX subscriber; '''Be right back''' set by user or application, delay time is definied in general settings of application.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_red.png | 32px]] ||PBX subscriber; '''Do not disturb''' set by user<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_grey.png | 32px]] ||PBX subscriber; '''Invisible''' set by user or application is logged off.<br />
|-<br />
|{{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)<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_history.png | 32px]] ||public subscriber; clicking icon will allow to send SMS or dial call to chosen subscriber.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_close_door.png | 32px]] ||doorphone; current door position - door closed, clicking icon will open door<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_open_door.png | 32px]] ||doorphone; door are open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_alarm_open_door.png | 32px]] ||doorphone; alarm timer for open doors was set off<br />
|-<br />
|}<br />
'''''Chart 1:''''' Meaning of icon status of application, users and doorphones.<br><br />
<br />
Chart is showing list if icon that appear on the left side of subscriber name in tab '''Contacts''' and '''Recent'''. Internal phone will have status icon being displayed<br />
<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Phone status and camera information<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_bell_red.png | 28px]] ||Phone is ringing<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_phone_red.png | 32px]] || During call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_camera.png | 25px]] ||Camera is associeted with phone or doorphone, clicking on icon will allow to preview camera video<br />
|-<br />
|}<br />
</center><br />
<center>'''''Tabela 2:''''' Icons displaying status of phone and camera</center><br />
<br />
== Preferences==<br />
<br />
Clicking '''Preferences''' icon in main program window will display window with program settings. In every tab there is available button with info "About software" and reseting default window position.<br />
<br />
=== Connection===<br />
In '''''Connection''''' field you must enter settings neccesary for application to connect:<br />
<br />
<center>[[File:MessengerCTI_connection.PNG]]</center><br />
<br />
'''Application login setting'''<br />
<br />
To login, application must have correct settings configured by PBX administrator: <br />
* subscriber numbers - extensions from PBX<br />
* CTI access and password:<br />
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/Settings CTI''' - '''CTI - access level''' and pasword'''Pss'''<br />
** for NCP - '''ConfigWEB''' chart '''Extensions/Subscribers/CTI setting''' - '''CTI Access''' and '''Password'''<br />
* Server address - PBX network settings<br />
CTI access level determines what options are available to application:<br />
* CTI.user - MessengerCTI without VoIP and camera preview<br />
* CTI.userPlus - MessengerCTI with VoIP and camera preview<br />
<br />
<br />
These connections settings must be filled:<br />
* '''Subscribers" field - extension number for which '''MessengerCTI.Dekstop''' will login.<br />
* '''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. <br />
* '''server IP address''' - IP address of PBX network interface. IP address of PBX network port. In case of logging outside od PBX network, IP address of edge router(port forwarding on router is necessary, 5529 TCP, 8100-8300 UDP for IPx, 10000-30000 UDP for NCP on PBX LAN interface).<br />
<br />
After user will change his password, administrator no longer will have access to this passowrd. Application can be set to remember user password by checking field while login in, if field wasn't checked application will always ask for password during every login.<br />
<br />
<br />
After proper 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. "Successful login" will apear in lower part of window.<br />
<br />
<br />
If login credentials, configuration settings aren't correct or there are issue with network connection those error messages may appear:<br />
* ''Wrong login or password. Check if correct login or password was used.''<br />
* ''Connecting to PBX'' alternating with<br />
* ''No connection to PBX'' Check IP address that was entered and check computer LAN connection.<br />
<br />
===General===<br />
<br />
<br />
<center>[[File:MessengerCTI_general_settings.PNG]]</center><br />
<br />
This window allows to configure settings defining how program works and startup options.<br />
Available settings:<br />
*Auto start on System startup - automatic start of application.<br />
*Start minimized - application will run hidden in system task bar.<br />
*Set "Be right back" state after - status icon will change automatically, informing about user being away from computer after defined time.<br />
*Set shortcut for application window - changes application from Windows task bar to desktop and vice versa.<br />
*Choose double click function(for contact or number):<br />
**show call window - choice windows is displayed with options - number, phone call, opening chat/SMS window, closing current window<br />
**call primary number - automatic number dialling<br />
**show last events - recent call history to particular subscriber is displayed.<br />
*Set this window position as default - allows to set up default application's window potion on screen.<br />
<br />
===Audio settings===<br />
These setting allow to set up audio notifications informing about incoming calls and messages and audio setting of computer audio devices.<br />
<br />
<br />
<center>[[File:MessengerCTI_audio_settings.PNG]]</center><br />
<br />
*Enable VoIP on when available - allows application to work as VoIP client(VoIP phone)<br />
<br />
<center>[[File:MessengerCTI_voip_settings.PNG]]</center><br />
<br />
==Dialing and picking up calls==<br />
To set up call between two users, particular hardware, software and proper configuration must be supplied:<br />
*Slican PBX<br />
*computer with installed and configured MessengerCTI.Desktop software<br />
**software logged to PBX with subscriber extension(Settings tab, Connection field)<br />
*analog, VoIP or Slican system phone<br />
*for video preview - DPH.IP doorphone with camera or phone associated with external camera(doesn't apply to VoIP phones with integrated camera)<br />
<br />
Call can be dialled using computer mouse and computer screen. Call is made between subscribers through phone connected to PBX and associated with MessengerCTI.Desktop. After choosing subscriber number to call and dialling call, PBX will call extension choosing number(to inform about being ready to set up connection), after picking up handset PBX will set up calling connection.<br />
<br />
==='''Dialing calls to particular number'''===<br />
<center>[[File:MessengerCTI_outgoing_call_window.png]]</center><br />
Making calls can be realised in few different way. Depending on how configured are general setting on application - option "Set double click function".<br />
* from '''Contacts''' tab<br />
**choose subscriber from proper group(if applicable) or from group "All contacts" by double clicking on number or contact<br />
**clicking on [[File:MessengerCTI_tv_green.png | 32px]] or [[File:MessengerCTI_history.png | 32px]]<br />
*'''Search''' field - by directly entering phone number with computer keyboard then clicking on green phone icon.<br />
*'''Recent''' tab - call history:<br />
**history of call with particular subscriber can be seen here, call is dialled by double click on number or contact<br />
**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]]<br />
<br />
==='''Incoming calls'''===<br />
<br />
<center>[[File:MessengerCTI_incoming_window.png]]</center><br />
Calls are displayed on computer screen with pop-up window, ringing application and ringing phone. Depending on applied configuration call can be picked up with application or phone.<br />
<br />
==='''Connecting to camera video preview'''===<br />
Connecting to/from DPH.IP with integrated camera or associated phone or external IP camera(doesn't apply to VoIP phone with integrated cameras)will display automatically new window on computer screen. Connecting to doorphone allows to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.<br />
<br />
<center>[[File:MessengerCTI_camera_preview.png]]</center><br />
<br />
<br />
<br />
===Transfering calls - version 1.03===<br />
Call can be transfered by choosing contact or number from: Recent or Contacts.<br />
* "blind transfer" - without checking target extensions state<br />
<center>[[File:MessengerCTI_blind_transfer.png | 700px]]</center><br />
<br />
<br />
* no announcing - check target extension state without announcing <br />
<center>[[File:MessengerCTI_no_announcing.png | 700px]]</center><br />
<br />
<br />
* with annoucing - check target extension state with announcing <br />
<center>[[File:MessengerCTI_with_announcing.png | 700px]]</center><br />
<br />
==Sending messages==<br />
Application allow sending(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.<br />
<br />
Receving new message is signalised on Windows system task bar with two icons alternating [[File:MessengerCTI_free.png | 32px]], [[File:MessengerCTI_mail.png | 32px]] and popping up [[File:MessengerCTI_new_message.png]].<br />
<br />
Messages history is available through hyper link '''Load previous'''. It is stored on computer local hard drive.<br />
<br />
<center>[[File:MessengerCTI_chat.png]]</center><br />
<br />
==Searching data==<br />
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Contacts''' tab in '''Search''':<br />
<br />
<br />
<center>[[File:MessengerCT_search_field.PNG]]</center><br />
<br />
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'''.<br />
<br />
== Contacts==<br />
This field allows for searching, displaying, customising and running actions related to contact. By default '''Favourites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.<br />
<br />
<center>[[File:MessengerCTI_contacts2.png]]</center><br />
<br />
Adding contacts is possible:<br />
<br />
* from search field - entering number and adding it with green handset icon<br />
* from '''Contacts''' or '''Recent''' tab - right clicking on connection<br />
<br />
From contact list we gain access to:<br />
*favourites<br />
*all contacts<br />
*extensions<br />
*created subscriber groups<br />
*public contacts<br />
*private contacts<br />
<br />
== Call history ==<br />
Choosing '''Recent''' tab - in main program window will display call history of currently logged extension to '''''MessengerCTI.Desktop'''''. Window will look like this.<br />
<br />
<br />
<center>[[File:MessengerCTI_recent.PNG]]</center><br />
<br />
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:<br />
<br />
[[File:MessengerCTI_outgoing_calls.PNG | 32px]]<br />
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.<br />
<br />
[[File:MessengerCTI_incoming_calls.PNG | 32px]]<br />
Downward arrow for incoming call that was picked up.<br />
<br />
[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]<br />
Turned arrow for missed incoming calls, digit is showing number of these calls.<br />
<br />
[[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]] [[File:MessengerCTI_message_amount.PNG | 32px]]<br />
Arrow with listed lines or text bubble for text chat or sent SMS. Digit is showing number of missed messages.<br />
If history contains missed calls or unread messages icon in '''Recent''' field will be in colour red.<br />
<br />
From History window call can be dialled or messages be send to chosen users by right clicking on subscribers text status<br />
, clicking on icons [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] and [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]] [[File:MessengerCTI_missed_calls.PNG | 32px]] [[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]]. If internal subscriber have other number listed in their phone book, choice can be made between them. For internal subscribers there is option of editing, deleting contact and deleting from favourite list.<br />
<br />
=MessengerCTI.Desktop for Call Center agents=<br />
Starting from NCP 1.12 firmware and MessengerCTI.Desktop 1.02 firmware, 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.<br />
<br />
<br />
Application state icons: <br />
* application logged: [[File:MessengerCTI.Desktop_log_in.png | 40px]]<br />
* application state: '''Be right back''' [[File:MessengerCTI.Desktop_brb.png | 40px]]<br />
Red dot by application state informs about unanswered call or message waiting for user.<br />
<br />
<br />
Agents state icons: <br />
* agent logged to queue: [[File:MessengerCTI.Desktop_agent_log_in.png | 40px]]<br />
* agent pause: [[File:MessengerCTI.Desktop_agent_pause.png | 40px]]<br />
* agent logged out of queue: [[File:MessengerCTI.Desktop_agent_log_out.png | 40px]]<br />
Red dot by agent state icons informs about calls unanswered by CC agents.<br />
<br />
<br />
'''CC''' tab within application, depending on configuration is showing:<br />
* up to 4 programmed buttons with present state for current agent: '''Log in/out of CC queue''' and '''Turn on/off agent pause'''<br />
* serviced queues with amount of logged agents and waiting calls<br />
* Callback list - numbers/contacts to call back<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_CC_tab_.png]]</center><br />
<br />
When using callback list, additional window will apear allowing to make call and field to confirm if call was successfull.<br />
<br />
<br />
To properly configure '''CC''' tab, '''Call Center''' sections within application preferences must be set up.<br />
<br />
<center>[[File:MessengerCTI.Desktop_configure_cc.png]]</center><br />
<br />
=Licensing=<br />
==IPX, MAC, CCT PBX==<br />
MessengerCTI.Desktop application:<br />
* 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.<br />
* 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<br />
* calls made form application in VoIP mode are using VoIP channels just like other VoIP devices<br />
* MessengerCTI.Dekstop configured without VoIP and camera preview access - CTIuser license is required<br />
* MessengerCTI.Desktop configured with VoIP and camera preview access - CTIuserplus license is required<br />
<br />
==NCP PBX==<br />
MessengerCTI.Desktop:<br />
* CAN be associated with any subscriber port - analogue, system or VoIP; each subscriber port is treated as 1 user from Base license, additionally while associating application with VoIP port 1 NCP.VoIPuser license is neccesary<br />
** 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<br />
** MessengerCTI.Desktop configured without VoIP and no camera preview access - NCP.CTIuser is required<br />
** MessengerCTI.Desktop configured with VoIP and camera preview access - NCP.CTIuserPlus license is required<br />
* MessengerCTI.Desktop as standalone subscriber - MCTI (not associated with subscriber port):<br />
** MessengerCTI.Desktop with VoIP funcionality and camera preview access - NCP.VoIPuser and NCP.CTIuserPlus licenses are required<br />
<br />
=One user and few different numbers=<br />
Sometimes one computer use must operate with few different extensions umber. On workstation(computer) use of "instance" is neccesary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create seperate configuration.<br />
<br />
* default location of program instalation is: C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe<br />
** 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 llok for MessengerCTI, right click -> More/ Open File Location - program icon will appear, right click -> Properties/Shortcut/Target<br />
* create program shortcut on desktop<br />
* in shortcut properties add instance - Properties/Shortcut/Target: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''<br />
* 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''', ...<br />
* while running aplication from shortcuts we can configure each one seperatly for different numbers</div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI_Manual&diff=7863MessengerCTI Manual2020-02-13T14:10:54Z<p>Marekg: /* NCP PBX */</p>
<hr />
<div>= Introduction =<br />
Slican '''MessengerCTI.Desktop''' is software which purpose is to assist users of Slican PBX. Thanks to the graphic interface displayed on the computer screen, software allows for convenient access of telephone calls and other functions related to it. Software delivers additional features that allows to expand capabilities of desk phone. Software combines capabilities of controlling desk phone connected to PBX, for example choosing number, receiving calls and also application is able to function as standalone phone. Software also allows to: accessing PBX's phonebook, call history, status of phone and other users of MessengerCTI, text communication and sending or receiving SMS messages. Additionally for new version of DPH.IP doorphone equipped with camera - video preview was added.<br />
<br />
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). Users of analogue phones will benefit from this software because they'll gain access to functions that aren't available on these types of devices.<br />
<br />
= Basic functionalities =<br />
<br />
=== Using cameras and DPH.IP doorphones ===<br />
<br />
Introduction of DPH.IP doorphones that include cameras led to solution that allows display of video from these cameras. Functionality was added with MessengerCTI.Desktop. While connecting to doorphone from software video from camera will appear in new window on computer display. After picking up and finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door,gate, using dedicated button. Reverse is also true, calling doorphone or another telephone number associated with camera, display screen will show video from camera. This allow for temporary observation of surroundings of installed camera, for example person we are calling. There is also option of watching video from any camera without making call, just using application icon. Thanks to MessengerCTI.Desktop user can preview video from camera of other manufacturers but those devices have to support video formats, codec compatible with VLC application libraries.<br />
<br />
{{Attention!|<br />
MessengerCTI.Desktop application was released mainly for displaying video from DPH.IP doorphones and and this time doesn't yet have all fuctionality of PhoneCTI application. Those options will be added gradually}}<br />
<br />
=== VoiP Client===<br />
<br />
MessengerCTI.Desktop can work as VoIP, concurrent phone connected to stationary desk phone(FXS,CTS,IP). User can decide on which device to pick up a call, phone or a computer - using it's integrated audio devices(sound card, microphone, speakers or external headphones). Since 1.11 version of NCP firmware application can be used as standalone SIP phone. For such configuration CTIuserPlus license is required.<br />
<br />
<br />
=== Phone Book ===<br />
<br />
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 possible instantly after adding it. Access to phone book allows to simply search numbers of contacts user want to call. On other hand, during incoming calls computer displaying will be showing clear information about calling person.<br />
<br />
=== Call History ===<br />
<br />
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.<br />
<br />
=== Text messages ===<br />
<br />
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.<br />
<br />
=== Usage alongside mobile version ===<br />
<br />
Application can be used alongside and synchronized to MessengerCTI.Mobile, Android version for mobile devices.<br />
<br />
<br />
= Minimum requirements =<br />
To install SLICAN MessengerCTI.Desktop application, following minimum requirements must be met:<br />
*CPU Frequency - 800 mhz or higher<br />
*Ram - 1 GB or more<br />
*GPU- compatible with DirectX 9 <br />
*Operating System - Windows 7 or more recent<br />
<br />
Application can be installed on computer which doesn't meet minimum requirements but it will run slowly or some option won't work correctly.<br />
{{Attention!|<br />
'''MessengerCTI.Desktop''' application works with IPx, Mac and CCT PBX with firmware 6.52 or newer, or NCP PBX with firmware 1.10}}<br />
<br />
= Installation of application =<br />
<br />
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 computer. After installing, application should be properly configured by entering necessary PBX information to which software should be conencted:<br />
Settings - Connection.<br />
{{Attention!|<br />
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.}}<br />
<br />
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"<br />
<br />
== Running application ==<br />
<br />
MessengerCTI.Dekstop can be run just as any other Windows compatible software. In the program settings automatic start during launch of operating system can bet set. During start of program it is logging to PBX(according to settings set in Settings - Connection tab). After successful login program data is synchronized with PBX data.<br />
<br />
== Updating application ==<br />
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 <br />
compared to version on PBX. If they differ, version from PBX is automaticly downloaded, installed and logged to PBX. Depending on version from PBX it may install newer or old version.<br />
<br />
= Available configurations =<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned off) - calling with phone, application - dialling up outgoing calls for phone(CTS, FXS, SIP) and picking up incoming calls for phone (CTS)<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned on) independent choice of picking/dialing up call with phone or application.<br />
*Autonomous application without desk phone (application VoIP mode on) - picking/dialling calls only with application.<br />
<br />
Other functionalities for example chat, sending and receiving SMS, displaying video from camera, accessing call history and phone book, configuring user status and Messenger aplication are available for each of the above configurations.<br />
<br />
Application '''MessengerCTI.Mobile''' is intended for mobile devices with Android system, its description can be found HERE(manual in progress).<br />
<br />
== '''MessengerCTI.Desktop''' with simultaneous configuration ==<br />
<br />
===Application with VoIP mode turned OFF.===<br />
<br />
Phone calls are made only using phone working alongside application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, dialling with phone speaker using CTS phone<br />
*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.<br />
<br />
For user of FXS nad SIP phones picking up earphone is necessary.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_VoIP.png |800px]]</center><br />
<br />
===Application with VoIP mode turned ON.===<br />
<br />
Phone calls can are made with phone or with computer and application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_with_phone.png |800px]]</center><br />
<br />
== '''MessengerCTI.Desktop''' working as standalone phone (only with NCP)==<br />
<br />
===Application with VoIP mode turned on.===<br />
<br />
Phone calls are made only with computer and application. Standalone applications allows:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_phone.png |800px]]</center><br />
<br />
= Program structure =<br />
==Main window==<br />
Main windows of MessengerCTI.Desktop application contains interface which show information and allows access to chat windows and main functions.<br />
<center>[[File:MessengerCTI_main_window.PNG]]</center><br />
===Upper part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_-_main_window_-_upper.png]]<br />
*left side<br />
**hyperlink to software version<br />
<br />
*right side<br />
**default window position button<br />
**close - minimizing to tray button<br />
<br />
===Middle part of window:===<br />
<br />
[[File:MessengerCTIDesktop_-_main_window_-_middle.png]]<br />
*left side:<br />
**changing application status button<br />
<br />
*middle: program name,below - user status - field that can by user to provide additional urlop, for example to inform about vacation or being busy with project<br />
<br />
*right side:<br />
**searching (magnifying glass) - button/field for searching number or contact<br />
**preferences - access to program settings<br />
<br />
===Lower part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_main_window_lower.PNG]]<br />
*access to tabs:<br />
**contacts - phonebook from bx with sorting options<br />
**recent - history of most recent calls and messages.<br />
<br />
== Status of application and user ==<br />
'''MessengerCTI.Dekstop''' software allows to show current status of user with coloured symbol and display it inside applications of other users. Applications status is informing about user availability, depending on user actions status can be changed by him or application can change it automatically. More information can be added through text status of user. User can choose different icons/symbol to set his status manually. Additionally there is graphic informing about ringing phone or current call.<br />
<br />
===List of icons and symbols===<br />
Chart presents list of icons available in '''Contacts''' and '''Recent''' tabs:<br />
<br />
* [[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.<br />
* [[File:MessengerCTI_history.png | 32px]] - for public subscribers.<br />
* [[File:MessengerCTI_close_door.png | 32px]] - for DPH.IP doorphones connected to open/closed door sensor<br />
<br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Status of application and DPH.IP doorphones<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_green.png | 32px]] ||PBX subscriber; '''MessengerCTI.Desktop''' application is running '''and and LOGGED IN'''from subscriber computer. Clicking icon will allow to send text messeger, SMS or dial a call to another application user.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_chat_tv_yellow.png | 29px]] ||PBX subscriber; '''Be right back''' set by user or application, delay time is definied in general settings of application.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_red.png | 32px]] ||PBX subscriber; '''Do not disturb''' set by user<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_grey.png | 32px]] ||PBX subscriber; '''Invisible''' set by user or application is logged off.<br />
|-<br />
|{{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)<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_history.png | 32px]] ||public subscriber; clicking icon will allow to send SMS or dial call to chosen subscriber.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_close_door.png | 32px]] ||doorphone; current door position - door closed, clicking icon will open door<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_open_door.png | 32px]] ||doorphone; door are open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_alarm_open_door.png | 32px]] ||doorphone; alarm timer for open doors was set off<br />
|-<br />
|}<br />
'''''Chart 1:''''' Meaning of icon status of application, users and doorphones.<br><br />
<br />
Chart is showing list if icon that appear on the left side of subscriber name in tab '''Contacts''' and '''Recent'''. Internal phone will have status icon being displayed<br />
<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Phone status and camera information<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_bell_red.png | 28px]] ||Phone is ringing<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_phone_red.png | 32px]] || During call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_camera.png | 25px]] ||Camera is associeted with phone or doorphone, clicking on icon will allow to preview camera video<br />
|-<br />
|}<br />
</center><br />
<center>'''''Tabela 2:''''' Icons displaying status of phone and camera</center><br />
<br />
== Preferences==<br />
<br />
Clicking '''Preferences''' icon in main program window will display window with program settings. In every tab there is available button with info "About software" and reseting default window position.<br />
<br />
=== Connection===<br />
In '''''Connection''''' field you must enter settings neccesary for application to connect:<br />
<br />
<center>[[File:MessengerCTI_connection.PNG]]</center><br />
<br />
'''Application login setting'''<br />
<br />
To login, application must have correct settings configured by PBX administrator: <br />
* subscriber numbers - extensions from PBX<br />
* CTI access and password:<br />
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/Settings CTI''' - '''CTI - access level''' and pasword'''Pss'''<br />
** for NCP - '''ConfigWEB''' chart '''Extensions/Subscribers/CTI setting''' - '''CTI Access''' and '''Password'''<br />
* Server address - PBX network settings<br />
CTI access level determines what options are available to application:<br />
* CTI.user - MessengerCTI without VoIP and camera preview<br />
* CTI.userPlus - MessengerCTI with VoIP and camera preview<br />
<br />
<br />
These connections settings must be filled:<br />
* '''Subscribers" field - extension number for which '''MessengerCTI.Dekstop''' will login.<br />
* '''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. <br />
* '''server IP address''' - IP address of PBX network interface. IP address of PBX network port. In case of logging outside od PBX network, IP address of edge router(port forwarding on router is necessary, 5529 TCP, 8100-8300 UDP for IPx, 10000-30000 UDP for NCP on PBX LAN interface).<br />
<br />
After user will change his password, administrator no longer will have access to this passowrd. Application can be set to remember user password by checking field while login in, if field wasn't checked application will always ask for password during every login.<br />
<br />
<br />
After proper 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. "Successful login" will apear in lower part of window.<br />
<br />
<br />
If login credentials, configuration settings aren't correct or there are issue with network connection those error messages may appear:<br />
* ''Wrong login or password. Check if correct login or password was used.''<br />
* ''Connecting to PBX'' alternating with<br />
* ''No connection to PBX'' Check IP address that was entered and check computer LAN connection.<br />
<br />
===General===<br />
<br />
<br />
<center>[[File:MessengerCTI_general_settings.PNG]]</center><br />
<br />
This window allows to configure settings defining how program works and startup options.<br />
Available settings:<br />
*Auto start on System startup - automatic start of application.<br />
*Start minimized - application will run hidden in system task bar.<br />
*Set "Be right back" state after - status icon will change automatically, informing about user being away from computer after defined time.<br />
*Set shortcut for application window - changes application from Windows task bar to desktop and vice versa.<br />
*Choose double click function(for contact or number):<br />
**show call window - choice windows is displayed with options - number, phone call, opening chat/SMS window, closing current window<br />
**call primary number - automatic number dialling<br />
**show last events - recent call history to particular subscriber is displayed.<br />
*Set this window position as default - allows to set up default application's window potion on screen.<br />
<br />
===Audio settings===<br />
These setting allow to set up audio notifications informing about incoming calls and messages and audio setting of computer audio devices.<br />
<br />
<br />
<center>[[File:MessengerCTI_audio_settings.PNG]]</center><br />
<br />
*Enable VoIP on when available - allows application to work as VoIP client(VoIP phone)<br />
<br />
<center>[[File:MessengerCTI_voip_settings.PNG]]</center><br />
<br />
==Dialing and picking up calls==<br />
To set up call between two users, particular hardware, software and proper configuration must be supplied:<br />
*Slican PBX<br />
*computer with installed and configured MessengerCTI.Desktop software<br />
**software logged to PBX with subscriber extension(Settings tab, Connection field)<br />
*analog, VoIP or Slican system phone<br />
*for video preview - DPH.IP doorphone with camera or phone associated with external camera(doesn't apply to VoIP phones with integrated camera)<br />
<br />
Call can be dialled using computer mouse and computer screen. Call is made between subscribers through phone connected to PBX and associated with MessengerCTI.Desktop. After choosing subscriber number to call and dialling call, PBX will call extension choosing number(to inform about being ready to set up connection), after picking up handset PBX will set up calling connection.<br />
<br />
==='''Dialing calls to particular number'''===<br />
<center>[[File:MessengerCTI_outgoing_call_window.png]]</center><br />
Making calls can be realised in few different way. Depending on how configured are general setting on application - option "Set double click function".<br />
* from '''Contacts''' tab<br />
**choose subscriber from proper group(if applicable) or from group "All contacts" by double clicking on number or contact<br />
**clicking on [[File:MessengerCTI_tv_green.png | 32px]] or [[File:MessengerCTI_history.png | 32px]]<br />
*'''Search''' field - by directly entering phone number with computer keyboard then clicking on green phone icon.<br />
*'''Recent''' tab - call history:<br />
**history of call with particular subscriber can be seen here, call is dialled by double click on number or contact<br />
**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]]<br />
<br />
==='''Incoming calls'''===<br />
<br />
<center>[[File:MessengerCTI_incoming_window.png]]</center><br />
Calls are displayed on computer screen with pop-up window, ringing application and ringing phone. Depending on applied configuration call can be picked up with application or phone.<br />
<br />
==='''Connecting to camera video preview'''===<br />
Connecting to/from DPH.IP with integrated camera or associated phone or external IP camera(doesn't apply to VoIP phone with integrated cameras)will display automatically new window on computer screen. Connecting to doorphone allows to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.<br />
<br />
<center>[[File:MessengerCTI_camera_preview.png]]</center><br />
<br />
<br />
<br />
===Transfering calls - version 1.03===<br />
Call can be transfered by choosing contact or number from: Recent or Contacts.<br />
* "blind transfer" - without checking target extensions state<br />
<center>[[File:MessengerCTI_blind_transfer.png | 700px]]</center><br />
<br />
<br />
* no announcing - check target extension state without announcing <br />
<center>[[File:MessengerCTI_no_announcing.png | 700px]]</center><br />
<br />
<br />
* with annoucing - check target extension state with announcing <br />
<center>[[File:MessengerCTI_with_announcing.png | 700px]]</center><br />
<br />
==Sending messages==<br />
Application allow sending(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.<br />
<br />
Receving new message is signalised on Windows system task bar with two icons alternating [[File:MessengerCTI_free.png | 32px]], [[File:MessengerCTI_mail.png | 32px]] and popping up [[File:MessengerCTI_new_message.png]].<br />
<br />
Messages history is available through hyper link '''Load previous'''. It is stored on computer local hard drive.<br />
<br />
<center>[[File:MessengerCTI_chat.png]]</center><br />
<br />
==Searching data==<br />
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Contacts''' tab in '''Search''':<br />
<br />
<br />
<center>[[File:MessengerCT_search_field.PNG]]</center><br />
<br />
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'''.<br />
<br />
== Contacts==<br />
This field allows for searching, displaying, customising and running actions related to contact. By default '''Favourites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.<br />
<br />
<center>[[File:MessengerCTI_contacts2.png]]</center><br />
<br />
Adding contacts is possible:<br />
<br />
* from search field - entering number and adding it with green handset icon<br />
* from '''Contacts''' or '''Recent''' tab - right clicking on connection<br />
<br />
From contact list we gain access to:<br />
*favourites<br />
*all contacts<br />
*extensions<br />
*created subscriber groups<br />
*public contacts<br />
*private contacts<br />
<br />
== Call history ==<br />
Choosing '''Recent''' tab - in main program window will display call history of currently logged extension to '''''MessengerCTI.Desktop'''''. Window will look like this.<br />
<br />
<br />
<center>[[File:MessengerCTI_recent.PNG]]</center><br />
<br />
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:<br />
<br />
[[File:MessengerCTI_outgoing_calls.PNG | 32px]]<br />
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.<br />
<br />
[[File:MessengerCTI_incoming_calls.PNG | 32px]]<br />
Downward arrow for incoming call that was picked up.<br />
<br />
[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]<br />
Turned arrow for missed incoming calls, digit is showing number of these calls.<br />
<br />
[[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]] [[File:MessengerCTI_message_amount.PNG | 32px]]<br />
Arrow with listed lines or text bubble for text chat or sent SMS. Digit is showing number of missed messages.<br />
If history contains missed calls or unread messages icon in '''Recent''' field will be in colour red.<br />
<br />
From History window call can be dialled or messages be send to chosen users by right clicking on subscribers text status<br />
, clicking on icons [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] and [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]] [[File:MessengerCTI_missed_calls.PNG | 32px]] [[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]]. If internal subscriber have other number listed in their phone book, choice can be made between them. For internal subscribers there is option of editing, deleting contact and deleting from favourite list.<br />
<br />
=MessengerCTI.Desktop for Call Center agents=<br />
Starting from NCP 1.12 firmware and MessengerCTI.Desktop 1.02 firmware, 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.<br />
<br />
<br />
Application state icons: <br />
* application logged: [[File:MessengerCTI.Desktop_log_in.png | 40px]]<br />
* application state: '''Be right back''' [[File:MessengerCTI.Desktop_brb.png | 40px]]<br />
Red dot by application state informs about unanswered call or message waiting for user.<br />
<br />
<br />
Agents state icons: <br />
* agent logged to queue: [[File:MessengerCTI.Desktop_agent_log_in.png | 40px]]<br />
* agent pause: [[File:MessengerCTI.Desktop_agent_pause.png | 40px]]<br />
* agent logged out of queue: [[File:MessengerCTI.Desktop_agent_log_out.png | 40px]]<br />
Red dot by agent state icons informs about calls unanswered by CC agents.<br />
<br />
<br />
'''CC''' tab within application, depending on configuration is showing:<br />
* up to 4 programmed buttons with present state for current agent: '''Log in/out of CC queue''' and '''Turn on/off agent pause'''<br />
* serviced queues with amount of logged agents and waiting calls<br />
* Callback list - numbers/contacts to call back<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_CC_tab_.png]]</center><br />
<br />
When using callback list, additional window will apear allowing to make call and field to confirm if call was successfull.<br />
<br />
<br />
To properly configure '''CC''' tab, '''Call Center''' sections within application preferences must be set up.<br />
<br />
<center>[[File:MessengerCTI.Desktop_configure_cc.png]]</center><br />
<br />
=Licensing=<br />
==IPX, MAC, CCT PBX==<br />
MessengerCTI.Desktop application:<br />
* 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.<br />
* 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<br />
* calls made form application in VoIP mode are using VoIP channels just like other VoIP devices<br />
* MessengerCTI.Dekstop configured without VoIP and camera preview access - CTIuser license is required<br />
* MessengerCTI.Desktop configured with VoIP and camera preview access - CTIuserplus license is required<br />
<br />
==NCP PBX==<br />
MessengerCTI.Desktop:<br />
* CAN be associated with any subscriber port - analogue, system or VoIP; each subscriber port is treated as 1 user from Base license, additionally while associating application with VoIP port 1 NCP.VoIPuser license is neccesary<br />
** for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
** MessengerCTI.Desktop configured without VoIP and no camera preview access - NCP.CTIuser is required<br />
** MessengerCTI.Desktop configured with VoIP and camera preview access - NCP.CTIuserPlus license is required<br />
* MessengerCTI.Desktop as standalone subscriber - MCTI (not associated with subscriber port):<br />
** MessengerCTI.Desktop with VoIP funcionality and camera preview access - NCP.VoIPuser and NCP.CTIuserPlus licenses are required<br />
<br />
=One user and few different numbers=<br />
Sometimes one computer use must operate with few different extensions umber. On workstation(computer) use of "instance" is neccesary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create seperate configuration.<br />
<br />
* default location of program instalation is: C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe<br />
** 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 llok for MessengerCTI, right click -> More/ Open File Location - program icon will appear, right click -> Properties/Shortcut/Target<br />
* create program shortcut on desktop<br />
* in shortcut properties add instance - Properties/Shortcut/Target: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''<br />
* 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''', ...<br />
* while running aplication from shortcuts we can configure each one seperatly for different numbers</div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI_Manual&diff=7862MessengerCTI Manual2020-02-13T14:10:32Z<p>Marekg: /* IPX, MAC, CCT PBX */</p>
<hr />
<div>= Introduction =<br />
Slican '''MessengerCTI.Desktop''' is software which purpose is to assist users of Slican PBX. Thanks to the graphic interface displayed on the computer screen, software allows for convenient access of telephone calls and other functions related to it. Software delivers additional features that allows to expand capabilities of desk phone. Software combines capabilities of controlling desk phone connected to PBX, for example choosing number, receiving calls and also application is able to function as standalone phone. Software also allows to: accessing PBX's phonebook, call history, status of phone and other users of MessengerCTI, text communication and sending or receiving SMS messages. Additionally for new version of DPH.IP doorphone equipped with camera - video preview was added.<br />
<br />
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). Users of analogue phones will benefit from this software because they'll gain access to functions that aren't available on these types of devices.<br />
<br />
= Basic functionalities =<br />
<br />
=== Using cameras and DPH.IP doorphones ===<br />
<br />
Introduction of DPH.IP doorphones that include cameras led to solution that allows display of video from these cameras. Functionality was added with MessengerCTI.Desktop. While connecting to doorphone from software video from camera will appear in new window on computer display. After picking up and finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door,gate, using dedicated button. Reverse is also true, calling doorphone or another telephone number associated with camera, display screen will show video from camera. This allow for temporary observation of surroundings of installed camera, for example person we are calling. There is also option of watching video from any camera without making call, just using application icon. Thanks to MessengerCTI.Desktop user can preview video from camera of other manufacturers but those devices have to support video formats, codec compatible with VLC application libraries.<br />
<br />
{{Attention!|<br />
MessengerCTI.Desktop application was released mainly for displaying video from DPH.IP doorphones and and this time doesn't yet have all fuctionality of PhoneCTI application. Those options will be added gradually}}<br />
<br />
=== VoiP Client===<br />
<br />
MessengerCTI.Desktop can work as VoIP, concurrent phone connected to stationary desk phone(FXS,CTS,IP). User can decide on which device to pick up a call, phone or a computer - using it's integrated audio devices(sound card, microphone, speakers or external headphones). Since 1.11 version of NCP firmware application can be used as standalone SIP phone. For such configuration CTIuserPlus license is required.<br />
<br />
<br />
=== Phone Book ===<br />
<br />
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 possible instantly after adding it. Access to phone book allows to simply search numbers of contacts user want to call. On other hand, during incoming calls computer displaying will be showing clear information about calling person.<br />
<br />
=== Call History ===<br />
<br />
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.<br />
<br />
=== Text messages ===<br />
<br />
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.<br />
<br />
=== Usage alongside mobile version ===<br />
<br />
Application can be used alongside and synchronized to MessengerCTI.Mobile, Android version for mobile devices.<br />
<br />
<br />
= Minimum requirements =<br />
To install SLICAN MessengerCTI.Desktop application, following minimum requirements must be met:<br />
*CPU Frequency - 800 mhz or higher<br />
*Ram - 1 GB or more<br />
*GPU- compatible with DirectX 9 <br />
*Operating System - Windows 7 or more recent<br />
<br />
Application can be installed on computer which doesn't meet minimum requirements but it will run slowly or some option won't work correctly.<br />
{{Attention!|<br />
'''MessengerCTI.Desktop''' application works with IPx, Mac and CCT PBX with firmware 6.52 or newer, or NCP PBX with firmware 1.10}}<br />
<br />
= Installation of application =<br />
<br />
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 computer. After installing, application should be properly configured by entering necessary PBX information to which software should be conencted:<br />
Settings - Connection.<br />
{{Attention!|<br />
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.}}<br />
<br />
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"<br />
<br />
== Running application ==<br />
<br />
MessengerCTI.Dekstop can be run just as any other Windows compatible software. In the program settings automatic start during launch of operating system can bet set. During start of program it is logging to PBX(according to settings set in Settings - Connection tab). After successful login program data is synchronized with PBX data.<br />
<br />
== Updating application ==<br />
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 <br />
compared to version on PBX. If they differ, version from PBX is automaticly downloaded, installed and logged to PBX. Depending on version from PBX it may install newer or old version.<br />
<br />
= Available configurations =<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned off) - calling with phone, application - dialling up outgoing calls for phone(CTS, FXS, SIP) and picking up incoming calls for phone (CTS)<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned on) independent choice of picking/dialing up call with phone or application.<br />
*Autonomous application without desk phone (application VoIP mode on) - picking/dialling calls only with application.<br />
<br />
Other functionalities for example chat, sending and receiving SMS, displaying video from camera, accessing call history and phone book, configuring user status and Messenger aplication are available for each of the above configurations.<br />
<br />
Application '''MessengerCTI.Mobile''' is intended for mobile devices with Android system, its description can be found HERE(manual in progress).<br />
<br />
== '''MessengerCTI.Desktop''' with simultaneous configuration ==<br />
<br />
===Application with VoIP mode turned OFF.===<br />
<br />
Phone calls are made only using phone working alongside application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, dialling with phone speaker using CTS phone<br />
*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.<br />
<br />
For user of FXS nad SIP phones picking up earphone is necessary.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_VoIP.png |800px]]</center><br />
<br />
===Application with VoIP mode turned ON.===<br />
<br />
Phone calls can are made with phone or with computer and application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_with_phone.png |800px]]</center><br />
<br />
== '''MessengerCTI.Desktop''' working as standalone phone (only with NCP)==<br />
<br />
===Application with VoIP mode turned on.===<br />
<br />
Phone calls are made only with computer and application. Standalone applications allows:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_phone.png |800px]]</center><br />
<br />
= Program structure =<br />
==Main window==<br />
Main windows of MessengerCTI.Desktop application contains interface which show information and allows access to chat windows and main functions.<br />
<center>[[File:MessengerCTI_main_window.PNG]]</center><br />
===Upper part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_-_main_window_-_upper.png]]<br />
*left side<br />
**hyperlink to software version<br />
<br />
*right side<br />
**default window position button<br />
**close - minimizing to tray button<br />
<br />
===Middle part of window:===<br />
<br />
[[File:MessengerCTIDesktop_-_main_window_-_middle.png]]<br />
*left side:<br />
**changing application status button<br />
<br />
*middle: program name,below - user status - field that can by user to provide additional urlop, for example to inform about vacation or being busy with project<br />
<br />
*right side:<br />
**searching (magnifying glass) - button/field for searching number or contact<br />
**preferences - access to program settings<br />
<br />
===Lower part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_main_window_lower.PNG]]<br />
*access to tabs:<br />
**contacts - phonebook from bx with sorting options<br />
**recent - history of most recent calls and messages.<br />
<br />
== Status of application and user ==<br />
'''MessengerCTI.Dekstop''' software allows to show current status of user with coloured symbol and display it inside applications of other users. Applications status is informing about user availability, depending on user actions status can be changed by him or application can change it automatically. More information can be added through text status of user. User can choose different icons/symbol to set his status manually. Additionally there is graphic informing about ringing phone or current call.<br />
<br />
===List of icons and symbols===<br />
Chart presents list of icons available in '''Contacts''' and '''Recent''' tabs:<br />
<br />
* [[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.<br />
* [[File:MessengerCTI_history.png | 32px]] - for public subscribers.<br />
* [[File:MessengerCTI_close_door.png | 32px]] - for DPH.IP doorphones connected to open/closed door sensor<br />
<br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Status of application and DPH.IP doorphones<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_green.png | 32px]] ||PBX subscriber; '''MessengerCTI.Desktop''' application is running '''and and LOGGED IN'''from subscriber computer. Clicking icon will allow to send text messeger, SMS or dial a call to another application user.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_chat_tv_yellow.png | 29px]] ||PBX subscriber; '''Be right back''' set by user or application, delay time is definied in general settings of application.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_red.png | 32px]] ||PBX subscriber; '''Do not disturb''' set by user<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_grey.png | 32px]] ||PBX subscriber; '''Invisible''' set by user or application is logged off.<br />
|-<br />
|{{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)<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_history.png | 32px]] ||public subscriber; clicking icon will allow to send SMS or dial call to chosen subscriber.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_close_door.png | 32px]] ||doorphone; current door position - door closed, clicking icon will open door<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_open_door.png | 32px]] ||doorphone; door are open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_alarm_open_door.png | 32px]] ||doorphone; alarm timer for open doors was set off<br />
|-<br />
|}<br />
'''''Chart 1:''''' Meaning of icon status of application, users and doorphones.<br><br />
<br />
Chart is showing list if icon that appear on the left side of subscriber name in tab '''Contacts''' and '''Recent'''. Internal phone will have status icon being displayed<br />
<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Phone status and camera information<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_bell_red.png | 28px]] ||Phone is ringing<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_phone_red.png | 32px]] || During call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_camera.png | 25px]] ||Camera is associeted with phone or doorphone, clicking on icon will allow to preview camera video<br />
|-<br />
|}<br />
</center><br />
<center>'''''Tabela 2:''''' Icons displaying status of phone and camera</center><br />
<br />
== Preferences==<br />
<br />
Clicking '''Preferences''' icon in main program window will display window with program settings. In every tab there is available button with info "About software" and reseting default window position.<br />
<br />
=== Connection===<br />
In '''''Connection''''' field you must enter settings neccesary for application to connect:<br />
<br />
<center>[[File:MessengerCTI_connection.PNG]]</center><br />
<br />
'''Application login setting'''<br />
<br />
To login, application must have correct settings configured by PBX administrator: <br />
* subscriber numbers - extensions from PBX<br />
* CTI access and password:<br />
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/Settings CTI''' - '''CTI - access level''' and pasword'''Pss'''<br />
** for NCP - '''ConfigWEB''' chart '''Extensions/Subscribers/CTI setting''' - '''CTI Access''' and '''Password'''<br />
* Server address - PBX network settings<br />
CTI access level determines what options are available to application:<br />
* CTI.user - MessengerCTI without VoIP and camera preview<br />
* CTI.userPlus - MessengerCTI with VoIP and camera preview<br />
<br />
<br />
These connections settings must be filled:<br />
* '''Subscribers" field - extension number for which '''MessengerCTI.Dekstop''' will login.<br />
* '''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. <br />
* '''server IP address''' - IP address of PBX network interface. IP address of PBX network port. In case of logging outside od PBX network, IP address of edge router(port forwarding on router is necessary, 5529 TCP, 8100-8300 UDP for IPx, 10000-30000 UDP for NCP on PBX LAN interface).<br />
<br />
After user will change his password, administrator no longer will have access to this passowrd. Application can be set to remember user password by checking field while login in, if field wasn't checked application will always ask for password during every login.<br />
<br />
<br />
After proper 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. "Successful login" will apear in lower part of window.<br />
<br />
<br />
If login credentials, configuration settings aren't correct or there are issue with network connection those error messages may appear:<br />
* ''Wrong login or password. Check if correct login or password was used.''<br />
* ''Connecting to PBX'' alternating with<br />
* ''No connection to PBX'' Check IP address that was entered and check computer LAN connection.<br />
<br />
===General===<br />
<br />
<br />
<center>[[File:MessengerCTI_general_settings.PNG]]</center><br />
<br />
This window allows to configure settings defining how program works and startup options.<br />
Available settings:<br />
*Auto start on System startup - automatic start of application.<br />
*Start minimized - application will run hidden in system task bar.<br />
*Set "Be right back" state after - status icon will change automatically, informing about user being away from computer after defined time.<br />
*Set shortcut for application window - changes application from Windows task bar to desktop and vice versa.<br />
*Choose double click function(for contact or number):<br />
**show call window - choice windows is displayed with options - number, phone call, opening chat/SMS window, closing current window<br />
**call primary number - automatic number dialling<br />
**show last events - recent call history to particular subscriber is displayed.<br />
*Set this window position as default - allows to set up default application's window potion on screen.<br />
<br />
===Audio settings===<br />
These setting allow to set up audio notifications informing about incoming calls and messages and audio setting of computer audio devices.<br />
<br />
<br />
<center>[[File:MessengerCTI_audio_settings.PNG]]</center><br />
<br />
*Enable VoIP on when available - allows application to work as VoIP client(VoIP phone)<br />
<br />
<center>[[File:MessengerCTI_voip_settings.PNG]]</center><br />
<br />
==Dialing and picking up calls==<br />
To set up call between two users, particular hardware, software and proper configuration must be supplied:<br />
*Slican PBX<br />
*computer with installed and configured MessengerCTI.Desktop software<br />
**software logged to PBX with subscriber extension(Settings tab, Connection field)<br />
*analog, VoIP or Slican system phone<br />
*for video preview - DPH.IP doorphone with camera or phone associated with external camera(doesn't apply to VoIP phones with integrated camera)<br />
<br />
Call can be dialled using computer mouse and computer screen. Call is made between subscribers through phone connected to PBX and associated with MessengerCTI.Desktop. After choosing subscriber number to call and dialling call, PBX will call extension choosing number(to inform about being ready to set up connection), after picking up handset PBX will set up calling connection.<br />
<br />
==='''Dialing calls to particular number'''===<br />
<center>[[File:MessengerCTI_outgoing_call_window.png]]</center><br />
Making calls can be realised in few different way. Depending on how configured are general setting on application - option "Set double click function".<br />
* from '''Contacts''' tab<br />
**choose subscriber from proper group(if applicable) or from group "All contacts" by double clicking on number or contact<br />
**clicking on [[File:MessengerCTI_tv_green.png | 32px]] or [[File:MessengerCTI_history.png | 32px]]<br />
*'''Search''' field - by directly entering phone number with computer keyboard then clicking on green phone icon.<br />
*'''Recent''' tab - call history:<br />
**history of call with particular subscriber can be seen here, call is dialled by double click on number or contact<br />
**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]]<br />
<br />
==='''Incoming calls'''===<br />
<br />
<center>[[File:MessengerCTI_incoming_window.png]]</center><br />
Calls are displayed on computer screen with pop-up window, ringing application and ringing phone. Depending on applied configuration call can be picked up with application or phone.<br />
<br />
==='''Connecting to camera video preview'''===<br />
Connecting to/from DPH.IP with integrated camera or associated phone or external IP camera(doesn't apply to VoIP phone with integrated cameras)will display automatically new window on computer screen. Connecting to doorphone allows to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.<br />
<br />
<center>[[File:MessengerCTI_camera_preview.png]]</center><br />
<br />
<br />
<br />
===Transfering calls - version 1.03===<br />
Call can be transfered by choosing contact or number from: Recent or Contacts.<br />
* "blind transfer" - without checking target extensions state<br />
<center>[[File:MessengerCTI_blind_transfer.png | 700px]]</center><br />
<br />
<br />
* no announcing - check target extension state without announcing <br />
<center>[[File:MessengerCTI_no_announcing.png | 700px]]</center><br />
<br />
<br />
* with annoucing - check target extension state with announcing <br />
<center>[[File:MessengerCTI_with_announcing.png | 700px]]</center><br />
<br />
==Sending messages==<br />
Application allow sending(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.<br />
<br />
Receving new message is signalised on Windows system task bar with two icons alternating [[File:MessengerCTI_free.png | 32px]], [[File:MessengerCTI_mail.png | 32px]] and popping up [[File:MessengerCTI_new_message.png]].<br />
<br />
Messages history is available through hyper link '''Load previous'''. It is stored on computer local hard drive.<br />
<br />
<center>[[File:MessengerCTI_chat.png]]</center><br />
<br />
==Searching data==<br />
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Contacts''' tab in '''Search''':<br />
<br />
<br />
<center>[[File:MessengerCT_search_field.PNG]]</center><br />
<br />
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'''.<br />
<br />
== Contacts==<br />
This field allows for searching, displaying, customising and running actions related to contact. By default '''Favourites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.<br />
<br />
<center>[[File:MessengerCTI_contacts2.png]]</center><br />
<br />
Adding contacts is possible:<br />
<br />
* from search field - entering number and adding it with green handset icon<br />
* from '''Contacts''' or '''Recent''' tab - right clicking on connection<br />
<br />
From contact list we gain access to:<br />
*favourites<br />
*all contacts<br />
*extensions<br />
*created subscriber groups<br />
*public contacts<br />
*private contacts<br />
<br />
== Call history ==<br />
Choosing '''Recent''' tab - in main program window will display call history of currently logged extension to '''''MessengerCTI.Desktop'''''. Window will look like this.<br />
<br />
<br />
<center>[[File:MessengerCTI_recent.PNG]]</center><br />
<br />
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:<br />
<br />
[[File:MessengerCTI_outgoing_calls.PNG | 32px]]<br />
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.<br />
<br />
[[File:MessengerCTI_incoming_calls.PNG | 32px]]<br />
Downward arrow for incoming call that was picked up.<br />
<br />
[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]<br />
Turned arrow for missed incoming calls, digit is showing number of these calls.<br />
<br />
[[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]] [[File:MessengerCTI_message_amount.PNG | 32px]]<br />
Arrow with listed lines or text bubble for text chat or sent SMS. Digit is showing number of missed messages.<br />
If history contains missed calls or unread messages icon in '''Recent''' field will be in colour red.<br />
<br />
From History window call can be dialled or messages be send to chosen users by right clicking on subscribers text status<br />
, clicking on icons [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] and [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]] [[File:MessengerCTI_missed_calls.PNG | 32px]] [[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]]. If internal subscriber have other number listed in their phone book, choice can be made between them. For internal subscribers there is option of editing, deleting contact and deleting from favourite list.<br />
<br />
=MessengerCTI.Desktop for Call Center agents=<br />
Starting from NCP 1.12 firmware and MessengerCTI.Desktop 1.02 firmware, 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.<br />
<br />
<br />
Application state icons: <br />
* application logged: [[File:MessengerCTI.Desktop_log_in.png | 40px]]<br />
* application state: '''Be right back''' [[File:MessengerCTI.Desktop_brb.png | 40px]]<br />
Red dot by application state informs about unanswered call or message waiting for user.<br />
<br />
<br />
Agents state icons: <br />
* agent logged to queue: [[File:MessengerCTI.Desktop_agent_log_in.png | 40px]]<br />
* agent pause: [[File:MessengerCTI.Desktop_agent_pause.png | 40px]]<br />
* agent logged out of queue: [[File:MessengerCTI.Desktop_agent_log_out.png | 40px]]<br />
Red dot by agent state icons informs about calls unanswered by CC agents.<br />
<br />
<br />
'''CC''' tab within application, depending on configuration is showing:<br />
* up to 4 programmed buttons with present state for current agent: '''Log in/out of CC queue''' and '''Turn on/off agent pause'''<br />
* serviced queues with amount of logged agents and waiting calls<br />
* Callback list - numbers/contacts to call back<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_CC_tab_.png]]</center><br />
<br />
When using callback list, additional window will apear allowing to make call and field to confirm if call was successfull.<br />
<br />
<br />
To properly configure '''CC''' tab, '''Call Center''' sections within application preferences must be set up.<br />
<br />
<center>[[File:MessengerCTI.Desktop_configure_cc.png]]</center><br />
<br />
=Licensing=<br />
==IPX, MAC, CCT PBX==<br />
MessengerCTI.Desktop application:<br />
* 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.<br />
* 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<br />
* calls made form application in VoIP mode are using VoIP channels just like other VoIP devices<br />
* MessengerCTI.Dekstop configured without VoIP and camera preview access - CTIuser license is required<br />
* MessengerCTI.Desktop configured with VoIP and camera preview access - CTIuserplus license is required<br />
<br />
==NCP PBX==<br />
MessengerCTI.Desktop:<br />
* CAN be associated with any subscriber port - analogue, system or VoIP; each subscriber port is treated as 1 user from Base license, additionally while associating application with VoIP port 1 NCP.VoIPuser license is neccesary<br />
** for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
** MessengerCTI.Desktop configured without VoIP and no camera preview access - NCP.CTIuser is required<br />
** MessengerCTI.Desktop configured with VoIP and camera preview access - NCP.CTIuserPlus license is required<br />
* MessengerCTI.Dekstop as standalone subscriber - MCTI (not associated with subscriber port):<br />
** Messenger.CTI Dekstop with VoIP funcionality and camera preview access - NCP.VoIPuser and NCP.CTIuserPlus licenses are required<br />
<br />
=One user and few different numbers=<br />
Sometimes one computer use must operate with few different extensions umber. On workstation(computer) use of "instance" is neccesary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create seperate configuration.<br />
<br />
* default location of program instalation is: C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe<br />
** 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 llok for MessengerCTI, right click -> More/ Open File Location - program icon will appear, right click -> Properties/Shortcut/Target<br />
* create program shortcut on desktop<br />
* in shortcut properties add instance - Properties/Shortcut/Target: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''<br />
* 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''', ...<br />
* while running aplication from shortcuts we can configure each one seperatly for different numbers</div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI_Manual&diff=7861MessengerCTI Manual2020-02-13T14:02:43Z<p>Marekg: /* MessengerCTI.Desktop for Call Center agents */</p>
<hr />
<div>= Introduction =<br />
Slican '''MessengerCTI.Desktop''' is software which purpose is to assist users of Slican PBX. Thanks to the graphic interface displayed on the computer screen, software allows for convenient access of telephone calls and other functions related to it. Software delivers additional features that allows to expand capabilities of desk phone. Software combines capabilities of controlling desk phone connected to PBX, for example choosing number, receiving calls and also application is able to function as standalone phone. Software also allows to: accessing PBX's phonebook, call history, status of phone and other users of MessengerCTI, text communication and sending or receiving SMS messages. Additionally for new version of DPH.IP doorphone equipped with camera - video preview was added.<br />
<br />
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). Users of analogue phones will benefit from this software because they'll gain access to functions that aren't available on these types of devices.<br />
<br />
= Basic functionalities =<br />
<br />
=== Using cameras and DPH.IP doorphones ===<br />
<br />
Introduction of DPH.IP doorphones that include cameras led to solution that allows display of video from these cameras. Functionality was added with MessengerCTI.Desktop. While connecting to doorphone from software video from camera will appear in new window on computer display. After picking up and finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door,gate, using dedicated button. Reverse is also true, calling doorphone or another telephone number associated with camera, display screen will show video from camera. This allow for temporary observation of surroundings of installed camera, for example person we are calling. There is also option of watching video from any camera without making call, just using application icon. Thanks to MessengerCTI.Desktop user can preview video from camera of other manufacturers but those devices have to support video formats, codec compatible with VLC application libraries.<br />
<br />
{{Attention!|<br />
MessengerCTI.Desktop application was released mainly for displaying video from DPH.IP doorphones and and this time doesn't yet have all fuctionality of PhoneCTI application. Those options will be added gradually}}<br />
<br />
=== VoiP Client===<br />
<br />
MessengerCTI.Desktop can work as VoIP, concurrent phone connected to stationary desk phone(FXS,CTS,IP). User can decide on which device to pick up a call, phone or a computer - using it's integrated audio devices(sound card, microphone, speakers or external headphones). Since 1.11 version of NCP firmware application can be used as standalone SIP phone. For such configuration CTIuserPlus license is required.<br />
<br />
<br />
=== Phone Book ===<br />
<br />
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 possible instantly after adding it. Access to phone book allows to simply search numbers of contacts user want to call. On other hand, during incoming calls computer displaying will be showing clear information about calling person.<br />
<br />
=== Call History ===<br />
<br />
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.<br />
<br />
=== Text messages ===<br />
<br />
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.<br />
<br />
=== Usage alongside mobile version ===<br />
<br />
Application can be used alongside and synchronized to MessengerCTI.Mobile, Android version for mobile devices.<br />
<br />
<br />
= Minimum requirements =<br />
To install SLICAN MessengerCTI.Desktop application, following minimum requirements must be met:<br />
*CPU Frequency - 800 mhz or higher<br />
*Ram - 1 GB or more<br />
*GPU- compatible with DirectX 9 <br />
*Operating System - Windows 7 or more recent<br />
<br />
Application can be installed on computer which doesn't meet minimum requirements but it will run slowly or some option won't work correctly.<br />
{{Attention!|<br />
'''MessengerCTI.Desktop''' application works with IPx, Mac and CCT PBX with firmware 6.52 or newer, or NCP PBX with firmware 1.10}}<br />
<br />
= Installation of application =<br />
<br />
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 computer. After installing, application should be properly configured by entering necessary PBX information to which software should be conencted:<br />
Settings - Connection.<br />
{{Attention!|<br />
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.}}<br />
<br />
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"<br />
<br />
== Running application ==<br />
<br />
MessengerCTI.Dekstop can be run just as any other Windows compatible software. In the program settings automatic start during launch of operating system can bet set. During start of program it is logging to PBX(according to settings set in Settings - Connection tab). After successful login program data is synchronized with PBX data.<br />
<br />
== Updating application ==<br />
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 <br />
compared to version on PBX. If they differ, version from PBX is automaticly downloaded, installed and logged to PBX. Depending on version from PBX it may install newer or old version.<br />
<br />
= Available configurations =<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned off) - calling with phone, application - dialling up outgoing calls for phone(CTS, FXS, SIP) and picking up incoming calls for phone (CTS)<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned on) independent choice of picking/dialing up call with phone or application.<br />
*Autonomous application without desk phone (application VoIP mode on) - picking/dialling calls only with application.<br />
<br />
Other functionalities for example chat, sending and receiving SMS, displaying video from camera, accessing call history and phone book, configuring user status and Messenger aplication are available for each of the above configurations.<br />
<br />
Application '''MessengerCTI.Mobile''' is intended for mobile devices with Android system, its description can be found HERE(manual in progress).<br />
<br />
== '''MessengerCTI.Desktop''' with simultaneous configuration ==<br />
<br />
===Application with VoIP mode turned OFF.===<br />
<br />
Phone calls are made only using phone working alongside application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, dialling with phone speaker using CTS phone<br />
*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.<br />
<br />
For user of FXS nad SIP phones picking up earphone is necessary.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_VoIP.png |800px]]</center><br />
<br />
===Application with VoIP mode turned ON.===<br />
<br />
Phone calls can are made with phone or with computer and application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_with_phone.png |800px]]</center><br />
<br />
== '''MessengerCTI.Desktop''' working as standalone phone (only with NCP)==<br />
<br />
===Application with VoIP mode turned on.===<br />
<br />
Phone calls are made only with computer and application. Standalone applications allows:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_phone.png |800px]]</center><br />
<br />
= Program structure =<br />
==Main window==<br />
Main windows of MessengerCTI.Desktop application contains interface which show information and allows access to chat windows and main functions.<br />
<center>[[File:MessengerCTI_main_window.PNG]]</center><br />
===Upper part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_-_main_window_-_upper.png]]<br />
*left side<br />
**hyperlink to software version<br />
<br />
*right side<br />
**default window position button<br />
**close - minimizing to tray button<br />
<br />
===Middle part of window:===<br />
<br />
[[File:MessengerCTIDesktop_-_main_window_-_middle.png]]<br />
*left side:<br />
**changing application status button<br />
<br />
*middle: program name,below - user status - field that can by user to provide additional urlop, for example to inform about vacation or being busy with project<br />
<br />
*right side:<br />
**searching (magnifying glass) - button/field for searching number or contact<br />
**preferences - access to program settings<br />
<br />
===Lower part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_main_window_lower.PNG]]<br />
*access to tabs:<br />
**contacts - phonebook from bx with sorting options<br />
**recent - history of most recent calls and messages.<br />
<br />
== Status of application and user ==<br />
'''MessengerCTI.Dekstop''' software allows to show current status of user with coloured symbol and display it inside applications of other users. Applications status is informing about user availability, depending on user actions status can be changed by him or application can change it automatically. More information can be added through text status of user. User can choose different icons/symbol to set his status manually. Additionally there is graphic informing about ringing phone or current call.<br />
<br />
===List of icons and symbols===<br />
Chart presents list of icons available in '''Contacts''' and '''Recent''' tabs:<br />
<br />
* [[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.<br />
* [[File:MessengerCTI_history.png | 32px]] - for public subscribers.<br />
* [[File:MessengerCTI_close_door.png | 32px]] - for DPH.IP doorphones connected to open/closed door sensor<br />
<br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Status of application and DPH.IP doorphones<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_green.png | 32px]] ||PBX subscriber; '''MessengerCTI.Desktop''' application is running '''and and LOGGED IN'''from subscriber computer. Clicking icon will allow to send text messeger, SMS or dial a call to another application user.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_chat_tv_yellow.png | 29px]] ||PBX subscriber; '''Be right back''' set by user or application, delay time is definied in general settings of application.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_red.png | 32px]] ||PBX subscriber; '''Do not disturb''' set by user<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_grey.png | 32px]] ||PBX subscriber; '''Invisible''' set by user or application is logged off.<br />
|-<br />
|{{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)<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_history.png | 32px]] ||public subscriber; clicking icon will allow to send SMS or dial call to chosen subscriber.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_close_door.png | 32px]] ||doorphone; current door position - door closed, clicking icon will open door<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_open_door.png | 32px]] ||doorphone; door are open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_alarm_open_door.png | 32px]] ||doorphone; alarm timer for open doors was set off<br />
|-<br />
|}<br />
'''''Chart 1:''''' Meaning of icon status of application, users and doorphones.<br><br />
<br />
Chart is showing list if icon that appear on the left side of subscriber name in tab '''Contacts''' and '''Recent'''. Internal phone will have status icon being displayed<br />
<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Phone status and camera information<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_bell_red.png | 28px]] ||Phone is ringing<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_phone_red.png | 32px]] || During call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_camera.png | 25px]] ||Camera is associeted with phone or doorphone, clicking on icon will allow to preview camera video<br />
|-<br />
|}<br />
</center><br />
<center>'''''Tabela 2:''''' Icons displaying status of phone and camera</center><br />
<br />
== Preferences==<br />
<br />
Clicking '''Preferences''' icon in main program window will display window with program settings. In every tab there is available button with info "About software" and reseting default window position.<br />
<br />
=== Connection===<br />
In '''''Connection''''' field you must enter settings neccesary for application to connect:<br />
<br />
<center>[[File:MessengerCTI_connection.PNG]]</center><br />
<br />
'''Application login setting'''<br />
<br />
To login, application must have correct settings configured by PBX administrator: <br />
* subscriber numbers - extensions from PBX<br />
* CTI access and password:<br />
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/Settings CTI''' - '''CTI - access level''' and pasword'''Pss'''<br />
** for NCP - '''ConfigWEB''' chart '''Extensions/Subscribers/CTI setting''' - '''CTI Access''' and '''Password'''<br />
* Server address - PBX network settings<br />
CTI access level determines what options are available to application:<br />
* CTI.user - MessengerCTI without VoIP and camera preview<br />
* CTI.userPlus - MessengerCTI with VoIP and camera preview<br />
<br />
<br />
These connections settings must be filled:<br />
* '''Subscribers" field - extension number for which '''MessengerCTI.Dekstop''' will login.<br />
* '''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. <br />
* '''server IP address''' - IP address of PBX network interface. IP address of PBX network port. In case of logging outside od PBX network, IP address of edge router(port forwarding on router is necessary, 5529 TCP, 8100-8300 UDP for IPx, 10000-30000 UDP for NCP on PBX LAN interface).<br />
<br />
After user will change his password, administrator no longer will have access to this passowrd. Application can be set to remember user password by checking field while login in, if field wasn't checked application will always ask for password during every login.<br />
<br />
<br />
After proper 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. "Successful login" will apear in lower part of window.<br />
<br />
<br />
If login credentials, configuration settings aren't correct or there are issue with network connection those error messages may appear:<br />
* ''Wrong login or password. Check if correct login or password was used.''<br />
* ''Connecting to PBX'' alternating with<br />
* ''No connection to PBX'' Check IP address that was entered and check computer LAN connection.<br />
<br />
===General===<br />
<br />
<br />
<center>[[File:MessengerCTI_general_settings.PNG]]</center><br />
<br />
This window allows to configure settings defining how program works and startup options.<br />
Available settings:<br />
*Auto start on System startup - automatic start of application.<br />
*Start minimized - application will run hidden in system task bar.<br />
*Set "Be right back" state after - status icon will change automatically, informing about user being away from computer after defined time.<br />
*Set shortcut for application window - changes application from Windows task bar to desktop and vice versa.<br />
*Choose double click function(for contact or number):<br />
**show call window - choice windows is displayed with options - number, phone call, opening chat/SMS window, closing current window<br />
**call primary number - automatic number dialling<br />
**show last events - recent call history to particular subscriber is displayed.<br />
*Set this window position as default - allows to set up default application's window potion on screen.<br />
<br />
===Audio settings===<br />
These setting allow to set up audio notifications informing about incoming calls and messages and audio setting of computer audio devices.<br />
<br />
<br />
<center>[[File:MessengerCTI_audio_settings.PNG]]</center><br />
<br />
*Enable VoIP on when available - allows application to work as VoIP client(VoIP phone)<br />
<br />
<center>[[File:MessengerCTI_voip_settings.PNG]]</center><br />
<br />
==Dialing and picking up calls==<br />
To set up call between two users, particular hardware, software and proper configuration must be supplied:<br />
*Slican PBX<br />
*computer with installed and configured MessengerCTI.Desktop software<br />
**software logged to PBX with subscriber extension(Settings tab, Connection field)<br />
*analog, VoIP or Slican system phone<br />
*for video preview - DPH.IP doorphone with camera or phone associated with external camera(doesn't apply to VoIP phones with integrated camera)<br />
<br />
Call can be dialled using computer mouse and computer screen. Call is made between subscribers through phone connected to PBX and associated with MessengerCTI.Desktop. After choosing subscriber number to call and dialling call, PBX will call extension choosing number(to inform about being ready to set up connection), after picking up handset PBX will set up calling connection.<br />
<br />
==='''Dialing calls to particular number'''===<br />
<center>[[File:MessengerCTI_outgoing_call_window.png]]</center><br />
Making calls can be realised in few different way. Depending on how configured are general setting on application - option "Set double click function".<br />
* from '''Contacts''' tab<br />
**choose subscriber from proper group(if applicable) or from group "All contacts" by double clicking on number or contact<br />
**clicking on [[File:MessengerCTI_tv_green.png | 32px]] or [[File:MessengerCTI_history.png | 32px]]<br />
*'''Search''' field - by directly entering phone number with computer keyboard then clicking on green phone icon.<br />
*'''Recent''' tab - call history:<br />
**history of call with particular subscriber can be seen here, call is dialled by double click on number or contact<br />
**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]]<br />
<br />
==='''Incoming calls'''===<br />
<br />
<center>[[File:MessengerCTI_incoming_window.png]]</center><br />
Calls are displayed on computer screen with pop-up window, ringing application and ringing phone. Depending on applied configuration call can be picked up with application or phone.<br />
<br />
==='''Connecting to camera video preview'''===<br />
Connecting to/from DPH.IP with integrated camera or associated phone or external IP camera(doesn't apply to VoIP phone with integrated cameras)will display automatically new window on computer screen. Connecting to doorphone allows to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.<br />
<br />
<center>[[File:MessengerCTI_camera_preview.png]]</center><br />
<br />
<br />
<br />
===Transfering calls - version 1.03===<br />
Call can be transfered by choosing contact or number from: Recent or Contacts.<br />
* "blind transfer" - without checking target extensions state<br />
<center>[[File:MessengerCTI_blind_transfer.png | 700px]]</center><br />
<br />
<br />
* no announcing - check target extension state without announcing <br />
<center>[[File:MessengerCTI_no_announcing.png | 700px]]</center><br />
<br />
<br />
* with annoucing - check target extension state with announcing <br />
<center>[[File:MessengerCTI_with_announcing.png | 700px]]</center><br />
<br />
==Sending messages==<br />
Application allow sending(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.<br />
<br />
Receving new message is signalised on Windows system task bar with two icons alternating [[File:MessengerCTI_free.png | 32px]], [[File:MessengerCTI_mail.png | 32px]] and popping up [[File:MessengerCTI_new_message.png]].<br />
<br />
Messages history is available through hyper link '''Load previous'''. It is stored on computer local hard drive.<br />
<br />
<center>[[File:MessengerCTI_chat.png]]</center><br />
<br />
==Searching data==<br />
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Contacts''' tab in '''Search''':<br />
<br />
<br />
<center>[[File:MessengerCT_search_field.PNG]]</center><br />
<br />
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'''.<br />
<br />
== Contacts==<br />
This field allows for searching, displaying, customising and running actions related to contact. By default '''Favourites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.<br />
<br />
<center>[[File:MessengerCTI_contacts2.png]]</center><br />
<br />
Adding contacts is possible:<br />
<br />
* from search field - entering number and adding it with green handset icon<br />
* from '''Contacts''' or '''Recent''' tab - right clicking on connection<br />
<br />
From contact list we gain access to:<br />
*favourites<br />
*all contacts<br />
*extensions<br />
*created subscriber groups<br />
*public contacts<br />
*private contacts<br />
<br />
== Call history ==<br />
Choosing '''Recent''' tab - in main program window will display call history of currently logged extension to '''''MessengerCTI.Desktop'''''. Window will look like this.<br />
<br />
<br />
<center>[[File:MessengerCTI_recent.PNG]]</center><br />
<br />
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:<br />
<br />
[[File:MessengerCTI_outgoing_calls.PNG | 32px]]<br />
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.<br />
<br />
[[File:MessengerCTI_incoming_calls.PNG | 32px]]<br />
Downward arrow for incoming call that was picked up.<br />
<br />
[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]<br />
Turned arrow for missed incoming calls, digit is showing number of these calls.<br />
<br />
[[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]] [[File:MessengerCTI_message_amount.PNG | 32px]]<br />
Arrow with listed lines or text bubble for text chat or sent SMS. Digit is showing number of missed messages.<br />
If history contains missed calls or unread messages icon in '''Recent''' field will be in colour red.<br />
<br />
From History window call can be dialled or messages be send to chosen users by right clicking on subscribers text status<br />
, clicking on icons [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] and [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]] [[File:MessengerCTI_missed_calls.PNG | 32px]] [[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]]. If internal subscriber have other number listed in their phone book, choice can be made between them. For internal subscribers there is option of editing, deleting contact and deleting from favourite list.<br />
<br />
=MessengerCTI.Desktop for Call Center agents=<br />
Starting from NCP 1.12 firmware and MessengerCTI.Desktop 1.02 firmware, 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.<br />
<br />
<br />
Application state icons: <br />
* application logged: [[File:MessengerCTI.Desktop_log_in.png | 40px]]<br />
* application state: '''Be right back''' [[File:MessengerCTI.Desktop_brb.png | 40px]]<br />
Red dot by application state informs about unanswered call or message waiting for user.<br />
<br />
<br />
Agents state icons: <br />
* agent logged to queue: [[File:MessengerCTI.Desktop_agent_log_in.png | 40px]]<br />
* agent pause: [[File:MessengerCTI.Desktop_agent_pause.png | 40px]]<br />
* agent logged out of queue: [[File:MessengerCTI.Desktop_agent_log_out.png | 40px]]<br />
Red dot by agent state icons informs about calls unanswered by CC agents.<br />
<br />
<br />
'''CC''' tab within application, depending on configuration is showing:<br />
* up to 4 programmed buttons with present state for current agent: '''Log in/out of CC queue''' and '''Turn on/off agent pause'''<br />
* serviced queues with amount of logged agents and waiting calls<br />
* Callback list - numbers/contacts to call back<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_CC_tab_.png]]</center><br />
<br />
When using callback list, additional window will apear allowing to make call and field to confirm if call was successfull.<br />
<br />
<br />
To properly configure '''CC''' tab, '''Call Center''' sections within application preferences must be set up.<br />
<br />
<center>[[File:MessengerCTI.Desktop_configure_cc.png]]</center><br />
<br />
=Licensing=<br />
==IPX, MAC, CCT PBX==<br />
MessengerCTI.Desktop application:<br />
* 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.<br />
* for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
* calls made form application in VoIP mode are using VoIP channels just like other VoIP devices<br />
* MessengerCTI.Dekstop configured without VoIP and camera preview access - CTIuser license is required<br />
* MessengerCTI.Desktop configured with VoIP and camera preview access - CTIuserplus license is required<br />
<br />
==NCP PBX==<br />
MessengerCTI.Desktop:<br />
* CAN be associated with any subscriber port - analogue, system or VoIP; each subscriber port is treated as 1 user from Base license, additionally while associating application with VoIP port 1 NCP.VoIPuser license is neccesary<br />
** for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
** MessengerCTI.Desktop configured without VoIP and no camera preview access - NCP.CTIuser is required<br />
** MessengerCTI.Desktop configured with VoIP and camera preview access - NCP.CTIuserPlus license is required<br />
* MessengerCTI.Dekstop as standalone subscriber - MCTI (not associated with subscriber port):<br />
** Messenger.CTI Dekstop with VoIP funcionality and camera preview access - NCP.VoIPuser and NCP.CTIuserPlus licenses are required<br />
<br />
=One user and few different numbers=<br />
Sometimes one computer use must operate with few different extensions umber. On workstation(computer) use of "instance" is neccesary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create seperate configuration.<br />
<br />
* default location of program instalation is: C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe<br />
** 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 llok for MessengerCTI, right click -> More/ Open File Location - program icon will appear, right click -> Properties/Shortcut/Target<br />
* create program shortcut on desktop<br />
* in shortcut properties add instance - Properties/Shortcut/Target: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''<br />
* 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''', ...<br />
* while running aplication from shortcuts we can configure each one seperatly for different numbers</div>Marekghttp://pubwiki.slican.com/index.php?title=File:MessengerCTI.Desktop_configure_cc.png&diff=7860File:MessengerCTI.Desktop configure cc.png2020-02-13T14:02:18Z<p>Marekg: </p>
<hr />
<div></div>Marekghttp://pubwiki.slican.com/index.php?title=File:MessengerCTI.Desktop_CC_tab_.png&diff=7859File:MessengerCTI.Desktop CC tab .png2020-02-13T14:01:55Z<p>Marekg: </p>
<hr />
<div></div>Marekghttp://pubwiki.slican.com/index.php?title=File:MessengerCTI.Desktop_agent_log_out.png&diff=7858File:MessengerCTI.Desktop agent log out.png2020-02-13T13:58:54Z<p>Marekg: </p>
<hr />
<div></div>Marekghttp://pubwiki.slican.com/index.php?title=File:MessengerCTI.Desktop_agent_pause.png&diff=7857File:MessengerCTI.Desktop agent pause.png2020-02-13T13:58:44Z<p>Marekg: </p>
<hr />
<div></div>Marekghttp://pubwiki.slican.com/index.php?title=File:MessengerCTI.Desktop_agent_log_in.png&diff=7856File:MessengerCTI.Desktop agent log in.png2020-02-13T13:55:22Z<p>Marekg: </p>
<hr />
<div></div>Marekghttp://pubwiki.slican.com/index.php?title=File:MessengerCTI.Desktop_brb.png&diff=7855File:MessengerCTI.Desktop brb.png2020-02-13T13:51:44Z<p>Marekg: </p>
<hr />
<div></div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI_Manual&diff=7854MessengerCTI Manual2020-02-13T13:32:38Z<p>Marekg: /* MessengerCTI.Desktop for Call Center agents */</p>
<hr />
<div>= Introduction =<br />
Slican '''MessengerCTI.Desktop''' is software which purpose is to assist users of Slican PBX. Thanks to the graphic interface displayed on the computer screen, software allows for convenient access of telephone calls and other functions related to it. Software delivers additional features that allows to expand capabilities of desk phone. Software combines capabilities of controlling desk phone connected to PBX, for example choosing number, receiving calls and also application is able to function as standalone phone. Software also allows to: accessing PBX's phonebook, call history, status of phone and other users of MessengerCTI, text communication and sending or receiving SMS messages. Additionally for new version of DPH.IP doorphone equipped with camera - video preview was added.<br />
<br />
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). Users of analogue phones will benefit from this software because they'll gain access to functions that aren't available on these types of devices.<br />
<br />
= Basic functionalities =<br />
<br />
=== Using cameras and DPH.IP doorphones ===<br />
<br />
Introduction of DPH.IP doorphones that include cameras led to solution that allows display of video from these cameras. Functionality was added with MessengerCTI.Desktop. While connecting to doorphone from software video from camera will appear in new window on computer display. After picking up and finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door,gate, using dedicated button. Reverse is also true, calling doorphone or another telephone number associated with camera, display screen will show video from camera. This allow for temporary observation of surroundings of installed camera, for example person we are calling. There is also option of watching video from any camera without making call, just using application icon. Thanks to MessengerCTI.Desktop user can preview video from camera of other manufacturers but those devices have to support video formats, codec compatible with VLC application libraries.<br />
<br />
{{Attention!|<br />
MessengerCTI.Desktop application was released mainly for displaying video from DPH.IP doorphones and and this time doesn't yet have all fuctionality of PhoneCTI application. Those options will be added gradually}}<br />
<br />
=== VoiP Client===<br />
<br />
MessengerCTI.Desktop can work as VoIP, concurrent phone connected to stationary desk phone(FXS,CTS,IP). User can decide on which device to pick up a call, phone or a computer - using it's integrated audio devices(sound card, microphone, speakers or external headphones). Since 1.11 version of NCP firmware application can be used as standalone SIP phone. For such configuration CTIuserPlus license is required.<br />
<br />
<br />
=== Phone Book ===<br />
<br />
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 possible instantly after adding it. Access to phone book allows to simply search numbers of contacts user want to call. On other hand, during incoming calls computer displaying will be showing clear information about calling person.<br />
<br />
=== Call History ===<br />
<br />
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.<br />
<br />
=== Text messages ===<br />
<br />
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.<br />
<br />
=== Usage alongside mobile version ===<br />
<br />
Application can be used alongside and synchronized to MessengerCTI.Mobile, Android version for mobile devices.<br />
<br />
<br />
= Minimum requirements =<br />
To install SLICAN MessengerCTI.Desktop application, following minimum requirements must be met:<br />
*CPU Frequency - 800 mhz or higher<br />
*Ram - 1 GB or more<br />
*GPU- compatible with DirectX 9 <br />
*Operating System - Windows 7 or more recent<br />
<br />
Application can be installed on computer which doesn't meet minimum requirements but it will run slowly or some option won't work correctly.<br />
{{Attention!|<br />
'''MessengerCTI.Desktop''' application works with IPx, Mac and CCT PBX with firmware 6.52 or newer, or NCP PBX with firmware 1.10}}<br />
<br />
= Installation of application =<br />
<br />
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 computer. After installing, application should be properly configured by entering necessary PBX information to which software should be conencted:<br />
Settings - Connection.<br />
{{Attention!|<br />
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.}}<br />
<br />
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"<br />
<br />
== Running application ==<br />
<br />
MessengerCTI.Dekstop can be run just as any other Windows compatible software. In the program settings automatic start during launch of operating system can bet set. During start of program it is logging to PBX(according to settings set in Settings - Connection tab). After successful login program data is synchronized with PBX data.<br />
<br />
== Updating application ==<br />
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 <br />
compared to version on PBX. If they differ, version from PBX is automaticly downloaded, installed and logged to PBX. Depending on version from PBX it may install newer or old version.<br />
<br />
= Available configurations =<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned off) - calling with phone, application - dialling up outgoing calls for phone(CTS, FXS, SIP) and picking up incoming calls for phone (CTS)<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned on) independent choice of picking/dialing up call with phone or application.<br />
*Autonomous application without desk phone (application VoIP mode on) - picking/dialling calls only with application.<br />
<br />
Other functionalities for example chat, sending and receiving SMS, displaying video from camera, accessing call history and phone book, configuring user status and Messenger aplication are available for each of the above configurations.<br />
<br />
Application '''MessengerCTI.Mobile''' is intended for mobile devices with Android system, its description can be found HERE(manual in progress).<br />
<br />
== '''MessengerCTI.Desktop''' with simultaneous configuration ==<br />
<br />
===Application with VoIP mode turned OFF.===<br />
<br />
Phone calls are made only using phone working alongside application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, dialling with phone speaker using CTS phone<br />
*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.<br />
<br />
For user of FXS nad SIP phones picking up earphone is necessary.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_VoIP.png |800px]]</center><br />
<br />
===Application with VoIP mode turned ON.===<br />
<br />
Phone calls can are made with phone or with computer and application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_with_phone.png |800px]]</center><br />
<br />
== '''MessengerCTI.Desktop''' working as standalone phone (only with NCP)==<br />
<br />
===Application with VoIP mode turned on.===<br />
<br />
Phone calls are made only with computer and application. Standalone applications allows:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_phone.png |800px]]</center><br />
<br />
= Program structure =<br />
==Main window==<br />
Main windows of MessengerCTI.Desktop application contains interface which show information and allows access to chat windows and main functions.<br />
<center>[[File:MessengerCTI_main_window.PNG]]</center><br />
===Upper part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_-_main_window_-_upper.png]]<br />
*left side<br />
**hyperlink to software version<br />
<br />
*right side<br />
**default window position button<br />
**close - minimizing to tray button<br />
<br />
===Middle part of window:===<br />
<br />
[[File:MessengerCTIDesktop_-_main_window_-_middle.png]]<br />
*left side:<br />
**changing application status button<br />
<br />
*middle: program name,below - user status - field that can by user to provide additional urlop, for example to inform about vacation or being busy with project<br />
<br />
*right side:<br />
**searching (magnifying glass) - button/field for searching number or contact<br />
**preferences - access to program settings<br />
<br />
===Lower part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_main_window_lower.PNG]]<br />
*access to tabs:<br />
**contacts - phonebook from bx with sorting options<br />
**recent - history of most recent calls and messages.<br />
<br />
== Status of application and user ==<br />
'''MessengerCTI.Dekstop''' software allows to show current status of user with coloured symbol and display it inside applications of other users. Applications status is informing about user availability, depending on user actions status can be changed by him or application can change it automatically. More information can be added through text status of user. User can choose different icons/symbol to set his status manually. Additionally there is graphic informing about ringing phone or current call.<br />
<br />
===List of icons and symbols===<br />
Chart presents list of icons available in '''Contacts''' and '''Recent''' tabs:<br />
<br />
* [[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.<br />
* [[File:MessengerCTI_history.png | 32px]] - for public subscribers.<br />
* [[File:MessengerCTI_close_door.png | 32px]] - for DPH.IP doorphones connected to open/closed door sensor<br />
<br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Status of application and DPH.IP doorphones<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_green.png | 32px]] ||PBX subscriber; '''MessengerCTI.Desktop''' application is running '''and and LOGGED IN'''from subscriber computer. Clicking icon will allow to send text messeger, SMS or dial a call to another application user.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_chat_tv_yellow.png | 29px]] ||PBX subscriber; '''Be right back''' set by user or application, delay time is definied in general settings of application.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_red.png | 32px]] ||PBX subscriber; '''Do not disturb''' set by user<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_grey.png | 32px]] ||PBX subscriber; '''Invisible''' set by user or application is logged off.<br />
|-<br />
|{{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)<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_history.png | 32px]] ||public subscriber; clicking icon will allow to send SMS or dial call to chosen subscriber.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_close_door.png | 32px]] ||doorphone; current door position - door closed, clicking icon will open door<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_open_door.png | 32px]] ||doorphone; door are open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_alarm_open_door.png | 32px]] ||doorphone; alarm timer for open doors was set off<br />
|-<br />
|}<br />
'''''Chart 1:''''' Meaning of icon status of application, users and doorphones.<br><br />
<br />
Chart is showing list if icon that appear on the left side of subscriber name in tab '''Contacts''' and '''Recent'''. Internal phone will have status icon being displayed<br />
<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Phone status and camera information<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_bell_red.png | 28px]] ||Phone is ringing<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_phone_red.png | 32px]] || During call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_camera.png | 25px]] ||Camera is associeted with phone or doorphone, clicking on icon will allow to preview camera video<br />
|-<br />
|}<br />
</center><br />
<center>'''''Tabela 2:''''' Icons displaying status of phone and camera</center><br />
<br />
== Preferences==<br />
<br />
Clicking '''Preferences''' icon in main program window will display window with program settings. In every tab there is available button with info "About software" and reseting default window position.<br />
<br />
=== Connection===<br />
In '''''Connection''''' field you must enter settings neccesary for application to connect:<br />
<br />
<center>[[File:MessengerCTI_connection.PNG]]</center><br />
<br />
'''Application login setting'''<br />
<br />
To login, application must have correct settings configured by PBX administrator: <br />
* subscriber numbers - extensions from PBX<br />
* CTI access and password:<br />
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/Settings CTI''' - '''CTI - access level''' and pasword'''Pss'''<br />
** for NCP - '''ConfigWEB''' chart '''Extensions/Subscribers/CTI setting''' - '''CTI Access''' and '''Password'''<br />
* Server address - PBX network settings<br />
CTI access level determines what options are available to application:<br />
* CTI.user - MessengerCTI without VoIP and camera preview<br />
* CTI.userPlus - MessengerCTI with VoIP and camera preview<br />
<br />
<br />
These connections settings must be filled:<br />
* '''Subscribers" field - extension number for which '''MessengerCTI.Dekstop''' will login.<br />
* '''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. <br />
* '''server IP address''' - IP address of PBX network interface. IP address of PBX network port. In case of logging outside od PBX network, IP address of edge router(port forwarding on router is necessary, 5529 TCP, 8100-8300 UDP for IPx, 10000-30000 UDP for NCP on PBX LAN interface).<br />
<br />
After user will change his password, administrator no longer will have access to this passowrd. Application can be set to remember user password by checking field while login in, if field wasn't checked application will always ask for password during every login.<br />
<br />
<br />
After proper 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. "Successful login" will apear in lower part of window.<br />
<br />
<br />
If login credentials, configuration settings aren't correct or there are issue with network connection those error messages may appear:<br />
* ''Wrong login or password. Check if correct login or password was used.''<br />
* ''Connecting to PBX'' alternating with<br />
* ''No connection to PBX'' Check IP address that was entered and check computer LAN connection.<br />
<br />
===General===<br />
<br />
<br />
<center>[[File:MessengerCTI_general_settings.PNG]]</center><br />
<br />
This window allows to configure settings defining how program works and startup options.<br />
Available settings:<br />
*Auto start on System startup - automatic start of application.<br />
*Start minimized - application will run hidden in system task bar.<br />
*Set "Be right back" state after - status icon will change automatically, informing about user being away from computer after defined time.<br />
*Set shortcut for application window - changes application from Windows task bar to desktop and vice versa.<br />
*Choose double click function(for contact or number):<br />
**show call window - choice windows is displayed with options - number, phone call, opening chat/SMS window, closing current window<br />
**call primary number - automatic number dialling<br />
**show last events - recent call history to particular subscriber is displayed.<br />
*Set this window position as default - allows to set up default application's window potion on screen.<br />
<br />
===Audio settings===<br />
These setting allow to set up audio notifications informing about incoming calls and messages and audio setting of computer audio devices.<br />
<br />
<br />
<center>[[File:MessengerCTI_audio_settings.PNG]]</center><br />
<br />
*Enable VoIP on when available - allows application to work as VoIP client(VoIP phone)<br />
<br />
<center>[[File:MessengerCTI_voip_settings.PNG]]</center><br />
<br />
==Dialing and picking up calls==<br />
To set up call between two users, particular hardware, software and proper configuration must be supplied:<br />
*Slican PBX<br />
*computer with installed and configured MessengerCTI.Desktop software<br />
**software logged to PBX with subscriber extension(Settings tab, Connection field)<br />
*analog, VoIP or Slican system phone<br />
*for video preview - DPH.IP doorphone with camera or phone associated with external camera(doesn't apply to VoIP phones with integrated camera)<br />
<br />
Call can be dialled using computer mouse and computer screen. Call is made between subscribers through phone connected to PBX and associated with MessengerCTI.Desktop. After choosing subscriber number to call and dialling call, PBX will call extension choosing number(to inform about being ready to set up connection), after picking up handset PBX will set up calling connection.<br />
<br />
==='''Dialing calls to particular number'''===<br />
<center>[[File:MessengerCTI_outgoing_call_window.png]]</center><br />
Making calls can be realised in few different way. Depending on how configured are general setting on application - option "Set double click function".<br />
* from '''Contacts''' tab<br />
**choose subscriber from proper group(if applicable) or from group "All contacts" by double clicking on number or contact<br />
**clicking on [[File:MessengerCTI_tv_green.png | 32px]] or [[File:MessengerCTI_history.png | 32px]]<br />
*'''Search''' field - by directly entering phone number with computer keyboard then clicking on green phone icon.<br />
*'''Recent''' tab - call history:<br />
**history of call with particular subscriber can be seen here, call is dialled by double click on number or contact<br />
**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]]<br />
<br />
==='''Incoming calls'''===<br />
<br />
<center>[[File:MessengerCTI_incoming_window.png]]</center><br />
Calls are displayed on computer screen with pop-up window, ringing application and ringing phone. Depending on applied configuration call can be picked up with application or phone.<br />
<br />
==='''Connecting to camera video preview'''===<br />
Connecting to/from DPH.IP with integrated camera or associated phone or external IP camera(doesn't apply to VoIP phone with integrated cameras)will display automatically new window on computer screen. Connecting to doorphone allows to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.<br />
<br />
<center>[[File:MessengerCTI_camera_preview.png]]</center><br />
<br />
<br />
<br />
===Transfering calls - version 1.03===<br />
Call can be transfered by choosing contact or number from: Recent or Contacts.<br />
* "blind transfer" - without checking target extensions state<br />
<center>[[File:MessengerCTI_blind_transfer.png | 700px]]</center><br />
<br />
<br />
* no announcing - check target extension state without announcing <br />
<center>[[File:MessengerCTI_no_announcing.png | 700px]]</center><br />
<br />
<br />
* with annoucing - check target extension state with announcing <br />
<center>[[File:MessengerCTI_with_announcing.png | 700px]]</center><br />
<br />
==Sending messages==<br />
Application allow sending(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.<br />
<br />
Receving new message is signalised on Windows system task bar with two icons alternating [[File:MessengerCTI_free.png | 32px]], [[File:MessengerCTI_mail.png | 32px]] and popping up [[File:MessengerCTI_new_message.png]].<br />
<br />
Messages history is available through hyper link '''Load previous'''. It is stored on computer local hard drive.<br />
<br />
<center>[[File:MessengerCTI_chat.png]]</center><br />
<br />
==Searching data==<br />
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Contacts''' tab in '''Search''':<br />
<br />
<br />
<center>[[File:MessengerCT_search_field.PNG]]</center><br />
<br />
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'''.<br />
<br />
== Contacts==<br />
This field allows for searching, displaying, customising and running actions related to contact. By default '''Favourites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.<br />
<br />
<center>[[File:MessengerCTI_contacts2.png]]</center><br />
<br />
Adding contacts is possible:<br />
<br />
* from search field - entering number and adding it with green handset icon<br />
* from '''Contacts''' or '''Recent''' tab - right clicking on connection<br />
<br />
From contact list we gain access to:<br />
*favourites<br />
*all contacts<br />
*extensions<br />
*created subscriber groups<br />
*public contacts<br />
*private contacts<br />
<br />
== Call history ==<br />
Choosing '''Recent''' tab - in main program window will display call history of currently logged extension to '''''MessengerCTI.Desktop'''''. Window will look like this.<br />
<br />
<br />
<center>[[File:MessengerCTI_recent.PNG]]</center><br />
<br />
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:<br />
<br />
[[File:MessengerCTI_outgoing_calls.PNG | 32px]]<br />
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.<br />
<br />
[[File:MessengerCTI_incoming_calls.PNG | 32px]]<br />
Downward arrow for incoming call that was picked up.<br />
<br />
[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]<br />
Turned arrow for missed incoming calls, digit is showing number of these calls.<br />
<br />
[[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]] [[File:MessengerCTI_message_amount.PNG | 32px]]<br />
Arrow with listed lines or text bubble for text chat or sent SMS. Digit is showing number of missed messages.<br />
If history contains missed calls or unread messages icon in '''Recent''' field will be in colour red.<br />
<br />
From History window call can be dialled or messages be send to chosen users by right clicking on subscribers text status<br />
, clicking on icons [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] and [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]] [[File:MessengerCTI_missed_calls.PNG | 32px]] [[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]]. If internal subscriber have other number listed in their phone book, choice can be made between them. For internal subscribers there is option of editing, deleting contact and deleting from favourite list.<br />
<br />
=MessengerCTI.Desktop for Call Center agents=<br />
Starting from NCP 1.12 firmware and MessengerCTI.Desktop 1.02 firmware, 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.<br />
<br />
<br />
Application state icons: <br />
* application logged: [[File:MessengerCTI.Desktop_log_in.png | 40px]]<br />
* application state: '''Be right back''' [[File:MessengerCTI.Desktop_brb.png | 40px]]<br />
Red dot by application state informs about unanswered call or message waiting for user.<br />
<br />
<br />
Agents state icons: <br />
* agent logged to queue: [[File:MessengerCTI.Desktop_agent_log_in.png | 40px]]<br />
* agent pause: [[File:MessengerCTI.Desktop_agent_pause.png | 40px]]<br />
* agent logged out of queue: [[File:MessengerCTI.Desktop_agent_log_out.png | 40px]]<br />
Red dot by agent state icons informs about calls unanswered by CC agents.<br />
<br />
<br />
'''CC''' tab within application, depending on configuration is showing:<br />
* up to 4 programmed buttons with present state for current agent: '''Log in/out of CC queue''' and '''Turn on/off agent pause'''<br />
* serviced queues with amount of logged agents and waiting calls<br />
* Callback list - numbers/contacts to call back<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_CC_tab_.png]]</center><br />
<br />
When using callback list, additional window will apear allowing to make call and field to confirm if call was successfull.<br />
<br />
<br />
To properly configure '''CC''' tab, '''Call Center''' sections within application preferences must be set up.<br />
<br />
<center>[[File:MessengerCTI.Desktop_configure_cc.png]]</center><br />
<br />
=Licensing=<br />
==IPX, MAC, CCT PBX==<br />
MessengerCTI.Desktop application:<br />
* 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.<br />
* for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
* calls made form application in VoIP mode are using VoIP channels just like other VoIP devices<br />
* MessengerCTI.Dekstop configured without VoIP and camera preview access - CTIuser license is required<br />
* MessengerCTI.Desktop configured with VoIP and camera preview access - CTIuserplus license is required<br />
<br />
==NCP PBX==<br />
MessengerCTI.Desktop:<br />
* CAN be associated with any subscriber port - analogue, system or VoIP; each subscriber port is treated as 1 user from Base license, additionally while associating application with VoIP port 1 NCP.VoIPuser license is neccesary<br />
** for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
** MessengerCTI.Desktop configured without VoIP and no camera preview access - NCP.CTIuser is required<br />
** MessengerCTI.Desktop configured with VoIP and camera preview access - NCP.CTIuserPlus license is required<br />
* MessengerCTI.Dekstop as standalone subscriber - MCTI (not associated with subscriber port):<br />
** Messenger.CTI Dekstop with VoIP funcionality and camera preview access - NCP.VoIPuser and NCP.CTIuserPlus licenses are required<br />
<br />
=One user and few different numbers=<br />
Sometimes one computer use must operate with few different extensions umber. On workstation(computer) use of "instance" is neccesary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create seperate configuration.<br />
<br />
* default location of program instalation is: C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe<br />
** 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 llok for MessengerCTI, right click -> More/ Open File Location - program icon will appear, right click -> Properties/Shortcut/Target<br />
* create program shortcut on desktop<br />
* in shortcut properties add instance - Properties/Shortcut/Target: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''<br />
* 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''', ...<br />
* while running aplication from shortcuts we can configure each one seperatly for different numbers</div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI_Manual&diff=7853MessengerCTI Manual2020-02-13T13:30:25Z<p>Marekg: /* MessengerCTI.Desktop for Call Center agents */</p>
<hr />
<div>= Introduction =<br />
Slican '''MessengerCTI.Desktop''' is software which purpose is to assist users of Slican PBX. Thanks to the graphic interface displayed on the computer screen, software allows for convenient access of telephone calls and other functions related to it. Software delivers additional features that allows to expand capabilities of desk phone. Software combines capabilities of controlling desk phone connected to PBX, for example choosing number, receiving calls and also application is able to function as standalone phone. Software also allows to: accessing PBX's phonebook, call history, status of phone and other users of MessengerCTI, text communication and sending or receiving SMS messages. Additionally for new version of DPH.IP doorphone equipped with camera - video preview was added.<br />
<br />
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). Users of analogue phones will benefit from this software because they'll gain access to functions that aren't available on these types of devices.<br />
<br />
= Basic functionalities =<br />
<br />
=== Using cameras and DPH.IP doorphones ===<br />
<br />
Introduction of DPH.IP doorphones that include cameras led to solution that allows display of video from these cameras. Functionality was added with MessengerCTI.Desktop. While connecting to doorphone from software video from camera will appear in new window on computer display. After picking up and finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door,gate, using dedicated button. Reverse is also true, calling doorphone or another telephone number associated with camera, display screen will show video from camera. This allow for temporary observation of surroundings of installed camera, for example person we are calling. There is also option of watching video from any camera without making call, just using application icon. Thanks to MessengerCTI.Desktop user can preview video from camera of other manufacturers but those devices have to support video formats, codec compatible with VLC application libraries.<br />
<br />
{{Attention!|<br />
MessengerCTI.Desktop application was released mainly for displaying video from DPH.IP doorphones and and this time doesn't yet have all fuctionality of PhoneCTI application. Those options will be added gradually}}<br />
<br />
=== VoiP Client===<br />
<br />
MessengerCTI.Desktop can work as VoIP, concurrent phone connected to stationary desk phone(FXS,CTS,IP). User can decide on which device to pick up a call, phone or a computer - using it's integrated audio devices(sound card, microphone, speakers or external headphones). Since 1.11 version of NCP firmware application can be used as standalone SIP phone. For such configuration CTIuserPlus license is required.<br />
<br />
<br />
=== Phone Book ===<br />
<br />
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 possible instantly after adding it. Access to phone book allows to simply search numbers of contacts user want to call. On other hand, during incoming calls computer displaying will be showing clear information about calling person.<br />
<br />
=== Call History ===<br />
<br />
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.<br />
<br />
=== Text messages ===<br />
<br />
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.<br />
<br />
=== Usage alongside mobile version ===<br />
<br />
Application can be used alongside and synchronized to MessengerCTI.Mobile, Android version for mobile devices.<br />
<br />
<br />
= Minimum requirements =<br />
To install SLICAN MessengerCTI.Desktop application, following minimum requirements must be met:<br />
*CPU Frequency - 800 mhz or higher<br />
*Ram - 1 GB or more<br />
*GPU- compatible with DirectX 9 <br />
*Operating System - Windows 7 or more recent<br />
<br />
Application can be installed on computer which doesn't meet minimum requirements but it will run slowly or some option won't work correctly.<br />
{{Attention!|<br />
'''MessengerCTI.Desktop''' application works with IPx, Mac and CCT PBX with firmware 6.52 or newer, or NCP PBX with firmware 1.10}}<br />
<br />
= Installation of application =<br />
<br />
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 computer. After installing, application should be properly configured by entering necessary PBX information to which software should be conencted:<br />
Settings - Connection.<br />
{{Attention!|<br />
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.}}<br />
<br />
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"<br />
<br />
== Running application ==<br />
<br />
MessengerCTI.Dekstop can be run just as any other Windows compatible software. In the program settings automatic start during launch of operating system can bet set. During start of program it is logging to PBX(according to settings set in Settings - Connection tab). After successful login program data is synchronized with PBX data.<br />
<br />
== Updating application ==<br />
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 <br />
compared to version on PBX. If they differ, version from PBX is automaticly downloaded, installed and logged to PBX. Depending on version from PBX it may install newer or old version.<br />
<br />
= Available configurations =<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned off) - calling with phone, application - dialling up outgoing calls for phone(CTS, FXS, SIP) and picking up incoming calls for phone (CTS)<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned on) independent choice of picking/dialing up call with phone or application.<br />
*Autonomous application without desk phone (application VoIP mode on) - picking/dialling calls only with application.<br />
<br />
Other functionalities for example chat, sending and receiving SMS, displaying video from camera, accessing call history and phone book, configuring user status and Messenger aplication are available for each of the above configurations.<br />
<br />
Application '''MessengerCTI.Mobile''' is intended for mobile devices with Android system, its description can be found HERE(manual in progress).<br />
<br />
== '''MessengerCTI.Desktop''' with simultaneous configuration ==<br />
<br />
===Application with VoIP mode turned OFF.===<br />
<br />
Phone calls are made only using phone working alongside application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, dialling with phone speaker using CTS phone<br />
*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.<br />
<br />
For user of FXS nad SIP phones picking up earphone is necessary.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_VoIP.png |800px]]</center><br />
<br />
===Application with VoIP mode turned ON.===<br />
<br />
Phone calls can are made with phone or with computer and application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_with_phone.png |800px]]</center><br />
<br />
== '''MessengerCTI.Desktop''' working as standalone phone (only with NCP)==<br />
<br />
===Application with VoIP mode turned on.===<br />
<br />
Phone calls are made only with computer and application. Standalone applications allows:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_phone.png |800px]]</center><br />
<br />
= Program structure =<br />
==Main window==<br />
Main windows of MessengerCTI.Desktop application contains interface which show information and allows access to chat windows and main functions.<br />
<center>[[File:MessengerCTI_main_window.PNG]]</center><br />
===Upper part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_-_main_window_-_upper.png]]<br />
*left side<br />
**hyperlink to software version<br />
<br />
*right side<br />
**default window position button<br />
**close - minimizing to tray button<br />
<br />
===Middle part of window:===<br />
<br />
[[File:MessengerCTIDesktop_-_main_window_-_middle.png]]<br />
*left side:<br />
**changing application status button<br />
<br />
*middle: program name,below - user status - field that can by user to provide additional urlop, for example to inform about vacation or being busy with project<br />
<br />
*right side:<br />
**searching (magnifying glass) - button/field for searching number or contact<br />
**preferences - access to program settings<br />
<br />
===Lower part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_main_window_lower.PNG]]<br />
*access to tabs:<br />
**contacts - phonebook from bx with sorting options<br />
**recent - history of most recent calls and messages.<br />
<br />
== Status of application and user ==<br />
'''MessengerCTI.Dekstop''' software allows to show current status of user with coloured symbol and display it inside applications of other users. Applications status is informing about user availability, depending on user actions status can be changed by him or application can change it automatically. More information can be added through text status of user. User can choose different icons/symbol to set his status manually. Additionally there is graphic informing about ringing phone or current call.<br />
<br />
===List of icons and symbols===<br />
Chart presents list of icons available in '''Contacts''' and '''Recent''' tabs:<br />
<br />
* [[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.<br />
* [[File:MessengerCTI_history.png | 32px]] - for public subscribers.<br />
* [[File:MessengerCTI_close_door.png | 32px]] - for DPH.IP doorphones connected to open/closed door sensor<br />
<br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Status of application and DPH.IP doorphones<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_green.png | 32px]] ||PBX subscriber; '''MessengerCTI.Desktop''' application is running '''and and LOGGED IN'''from subscriber computer. Clicking icon will allow to send text messeger, SMS or dial a call to another application user.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_chat_tv_yellow.png | 29px]] ||PBX subscriber; '''Be right back''' set by user or application, delay time is definied in general settings of application.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_red.png | 32px]] ||PBX subscriber; '''Do not disturb''' set by user<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_grey.png | 32px]] ||PBX subscriber; '''Invisible''' set by user or application is logged off.<br />
|-<br />
|{{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)<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_history.png | 32px]] ||public subscriber; clicking icon will allow to send SMS or dial call to chosen subscriber.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_close_door.png | 32px]] ||doorphone; current door position - door closed, clicking icon will open door<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_open_door.png | 32px]] ||doorphone; door are open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_alarm_open_door.png | 32px]] ||doorphone; alarm timer for open doors was set off<br />
|-<br />
|}<br />
'''''Chart 1:''''' Meaning of icon status of application, users and doorphones.<br><br />
<br />
Chart is showing list if icon that appear on the left side of subscriber name in tab '''Contacts''' and '''Recent'''. Internal phone will have status icon being displayed<br />
<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Phone status and camera information<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_bell_red.png | 28px]] ||Phone is ringing<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_phone_red.png | 32px]] || During call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_camera.png | 25px]] ||Camera is associeted with phone or doorphone, clicking on icon will allow to preview camera video<br />
|-<br />
|}<br />
</center><br />
<center>'''''Tabela 2:''''' Icons displaying status of phone and camera</center><br />
<br />
== Preferences==<br />
<br />
Clicking '''Preferences''' icon in main program window will display window with program settings. In every tab there is available button with info "About software" and reseting default window position.<br />
<br />
=== Connection===<br />
In '''''Connection''''' field you must enter settings neccesary for application to connect:<br />
<br />
<center>[[File:MessengerCTI_connection.PNG]]</center><br />
<br />
'''Application login setting'''<br />
<br />
To login, application must have correct settings configured by PBX administrator: <br />
* subscriber numbers - extensions from PBX<br />
* CTI access and password:<br />
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/Settings CTI''' - '''CTI - access level''' and pasword'''Pss'''<br />
** for NCP - '''ConfigWEB''' chart '''Extensions/Subscribers/CTI setting''' - '''CTI Access''' and '''Password'''<br />
* Server address - PBX network settings<br />
CTI access level determines what options are available to application:<br />
* CTI.user - MessengerCTI without VoIP and camera preview<br />
* CTI.userPlus - MessengerCTI with VoIP and camera preview<br />
<br />
<br />
These connections settings must be filled:<br />
* '''Subscribers" field - extension number for which '''MessengerCTI.Dekstop''' will login.<br />
* '''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. <br />
* '''server IP address''' - IP address of PBX network interface. IP address of PBX network port. In case of logging outside od PBX network, IP address of edge router(port forwarding on router is necessary, 5529 TCP, 8100-8300 UDP for IPx, 10000-30000 UDP for NCP on PBX LAN interface).<br />
<br />
After user will change his password, administrator no longer will have access to this passowrd. Application can be set to remember user password by checking field while login in, if field wasn't checked application will always ask for password during every login.<br />
<br />
<br />
After proper 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. "Successful login" will apear in lower part of window.<br />
<br />
<br />
If login credentials, configuration settings aren't correct or there are issue with network connection those error messages may appear:<br />
* ''Wrong login or password. Check if correct login or password was used.''<br />
* ''Connecting to PBX'' alternating with<br />
* ''No connection to PBX'' Check IP address that was entered and check computer LAN connection.<br />
<br />
===General===<br />
<br />
<br />
<center>[[File:MessengerCTI_general_settings.PNG]]</center><br />
<br />
This window allows to configure settings defining how program works and startup options.<br />
Available settings:<br />
*Auto start on System startup - automatic start of application.<br />
*Start minimized - application will run hidden in system task bar.<br />
*Set "Be right back" state after - status icon will change automatically, informing about user being away from computer after defined time.<br />
*Set shortcut for application window - changes application from Windows task bar to desktop and vice versa.<br />
*Choose double click function(for contact or number):<br />
**show call window - choice windows is displayed with options - number, phone call, opening chat/SMS window, closing current window<br />
**call primary number - automatic number dialling<br />
**show last events - recent call history to particular subscriber is displayed.<br />
*Set this window position as default - allows to set up default application's window potion on screen.<br />
<br />
===Audio settings===<br />
These setting allow to set up audio notifications informing about incoming calls and messages and audio setting of computer audio devices.<br />
<br />
<br />
<center>[[File:MessengerCTI_audio_settings.PNG]]</center><br />
<br />
*Enable VoIP on when available - allows application to work as VoIP client(VoIP phone)<br />
<br />
<center>[[File:MessengerCTI_voip_settings.PNG]]</center><br />
<br />
==Dialing and picking up calls==<br />
To set up call between two users, particular hardware, software and proper configuration must be supplied:<br />
*Slican PBX<br />
*computer with installed and configured MessengerCTI.Desktop software<br />
**software logged to PBX with subscriber extension(Settings tab, Connection field)<br />
*analog, VoIP or Slican system phone<br />
*for video preview - DPH.IP doorphone with camera or phone associated with external camera(doesn't apply to VoIP phones with integrated camera)<br />
<br />
Call can be dialled using computer mouse and computer screen. Call is made between subscribers through phone connected to PBX and associated with MessengerCTI.Desktop. After choosing subscriber number to call and dialling call, PBX will call extension choosing number(to inform about being ready to set up connection), after picking up handset PBX will set up calling connection.<br />
<br />
==='''Dialing calls to particular number'''===<br />
<center>[[File:MessengerCTI_outgoing_call_window.png]]</center><br />
Making calls can be realised in few different way. Depending on how configured are general setting on application - option "Set double click function".<br />
* from '''Contacts''' tab<br />
**choose subscriber from proper group(if applicable) or from group "All contacts" by double clicking on number or contact<br />
**clicking on [[File:MessengerCTI_tv_green.png | 32px]] or [[File:MessengerCTI_history.png | 32px]]<br />
*'''Search''' field - by directly entering phone number with computer keyboard then clicking on green phone icon.<br />
*'''Recent''' tab - call history:<br />
**history of call with particular subscriber can be seen here, call is dialled by double click on number or contact<br />
**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]]<br />
<br />
==='''Incoming calls'''===<br />
<br />
<center>[[File:MessengerCTI_incoming_window.png]]</center><br />
Calls are displayed on computer screen with pop-up window, ringing application and ringing phone. Depending on applied configuration call can be picked up with application or phone.<br />
<br />
==='''Connecting to camera video preview'''===<br />
Connecting to/from DPH.IP with integrated camera or associated phone or external IP camera(doesn't apply to VoIP phone with integrated cameras)will display automatically new window on computer screen. Connecting to doorphone allows to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.<br />
<br />
<center>[[File:MessengerCTI_camera_preview.png]]</center><br />
<br />
<br />
<br />
===Transfering calls - version 1.03===<br />
Call can be transfered by choosing contact or number from: Recent or Contacts.<br />
* "blind transfer" - without checking target extensions state<br />
<center>[[File:MessengerCTI_blind_transfer.png | 700px]]</center><br />
<br />
<br />
* no announcing - check target extension state without announcing <br />
<center>[[File:MessengerCTI_no_announcing.png | 700px]]</center><br />
<br />
<br />
* with annoucing - check target extension state with announcing <br />
<center>[[File:MessengerCTI_with_announcing.png | 700px]]</center><br />
<br />
==Sending messages==<br />
Application allow sending(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.<br />
<br />
Receving new message is signalised on Windows system task bar with two icons alternating [[File:MessengerCTI_free.png | 32px]], [[File:MessengerCTI_mail.png | 32px]] and popping up [[File:MessengerCTI_new_message.png]].<br />
<br />
Messages history is available through hyper link '''Load previous'''. It is stored on computer local hard drive.<br />
<br />
<center>[[File:MessengerCTI_chat.png]]</center><br />
<br />
==Searching data==<br />
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Contacts''' tab in '''Search''':<br />
<br />
<br />
<center>[[File:MessengerCT_search_field.PNG]]</center><br />
<br />
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'''.<br />
<br />
== Contacts==<br />
This field allows for searching, displaying, customising and running actions related to contact. By default '''Favourites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.<br />
<br />
<center>[[File:MessengerCTI_contacts2.png]]</center><br />
<br />
Adding contacts is possible:<br />
<br />
* from search field - entering number and adding it with green handset icon<br />
* from '''Contacts''' or '''Recent''' tab - right clicking on connection<br />
<br />
From contact list we gain access to:<br />
*favourites<br />
*all contacts<br />
*extensions<br />
*created subscriber groups<br />
*public contacts<br />
*private contacts<br />
<br />
== Call history ==<br />
Choosing '''Recent''' tab - in main program window will display call history of currently logged extension to '''''MessengerCTI.Desktop'''''. Window will look like this.<br />
<br />
<br />
<center>[[File:MessengerCTI_recent.PNG]]</center><br />
<br />
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:<br />
<br />
[[File:MessengerCTI_outgoing_calls.PNG | 32px]]<br />
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.<br />
<br />
[[File:MessengerCTI_incoming_calls.PNG | 32px]]<br />
Downward arrow for incoming call that was picked up.<br />
<br />
[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]<br />
Turned arrow for missed incoming calls, digit is showing number of these calls.<br />
<br />
[[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]] [[File:MessengerCTI_message_amount.PNG | 32px]]<br />
Arrow with listed lines or text bubble for text chat or sent SMS. Digit is showing number of missed messages.<br />
If history contains missed calls or unread messages icon in '''Recent''' field will be in colour red.<br />
<br />
From History window call can be dialled or messages be send to chosen users by right clicking on subscribers text status<br />
, clicking on icons [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] and [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]] [[File:MessengerCTI_missed_calls.PNG | 32px]] [[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]]. If internal subscriber have other number listed in their phone book, choice can be made between them. For internal subscribers there is option of editing, deleting contact and deleting from favourite list.<br />
<br />
=MessengerCTI.Desktop for Call Center agents=<br />
Starting from NCP 1.12 firmware and MessengerCTI.Desktop 1.02 firmware, 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.<br />
<br />
<br />
Application state icons: <br />
* application logged: [[File:MessengerCTI.Desktop_log_in.png | 40px]]<br />
* application state: '''Be right back''' [[File:MessengerCTI.Desktop status zaraz wracam.png | 40px]]<br />
Red dot by application state informs about unanswered call or message waiting for user.<br />
<br />
<br />
Agents state icons: <br />
* agent logged to queue: [[File:MessengerCTI.Desktop agent zalogowany.png | 40px]]<br />
* agent pause: [[File:MessengerCTI.Desktop przerwa agenta.png | 40px]]<br />
* agent logged out of queue: [[File:MessengerCTI.Desktop agent wylogowany.png | 40px]]<br />
Red dot by agent state icons informs about calls unanswered by CC agents.<br />
<br />
<br />
'''CC''' tab within application, depending on configuration is showing:<br />
* up to 4 programmed buttons with present state for current agent: '''Log in/out of CC queue''' and '''Turn on/off agent pause'''<br />
* serviced queues with amount of logged agents and waiting calls<br />
* Callback list - numbers/contacts to call back<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop zakładka CC.png]]</center><br />
<br />
When using callback list, additional window will apear allowing to make call and field to confirm if call was successfull.<br />
<br />
<br />
To properly configure '''CC''' tab, '''Call Center''' sections within application preferences must be set up.<br />
<br />
<center>[[File:MessengerCTI.Desktop konfiguracja CC.png]]</center><br />
<br />
=Licensing=<br />
==IPX, MAC, CCT PBX==<br />
MessengerCTI.Desktop application:<br />
* 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.<br />
* for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
* calls made form application in VoIP mode are using VoIP channels just like other VoIP devices<br />
* MessengerCTI.Dekstop configured without VoIP and camera preview access - CTIuser license is required<br />
* MessengerCTI.Desktop configured with VoIP and camera preview access - CTIuserplus license is required<br />
<br />
==NCP PBX==<br />
MessengerCTI.Desktop:<br />
* CAN be associated with any subscriber port - analogue, system or VoIP; each subscriber port is treated as 1 user from Base license, additionally while associating application with VoIP port 1 NCP.VoIPuser license is neccesary<br />
** for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
** MessengerCTI.Desktop configured without VoIP and no camera preview access - NCP.CTIuser is required<br />
** MessengerCTI.Desktop configured with VoIP and camera preview access - NCP.CTIuserPlus license is required<br />
* MessengerCTI.Dekstop as standalone subscriber - MCTI (not associated with subscriber port):<br />
** Messenger.CTI Dekstop with VoIP funcionality and camera preview access - NCP.VoIPuser and NCP.CTIuserPlus licenses are required<br />
<br />
=One user and few different numbers=<br />
Sometimes one computer use must operate with few different extensions umber. On workstation(computer) use of "instance" is neccesary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create seperate configuration.<br />
<br />
* default location of program instalation is: C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe<br />
** 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 llok for MessengerCTI, right click -> More/ Open File Location - program icon will appear, right click -> Properties/Shortcut/Target<br />
* create program shortcut on desktop<br />
* in shortcut properties add instance - Properties/Shortcut/Target: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''<br />
* 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''', ...<br />
* while running aplication from shortcuts we can configure each one seperatly for different numbers</div>Marekghttp://pubwiki.slican.com/index.php?title=File:MessengerCTI.Desktop_log_in.png&diff=7852File:MessengerCTI.Desktop log in.png2020-02-13T13:29:44Z<p>Marekg: </p>
<hr />
<div></div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI_Manual&diff=7851MessengerCTI Manual2020-02-13T13:27:32Z<p>Marekg: /* MessengerCTI.Desktop for Call Center agents */</p>
<hr />
<div>= Introduction =<br />
Slican '''MessengerCTI.Desktop''' is software which purpose is to assist users of Slican PBX. Thanks to the graphic interface displayed on the computer screen, software allows for convenient access of telephone calls and other functions related to it. Software delivers additional features that allows to expand capabilities of desk phone. Software combines capabilities of controlling desk phone connected to PBX, for example choosing number, receiving calls and also application is able to function as standalone phone. Software also allows to: accessing PBX's phonebook, call history, status of phone and other users of MessengerCTI, text communication and sending or receiving SMS messages. Additionally for new version of DPH.IP doorphone equipped with camera - video preview was added.<br />
<br />
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). Users of analogue phones will benefit from this software because they'll gain access to functions that aren't available on these types of devices.<br />
<br />
= Basic functionalities =<br />
<br />
=== Using cameras and DPH.IP doorphones ===<br />
<br />
Introduction of DPH.IP doorphones that include cameras led to solution that allows display of video from these cameras. Functionality was added with MessengerCTI.Desktop. While connecting to doorphone from software video from camera will appear in new window on computer display. After picking up and finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door,gate, using dedicated button. Reverse is also true, calling doorphone or another telephone number associated with camera, display screen will show video from camera. This allow for temporary observation of surroundings of installed camera, for example person we are calling. There is also option of watching video from any camera without making call, just using application icon. Thanks to MessengerCTI.Desktop user can preview video from camera of other manufacturers but those devices have to support video formats, codec compatible with VLC application libraries.<br />
<br />
{{Attention!|<br />
MessengerCTI.Desktop application was released mainly for displaying video from DPH.IP doorphones and and this time doesn't yet have all fuctionality of PhoneCTI application. Those options will be added gradually}}<br />
<br />
=== VoiP Client===<br />
<br />
MessengerCTI.Desktop can work as VoIP, concurrent phone connected to stationary desk phone(FXS,CTS,IP). User can decide on which device to pick up a call, phone or a computer - using it's integrated audio devices(sound card, microphone, speakers or external headphones). Since 1.11 version of NCP firmware application can be used as standalone SIP phone. For such configuration CTIuserPlus license is required.<br />
<br />
<br />
=== Phone Book ===<br />
<br />
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 possible instantly after adding it. Access to phone book allows to simply search numbers of contacts user want to call. On other hand, during incoming calls computer displaying will be showing clear information about calling person.<br />
<br />
=== Call History ===<br />
<br />
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.<br />
<br />
=== Text messages ===<br />
<br />
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.<br />
<br />
=== Usage alongside mobile version ===<br />
<br />
Application can be used alongside and synchronized to MessengerCTI.Mobile, Android version for mobile devices.<br />
<br />
<br />
= Minimum requirements =<br />
To install SLICAN MessengerCTI.Desktop application, following minimum requirements must be met:<br />
*CPU Frequency - 800 mhz or higher<br />
*Ram - 1 GB or more<br />
*GPU- compatible with DirectX 9 <br />
*Operating System - Windows 7 or more recent<br />
<br />
Application can be installed on computer which doesn't meet minimum requirements but it will run slowly or some option won't work correctly.<br />
{{Attention!|<br />
'''MessengerCTI.Desktop''' application works with IPx, Mac and CCT PBX with firmware 6.52 or newer, or NCP PBX with firmware 1.10}}<br />
<br />
= Installation of application =<br />
<br />
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 computer. After installing, application should be properly configured by entering necessary PBX information to which software should be conencted:<br />
Settings - Connection.<br />
{{Attention!|<br />
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.}}<br />
<br />
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"<br />
<br />
== Running application ==<br />
<br />
MessengerCTI.Dekstop can be run just as any other Windows compatible software. In the program settings automatic start during launch of operating system can bet set. During start of program it is logging to PBX(according to settings set in Settings - Connection tab). After successful login program data is synchronized with PBX data.<br />
<br />
== Updating application ==<br />
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 <br />
compared to version on PBX. If they differ, version from PBX is automaticly downloaded, installed and logged to PBX. Depending on version from PBX it may install newer or old version.<br />
<br />
= Available configurations =<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned off) - calling with phone, application - dialling up outgoing calls for phone(CTS, FXS, SIP) and picking up incoming calls for phone (CTS)<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned on) independent choice of picking/dialing up call with phone or application.<br />
*Autonomous application without desk phone (application VoIP mode on) - picking/dialling calls only with application.<br />
<br />
Other functionalities for example chat, sending and receiving SMS, displaying video from camera, accessing call history and phone book, configuring user status and Messenger aplication are available for each of the above configurations.<br />
<br />
Application '''MessengerCTI.Mobile''' is intended for mobile devices with Android system, its description can be found HERE(manual in progress).<br />
<br />
== '''MessengerCTI.Desktop''' with simultaneous configuration ==<br />
<br />
===Application with VoIP mode turned OFF.===<br />
<br />
Phone calls are made only using phone working alongside application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, dialling with phone speaker using CTS phone<br />
*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.<br />
<br />
For user of FXS nad SIP phones picking up earphone is necessary.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_VoIP.png |800px]]</center><br />
<br />
===Application with VoIP mode turned ON.===<br />
<br />
Phone calls can are made with phone or with computer and application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_with_phone.png |800px]]</center><br />
<br />
== '''MessengerCTI.Desktop''' working as standalone phone (only with NCP)==<br />
<br />
===Application with VoIP mode turned on.===<br />
<br />
Phone calls are made only with computer and application. Standalone applications allows:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_phone.png |800px]]</center><br />
<br />
= Program structure =<br />
==Main window==<br />
Main windows of MessengerCTI.Desktop application contains interface which show information and allows access to chat windows and main functions.<br />
<center>[[File:MessengerCTI_main_window.PNG]]</center><br />
===Upper part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_-_main_window_-_upper.png]]<br />
*left side<br />
**hyperlink to software version<br />
<br />
*right side<br />
**default window position button<br />
**close - minimizing to tray button<br />
<br />
===Middle part of window:===<br />
<br />
[[File:MessengerCTIDesktop_-_main_window_-_middle.png]]<br />
*left side:<br />
**changing application status button<br />
<br />
*middle: program name,below - user status - field that can by user to provide additional urlop, for example to inform about vacation or being busy with project<br />
<br />
*right side:<br />
**searching (magnifying glass) - button/field for searching number or contact<br />
**preferences - access to program settings<br />
<br />
===Lower part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_main_window_lower.PNG]]<br />
*access to tabs:<br />
**contacts - phonebook from bx with sorting options<br />
**recent - history of most recent calls and messages.<br />
<br />
== Status of application and user ==<br />
'''MessengerCTI.Dekstop''' software allows to show current status of user with coloured symbol and display it inside applications of other users. Applications status is informing about user availability, depending on user actions status can be changed by him or application can change it automatically. More information can be added through text status of user. User can choose different icons/symbol to set his status manually. Additionally there is graphic informing about ringing phone or current call.<br />
<br />
===List of icons and symbols===<br />
Chart presents list of icons available in '''Contacts''' and '''Recent''' tabs:<br />
<br />
* [[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.<br />
* [[File:MessengerCTI_history.png | 32px]] - for public subscribers.<br />
* [[File:MessengerCTI_close_door.png | 32px]] - for DPH.IP doorphones connected to open/closed door sensor<br />
<br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Status of application and DPH.IP doorphones<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_green.png | 32px]] ||PBX subscriber; '''MessengerCTI.Desktop''' application is running '''and and LOGGED IN'''from subscriber computer. Clicking icon will allow to send text messeger, SMS or dial a call to another application user.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_chat_tv_yellow.png | 29px]] ||PBX subscriber; '''Be right back''' set by user or application, delay time is definied in general settings of application.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_red.png | 32px]] ||PBX subscriber; '''Do not disturb''' set by user<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_grey.png | 32px]] ||PBX subscriber; '''Invisible''' set by user or application is logged off.<br />
|-<br />
|{{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)<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_history.png | 32px]] ||public subscriber; clicking icon will allow to send SMS or dial call to chosen subscriber.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_close_door.png | 32px]] ||doorphone; current door position - door closed, clicking icon will open door<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_open_door.png | 32px]] ||doorphone; door are open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_alarm_open_door.png | 32px]] ||doorphone; alarm timer for open doors was set off<br />
|-<br />
|}<br />
'''''Chart 1:''''' Meaning of icon status of application, users and doorphones.<br><br />
<br />
Chart is showing list if icon that appear on the left side of subscriber name in tab '''Contacts''' and '''Recent'''. Internal phone will have status icon being displayed<br />
<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Phone status and camera information<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_bell_red.png | 28px]] ||Phone is ringing<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_phone_red.png | 32px]] || During call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_camera.png | 25px]] ||Camera is associeted with phone or doorphone, clicking on icon will allow to preview camera video<br />
|-<br />
|}<br />
</center><br />
<center>'''''Tabela 2:''''' Icons displaying status of phone and camera</center><br />
<br />
== Preferences==<br />
<br />
Clicking '''Preferences''' icon in main program window will display window with program settings. In every tab there is available button with info "About software" and reseting default window position.<br />
<br />
=== Connection===<br />
In '''''Connection''''' field you must enter settings neccesary for application to connect:<br />
<br />
<center>[[File:MessengerCTI_connection.PNG]]</center><br />
<br />
'''Application login setting'''<br />
<br />
To login, application must have correct settings configured by PBX administrator: <br />
* subscriber numbers - extensions from PBX<br />
* CTI access and password:<br />
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/Settings CTI''' - '''CTI - access level''' and pasword'''Pss'''<br />
** for NCP - '''ConfigWEB''' chart '''Extensions/Subscribers/CTI setting''' - '''CTI Access''' and '''Password'''<br />
* Server address - PBX network settings<br />
CTI access level determines what options are available to application:<br />
* CTI.user - MessengerCTI without VoIP and camera preview<br />
* CTI.userPlus - MessengerCTI with VoIP and camera preview<br />
<br />
<br />
These connections settings must be filled:<br />
* '''Subscribers" field - extension number for which '''MessengerCTI.Dekstop''' will login.<br />
* '''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. <br />
* '''server IP address''' - IP address of PBX network interface. IP address of PBX network port. In case of logging outside od PBX network, IP address of edge router(port forwarding on router is necessary, 5529 TCP, 8100-8300 UDP for IPx, 10000-30000 UDP for NCP on PBX LAN interface).<br />
<br />
After user will change his password, administrator no longer will have access to this passowrd. Application can be set to remember user password by checking field while login in, if field wasn't checked application will always ask for password during every login.<br />
<br />
<br />
After proper 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. "Successful login" will apear in lower part of window.<br />
<br />
<br />
If login credentials, configuration settings aren't correct or there are issue with network connection those error messages may appear:<br />
* ''Wrong login or password. Check if correct login or password was used.''<br />
* ''Connecting to PBX'' alternating with<br />
* ''No connection to PBX'' Check IP address that was entered and check computer LAN connection.<br />
<br />
===General===<br />
<br />
<br />
<center>[[File:MessengerCTI_general_settings.PNG]]</center><br />
<br />
This window allows to configure settings defining how program works and startup options.<br />
Available settings:<br />
*Auto start on System startup - automatic start of application.<br />
*Start minimized - application will run hidden in system task bar.<br />
*Set "Be right back" state after - status icon will change automatically, informing about user being away from computer after defined time.<br />
*Set shortcut for application window - changes application from Windows task bar to desktop and vice versa.<br />
*Choose double click function(for contact or number):<br />
**show call window - choice windows is displayed with options - number, phone call, opening chat/SMS window, closing current window<br />
**call primary number - automatic number dialling<br />
**show last events - recent call history to particular subscriber is displayed.<br />
*Set this window position as default - allows to set up default application's window potion on screen.<br />
<br />
===Audio settings===<br />
These setting allow to set up audio notifications informing about incoming calls and messages and audio setting of computer audio devices.<br />
<br />
<br />
<center>[[File:MessengerCTI_audio_settings.PNG]]</center><br />
<br />
*Enable VoIP on when available - allows application to work as VoIP client(VoIP phone)<br />
<br />
<center>[[File:MessengerCTI_voip_settings.PNG]]</center><br />
<br />
==Dialing and picking up calls==<br />
To set up call between two users, particular hardware, software and proper configuration must be supplied:<br />
*Slican PBX<br />
*computer with installed and configured MessengerCTI.Desktop software<br />
**software logged to PBX with subscriber extension(Settings tab, Connection field)<br />
*analog, VoIP or Slican system phone<br />
*for video preview - DPH.IP doorphone with camera or phone associated with external camera(doesn't apply to VoIP phones with integrated camera)<br />
<br />
Call can be dialled using computer mouse and computer screen. Call is made between subscribers through phone connected to PBX and associated with MessengerCTI.Desktop. After choosing subscriber number to call and dialling call, PBX will call extension choosing number(to inform about being ready to set up connection), after picking up handset PBX will set up calling connection.<br />
<br />
==='''Dialing calls to particular number'''===<br />
<center>[[File:MessengerCTI_outgoing_call_window.png]]</center><br />
Making calls can be realised in few different way. Depending on how configured are general setting on application - option "Set double click function".<br />
* from '''Contacts''' tab<br />
**choose subscriber from proper group(if applicable) or from group "All contacts" by double clicking on number or contact<br />
**clicking on [[File:MessengerCTI_tv_green.png | 32px]] or [[File:MessengerCTI_history.png | 32px]]<br />
*'''Search''' field - by directly entering phone number with computer keyboard then clicking on green phone icon.<br />
*'''Recent''' tab - call history:<br />
**history of call with particular subscriber can be seen here, call is dialled by double click on number or contact<br />
**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]]<br />
<br />
==='''Incoming calls'''===<br />
<br />
<center>[[File:MessengerCTI_incoming_window.png]]</center><br />
Calls are displayed on computer screen with pop-up window, ringing application and ringing phone. Depending on applied configuration call can be picked up with application or phone.<br />
<br />
==='''Connecting to camera video preview'''===<br />
Connecting to/from DPH.IP with integrated camera or associated phone or external IP camera(doesn't apply to VoIP phone with integrated cameras)will display automatically new window on computer screen. Connecting to doorphone allows to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.<br />
<br />
<center>[[File:MessengerCTI_camera_preview.png]]</center><br />
<br />
<br />
<br />
===Transfering calls - version 1.03===<br />
Call can be transfered by choosing contact or number from: Recent or Contacts.<br />
* "blind transfer" - without checking target extensions state<br />
<center>[[File:MessengerCTI_blind_transfer.png | 700px]]</center><br />
<br />
<br />
* no announcing - check target extension state without announcing <br />
<center>[[File:MessengerCTI_no_announcing.png | 700px]]</center><br />
<br />
<br />
* with annoucing - check target extension state with announcing <br />
<center>[[File:MessengerCTI_with_announcing.png | 700px]]</center><br />
<br />
==Sending messages==<br />
Application allow sending(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.<br />
<br />
Receving new message is signalised on Windows system task bar with two icons alternating [[File:MessengerCTI_free.png | 32px]], [[File:MessengerCTI_mail.png | 32px]] and popping up [[File:MessengerCTI_new_message.png]].<br />
<br />
Messages history is available through hyper link '''Load previous'''. It is stored on computer local hard drive.<br />
<br />
<center>[[File:MessengerCTI_chat.png]]</center><br />
<br />
==Searching data==<br />
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Contacts''' tab in '''Search''':<br />
<br />
<br />
<center>[[File:MessengerCT_search_field.PNG]]</center><br />
<br />
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'''.<br />
<br />
== Contacts==<br />
This field allows for searching, displaying, customising and running actions related to contact. By default '''Favourites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.<br />
<br />
<center>[[File:MessengerCTI_contacts2.png]]</center><br />
<br />
Adding contacts is possible:<br />
<br />
* from search field - entering number and adding it with green handset icon<br />
* from '''Contacts''' or '''Recent''' tab - right clicking on connection<br />
<br />
From contact list we gain access to:<br />
*favourites<br />
*all contacts<br />
*extensions<br />
*created subscriber groups<br />
*public contacts<br />
*private contacts<br />
<br />
== Call history ==<br />
Choosing '''Recent''' tab - in main program window will display call history of currently logged extension to '''''MessengerCTI.Desktop'''''. Window will look like this.<br />
<br />
<br />
<center>[[File:MessengerCTI_recent.PNG]]</center><br />
<br />
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:<br />
<br />
[[File:MessengerCTI_outgoing_calls.PNG | 32px]]<br />
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.<br />
<br />
[[File:MessengerCTI_incoming_calls.PNG | 32px]]<br />
Downward arrow for incoming call that was picked up.<br />
<br />
[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]<br />
Turned arrow for missed incoming calls, digit is showing number of these calls.<br />
<br />
[[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]] [[File:MessengerCTI_message_amount.PNG | 32px]]<br />
Arrow with listed lines or text bubble for text chat or sent SMS. Digit is showing number of missed messages.<br />
If history contains missed calls or unread messages icon in '''Recent''' field will be in colour red.<br />
<br />
From History window call can be dialled or messages be send to chosen users by right clicking on subscribers text status<br />
, clicking on icons [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] and [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]] [[File:MessengerCTI_missed_calls.PNG | 32px]] [[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]]. If internal subscriber have other number listed in their phone book, choice can be made between them. For internal subscribers there is option of editing, deleting contact and deleting from favourite list.<br />
<br />
=MessengerCTI.Desktop for Call Center agents=<br />
Starting from NCP 1.12 firmware and MessengerCTI.Desktop 1.02 firmware, 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.<br />
<br />
<br />
Application state icons: <br />
* application logged: [[File:MessengerCTI.Desktop status zalogowany.png | 40px]]<br />
* application state: '''Be right back''' [[File:MessengerCTI.Desktop status zaraz wracam.png | 40px]]<br />
Red dot by application state informs about unanswered call or message waiting for user.<br />
<br />
<br />
Agents state icons: <br />
* agent logged to queue: [[File:MessengerCTI.Desktop agent zalogowany.png | 40px]]<br />
* agent pause: [[File:MessengerCTI.Desktop przerwa agenta.png | 40px]]<br />
* agent logged out of queue: [[File:MessengerCTI.Desktop agent wylogowany.png | 40px]]<br />
Red dot by agent state icons informs about calls unanswered by CC agents.<br />
<br />
<br />
'''CC''' tab within application, depending on configuration is showing:<br />
* up to 4 programmed buttons with present state for current agent: '''Log in/out of CC queue''' and '''Turn on/off agent pause'''<br />
* serviced queues with amount of logged agents and waiting calls<br />
* Callback list - numbers/contacts to call back<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop zakładka CC.png]]</center><br />
<br />
When using callback list, additional window will apear allowing to make call and field to confirm if call was successfull.<br />
<br />
<br />
To properly configure '''CC''' tab, '''Call Center''' sections within application preferences must be set up.<br />
<br />
<center>[[File:MessengerCTI.Desktop konfiguracja CC.png]]</center><br />
<br />
=Licensing=<br />
==IPX, MAC, CCT PBX==<br />
MessengerCTI.Desktop application:<br />
* 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.<br />
* for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
* calls made form application in VoIP mode are using VoIP channels just like other VoIP devices<br />
* MessengerCTI.Dekstop configured without VoIP and camera preview access - CTIuser license is required<br />
* MessengerCTI.Desktop configured with VoIP and camera preview access - CTIuserplus license is required<br />
<br />
==NCP PBX==<br />
MessengerCTI.Desktop:<br />
* CAN be associated with any subscriber port - analogue, system or VoIP; each subscriber port is treated as 1 user from Base license, additionally while associating application with VoIP port 1 NCP.VoIPuser license is neccesary<br />
** for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
** MessengerCTI.Desktop configured without VoIP and no camera preview access - NCP.CTIuser is required<br />
** MessengerCTI.Desktop configured with VoIP and camera preview access - NCP.CTIuserPlus license is required<br />
* MessengerCTI.Dekstop as standalone subscriber - MCTI (not associated with subscriber port):<br />
** Messenger.CTI Dekstop with VoIP funcionality and camera preview access - NCP.VoIPuser and NCP.CTIuserPlus licenses are required<br />
<br />
=One user and few different numbers=<br />
Sometimes one computer use must operate with few different extensions umber. On workstation(computer) use of "instance" is neccesary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create seperate configuration.<br />
<br />
* default location of program instalation is: C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe<br />
** 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 llok for MessengerCTI, right click -> More/ Open File Location - program icon will appear, right click -> Properties/Shortcut/Target<br />
* create program shortcut on desktop<br />
* in shortcut properties add instance - Properties/Shortcut/Target: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''<br />
* 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''', ...<br />
* while running aplication from shortcuts we can configure each one seperatly for different numbers</div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI_Manual&diff=7850MessengerCTI Manual2020-02-13T13:24:22Z<p>Marekg: /* MessengerCTI.Desktop for Call Center agents */</p>
<hr />
<div>= Introduction =<br />
Slican '''MessengerCTI.Desktop''' is software which purpose is to assist users of Slican PBX. Thanks to the graphic interface displayed on the computer screen, software allows for convenient access of telephone calls and other functions related to it. Software delivers additional features that allows to expand capabilities of desk phone. Software combines capabilities of controlling desk phone connected to PBX, for example choosing number, receiving calls and also application is able to function as standalone phone. Software also allows to: accessing PBX's phonebook, call history, status of phone and other users of MessengerCTI, text communication and sending or receiving SMS messages. Additionally for new version of DPH.IP doorphone equipped with camera - video preview was added.<br />
<br />
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). Users of analogue phones will benefit from this software because they'll gain access to functions that aren't available on these types of devices.<br />
<br />
= Basic functionalities =<br />
<br />
=== Using cameras and DPH.IP doorphones ===<br />
<br />
Introduction of DPH.IP doorphones that include cameras led to solution that allows display of video from these cameras. Functionality was added with MessengerCTI.Desktop. While connecting to doorphone from software video from camera will appear in new window on computer display. After picking up and finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door,gate, using dedicated button. Reverse is also true, calling doorphone or another telephone number associated with camera, display screen will show video from camera. This allow for temporary observation of surroundings of installed camera, for example person we are calling. There is also option of watching video from any camera without making call, just using application icon. Thanks to MessengerCTI.Desktop user can preview video from camera of other manufacturers but those devices have to support video formats, codec compatible with VLC application libraries.<br />
<br />
{{Attention!|<br />
MessengerCTI.Desktop application was released mainly for displaying video from DPH.IP doorphones and and this time doesn't yet have all fuctionality of PhoneCTI application. Those options will be added gradually}}<br />
<br />
=== VoiP Client===<br />
<br />
MessengerCTI.Desktop can work as VoIP, concurrent phone connected to stationary desk phone(FXS,CTS,IP). User can decide on which device to pick up a call, phone or a computer - using it's integrated audio devices(sound card, microphone, speakers or external headphones). Since 1.11 version of NCP firmware application can be used as standalone SIP phone. For such configuration CTIuserPlus license is required.<br />
<br />
<br />
=== Phone Book ===<br />
<br />
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 possible instantly after adding it. Access to phone book allows to simply search numbers of contacts user want to call. On other hand, during incoming calls computer displaying will be showing clear information about calling person.<br />
<br />
=== Call History ===<br />
<br />
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.<br />
<br />
=== Text messages ===<br />
<br />
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.<br />
<br />
=== Usage alongside mobile version ===<br />
<br />
Application can be used alongside and synchronized to MessengerCTI.Mobile, Android version for mobile devices.<br />
<br />
<br />
= Minimum requirements =<br />
To install SLICAN MessengerCTI.Desktop application, following minimum requirements must be met:<br />
*CPU Frequency - 800 mhz or higher<br />
*Ram - 1 GB or more<br />
*GPU- compatible with DirectX 9 <br />
*Operating System - Windows 7 or more recent<br />
<br />
Application can be installed on computer which doesn't meet minimum requirements but it will run slowly or some option won't work correctly.<br />
{{Attention!|<br />
'''MessengerCTI.Desktop''' application works with IPx, Mac and CCT PBX with firmware 6.52 or newer, or NCP PBX with firmware 1.10}}<br />
<br />
= Installation of application =<br />
<br />
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 computer. After installing, application should be properly configured by entering necessary PBX information to which software should be conencted:<br />
Settings - Connection.<br />
{{Attention!|<br />
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.}}<br />
<br />
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"<br />
<br />
== Running application ==<br />
<br />
MessengerCTI.Dekstop can be run just as any other Windows compatible software. In the program settings automatic start during launch of operating system can bet set. During start of program it is logging to PBX(according to settings set in Settings - Connection tab). After successful login program data is synchronized with PBX data.<br />
<br />
== Updating application ==<br />
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 <br />
compared to version on PBX. If they differ, version from PBX is automaticly downloaded, installed and logged to PBX. Depending on version from PBX it may install newer or old version.<br />
<br />
= Available configurations =<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned off) - calling with phone, application - dialling up outgoing calls for phone(CTS, FXS, SIP) and picking up incoming calls for phone (CTS)<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned on) independent choice of picking/dialing up call with phone or application.<br />
*Autonomous application without desk phone (application VoIP mode on) - picking/dialling calls only with application.<br />
<br />
Other functionalities for example chat, sending and receiving SMS, displaying video from camera, accessing call history and phone book, configuring user status and Messenger aplication are available for each of the above configurations.<br />
<br />
Application '''MessengerCTI.Mobile''' is intended for mobile devices with Android system, its description can be found HERE(manual in progress).<br />
<br />
== '''MessengerCTI.Desktop''' with simultaneous configuration ==<br />
<br />
===Application with VoIP mode turned OFF.===<br />
<br />
Phone calls are made only using phone working alongside application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, dialling with phone speaker using CTS phone<br />
*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.<br />
<br />
For user of FXS nad SIP phones picking up earphone is necessary.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_VoIP.png |800px]]</center><br />
<br />
===Application with VoIP mode turned ON.===<br />
<br />
Phone calls can are made with phone or with computer and application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_with_phone.png |800px]]</center><br />
<br />
== '''MessengerCTI.Desktop''' working as standalone phone (only with NCP)==<br />
<br />
===Application with VoIP mode turned on.===<br />
<br />
Phone calls are made only with computer and application. Standalone applications allows:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_phone.png |800px]]</center><br />
<br />
= Program structure =<br />
==Main window==<br />
Main windows of MessengerCTI.Desktop application contains interface which show information and allows access to chat windows and main functions.<br />
<center>[[File:MessengerCTI_main_window.PNG]]</center><br />
===Upper part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_-_main_window_-_upper.png]]<br />
*left side<br />
**hyperlink to software version<br />
<br />
*right side<br />
**default window position button<br />
**close - minimizing to tray button<br />
<br />
===Middle part of window:===<br />
<br />
[[File:MessengerCTIDesktop_-_main_window_-_middle.png]]<br />
*left side:<br />
**changing application status button<br />
<br />
*middle: program name,below - user status - field that can by user to provide additional urlop, for example to inform about vacation or being busy with project<br />
<br />
*right side:<br />
**searching (magnifying glass) - button/field for searching number or contact<br />
**preferences - access to program settings<br />
<br />
===Lower part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_main_window_lower.PNG]]<br />
*access to tabs:<br />
**contacts - phonebook from bx with sorting options<br />
**recent - history of most recent calls and messages.<br />
<br />
== Status of application and user ==<br />
'''MessengerCTI.Dekstop''' software allows to show current status of user with coloured symbol and display it inside applications of other users. Applications status is informing about user availability, depending on user actions status can be changed by him or application can change it automatically. More information can be added through text status of user. User can choose different icons/symbol to set his status manually. Additionally there is graphic informing about ringing phone or current call.<br />
<br />
===List of icons and symbols===<br />
Chart presents list of icons available in '''Contacts''' and '''Recent''' tabs:<br />
<br />
* [[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.<br />
* [[File:MessengerCTI_history.png | 32px]] - for public subscribers.<br />
* [[File:MessengerCTI_close_door.png | 32px]] - for DPH.IP doorphones connected to open/closed door sensor<br />
<br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Status of application and DPH.IP doorphones<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_green.png | 32px]] ||PBX subscriber; '''MessengerCTI.Desktop''' application is running '''and and LOGGED IN'''from subscriber computer. Clicking icon will allow to send text messeger, SMS or dial a call to another application user.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_chat_tv_yellow.png | 29px]] ||PBX subscriber; '''Be right back''' set by user or application, delay time is definied in general settings of application.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_red.png | 32px]] ||PBX subscriber; '''Do not disturb''' set by user<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_grey.png | 32px]] ||PBX subscriber; '''Invisible''' set by user or application is logged off.<br />
|-<br />
|{{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)<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_history.png | 32px]] ||public subscriber; clicking icon will allow to send SMS or dial call to chosen subscriber.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_close_door.png | 32px]] ||doorphone; current door position - door closed, clicking icon will open door<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_open_door.png | 32px]] ||doorphone; door are open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_alarm_open_door.png | 32px]] ||doorphone; alarm timer for open doors was set off<br />
|-<br />
|}<br />
'''''Chart 1:''''' Meaning of icon status of application, users and doorphones.<br><br />
<br />
Chart is showing list if icon that appear on the left side of subscriber name in tab '''Contacts''' and '''Recent'''. Internal phone will have status icon being displayed<br />
<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Phone status and camera information<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_bell_red.png | 28px]] ||Phone is ringing<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_phone_red.png | 32px]] || During call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_camera.png | 25px]] ||Camera is associeted with phone or doorphone, clicking on icon will allow to preview camera video<br />
|-<br />
|}<br />
</center><br />
<center>'''''Tabela 2:''''' Icons displaying status of phone and camera</center><br />
<br />
== Preferences==<br />
<br />
Clicking '''Preferences''' icon in main program window will display window with program settings. In every tab there is available button with info "About software" and reseting default window position.<br />
<br />
=== Connection===<br />
In '''''Connection''''' field you must enter settings neccesary for application to connect:<br />
<br />
<center>[[File:MessengerCTI_connection.PNG]]</center><br />
<br />
'''Application login setting'''<br />
<br />
To login, application must have correct settings configured by PBX administrator: <br />
* subscriber numbers - extensions from PBX<br />
* CTI access and password:<br />
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/Settings CTI''' - '''CTI - access level''' and pasword'''Pss'''<br />
** for NCP - '''ConfigWEB''' chart '''Extensions/Subscribers/CTI setting''' - '''CTI Access''' and '''Password'''<br />
* Server address - PBX network settings<br />
CTI access level determines what options are available to application:<br />
* CTI.user - MessengerCTI without VoIP and camera preview<br />
* CTI.userPlus - MessengerCTI with VoIP and camera preview<br />
<br />
<br />
These connections settings must be filled:<br />
* '''Subscribers" field - extension number for which '''MessengerCTI.Dekstop''' will login.<br />
* '''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. <br />
* '''server IP address''' - IP address of PBX network interface. IP address of PBX network port. In case of logging outside od PBX network, IP address of edge router(port forwarding on router is necessary, 5529 TCP, 8100-8300 UDP for IPx, 10000-30000 UDP for NCP on PBX LAN interface).<br />
<br />
After user will change his password, administrator no longer will have access to this passowrd. Application can be set to remember user password by checking field while login in, if field wasn't checked application will always ask for password during every login.<br />
<br />
<br />
After proper 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. "Successful login" will apear in lower part of window.<br />
<br />
<br />
If login credentials, configuration settings aren't correct or there are issue with network connection those error messages may appear:<br />
* ''Wrong login or password. Check if correct login or password was used.''<br />
* ''Connecting to PBX'' alternating with<br />
* ''No connection to PBX'' Check IP address that was entered and check computer LAN connection.<br />
<br />
===General===<br />
<br />
<br />
<center>[[File:MessengerCTI_general_settings.PNG]]</center><br />
<br />
This window allows to configure settings defining how program works and startup options.<br />
Available settings:<br />
*Auto start on System startup - automatic start of application.<br />
*Start minimized - application will run hidden in system task bar.<br />
*Set "Be right back" state after - status icon will change automatically, informing about user being away from computer after defined time.<br />
*Set shortcut for application window - changes application from Windows task bar to desktop and vice versa.<br />
*Choose double click function(for contact or number):<br />
**show call window - choice windows is displayed with options - number, phone call, opening chat/SMS window, closing current window<br />
**call primary number - automatic number dialling<br />
**show last events - recent call history to particular subscriber is displayed.<br />
*Set this window position as default - allows to set up default application's window potion on screen.<br />
<br />
===Audio settings===<br />
These setting allow to set up audio notifications informing about incoming calls and messages and audio setting of computer audio devices.<br />
<br />
<br />
<center>[[File:MessengerCTI_audio_settings.PNG]]</center><br />
<br />
*Enable VoIP on when available - allows application to work as VoIP client(VoIP phone)<br />
<br />
<center>[[File:MessengerCTI_voip_settings.PNG]]</center><br />
<br />
==Dialing and picking up calls==<br />
To set up call between two users, particular hardware, software and proper configuration must be supplied:<br />
*Slican PBX<br />
*computer with installed and configured MessengerCTI.Desktop software<br />
**software logged to PBX with subscriber extension(Settings tab, Connection field)<br />
*analog, VoIP or Slican system phone<br />
*for video preview - DPH.IP doorphone with camera or phone associated with external camera(doesn't apply to VoIP phones with integrated camera)<br />
<br />
Call can be dialled using computer mouse and computer screen. Call is made between subscribers through phone connected to PBX and associated with MessengerCTI.Desktop. After choosing subscriber number to call and dialling call, PBX will call extension choosing number(to inform about being ready to set up connection), after picking up handset PBX will set up calling connection.<br />
<br />
==='''Dialing calls to particular number'''===<br />
<center>[[File:MessengerCTI_outgoing_call_window.png]]</center><br />
Making calls can be realised in few different way. Depending on how configured are general setting on application - option "Set double click function".<br />
* from '''Contacts''' tab<br />
**choose subscriber from proper group(if applicable) or from group "All contacts" by double clicking on number or contact<br />
**clicking on [[File:MessengerCTI_tv_green.png | 32px]] or [[File:MessengerCTI_history.png | 32px]]<br />
*'''Search''' field - by directly entering phone number with computer keyboard then clicking on green phone icon.<br />
*'''Recent''' tab - call history:<br />
**history of call with particular subscriber can be seen here, call is dialled by double click on number or contact<br />
**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]]<br />
<br />
==='''Incoming calls'''===<br />
<br />
<center>[[File:MessengerCTI_incoming_window.png]]</center><br />
Calls are displayed on computer screen with pop-up window, ringing application and ringing phone. Depending on applied configuration call can be picked up with application or phone.<br />
<br />
==='''Connecting to camera video preview'''===<br />
Connecting to/from DPH.IP with integrated camera or associated phone or external IP camera(doesn't apply to VoIP phone with integrated cameras)will display automatically new window on computer screen. Connecting to doorphone allows to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.<br />
<br />
<center>[[File:MessengerCTI_camera_preview.png]]</center><br />
<br />
<br />
<br />
===Transfering calls - version 1.03===<br />
Call can be transfered by choosing contact or number from: Recent or Contacts.<br />
* "blind transfer" - without checking target extensions state<br />
<center>[[File:MessengerCTI_blind_transfer.png | 700px]]</center><br />
<br />
<br />
* no announcing - check target extension state without announcing <br />
<center>[[File:MessengerCTI_no_announcing.png | 700px]]</center><br />
<br />
<br />
* with annoucing - check target extension state with announcing <br />
<center>[[File:MessengerCTI_with_announcing.png | 700px]]</center><br />
<br />
==Sending messages==<br />
Application allow sending(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.<br />
<br />
Receving new message is signalised on Windows system task bar with two icons alternating [[File:MessengerCTI_free.png | 32px]], [[File:MessengerCTI_mail.png | 32px]] and popping up [[File:MessengerCTI_new_message.png]].<br />
<br />
Messages history is available through hyper link '''Load previous'''. It is stored on computer local hard drive.<br />
<br />
<center>[[File:MessengerCTI_chat.png]]</center><br />
<br />
==Searching data==<br />
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Contacts''' tab in '''Search''':<br />
<br />
<br />
<center>[[File:MessengerCT_search_field.PNG]]</center><br />
<br />
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'''.<br />
<br />
== Contacts==<br />
This field allows for searching, displaying, customising and running actions related to contact. By default '''Favourites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.<br />
<br />
<center>[[File:MessengerCTI_contacts2.png]]</center><br />
<br />
Adding contacts is possible:<br />
<br />
* from search field - entering number and adding it with green handset icon<br />
* from '''Contacts''' or '''Recent''' tab - right clicking on connection<br />
<br />
From contact list we gain access to:<br />
*favourites<br />
*all contacts<br />
*extensions<br />
*created subscriber groups<br />
*public contacts<br />
*private contacts<br />
<br />
== Call history ==<br />
Choosing '''Recent''' tab - in main program window will display call history of currently logged extension to '''''MessengerCTI.Desktop'''''. Window will look like this.<br />
<br />
<br />
<center>[[File:MessengerCTI_recent.PNG]]</center><br />
<br />
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:<br />
<br />
[[File:MessengerCTI_outgoing_calls.PNG | 32px]]<br />
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.<br />
<br />
[[File:MessengerCTI_incoming_calls.PNG | 32px]]<br />
Downward arrow for incoming call that was picked up.<br />
<br />
[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]<br />
Turned arrow for missed incoming calls, digit is showing number of these calls.<br />
<br />
[[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]] [[File:MessengerCTI_message_amount.PNG | 32px]]<br />
Arrow with listed lines or text bubble for text chat or sent SMS. Digit is showing number of missed messages.<br />
If history contains missed calls or unread messages icon in '''Recent''' field will be in colour red.<br />
<br />
From History window call can be dialled or messages be send to chosen users by right clicking on subscribers text status<br />
, clicking on icons [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] and [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]] [[File:MessengerCTI_missed_calls.PNG | 32px]] [[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]]. If internal subscriber have other number listed in their phone book, choice can be made between them. For internal subscribers there is option of editing, deleting contact and deleting from favourite list.<br />
<br />
=MessengerCTI.Desktop for Call Center agents=<br />
Starting from NCP 1.12 firmware and MessengerCTI.Desktop 1.02 firmware, 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.<br />
<br />
<br />
Application state icons: <br />
* application logged: [[File:MessengerCTI.Desktop status zalogowany.png | 40px]]<br />
* application state: '''Be right back''' [[File:MessengerCTI.Desktop status zaraz wracam.png | 40px]]<br />
Red dot by application state informs about unanswered call or message waiting for user.<br />
<br />
<br />
Agents state icons: <br />
* agent logged to queue: [[File:MessengerCTI.Desktop agent zalogowany.png | 40px]]<br />
* agent pause: [[File:MessengerCTI.Desktop przerwa agenta.png | 40px]]<br />
* agent logged out of queue: [[File:MessengerCTI.Desktop agent wylogowany.png | 40px]]<br />
Red dot by agent state icons informs about calls unanswered by CC agents.<br />
<br />
<br />
'''CC''' tab within application, depending on configuration is showing:<br />
* up to 4 programmed buttons with present state for current agent: '''Log in/out of CC queue''' and ''Turn on/off agent pause'''<br />
* serviced queues with amount of logged agents and waiting calls<br />
* Callback list - numbers/contacts to call back<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop zakładka CC.png]]</center><br />
<br />
When using callback list, additional window will apear allowing to make call and field to confirm if call was successfull.<br />
<br />
<br />
To properly configure '''CC''' tab, '''Call Center''' sections within application preferences must be set up.<br />
<br />
<center>[[File:MessengerCTI.Desktop konfiguracja CC.png]]</center><br />
<br />
=Licensing=<br />
==IPX, MAC, CCT PBX==<br />
MessengerCTI.Desktop application:<br />
* 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.<br />
* for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
* calls made form application in VoIP mode are using VoIP channels just like other VoIP devices<br />
* MessengerCTI.Dekstop configured without VoIP and camera preview access - CTIuser license is required<br />
* MessengerCTI.Desktop configured with VoIP and camera preview access - CTIuserplus license is required<br />
<br />
==NCP PBX==<br />
MessengerCTI.Desktop:<br />
* CAN be associated with any subscriber port - analogue, system or VoIP; each subscriber port is treated as 1 user from Base license, additionally while associating application with VoIP port 1 NCP.VoIPuser license is neccesary<br />
** for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
** MessengerCTI.Desktop configured without VoIP and no camera preview access - NCP.CTIuser is required<br />
** MessengerCTI.Desktop configured with VoIP and camera preview access - NCP.CTIuserPlus license is required<br />
* MessengerCTI.Dekstop as standalone subscriber - MCTI (not associated with subscriber port):<br />
** Messenger.CTI Dekstop with VoIP funcionality and camera preview access - NCP.VoIPuser and NCP.CTIuserPlus licenses are required<br />
<br />
=One user and few different numbers=<br />
Sometimes one computer use must operate with few different extensions umber. On workstation(computer) use of "instance" is neccesary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create seperate configuration.<br />
<br />
* default location of program instalation is: C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe<br />
** 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 llok for MessengerCTI, right click -> More/ Open File Location - program icon will appear, right click -> Properties/Shortcut/Target<br />
* create program shortcut on desktop<br />
* in shortcut properties add instance - Properties/Shortcut/Target: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''<br />
* 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''', ...<br />
* while running aplication from shortcuts we can configure each one seperatly for different numbers</div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI_Manual&diff=7849MessengerCTI Manual2020-02-13T11:48:40Z<p>Marekg: /* MessengerCTI.Desktop for Call Center agents */</p>
<hr />
<div>= Introduction =<br />
Slican '''MessengerCTI.Desktop''' is software which purpose is to assist users of Slican PBX. Thanks to the graphic interface displayed on the computer screen, software allows for convenient access of telephone calls and other functions related to it. Software delivers additional features that allows to expand capabilities of desk phone. Software combines capabilities of controlling desk phone connected to PBX, for example choosing number, receiving calls and also application is able to function as standalone phone. Software also allows to: accessing PBX's phonebook, call history, status of phone and other users of MessengerCTI, text communication and sending or receiving SMS messages. Additionally for new version of DPH.IP doorphone equipped with camera - video preview was added.<br />
<br />
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). Users of analogue phones will benefit from this software because they'll gain access to functions that aren't available on these types of devices.<br />
<br />
= Basic functionalities =<br />
<br />
=== Using cameras and DPH.IP doorphones ===<br />
<br />
Introduction of DPH.IP doorphones that include cameras led to solution that allows display of video from these cameras. Functionality was added with MessengerCTI.Desktop. While connecting to doorphone from software video from camera will appear in new window on computer display. After picking up and finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door,gate, using dedicated button. Reverse is also true, calling doorphone or another telephone number associated with camera, display screen will show video from camera. This allow for temporary observation of surroundings of installed camera, for example person we are calling. There is also option of watching video from any camera without making call, just using application icon. Thanks to MessengerCTI.Desktop user can preview video from camera of other manufacturers but those devices have to support video formats, codec compatible with VLC application libraries.<br />
<br />
{{Attention!|<br />
MessengerCTI.Desktop application was released mainly for displaying video from DPH.IP doorphones and and this time doesn't yet have all fuctionality of PhoneCTI application. Those options will be added gradually}}<br />
<br />
=== VoiP Client===<br />
<br />
MessengerCTI.Desktop can work as VoIP, concurrent phone connected to stationary desk phone(FXS,CTS,IP). User can decide on which device to pick up a call, phone or a computer - using it's integrated audio devices(sound card, microphone, speakers or external headphones). Since 1.11 version of NCP firmware application can be used as standalone SIP phone. For such configuration CTIuserPlus license is required.<br />
<br />
<br />
=== Phone Book ===<br />
<br />
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 possible instantly after adding it. Access to phone book allows to simply search numbers of contacts user want to call. On other hand, during incoming calls computer displaying will be showing clear information about calling person.<br />
<br />
=== Call History ===<br />
<br />
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.<br />
<br />
=== Text messages ===<br />
<br />
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.<br />
<br />
=== Usage alongside mobile version ===<br />
<br />
Application can be used alongside and synchronized to MessengerCTI.Mobile, Android version for mobile devices.<br />
<br />
<br />
= Minimum requirements =<br />
To install SLICAN MessengerCTI.Desktop application, following minimum requirements must be met:<br />
*CPU Frequency - 800 mhz or higher<br />
*Ram - 1 GB or more<br />
*GPU- compatible with DirectX 9 <br />
*Operating System - Windows 7 or more recent<br />
<br />
Application can be installed on computer which doesn't meet minimum requirements but it will run slowly or some option won't work correctly.<br />
{{Attention!|<br />
'''MessengerCTI.Desktop''' application works with IPx, Mac and CCT PBX with firmware 6.52 or newer, or NCP PBX with firmware 1.10}}<br />
<br />
= Installation of application =<br />
<br />
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 computer. After installing, application should be properly configured by entering necessary PBX information to which software should be conencted:<br />
Settings - Connection.<br />
{{Attention!|<br />
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.}}<br />
<br />
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"<br />
<br />
== Running application ==<br />
<br />
MessengerCTI.Dekstop can be run just as any other Windows compatible software. In the program settings automatic start during launch of operating system can bet set. During start of program it is logging to PBX(according to settings set in Settings - Connection tab). After successful login program data is synchronized with PBX data.<br />
<br />
== Updating application ==<br />
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 <br />
compared to version on PBX. If they differ, version from PBX is automaticly downloaded, installed and logged to PBX. Depending on version from PBX it may install newer or old version.<br />
<br />
= Available configurations =<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned off) - calling with phone, application - dialling up outgoing calls for phone(CTS, FXS, SIP) and picking up incoming calls for phone (CTS)<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned on) independent choice of picking/dialing up call with phone or application.<br />
*Autonomous application without desk phone (application VoIP mode on) - picking/dialling calls only with application.<br />
<br />
Other functionalities for example chat, sending and receiving SMS, displaying video from camera, accessing call history and phone book, configuring user status and Messenger aplication are available for each of the above configurations.<br />
<br />
Application '''MessengerCTI.Mobile''' is intended for mobile devices with Android system, its description can be found HERE(manual in progress).<br />
<br />
== '''MessengerCTI.Desktop''' with simultaneous configuration ==<br />
<br />
===Application with VoIP mode turned OFF.===<br />
<br />
Phone calls are made only using phone working alongside application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, dialling with phone speaker using CTS phone<br />
*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.<br />
<br />
For user of FXS nad SIP phones picking up earphone is necessary.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_VoIP.png |800px]]</center><br />
<br />
===Application with VoIP mode turned ON.===<br />
<br />
Phone calls can are made with phone or with computer and application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_with_phone.png |800px]]</center><br />
<br />
== '''MessengerCTI.Desktop''' working as standalone phone (only with NCP)==<br />
<br />
===Application with VoIP mode turned on.===<br />
<br />
Phone calls are made only with computer and application. Standalone applications allows:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_phone.png |800px]]</center><br />
<br />
= Program structure =<br />
==Main window==<br />
Main windows of MessengerCTI.Desktop application contains interface which show information and allows access to chat windows and main functions.<br />
<center>[[File:MessengerCTI_main_window.PNG]]</center><br />
===Upper part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_-_main_window_-_upper.png]]<br />
*left side<br />
**hyperlink to software version<br />
<br />
*right side<br />
**default window position button<br />
**close - minimizing to tray button<br />
<br />
===Middle part of window:===<br />
<br />
[[File:MessengerCTIDesktop_-_main_window_-_middle.png]]<br />
*left side:<br />
**changing application status button<br />
<br />
*middle: program name,below - user status - field that can by user to provide additional urlop, for example to inform about vacation or being busy with project<br />
<br />
*right side:<br />
**searching (magnifying glass) - button/field for searching number or contact<br />
**preferences - access to program settings<br />
<br />
===Lower part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_main_window_lower.PNG]]<br />
*access to tabs:<br />
**contacts - phonebook from bx with sorting options<br />
**recent - history of most recent calls and messages.<br />
<br />
== Status of application and user ==<br />
'''MessengerCTI.Dekstop''' software allows to show current status of user with coloured symbol and display it inside applications of other users. Applications status is informing about user availability, depending on user actions status can be changed by him or application can change it automatically. More information can be added through text status of user. User can choose different icons/symbol to set his status manually. Additionally there is graphic informing about ringing phone or current call.<br />
<br />
===List of icons and symbols===<br />
Chart presents list of icons available in '''Contacts''' and '''Recent''' tabs:<br />
<br />
* [[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.<br />
* [[File:MessengerCTI_history.png | 32px]] - for public subscribers.<br />
* [[File:MessengerCTI_close_door.png | 32px]] - for DPH.IP doorphones connected to open/closed door sensor<br />
<br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Status of application and DPH.IP doorphones<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_green.png | 32px]] ||PBX subscriber; '''MessengerCTI.Desktop''' application is running '''and and LOGGED IN'''from subscriber computer. Clicking icon will allow to send text messeger, SMS or dial a call to another application user.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_chat_tv_yellow.png | 29px]] ||PBX subscriber; '''Be right back''' set by user or application, delay time is definied in general settings of application.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_red.png | 32px]] ||PBX subscriber; '''Do not disturb''' set by user<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_grey.png | 32px]] ||PBX subscriber; '''Invisible''' set by user or application is logged off.<br />
|-<br />
|{{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)<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_history.png | 32px]] ||public subscriber; clicking icon will allow to send SMS or dial call to chosen subscriber.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_close_door.png | 32px]] ||doorphone; current door position - door closed, clicking icon will open door<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_open_door.png | 32px]] ||doorphone; door are open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_alarm_open_door.png | 32px]] ||doorphone; alarm timer for open doors was set off<br />
|-<br />
|}<br />
'''''Chart 1:''''' Meaning of icon status of application, users and doorphones.<br><br />
<br />
Chart is showing list if icon that appear on the left side of subscriber name in tab '''Contacts''' and '''Recent'''. Internal phone will have status icon being displayed<br />
<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Phone status and camera information<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_bell_red.png | 28px]] ||Phone is ringing<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_phone_red.png | 32px]] || During call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_camera.png | 25px]] ||Camera is associeted with phone or doorphone, clicking on icon will allow to preview camera video<br />
|-<br />
|}<br />
</center><br />
<center>'''''Tabela 2:''''' Icons displaying status of phone and camera</center><br />
<br />
== Preferences==<br />
<br />
Clicking '''Preferences''' icon in main program window will display window with program settings. In every tab there is available button with info "About software" and reseting default window position.<br />
<br />
=== Connection===<br />
In '''''Connection''''' field you must enter settings neccesary for application to connect:<br />
<br />
<center>[[File:MessengerCTI_connection.PNG]]</center><br />
<br />
'''Application login setting'''<br />
<br />
To login, application must have correct settings configured by PBX administrator: <br />
* subscriber numbers - extensions from PBX<br />
* CTI access and password:<br />
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/Settings CTI''' - '''CTI - access level''' and pasword'''Pss'''<br />
** for NCP - '''ConfigWEB''' chart '''Extensions/Subscribers/CTI setting''' - '''CTI Access''' and '''Password'''<br />
* Server address - PBX network settings<br />
CTI access level determines what options are available to application:<br />
* CTI.user - MessengerCTI without VoIP and camera preview<br />
* CTI.userPlus - MessengerCTI with VoIP and camera preview<br />
<br />
<br />
These connections settings must be filled:<br />
* '''Subscribers" field - extension number for which '''MessengerCTI.Dekstop''' will login.<br />
* '''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. <br />
* '''server IP address''' - IP address of PBX network interface. IP address of PBX network port. In case of logging outside od PBX network, IP address of edge router(port forwarding on router is necessary, 5529 TCP, 8100-8300 UDP for IPx, 10000-30000 UDP for NCP on PBX LAN interface).<br />
<br />
After user will change his password, administrator no longer will have access to this passowrd. Application can be set to remember user password by checking field while login in, if field wasn't checked application will always ask for password during every login.<br />
<br />
<br />
After proper 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. "Successful login" will apear in lower part of window.<br />
<br />
<br />
If login credentials, configuration settings aren't correct or there are issue with network connection those error messages may appear:<br />
* ''Wrong login or password. Check if correct login or password was used.''<br />
* ''Connecting to PBX'' alternating with<br />
* ''No connection to PBX'' Check IP address that was entered and check computer LAN connection.<br />
<br />
===General===<br />
<br />
<br />
<center>[[File:MessengerCTI_general_settings.PNG]]</center><br />
<br />
This window allows to configure settings defining how program works and startup options.<br />
Available settings:<br />
*Auto start on System startup - automatic start of application.<br />
*Start minimized - application will run hidden in system task bar.<br />
*Set "Be right back" state after - status icon will change automatically, informing about user being away from computer after defined time.<br />
*Set shortcut for application window - changes application from Windows task bar to desktop and vice versa.<br />
*Choose double click function(for contact or number):<br />
**show call window - choice windows is displayed with options - number, phone call, opening chat/SMS window, closing current window<br />
**call primary number - automatic number dialling<br />
**show last events - recent call history to particular subscriber is displayed.<br />
*Set this window position as default - allows to set up default application's window potion on screen.<br />
<br />
===Audio settings===<br />
These setting allow to set up audio notifications informing about incoming calls and messages and audio setting of computer audio devices.<br />
<br />
<br />
<center>[[File:MessengerCTI_audio_settings.PNG]]</center><br />
<br />
*Enable VoIP on when available - allows application to work as VoIP client(VoIP phone)<br />
<br />
<center>[[File:MessengerCTI_voip_settings.PNG]]</center><br />
<br />
==Dialing and picking up calls==<br />
To set up call between two users, particular hardware, software and proper configuration must be supplied:<br />
*Slican PBX<br />
*computer with installed and configured MessengerCTI.Desktop software<br />
**software logged to PBX with subscriber extension(Settings tab, Connection field)<br />
*analog, VoIP or Slican system phone<br />
*for video preview - DPH.IP doorphone with camera or phone associated with external camera(doesn't apply to VoIP phones with integrated camera)<br />
<br />
Call can be dialled using computer mouse and computer screen. Call is made between subscribers through phone connected to PBX and associated with MessengerCTI.Desktop. After choosing subscriber number to call and dialling call, PBX will call extension choosing number(to inform about being ready to set up connection), after picking up handset PBX will set up calling connection.<br />
<br />
==='''Dialing calls to particular number'''===<br />
<center>[[File:MessengerCTI_outgoing_call_window.png]]</center><br />
Making calls can be realised in few different way. Depending on how configured are general setting on application - option "Set double click function".<br />
* from '''Contacts''' tab<br />
**choose subscriber from proper group(if applicable) or from group "All contacts" by double clicking on number or contact<br />
**clicking on [[File:MessengerCTI_tv_green.png | 32px]] or [[File:MessengerCTI_history.png | 32px]]<br />
*'''Search''' field - by directly entering phone number with computer keyboard then clicking on green phone icon.<br />
*'''Recent''' tab - call history:<br />
**history of call with particular subscriber can be seen here, call is dialled by double click on number or contact<br />
**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]]<br />
<br />
==='''Incoming calls'''===<br />
<br />
<center>[[File:MessengerCTI_incoming_window.png]]</center><br />
Calls are displayed on computer screen with pop-up window, ringing application and ringing phone. Depending on applied configuration call can be picked up with application or phone.<br />
<br />
==='''Connecting to camera video preview'''===<br />
Connecting to/from DPH.IP with integrated camera or associated phone or external IP camera(doesn't apply to VoIP phone with integrated cameras)will display automatically new window on computer screen. Connecting to doorphone allows to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.<br />
<br />
<center>[[File:MessengerCTI_camera_preview.png]]</center><br />
<br />
<br />
<br />
===Transfering calls - version 1.03===<br />
Call can be transfered by choosing contact or number from: Recent or Contacts.<br />
* "blind transfer" - without checking target extensions state<br />
<center>[[File:MessengerCTI_blind_transfer.png | 700px]]</center><br />
<br />
<br />
* no announcing - check target extension state without announcing <br />
<center>[[File:MessengerCTI_no_announcing.png | 700px]]</center><br />
<br />
<br />
* with annoucing - check target extension state with announcing <br />
<center>[[File:MessengerCTI_with_announcing.png | 700px]]</center><br />
<br />
==Sending messages==<br />
Application allow sending(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.<br />
<br />
Receving new message is signalised on Windows system task bar with two icons alternating [[File:MessengerCTI_free.png | 32px]], [[File:MessengerCTI_mail.png | 32px]] and popping up [[File:MessengerCTI_new_message.png]].<br />
<br />
Messages history is available through hyper link '''Load previous'''. It is stored on computer local hard drive.<br />
<br />
<center>[[File:MessengerCTI_chat.png]]</center><br />
<br />
==Searching data==<br />
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Contacts''' tab in '''Search''':<br />
<br />
<br />
<center>[[File:MessengerCT_search_field.PNG]]</center><br />
<br />
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'''.<br />
<br />
== Contacts==<br />
This field allows for searching, displaying, customising and running actions related to contact. By default '''Favourites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.<br />
<br />
<center>[[File:MessengerCTI_contacts2.png]]</center><br />
<br />
Adding contacts is possible:<br />
<br />
* from search field - entering number and adding it with green handset icon<br />
* from '''Contacts''' or '''Recent''' tab - right clicking on connection<br />
<br />
From contact list we gain access to:<br />
*favourites<br />
*all contacts<br />
*extensions<br />
*created subscriber groups<br />
*public contacts<br />
*private contacts<br />
<br />
== Call history ==<br />
Choosing '''Recent''' tab - in main program window will display call history of currently logged extension to '''''MessengerCTI.Desktop'''''. Window will look like this.<br />
<br />
<br />
<center>[[File:MessengerCTI_recent.PNG]]</center><br />
<br />
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:<br />
<br />
[[File:MessengerCTI_outgoing_calls.PNG | 32px]]<br />
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.<br />
<br />
[[File:MessengerCTI_incoming_calls.PNG | 32px]]<br />
Downward arrow for incoming call that was picked up.<br />
<br />
[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]<br />
Turned arrow for missed incoming calls, digit is showing number of these calls.<br />
<br />
[[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]] [[File:MessengerCTI_message_amount.PNG | 32px]]<br />
Arrow with listed lines or text bubble for text chat or sent SMS. Digit is showing number of missed messages.<br />
If history contains missed calls or unread messages icon in '''Recent''' field will be in colour red.<br />
<br />
From History window call can be dialled or messages be send to chosen users by right clicking on subscribers text status<br />
, clicking on icons [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] and [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]] [[File:MessengerCTI_missed_calls.PNG | 32px]] [[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]]. If internal subscriber have other number listed in their phone book, choice can be made between them. For internal subscribers there is option of editing, deleting contact and deleting from favourite list.<br />
<br />
=MessengerCTI.Desktop for Call Center agents=<br />
Starting from NCP 1.12 firmware and MessengerCTI.Desktop 1.02 firmware, application includes features for servicing Call Center queues. For application user which have Call Center permissions set in PBX - Wyndows system tool bar will have additional icon '''Agents status''' and additional tab '''CC''' in application itself.<br />
<br />
<br />
Application state icons: <br />
* application logged: [[File:MessengerCTI.Desktop status zalogowany.png | 40px]]<br />
* application state: '''Be right back''' [[File:MessengerCTI.Desktop status zaraz wracam.png | 40px]]<br />
Czerwona kropka przy statusie aplikacji wskazuje na nieodebrane połączenie lub wiadomość do użytkownika numeru.<br />
<br />
<br />
<br />
Ikony statusu Agenta: <br />
* agent zalogowany do kolejki: [[File:MessengerCTI.Desktop agent zalogowany.png | 40px]]<br />
* przerwa agenta: [[File:MessengerCTI.Desktop przerwa agenta.png | 40px]]<br />
* agent wylogowny z kolejki: [[File:MessengerCTI.Desktop agent wylogowany.png | 40px]]<br />
Czerwona kropka przy statusie agenta wskazuje na nieodebrane połączenie przez agentów kolejki CC.<br />
<br />
<br />
<br />
W zakładce '''CC''' aplikacji w zależności od przyjętej konfiguracji wyświetlane są:<br />
* do 4 zaprogramowanych przycisków wraz z aktualnym jej stanem dla danego agenta: '''Logowanie/wylogowanie z kolejki CC''' oraz '''Włączenie/wyłączenie przerwy agenta'''<br />
* obsługiwane kolejki z liczbą zalogowanych do niej agentów oraz oczekujących aktualnie w kolejce<br />
* lista nieodebranych połączeń - numerów/kontaktów do oddzwonienia<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop zakładka CC.png]]</center><br />
<br />
W przypadku korzystania z listy oddzwonienia pojawia się dodatkowe okno z możliwością nawiązania połączenia oraz polem potwierdzenia czy oddzwonienie było skuteczne.<br />
<br />
<br />
<br />
W celu odpowiedniego skonfigurowania zakładki '''CC''' należy w preferencjach aplikacji prawidłowo skonfigurować zakładkę '''Call Center'''<br />
<br />
<center>[[File:MessengerCTI.Desktop konfiguracja CC.png]]</center><br />
<br />
=Licensing=<br />
==IPX, MAC, CCT PBX==<br />
MessengerCTI.Desktop application:<br />
* 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.<br />
* for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
* calls made form application in VoIP mode are using VoIP channels just like other VoIP devices<br />
* MessengerCTI.Dekstop configured without VoIP and camera preview access - CTIuser license is required<br />
* MessengerCTI.Desktop configured with VoIP and camera preview access - CTIuserplus license is required<br />
<br />
==NCP PBX==<br />
MessengerCTI.Desktop:<br />
* CAN be associated with any subscriber port - analogue, system or VoIP; each subscriber port is treated as 1 user from Base license, additionally while associating application with VoIP port 1 NCP.VoIPuser license is neccesary<br />
** for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
** MessengerCTI.Desktop configured without VoIP and no camera preview access - NCP.CTIuser is required<br />
** MessengerCTI.Desktop configured with VoIP and camera preview access - NCP.CTIuserPlus license is required<br />
* MessengerCTI.Dekstop as standalone subscriber - MCTI (not associated with subscriber port):<br />
** Messenger.CTI Dekstop with VoIP funcionality and camera preview access - NCP.VoIPuser and NCP.CTIuserPlus licenses are required<br />
<br />
=One user and few different numbers=<br />
Sometimes one computer use must operate with few different extensions umber. On workstation(computer) use of "instance" is neccesary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create seperate configuration.<br />
<br />
* default location of program instalation is: C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe<br />
** 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 llok for MessengerCTI, right click -> More/ Open File Location - program icon will appear, right click -> Properties/Shortcut/Target<br />
* create program shortcut on desktop<br />
* in shortcut properties add instance - Properties/Shortcut/Target: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''<br />
* 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''', ...<br />
* while running aplication from shortcuts we can configure each one seperatly for different numbers</div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI_Manual&diff=7848MessengerCTI Manual2020-02-13T10:34:07Z<p>Marekg: /* MessengerCTI.Desktop dla agenta Call Center */</p>
<hr />
<div>= Introduction =<br />
Slican '''MessengerCTI.Desktop''' is software which purpose is to assist users of Slican PBX. Thanks to the graphic interface displayed on the computer screen, software allows for convenient access of telephone calls and other functions related to it. Software delivers additional features that allows to expand capabilities of desk phone. Software combines capabilities of controlling desk phone connected to PBX, for example choosing number, receiving calls and also application is able to function as standalone phone. Software also allows to: accessing PBX's phonebook, call history, status of phone and other users of MessengerCTI, text communication and sending or receiving SMS messages. Additionally for new version of DPH.IP doorphone equipped with camera - video preview was added.<br />
<br />
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). Users of analogue phones will benefit from this software because they'll gain access to functions that aren't available on these types of devices.<br />
<br />
= Basic functionalities =<br />
<br />
=== Using cameras and DPH.IP doorphones ===<br />
<br />
Introduction of DPH.IP doorphones that include cameras led to solution that allows display of video from these cameras. Functionality was added with MessengerCTI.Desktop. While connecting to doorphone from software video from camera will appear in new window on computer display. After picking up and finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door,gate, using dedicated button. Reverse is also true, calling doorphone or another telephone number associated with camera, display screen will show video from camera. This allow for temporary observation of surroundings of installed camera, for example person we are calling. There is also option of watching video from any camera without making call, just using application icon. Thanks to MessengerCTI.Desktop user can preview video from camera of other manufacturers but those devices have to support video formats, codec compatible with VLC application libraries.<br />
<br />
{{Attention!|<br />
MessengerCTI.Desktop application was released mainly for displaying video from DPH.IP doorphones and and this time doesn't yet have all fuctionality of PhoneCTI application. Those options will be added gradually}}<br />
<br />
=== VoiP Client===<br />
<br />
MessengerCTI.Desktop can work as VoIP, concurrent phone connected to stationary desk phone(FXS,CTS,IP). User can decide on which device to pick up a call, phone or a computer - using it's integrated audio devices(sound card, microphone, speakers or external headphones). Since 1.11 version of NCP firmware application can be used as standalone SIP phone. For such configuration CTIuserPlus license is required.<br />
<br />
<br />
=== Phone Book ===<br />
<br />
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 possible instantly after adding it. Access to phone book allows to simply search numbers of contacts user want to call. On other hand, during incoming calls computer displaying will be showing clear information about calling person.<br />
<br />
=== Call History ===<br />
<br />
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.<br />
<br />
=== Text messages ===<br />
<br />
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.<br />
<br />
=== Usage alongside mobile version ===<br />
<br />
Application can be used alongside and synchronized to MessengerCTI.Mobile, Android version for mobile devices.<br />
<br />
<br />
= Minimum requirements =<br />
To install SLICAN MessengerCTI.Desktop application, following minimum requirements must be met:<br />
*CPU Frequency - 800 mhz or higher<br />
*Ram - 1 GB or more<br />
*GPU- compatible with DirectX 9 <br />
*Operating System - Windows 7 or more recent<br />
<br />
Application can be installed on computer which doesn't meet minimum requirements but it will run slowly or some option won't work correctly.<br />
{{Attention!|<br />
'''MessengerCTI.Desktop''' application works with IPx, Mac and CCT PBX with firmware 6.52 or newer, or NCP PBX with firmware 1.10}}<br />
<br />
= Installation of application =<br />
<br />
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 computer. After installing, application should be properly configured by entering necessary PBX information to which software should be conencted:<br />
Settings - Connection.<br />
{{Attention!|<br />
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.}}<br />
<br />
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"<br />
<br />
== Running application ==<br />
<br />
MessengerCTI.Dekstop can be run just as any other Windows compatible software. In the program settings automatic start during launch of operating system can bet set. During start of program it is logging to PBX(according to settings set in Settings - Connection tab). After successful login program data is synchronized with PBX data.<br />
<br />
== Updating application ==<br />
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 <br />
compared to version on PBX. If they differ, version from PBX is automaticly downloaded, installed and logged to PBX. Depending on version from PBX it may install newer or old version.<br />
<br />
= Available configurations =<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned off) - calling with phone, application - dialling up outgoing calls for phone(CTS, FXS, SIP) and picking up incoming calls for phone (CTS)<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned on) independent choice of picking/dialing up call with phone or application.<br />
*Autonomous application without desk phone (application VoIP mode on) - picking/dialling calls only with application.<br />
<br />
Other functionalities for example chat, sending and receiving SMS, displaying video from camera, accessing call history and phone book, configuring user status and Messenger aplication are available for each of the above configurations.<br />
<br />
Application '''MessengerCTI.Mobile''' is intended for mobile devices with Android system, its description can be found HERE(manual in progress).<br />
<br />
== '''MessengerCTI.Desktop''' with simultaneous configuration ==<br />
<br />
===Application with VoIP mode turned OFF.===<br />
<br />
Phone calls are made only using phone working alongside application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, dialling with phone speaker using CTS phone<br />
*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.<br />
<br />
For user of FXS nad SIP phones picking up earphone is necessary.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_VoIP.png |800px]]</center><br />
<br />
===Application with VoIP mode turned ON.===<br />
<br />
Phone calls can are made with phone or with computer and application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_with_phone.png |800px]]</center><br />
<br />
== '''MessengerCTI.Desktop''' working as standalone phone (only with NCP)==<br />
<br />
===Application with VoIP mode turned on.===<br />
<br />
Phone calls are made only with computer and application. Standalone applications allows:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_phone.png |800px]]</center><br />
<br />
= Program structure =<br />
==Main window==<br />
Main windows of MessengerCTI.Desktop application contains interface which show information and allows access to chat windows and main functions.<br />
<center>[[File:MessengerCTI_main_window.PNG]]</center><br />
===Upper part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_-_main_window_-_upper.png]]<br />
*left side<br />
**hyperlink to software version<br />
<br />
*right side<br />
**default window position button<br />
**close - minimizing to tray button<br />
<br />
===Middle part of window:===<br />
<br />
[[File:MessengerCTIDesktop_-_main_window_-_middle.png]]<br />
*left side:<br />
**changing application status button<br />
<br />
*middle: program name,below - user status - field that can by user to provide additional urlop, for example to inform about vacation or being busy with project<br />
<br />
*right side:<br />
**searching (magnifying glass) - button/field for searching number or contact<br />
**preferences - access to program settings<br />
<br />
===Lower part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_main_window_lower.PNG]]<br />
*access to tabs:<br />
**contacts - phonebook from bx with sorting options<br />
**recent - history of most recent calls and messages.<br />
<br />
== Status of application and user ==<br />
'''MessengerCTI.Dekstop''' software allows to show current status of user with coloured symbol and display it inside applications of other users. Applications status is informing about user availability, depending on user actions status can be changed by him or application can change it automatically. More information can be added through text status of user. User can choose different icons/symbol to set his status manually. Additionally there is graphic informing about ringing phone or current call.<br />
<br />
===List of icons and symbols===<br />
Chart presents list of icons available in '''Contacts''' and '''Recent''' tabs:<br />
<br />
* [[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.<br />
* [[File:MessengerCTI_history.png | 32px]] - for public subscribers.<br />
* [[File:MessengerCTI_close_door.png | 32px]] - for DPH.IP doorphones connected to open/closed door sensor<br />
<br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Status of application and DPH.IP doorphones<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_green.png | 32px]] ||PBX subscriber; '''MessengerCTI.Desktop''' application is running '''and and LOGGED IN'''from subscriber computer. Clicking icon will allow to send text messeger, SMS or dial a call to another application user.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_chat_tv_yellow.png | 29px]] ||PBX subscriber; '''Be right back''' set by user or application, delay time is definied in general settings of application.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_red.png | 32px]] ||PBX subscriber; '''Do not disturb''' set by user<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_grey.png | 32px]] ||PBX subscriber; '''Invisible''' set by user or application is logged off.<br />
|-<br />
|{{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)<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_history.png | 32px]] ||public subscriber; clicking icon will allow to send SMS or dial call to chosen subscriber.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_close_door.png | 32px]] ||doorphone; current door position - door closed, clicking icon will open door<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_open_door.png | 32px]] ||doorphone; door are open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_alarm_open_door.png | 32px]] ||doorphone; alarm timer for open doors was set off<br />
|-<br />
|}<br />
'''''Chart 1:''''' Meaning of icon status of application, users and doorphones.<br><br />
<br />
Chart is showing list if icon that appear on the left side of subscriber name in tab '''Contacts''' and '''Recent'''. Internal phone will have status icon being displayed<br />
<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Phone status and camera information<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_bell_red.png | 28px]] ||Phone is ringing<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_phone_red.png | 32px]] || During call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_camera.png | 25px]] ||Camera is associeted with phone or doorphone, clicking on icon will allow to preview camera video<br />
|-<br />
|}<br />
</center><br />
<center>'''''Tabela 2:''''' Icons displaying status of phone and camera</center><br />
<br />
== Preferences==<br />
<br />
Clicking '''Preferences''' icon in main program window will display window with program settings. In every tab there is available button with info "About software" and reseting default window position.<br />
<br />
=== Connection===<br />
In '''''Connection''''' field you must enter settings neccesary for application to connect:<br />
<br />
<center>[[File:MessengerCTI_connection.PNG]]</center><br />
<br />
'''Application login setting'''<br />
<br />
To login, application must have correct settings configured by PBX administrator: <br />
* subscriber numbers - extensions from PBX<br />
* CTI access and password:<br />
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/Settings CTI''' - '''CTI - access level''' and pasword'''Pss'''<br />
** for NCP - '''ConfigWEB''' chart '''Extensions/Subscribers/CTI setting''' - '''CTI Access''' and '''Password'''<br />
* Server address - PBX network settings<br />
CTI access level determines what options are available to application:<br />
* CTI.user - MessengerCTI without VoIP and camera preview<br />
* CTI.userPlus - MessengerCTI with VoIP and camera preview<br />
<br />
<br />
These connections settings must be filled:<br />
* '''Subscribers" field - extension number for which '''MessengerCTI.Dekstop''' will login.<br />
* '''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. <br />
* '''server IP address''' - IP address of PBX network interface. IP address of PBX network port. In case of logging outside od PBX network, IP address of edge router(port forwarding on router is necessary, 5529 TCP, 8100-8300 UDP for IPx, 10000-30000 UDP for NCP on PBX LAN interface).<br />
<br />
After user will change his password, administrator no longer will have access to this passowrd. Application can be set to remember user password by checking field while login in, if field wasn't checked application will always ask for password during every login.<br />
<br />
<br />
After proper 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. "Successful login" will apear in lower part of window.<br />
<br />
<br />
If login credentials, configuration settings aren't correct or there are issue with network connection those error messages may appear:<br />
* ''Wrong login or password. Check if correct login or password was used.''<br />
* ''Connecting to PBX'' alternating with<br />
* ''No connection to PBX'' Check IP address that was entered and check computer LAN connection.<br />
<br />
===General===<br />
<br />
<br />
<center>[[File:MessengerCTI_general_settings.PNG]]</center><br />
<br />
This window allows to configure settings defining how program works and startup options.<br />
Available settings:<br />
*Auto start on System startup - automatic start of application.<br />
*Start minimized - application will run hidden in system task bar.<br />
*Set "Be right back" state after - status icon will change automatically, informing about user being away from computer after defined time.<br />
*Set shortcut for application window - changes application from Windows task bar to desktop and vice versa.<br />
*Choose double click function(for contact or number):<br />
**show call window - choice windows is displayed with options - number, phone call, opening chat/SMS window, closing current window<br />
**call primary number - automatic number dialling<br />
**show last events - recent call history to particular subscriber is displayed.<br />
*Set this window position as default - allows to set up default application's window potion on screen.<br />
<br />
===Audio settings===<br />
These setting allow to set up audio notifications informing about incoming calls and messages and audio setting of computer audio devices.<br />
<br />
<br />
<center>[[File:MessengerCTI_audio_settings.PNG]]</center><br />
<br />
*Enable VoIP on when available - allows application to work as VoIP client(VoIP phone)<br />
<br />
<center>[[File:MessengerCTI_voip_settings.PNG]]</center><br />
<br />
==Dialing and picking up calls==<br />
To set up call between two users, particular hardware, software and proper configuration must be supplied:<br />
*Slican PBX<br />
*computer with installed and configured MessengerCTI.Desktop software<br />
**software logged to PBX with subscriber extension(Settings tab, Connection field)<br />
*analog, VoIP or Slican system phone<br />
*for video preview - DPH.IP doorphone with camera or phone associated with external camera(doesn't apply to VoIP phones with integrated camera)<br />
<br />
Call can be dialled using computer mouse and computer screen. Call is made between subscribers through phone connected to PBX and associated with MessengerCTI.Desktop. After choosing subscriber number to call and dialling call, PBX will call extension choosing number(to inform about being ready to set up connection), after picking up handset PBX will set up calling connection.<br />
<br />
==='''Dialing calls to particular number'''===<br />
<center>[[File:MessengerCTI_outgoing_call_window.png]]</center><br />
Making calls can be realised in few different way. Depending on how configured are general setting on application - option "Set double click function".<br />
* from '''Contacts''' tab<br />
**choose subscriber from proper group(if applicable) or from group "All contacts" by double clicking on number or contact<br />
**clicking on [[File:MessengerCTI_tv_green.png | 32px]] or [[File:MessengerCTI_history.png | 32px]]<br />
*'''Search''' field - by directly entering phone number with computer keyboard then clicking on green phone icon.<br />
*'''Recent''' tab - call history:<br />
**history of call with particular subscriber can be seen here, call is dialled by double click on number or contact<br />
**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]]<br />
<br />
==='''Incoming calls'''===<br />
<br />
<center>[[File:MessengerCTI_incoming_window.png]]</center><br />
Calls are displayed on computer screen with pop-up window, ringing application and ringing phone. Depending on applied configuration call can be picked up with application or phone.<br />
<br />
==='''Connecting to camera video preview'''===<br />
Connecting to/from DPH.IP with integrated camera or associated phone or external IP camera(doesn't apply to VoIP phone with integrated cameras)will display automatically new window on computer screen. Connecting to doorphone allows to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.<br />
<br />
<center>[[File:MessengerCTI_camera_preview.png]]</center><br />
<br />
<br />
<br />
===Transfering calls - version 1.03===<br />
Call can be transfered by choosing contact or number from: Recent or Contacts.<br />
* "blind transfer" - without checking target extensions state<br />
<center>[[File:MessengerCTI_blind_transfer.png | 700px]]</center><br />
<br />
<br />
* no announcing - check target extension state without announcing <br />
<center>[[File:MessengerCTI_no_announcing.png | 700px]]</center><br />
<br />
<br />
* with annoucing - check target extension state with announcing <br />
<center>[[File:MessengerCTI_with_announcing.png | 700px]]</center><br />
<br />
==Sending messages==<br />
Application allow sending(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.<br />
<br />
Receving new message is signalised on Windows system task bar with two icons alternating [[File:MessengerCTI_free.png | 32px]], [[File:MessengerCTI_mail.png | 32px]] and popping up [[File:MessengerCTI_new_message.png]].<br />
<br />
Messages history is available through hyper link '''Load previous'''. It is stored on computer local hard drive.<br />
<br />
<center>[[File:MessengerCTI_chat.png]]</center><br />
<br />
==Searching data==<br />
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Contacts''' tab in '''Search''':<br />
<br />
<br />
<center>[[File:MessengerCT_search_field.PNG]]</center><br />
<br />
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'''.<br />
<br />
== Contacts==<br />
This field allows for searching, displaying, customising and running actions related to contact. By default '''Favourites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.<br />
<br />
<center>[[File:MessengerCTI_contacts2.png]]</center><br />
<br />
Adding contacts is possible:<br />
<br />
* from search field - entering number and adding it with green handset icon<br />
* from '''Contacts''' or '''Recent''' tab - right clicking on connection<br />
<br />
From contact list we gain access to:<br />
*favourites<br />
*all contacts<br />
*extensions<br />
*created subscriber groups<br />
*public contacts<br />
*private contacts<br />
<br />
== Call history ==<br />
Choosing '''Recent''' tab - in main program window will display call history of currently logged extension to '''''MessengerCTI.Desktop'''''. Window will look like this.<br />
<br />
<br />
<center>[[File:MessengerCTI_recent.PNG]]</center><br />
<br />
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:<br />
<br />
[[File:MessengerCTI_outgoing_calls.PNG | 32px]]<br />
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.<br />
<br />
[[File:MessengerCTI_incoming_calls.PNG | 32px]]<br />
Downward arrow for incoming call that was picked up.<br />
<br />
[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]<br />
Turned arrow for missed incoming calls, digit is showing number of these calls.<br />
<br />
[[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]] [[File:MessengerCTI_message_amount.PNG | 32px]]<br />
Arrow with listed lines or text bubble for text chat or sent SMS. Digit is showing number of missed messages.<br />
If history contains missed calls or unread messages icon in '''Recent''' field will be in colour red.<br />
<br />
From History window call can be dialled or messages be send to chosen users by right clicking on subscribers text status<br />
, clicking on icons [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] and [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]] [[File:MessengerCTI_missed_calls.PNG | 32px]] [[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]]. If internal subscriber have other number listed in their phone book, choice can be made between them. For internal subscribers there is option of editing, deleting contact and deleting from favourite list.<br />
<br />
=MessengerCTI.Desktop for Call Center agents=<br />
Od firmware 1.12 NCP oraz 1.02 MessengerCTI.Desktop w aplikacji pojawiły się funkcjonalności związane z obsługą kolejek Call Center. U użytkownika programu, który w centrali ma włączoną opcję agenta Call Center - w aplikacji na pasku statusu systemu operacyjnego dodatkowo wyświetla się dodatkowa ikona '''Status agenta''' oraz w oknie głównym aplikacji zakładka '''CC'''<br />
Starting from NCP 1.12 firmware and MessengerCTI.Desktop 1.02 firmware, application includes features for servicing Call Center queues.<br />
<br />
<br />
Ikony statusu aplikacji: <br />
* aplikacja zalogowana: [[File:MessengerCTI.Desktop status zalogowany.png | 40px]]<br />
* aplikacja w stanie: '''Zaraz wracam''' [[File:MessengerCTI.Desktop status zaraz wracam.png | 40px]]<br />
Czerwona kropka przy statusie aplikacji wskazuje na nieodebrane połączenie lub wiadomość do użytkownika numeru.<br />
<br />
<br />
<br />
Ikony statusu Agenta: <br />
* agent zalogowany do kolejki: [[File:MessengerCTI.Desktop agent zalogowany.png | 40px]]<br />
* przerwa agenta: [[File:MessengerCTI.Desktop przerwa agenta.png | 40px]]<br />
* agent wylogowny z kolejki: [[File:MessengerCTI.Desktop agent wylogowany.png | 40px]]<br />
Czerwona kropka przy statusie agenta wskazuje na nieodebrane połączenie przez agentów kolejki CC.<br />
<br />
<br />
<br />
W zakładce '''CC''' aplikacji w zależności od przyjętej konfiguracji wyświetlane są:<br />
* do 4 zaprogramowanych przycisków wraz z aktualnym jej stanem dla danego agenta: '''Logowanie/wylogowanie z kolejki CC''' oraz '''Włączenie/wyłączenie przerwy agenta'''<br />
* obsługiwane kolejki z liczbą zalogowanych do niej agentów oraz oczekujących aktualnie w kolejce<br />
* lista nieodebranych połączeń - numerów/kontaktów do oddzwonienia<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop zakładka CC.png]]</center><br />
<br />
W przypadku korzystania z listy oddzwonienia pojawia się dodatkowe okno z możliwością nawiązania połączenia oraz polem potwierdzenia czy oddzwonienie było skuteczne.<br />
<br />
<br />
<br />
W celu odpowiedniego skonfigurowania zakładki '''CC''' należy w preferencjach aplikacji prawidłowo skonfigurować zakładkę '''Call Center'''<br />
<br />
<center>[[File:MessengerCTI.Desktop konfiguracja CC.png]]</center><br />
<br />
=Licensing=<br />
==IPX, MAC, CCT PBX==<br />
MessengerCTI.Desktop application:<br />
* 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.<br />
* for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
* calls made form application in VoIP mode are using VoIP channels just like other VoIP devices<br />
* MessengerCTI.Dekstop configured without VoIP and camera preview access - CTIuser license is required<br />
* MessengerCTI.Desktop configured with VoIP and camera preview access - CTIuserplus license is required<br />
<br />
==NCP PBX==<br />
MessengerCTI.Desktop:<br />
* CAN be associated with any subscriber port - analogue, system or VoIP; each subscriber port is treated as 1 user from Base license, additionally while associating application with VoIP port 1 NCP.VoIPuser license is neccesary<br />
** for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
** MessengerCTI.Desktop configured without VoIP and no camera preview access - NCP.CTIuser is required<br />
** MessengerCTI.Desktop configured with VoIP and camera preview access - NCP.CTIuserPlus license is required<br />
* MessengerCTI.Dekstop as standalone subscriber - MCTI (not associated with subscriber port):<br />
** Messenger.CTI Dekstop with VoIP funcionality and camera preview access - NCP.VoIPuser and NCP.CTIuserPlus licenses are required<br />
<br />
=One user and few different numbers=<br />
Sometimes one computer use must operate with few different extensions umber. On workstation(computer) use of "instance" is neccesary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create seperate configuration.<br />
<br />
* default location of program instalation is: C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe<br />
** 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 llok for MessengerCTI, right click -> More/ Open File Location - program icon will appear, right click -> Properties/Shortcut/Target<br />
* create program shortcut on desktop<br />
* in shortcut properties add instance - Properties/Shortcut/Target: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''<br />
* 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''', ...<br />
* while running aplication from shortcuts we can configure each one seperatly for different numbers</div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI_Manual&diff=7847MessengerCTI Manual2020-02-13T08:45:27Z<p>Marekg: /* MessengerCTI.Desktop dla agenta Call Center */</p>
<hr />
<div>= Introduction =<br />
Slican '''MessengerCTI.Desktop''' is software which purpose is to assist users of Slican PBX. Thanks to the graphic interface displayed on the computer screen, software allows for convenient access of telephone calls and other functions related to it. Software delivers additional features that allows to expand capabilities of desk phone. Software combines capabilities of controlling desk phone connected to PBX, for example choosing number, receiving calls and also application is able to function as standalone phone. Software also allows to: accessing PBX's phonebook, call history, status of phone and other users of MessengerCTI, text communication and sending or receiving SMS messages. Additionally for new version of DPH.IP doorphone equipped with camera - video preview was added.<br />
<br />
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). Users of analogue phones will benefit from this software because they'll gain access to functions that aren't available on these types of devices.<br />
<br />
= Basic functionalities =<br />
<br />
=== Using cameras and DPH.IP doorphones ===<br />
<br />
Introduction of DPH.IP doorphones that include cameras led to solution that allows display of video from these cameras. Functionality was added with MessengerCTI.Desktop. While connecting to doorphone from software video from camera will appear in new window on computer display. After picking up and finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door,gate, using dedicated button. Reverse is also true, calling doorphone or another telephone number associated with camera, display screen will show video from camera. This allow for temporary observation of surroundings of installed camera, for example person we are calling. There is also option of watching video from any camera without making call, just using application icon. Thanks to MessengerCTI.Desktop user can preview video from camera of other manufacturers but those devices have to support video formats, codec compatible with VLC application libraries.<br />
<br />
{{Attention!|<br />
MessengerCTI.Desktop application was released mainly for displaying video from DPH.IP doorphones and and this time doesn't yet have all fuctionality of PhoneCTI application. Those options will be added gradually}}<br />
<br />
=== VoiP Client===<br />
<br />
MessengerCTI.Desktop can work as VoIP, concurrent phone connected to stationary desk phone(FXS,CTS,IP). User can decide on which device to pick up a call, phone or a computer - using it's integrated audio devices(sound card, microphone, speakers or external headphones). Since 1.11 version of NCP firmware application can be used as standalone SIP phone. For such configuration CTIuserPlus license is required.<br />
<br />
<br />
=== Phone Book ===<br />
<br />
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 possible instantly after adding it. Access to phone book allows to simply search numbers of contacts user want to call. On other hand, during incoming calls computer displaying will be showing clear information about calling person.<br />
<br />
=== Call History ===<br />
<br />
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.<br />
<br />
=== Text messages ===<br />
<br />
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.<br />
<br />
=== Usage alongside mobile version ===<br />
<br />
Application can be used alongside and synchronized to MessengerCTI.Mobile, Android version for mobile devices.<br />
<br />
<br />
= Minimum requirements =<br />
To install SLICAN MessengerCTI.Desktop application, following minimum requirements must be met:<br />
*CPU Frequency - 800 mhz or higher<br />
*Ram - 1 GB or more<br />
*GPU- compatible with DirectX 9 <br />
*Operating System - Windows 7 or more recent<br />
<br />
Application can be installed on computer which doesn't meet minimum requirements but it will run slowly or some option won't work correctly.<br />
{{Attention!|<br />
'''MessengerCTI.Desktop''' application works with IPx, Mac and CCT PBX with firmware 6.52 or newer, or NCP PBX with firmware 1.10}}<br />
<br />
= Installation of application =<br />
<br />
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 computer. After installing, application should be properly configured by entering necessary PBX information to which software should be conencted:<br />
Settings - Connection.<br />
{{Attention!|<br />
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.}}<br />
<br />
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"<br />
<br />
== Running application ==<br />
<br />
MessengerCTI.Dekstop can be run just as any other Windows compatible software. In the program settings automatic start during launch of operating system can bet set. During start of program it is logging to PBX(according to settings set in Settings - Connection tab). After successful login program data is synchronized with PBX data.<br />
<br />
== Updating application ==<br />
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 <br />
compared to version on PBX. If they differ, version from PBX is automaticly downloaded, installed and logged to PBX. Depending on version from PBX it may install newer or old version.<br />
<br />
= Available configurations =<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned off) - calling with phone, application - dialling up outgoing calls for phone(CTS, FXS, SIP) and picking up incoming calls for phone (CTS)<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned on) independent choice of picking/dialing up call with phone or application.<br />
*Autonomous application without desk phone (application VoIP mode on) - picking/dialling calls only with application.<br />
<br />
Other functionalities for example chat, sending and receiving SMS, displaying video from camera, accessing call history and phone book, configuring user status and Messenger aplication are available for each of the above configurations.<br />
<br />
Application '''MessengerCTI.Mobile''' is intended for mobile devices with Android system, its description can be found HERE(manual in progress).<br />
<br />
== '''MessengerCTI.Desktop''' with simultaneous configuration ==<br />
<br />
===Application with VoIP mode turned OFF.===<br />
<br />
Phone calls are made only using phone working alongside application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, dialling with phone speaker using CTS phone<br />
*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.<br />
<br />
For user of FXS nad SIP phones picking up earphone is necessary.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_VoIP.png |800px]]</center><br />
<br />
===Application with VoIP mode turned ON.===<br />
<br />
Phone calls can are made with phone or with computer and application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_with_phone.png |800px]]</center><br />
<br />
== '''MessengerCTI.Desktop''' working as standalone phone (only with NCP)==<br />
<br />
===Application with VoIP mode turned on.===<br />
<br />
Phone calls are made only with computer and application. Standalone applications allows:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_phone.png |800px]]</center><br />
<br />
= Program structure =<br />
==Main window==<br />
Main windows of MessengerCTI.Desktop application contains interface which show information and allows access to chat windows and main functions.<br />
<center>[[File:MessengerCTI_main_window.PNG]]</center><br />
===Upper part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_-_main_window_-_upper.png]]<br />
*left side<br />
**hyperlink to software version<br />
<br />
*right side<br />
**default window position button<br />
**close - minimizing to tray button<br />
<br />
===Middle part of window:===<br />
<br />
[[File:MessengerCTIDesktop_-_main_window_-_middle.png]]<br />
*left side:<br />
**changing application status button<br />
<br />
*middle: program name,below - user status - field that can by user to provide additional urlop, for example to inform about vacation or being busy with project<br />
<br />
*right side:<br />
**searching (magnifying glass) - button/field for searching number or contact<br />
**preferences - access to program settings<br />
<br />
===Lower part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_main_window_lower.PNG]]<br />
*access to tabs:<br />
**contacts - phonebook from bx with sorting options<br />
**recent - history of most recent calls and messages.<br />
<br />
== Status of application and user ==<br />
'''MessengerCTI.Dekstop''' software allows to show current status of user with coloured symbol and display it inside applications of other users. Applications status is informing about user availability, depending on user actions status can be changed by him or application can change it automatically. More information can be added through text status of user. User can choose different icons/symbol to set his status manually. Additionally there is graphic informing about ringing phone or current call.<br />
<br />
===List of icons and symbols===<br />
Chart presents list of icons available in '''Contacts''' and '''Recent''' tabs:<br />
<br />
* [[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.<br />
* [[File:MessengerCTI_history.png | 32px]] - for public subscribers.<br />
* [[File:MessengerCTI_close_door.png | 32px]] - for DPH.IP doorphones connected to open/closed door sensor<br />
<br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Status of application and DPH.IP doorphones<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_green.png | 32px]] ||PBX subscriber; '''MessengerCTI.Desktop''' application is running '''and and LOGGED IN'''from subscriber computer. Clicking icon will allow to send text messeger, SMS or dial a call to another application user.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_chat_tv_yellow.png | 29px]] ||PBX subscriber; '''Be right back''' set by user or application, delay time is definied in general settings of application.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_red.png | 32px]] ||PBX subscriber; '''Do not disturb''' set by user<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_grey.png | 32px]] ||PBX subscriber; '''Invisible''' set by user or application is logged off.<br />
|-<br />
|{{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)<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_history.png | 32px]] ||public subscriber; clicking icon will allow to send SMS or dial call to chosen subscriber.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_close_door.png | 32px]] ||doorphone; current door position - door closed, clicking icon will open door<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_open_door.png | 32px]] ||doorphone; door are open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_alarm_open_door.png | 32px]] ||doorphone; alarm timer for open doors was set off<br />
|-<br />
|}<br />
'''''Chart 1:''''' Meaning of icon status of application, users and doorphones.<br><br />
<br />
Chart is showing list if icon that appear on the left side of subscriber name in tab '''Contacts''' and '''Recent'''. Internal phone will have status icon being displayed<br />
<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Phone status and camera information<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_bell_red.png | 28px]] ||Phone is ringing<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_phone_red.png | 32px]] || During call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_camera.png | 25px]] ||Camera is associeted with phone or doorphone, clicking on icon will allow to preview camera video<br />
|-<br />
|}<br />
</center><br />
<center>'''''Tabela 2:''''' Icons displaying status of phone and camera</center><br />
<br />
== Preferences==<br />
<br />
Clicking '''Preferences''' icon in main program window will display window with program settings. In every tab there is available button with info "About software" and reseting default window position.<br />
<br />
=== Connection===<br />
In '''''Connection''''' field you must enter settings neccesary for application to connect:<br />
<br />
<center>[[File:MessengerCTI_connection.PNG]]</center><br />
<br />
'''Application login setting'''<br />
<br />
To login, application must have correct settings configured by PBX administrator: <br />
* subscriber numbers - extensions from PBX<br />
* CTI access and password:<br />
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/Settings CTI''' - '''CTI - access level''' and pasword'''Pss'''<br />
** for NCP - '''ConfigWEB''' chart '''Extensions/Subscribers/CTI setting''' - '''CTI Access''' and '''Password'''<br />
* Server address - PBX network settings<br />
CTI access level determines what options are available to application:<br />
* CTI.user - MessengerCTI without VoIP and camera preview<br />
* CTI.userPlus - MessengerCTI with VoIP and camera preview<br />
<br />
<br />
These connections settings must be filled:<br />
* '''Subscribers" field - extension number for which '''MessengerCTI.Dekstop''' will login.<br />
* '''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. <br />
* '''server IP address''' - IP address of PBX network interface. IP address of PBX network port. In case of logging outside od PBX network, IP address of edge router(port forwarding on router is necessary, 5529 TCP, 8100-8300 UDP for IPx, 10000-30000 UDP for NCP on PBX LAN interface).<br />
<br />
After user will change his password, administrator no longer will have access to this passowrd. Application can be set to remember user password by checking field while login in, if field wasn't checked application will always ask for password during every login.<br />
<br />
<br />
After proper 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. "Successful login" will apear in lower part of window.<br />
<br />
<br />
If login credentials, configuration settings aren't correct or there are issue with network connection those error messages may appear:<br />
* ''Wrong login or password. Check if correct login or password was used.''<br />
* ''Connecting to PBX'' alternating with<br />
* ''No connection to PBX'' Check IP address that was entered and check computer LAN connection.<br />
<br />
===General===<br />
<br />
<br />
<center>[[File:MessengerCTI_general_settings.PNG]]</center><br />
<br />
This window allows to configure settings defining how program works and startup options.<br />
Available settings:<br />
*Auto start on System startup - automatic start of application.<br />
*Start minimized - application will run hidden in system task bar.<br />
*Set "Be right back" state after - status icon will change automatically, informing about user being away from computer after defined time.<br />
*Set shortcut for application window - changes application from Windows task bar to desktop and vice versa.<br />
*Choose double click function(for contact or number):<br />
**show call window - choice windows is displayed with options - number, phone call, opening chat/SMS window, closing current window<br />
**call primary number - automatic number dialling<br />
**show last events - recent call history to particular subscriber is displayed.<br />
*Set this window position as default - allows to set up default application's window potion on screen.<br />
<br />
===Audio settings===<br />
These setting allow to set up audio notifications informing about incoming calls and messages and audio setting of computer audio devices.<br />
<br />
<br />
<center>[[File:MessengerCTI_audio_settings.PNG]]</center><br />
<br />
*Enable VoIP on when available - allows application to work as VoIP client(VoIP phone)<br />
<br />
<center>[[File:MessengerCTI_voip_settings.PNG]]</center><br />
<br />
==Dialing and picking up calls==<br />
To set up call between two users, particular hardware, software and proper configuration must be supplied:<br />
*Slican PBX<br />
*computer with installed and configured MessengerCTI.Desktop software<br />
**software logged to PBX with subscriber extension(Settings tab, Connection field)<br />
*analog, VoIP or Slican system phone<br />
*for video preview - DPH.IP doorphone with camera or phone associated with external camera(doesn't apply to VoIP phones with integrated camera)<br />
<br />
Call can be dialled using computer mouse and computer screen. Call is made between subscribers through phone connected to PBX and associated with MessengerCTI.Desktop. After choosing subscriber number to call and dialling call, PBX will call extension choosing number(to inform about being ready to set up connection), after picking up handset PBX will set up calling connection.<br />
<br />
==='''Dialing calls to particular number'''===<br />
<center>[[File:MessengerCTI_outgoing_call_window.png]]</center><br />
Making calls can be realised in few different way. Depending on how configured are general setting on application - option "Set double click function".<br />
* from '''Contacts''' tab<br />
**choose subscriber from proper group(if applicable) or from group "All contacts" by double clicking on number or contact<br />
**clicking on [[File:MessengerCTI_tv_green.png | 32px]] or [[File:MessengerCTI_history.png | 32px]]<br />
*'''Search''' field - by directly entering phone number with computer keyboard then clicking on green phone icon.<br />
*'''Recent''' tab - call history:<br />
**history of call with particular subscriber can be seen here, call is dialled by double click on number or contact<br />
**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]]<br />
<br />
==='''Incoming calls'''===<br />
<br />
<center>[[File:MessengerCTI_incoming_window.png]]</center><br />
Calls are displayed on computer screen with pop-up window, ringing application and ringing phone. Depending on applied configuration call can be picked up with application or phone.<br />
<br />
==='''Connecting to camera video preview'''===<br />
Connecting to/from DPH.IP with integrated camera or associated phone or external IP camera(doesn't apply to VoIP phone with integrated cameras)will display automatically new window on computer screen. Connecting to doorphone allows to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.<br />
<br />
<center>[[File:MessengerCTI_camera_preview.png]]</center><br />
<br />
<br />
<br />
===Transfering calls - version 1.03===<br />
Call can be transfered by choosing contact or number from: Recent or Contacts.<br />
* "blind transfer" - without checking target extensions state<br />
<center>[[File:MessengerCTI_blind_transfer.png | 700px]]</center><br />
<br />
<br />
* no announcing - check target extension state without announcing <br />
<center>[[File:MessengerCTI_no_announcing.png | 700px]]</center><br />
<br />
<br />
* with annoucing - check target extension state with announcing <br />
<center>[[File:MessengerCTI_with_announcing.png | 700px]]</center><br />
<br />
==Sending messages==<br />
Application allow sending(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.<br />
<br />
Receving new message is signalised on Windows system task bar with two icons alternating [[File:MessengerCTI_free.png | 32px]], [[File:MessengerCTI_mail.png | 32px]] and popping up [[File:MessengerCTI_new_message.png]].<br />
<br />
Messages history is available through hyper link '''Load previous'''. It is stored on computer local hard drive.<br />
<br />
<center>[[File:MessengerCTI_chat.png]]</center><br />
<br />
==Searching data==<br />
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Contacts''' tab in '''Search''':<br />
<br />
<br />
<center>[[File:MessengerCT_search_field.PNG]]</center><br />
<br />
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'''.<br />
<br />
== Contacts==<br />
This field allows for searching, displaying, customising and running actions related to contact. By default '''Favourites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.<br />
<br />
<center>[[File:MessengerCTI_contacts2.png]]</center><br />
<br />
Adding contacts is possible:<br />
<br />
* from search field - entering number and adding it with green handset icon<br />
* from '''Contacts''' or '''Recent''' tab - right clicking on connection<br />
<br />
From contact list we gain access to:<br />
*favourites<br />
*all contacts<br />
*extensions<br />
*created subscriber groups<br />
*public contacts<br />
*private contacts<br />
<br />
== Call history ==<br />
Choosing '''Recent''' tab - in main program window will display call history of currently logged extension to '''''MessengerCTI.Desktop'''''. Window will look like this.<br />
<br />
<br />
<center>[[File:MessengerCTI_recent.PNG]]</center><br />
<br />
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:<br />
<br />
[[File:MessengerCTI_outgoing_calls.PNG | 32px]]<br />
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.<br />
<br />
[[File:MessengerCTI_incoming_calls.PNG | 32px]]<br />
Downward arrow for incoming call that was picked up.<br />
<br />
[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]<br />
Turned arrow for missed incoming calls, digit is showing number of these calls.<br />
<br />
[[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]] [[File:MessengerCTI_message_amount.PNG | 32px]]<br />
Arrow with listed lines or text bubble for text chat or sent SMS. Digit is showing number of missed messages.<br />
If history contains missed calls or unread messages icon in '''Recent''' field will be in colour red.<br />
<br />
From History window call can be dialled or messages be send to chosen users by right clicking on subscribers text status<br />
, clicking on icons [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] and [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]] [[File:MessengerCTI_missed_calls.PNG | 32px]] [[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]]. If internal subscriber have other number listed in their phone book, choice can be made between them. For internal subscribers there is option of editing, deleting contact and deleting from favourite list.<br />
<br />
=MessengerCTI.Desktop dla agenta Call Center=<br />
Od firmware 1.12 NCP oraz 1.02 MessengerCTI.Desktop w aplikacji pojawiły się funkcjonalności związane z obsługą kolejek Call Center. U użytkownika programu, który w centrali ma włączoną opcję agenta Call Center - w aplikacji na pasku statusu systemu operacyjnego dodatkowo wyświetla się dodatkowa ikona '''Status agenta''' oraz w oknie głównym aplikacji zakładka '''CC'''<br />
<br />
<br />
Ikony statusu aplikacji: <br />
* aplikacja zalogowana: [[File:MessengerCTI.Desktop status zalogowany.png | 40px]]<br />
* aplikacja w stanie: '''Zaraz wracam''' [[File:MessengerCTI.Desktop status zaraz wracam.png | 40px]]<br />
Czerwona kropka przy statusie aplikacji wskazuje na nieodebrane połączenie lub wiadomość do użytkownika numeru.<br />
<br />
<br />
<br />
Ikony statusu Agenta: <br />
* agent zalogowany do kolejki: [[File:MessengerCTI.Desktop agent zalogowany.png | 40px]]<br />
* przerwa agenta: [[File:MessengerCTI.Desktop przerwa agenta.png | 40px]]<br />
* agent wylogowny z kolejki: [[File:MessengerCTI.Desktop agent wylogowany.png | 40px]]<br />
Czerwona kropka przy statusie agenta wskazuje na nieodebrane połączenie przez agentów kolejki CC.<br />
<br />
<br />
<br />
W zakładce '''CC''' aplikacji w zależności od przyjętej konfiguracji wyświetlane są:<br />
* do 4 zaprogramowanych przycisków wraz z aktualnym jej stanem dla danego agenta: '''Logowanie/wylogowanie z kolejki CC''' oraz '''Włączenie/wyłączenie przerwy agenta'''<br />
* obsługiwane kolejki z liczbą zalogowanych do niej agentów oraz oczekujących aktualnie w kolejce<br />
* lista nieodebranych połączeń - numerów/kontaktów do oddzwonienia<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop zakładka CC.png]]</center><br />
<br />
W przypadku korzystania z listy oddzwonienia pojawia się dodatkowe okno z możliwością nawiązania połączenia oraz polem potwierdzenia czy oddzwonienie było skuteczne.<br />
<br />
<br />
<br />
W celu odpowiedniego skonfigurowania zakładki '''CC''' należy w preferencjach aplikacji prawidłowo skonfigurować zakładkę '''Call Center'''<br />
<br />
<center>[[File:MessengerCTI.Desktop konfiguracja CC.png]]</center><br />
<br />
=Licensing=<br />
==IPX, MAC, CCT PBX==<br />
MessengerCTI.Desktop application:<br />
* 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.<br />
* for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
* calls made form application in VoIP mode are using VoIP channels just like other VoIP devices<br />
* MessengerCTI.Dekstop configured without VoIP and camera preview access - CTIuser license is required<br />
* MessengerCTI.Desktop configured with VoIP and camera preview access - CTIuserplus license is required<br />
<br />
==NCP PBX==<br />
MessengerCTI.Desktop:<br />
* CAN be associated with any subscriber port - analogue, system or VoIP; each subscriber port is treated as 1 user from Base license, additionally while associating application with VoIP port 1 NCP.VoIPuser license is neccesary<br />
** for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
** MessengerCTI.Desktop configured without VoIP and no camera preview access - NCP.CTIuser is required<br />
** MessengerCTI.Desktop configured with VoIP and camera preview access - NCP.CTIuserPlus license is required<br />
* MessengerCTI.Dekstop as standalone subscriber - MCTI (not associated with subscriber port):<br />
** Messenger.CTI Dekstop with VoIP funcionality and camera preview access - NCP.VoIPuser and NCP.CTIuserPlus licenses are required<br />
<br />
=One user and few different numbers=<br />
Sometimes one computer use must operate with few different extensions umber. On workstation(computer) use of "instance" is neccesary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create seperate configuration.<br />
<br />
* default location of program instalation is: C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe<br />
** 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 llok for MessengerCTI, right click -> More/ Open File Location - program icon will appear, right click -> Properties/Shortcut/Target<br />
* create program shortcut on desktop<br />
* in shortcut properties add instance - Properties/Shortcut/Target: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''<br />
* 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''', ...<br />
* while running aplication from shortcuts we can configure each one seperatly for different numbers</div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI_Manual&diff=7846MessengerCTI Manual2020-02-13T08:45:07Z<p>Marekg: /* MessengerCTI.Desktop dla agenta Call Center */</p>
<hr />
<div>= Introduction =<br />
Slican '''MessengerCTI.Desktop''' is software which purpose is to assist users of Slican PBX. Thanks to the graphic interface displayed on the computer screen, software allows for convenient access of telephone calls and other functions related to it. Software delivers additional features that allows to expand capabilities of desk phone. Software combines capabilities of controlling desk phone connected to PBX, for example choosing number, receiving calls and also application is able to function as standalone phone. Software also allows to: accessing PBX's phonebook, call history, status of phone and other users of MessengerCTI, text communication and sending or receiving SMS messages. Additionally for new version of DPH.IP doorphone equipped with camera - video preview was added.<br />
<br />
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). Users of analogue phones will benefit from this software because they'll gain access to functions that aren't available on these types of devices.<br />
<br />
= Basic functionalities =<br />
<br />
=== Using cameras and DPH.IP doorphones ===<br />
<br />
Introduction of DPH.IP doorphones that include cameras led to solution that allows display of video from these cameras. Functionality was added with MessengerCTI.Desktop. While connecting to doorphone from software video from camera will appear in new window on computer display. After picking up and finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door,gate, using dedicated button. Reverse is also true, calling doorphone or another telephone number associated with camera, display screen will show video from camera. This allow for temporary observation of surroundings of installed camera, for example person we are calling. There is also option of watching video from any camera without making call, just using application icon. Thanks to MessengerCTI.Desktop user can preview video from camera of other manufacturers but those devices have to support video formats, codec compatible with VLC application libraries.<br />
<br />
{{Attention!|<br />
MessengerCTI.Desktop application was released mainly for displaying video from DPH.IP doorphones and and this time doesn't yet have all fuctionality of PhoneCTI application. Those options will be added gradually}}<br />
<br />
=== VoiP Client===<br />
<br />
MessengerCTI.Desktop can work as VoIP, concurrent phone connected to stationary desk phone(FXS,CTS,IP). User can decide on which device to pick up a call, phone or a computer - using it's integrated audio devices(sound card, microphone, speakers or external headphones). Since 1.11 version of NCP firmware application can be used as standalone SIP phone. For such configuration CTIuserPlus license is required.<br />
<br />
<br />
=== Phone Book ===<br />
<br />
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 possible instantly after adding it. Access to phone book allows to simply search numbers of contacts user want to call. On other hand, during incoming calls computer displaying will be showing clear information about calling person.<br />
<br />
=== Call History ===<br />
<br />
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.<br />
<br />
=== Text messages ===<br />
<br />
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.<br />
<br />
=== Usage alongside mobile version ===<br />
<br />
Application can be used alongside and synchronized to MessengerCTI.Mobile, Android version for mobile devices.<br />
<br />
<br />
= Minimum requirements =<br />
To install SLICAN MessengerCTI.Desktop application, following minimum requirements must be met:<br />
*CPU Frequency - 800 mhz or higher<br />
*Ram - 1 GB or more<br />
*GPU- compatible with DirectX 9 <br />
*Operating System - Windows 7 or more recent<br />
<br />
Application can be installed on computer which doesn't meet minimum requirements but it will run slowly or some option won't work correctly.<br />
{{Attention!|<br />
'''MessengerCTI.Desktop''' application works with IPx, Mac and CCT PBX with firmware 6.52 or newer, or NCP PBX with firmware 1.10}}<br />
<br />
= Installation of application =<br />
<br />
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 computer. After installing, application should be properly configured by entering necessary PBX information to which software should be conencted:<br />
Settings - Connection.<br />
{{Attention!|<br />
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.}}<br />
<br />
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"<br />
<br />
== Running application ==<br />
<br />
MessengerCTI.Dekstop can be run just as any other Windows compatible software. In the program settings automatic start during launch of operating system can bet set. During start of program it is logging to PBX(according to settings set in Settings - Connection tab). After successful login program data is synchronized with PBX data.<br />
<br />
== Updating application ==<br />
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 <br />
compared to version on PBX. If they differ, version from PBX is automaticly downloaded, installed and logged to PBX. Depending on version from PBX it may install newer or old version.<br />
<br />
= Available configurations =<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned off) - calling with phone, application - dialling up outgoing calls for phone(CTS, FXS, SIP) and picking up incoming calls for phone (CTS)<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned on) independent choice of picking/dialing up call with phone or application.<br />
*Autonomous application without desk phone (application VoIP mode on) - picking/dialling calls only with application.<br />
<br />
Other functionalities for example chat, sending and receiving SMS, displaying video from camera, accessing call history and phone book, configuring user status and Messenger aplication are available for each of the above configurations.<br />
<br />
Application '''MessengerCTI.Mobile''' is intended for mobile devices with Android system, its description can be found HERE(manual in progress).<br />
<br />
== '''MessengerCTI.Desktop''' with simultaneous configuration ==<br />
<br />
===Application with VoIP mode turned OFF.===<br />
<br />
Phone calls are made only using phone working alongside application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, dialling with phone speaker using CTS phone<br />
*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.<br />
<br />
For user of FXS nad SIP phones picking up earphone is necessary.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_VoIP.png |800px]]</center><br />
<br />
===Application with VoIP mode turned ON.===<br />
<br />
Phone calls can are made with phone or with computer and application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_with_phone.png |800px]]</center><br />
<br />
== '''MessengerCTI.Desktop''' working as standalone phone (only with NCP)==<br />
<br />
===Application with VoIP mode turned on.===<br />
<br />
Phone calls are made only with computer and application. Standalone applications allows:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_phone.png |800px]]</center><br />
<br />
= Program structure =<br />
==Main window==<br />
Main windows of MessengerCTI.Desktop application contains interface which show information and allows access to chat windows and main functions.<br />
<center>[[File:MessengerCTI_main_window.PNG]]</center><br />
===Upper part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_-_main_window_-_upper.png]]<br />
*left side<br />
**hyperlink to software version<br />
<br />
*right side<br />
**default window position button<br />
**close - minimizing to tray button<br />
<br />
===Middle part of window:===<br />
<br />
[[File:MessengerCTIDesktop_-_main_window_-_middle.png]]<br />
*left side:<br />
**changing application status button<br />
<br />
*middle: program name,below - user status - field that can by user to provide additional urlop, for example to inform about vacation or being busy with project<br />
<br />
*right side:<br />
**searching (magnifying glass) - button/field for searching number or contact<br />
**preferences - access to program settings<br />
<br />
===Lower part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_main_window_lower.PNG]]<br />
*access to tabs:<br />
**contacts - phonebook from bx with sorting options<br />
**recent - history of most recent calls and messages.<br />
<br />
== Status of application and user ==<br />
'''MessengerCTI.Dekstop''' software allows to show current status of user with coloured symbol and display it inside applications of other users. Applications status is informing about user availability, depending on user actions status can be changed by him or application can change it automatically. More information can be added through text status of user. User can choose different icons/symbol to set his status manually. Additionally there is graphic informing about ringing phone or current call.<br />
<br />
===List of icons and symbols===<br />
Chart presents list of icons available in '''Contacts''' and '''Recent''' tabs:<br />
<br />
* [[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.<br />
* [[File:MessengerCTI_history.png | 32px]] - for public subscribers.<br />
* [[File:MessengerCTI_close_door.png | 32px]] - for DPH.IP doorphones connected to open/closed door sensor<br />
<br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Status of application and DPH.IP doorphones<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_green.png | 32px]] ||PBX subscriber; '''MessengerCTI.Desktop''' application is running '''and and LOGGED IN'''from subscriber computer. Clicking icon will allow to send text messeger, SMS or dial a call to another application user.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_chat_tv_yellow.png | 29px]] ||PBX subscriber; '''Be right back''' set by user or application, delay time is definied in general settings of application.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_red.png | 32px]] ||PBX subscriber; '''Do not disturb''' set by user<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_grey.png | 32px]] ||PBX subscriber; '''Invisible''' set by user or application is logged off.<br />
|-<br />
|{{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)<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_history.png | 32px]] ||public subscriber; clicking icon will allow to send SMS or dial call to chosen subscriber.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_close_door.png | 32px]] ||doorphone; current door position - door closed, clicking icon will open door<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_open_door.png | 32px]] ||doorphone; door are open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_alarm_open_door.png | 32px]] ||doorphone; alarm timer for open doors was set off<br />
|-<br />
|}<br />
'''''Chart 1:''''' Meaning of icon status of application, users and doorphones.<br><br />
<br />
Chart is showing list if icon that appear on the left side of subscriber name in tab '''Contacts''' and '''Recent'''. Internal phone will have status icon being displayed<br />
<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Phone status and camera information<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_bell_red.png | 28px]] ||Phone is ringing<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_phone_red.png | 32px]] || During call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_camera.png | 25px]] ||Camera is associeted with phone or doorphone, clicking on icon will allow to preview camera video<br />
|-<br />
|}<br />
</center><br />
<center>'''''Tabela 2:''''' Icons displaying status of phone and camera</center><br />
<br />
== Preferences==<br />
<br />
Clicking '''Preferences''' icon in main program window will display window with program settings. In every tab there is available button with info "About software" and reseting default window position.<br />
<br />
=== Connection===<br />
In '''''Connection''''' field you must enter settings neccesary for application to connect:<br />
<br />
<center>[[File:MessengerCTI_connection.PNG]]</center><br />
<br />
'''Application login setting'''<br />
<br />
To login, application must have correct settings configured by PBX administrator: <br />
* subscriber numbers - extensions from PBX<br />
* CTI access and password:<br />
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/Settings CTI''' - '''CTI - access level''' and pasword'''Pss'''<br />
** for NCP - '''ConfigWEB''' chart '''Extensions/Subscribers/CTI setting''' - '''CTI Access''' and '''Password'''<br />
* Server address - PBX network settings<br />
CTI access level determines what options are available to application:<br />
* CTI.user - MessengerCTI without VoIP and camera preview<br />
* CTI.userPlus - MessengerCTI with VoIP and camera preview<br />
<br />
<br />
These connections settings must be filled:<br />
* '''Subscribers" field - extension number for which '''MessengerCTI.Dekstop''' will login.<br />
* '''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. <br />
* '''server IP address''' - IP address of PBX network interface. IP address of PBX network port. In case of logging outside od PBX network, IP address of edge router(port forwarding on router is necessary, 5529 TCP, 8100-8300 UDP for IPx, 10000-30000 UDP for NCP on PBX LAN interface).<br />
<br />
After user will change his password, administrator no longer will have access to this passowrd. Application can be set to remember user password by checking field while login in, if field wasn't checked application will always ask for password during every login.<br />
<br />
<br />
After proper 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. "Successful login" will apear in lower part of window.<br />
<br />
<br />
If login credentials, configuration settings aren't correct or there are issue with network connection those error messages may appear:<br />
* ''Wrong login or password. Check if correct login or password was used.''<br />
* ''Connecting to PBX'' alternating with<br />
* ''No connection to PBX'' Check IP address that was entered and check computer LAN connection.<br />
<br />
===General===<br />
<br />
<br />
<center>[[File:MessengerCTI_general_settings.PNG]]</center><br />
<br />
This window allows to configure settings defining how program works and startup options.<br />
Available settings:<br />
*Auto start on System startup - automatic start of application.<br />
*Start minimized - application will run hidden in system task bar.<br />
*Set "Be right back" state after - status icon will change automatically, informing about user being away from computer after defined time.<br />
*Set shortcut for application window - changes application from Windows task bar to desktop and vice versa.<br />
*Choose double click function(for contact or number):<br />
**show call window - choice windows is displayed with options - number, phone call, opening chat/SMS window, closing current window<br />
**call primary number - automatic number dialling<br />
**show last events - recent call history to particular subscriber is displayed.<br />
*Set this window position as default - allows to set up default application's window potion on screen.<br />
<br />
===Audio settings===<br />
These setting allow to set up audio notifications informing about incoming calls and messages and audio setting of computer audio devices.<br />
<br />
<br />
<center>[[File:MessengerCTI_audio_settings.PNG]]</center><br />
<br />
*Enable VoIP on when available - allows application to work as VoIP client(VoIP phone)<br />
<br />
<center>[[File:MessengerCTI_voip_settings.PNG]]</center><br />
<br />
==Dialing and picking up calls==<br />
To set up call between two users, particular hardware, software and proper configuration must be supplied:<br />
*Slican PBX<br />
*computer with installed and configured MessengerCTI.Desktop software<br />
**software logged to PBX with subscriber extension(Settings tab, Connection field)<br />
*analog, VoIP or Slican system phone<br />
*for video preview - DPH.IP doorphone with camera or phone associated with external camera(doesn't apply to VoIP phones with integrated camera)<br />
<br />
Call can be dialled using computer mouse and computer screen. Call is made between subscribers through phone connected to PBX and associated with MessengerCTI.Desktop. After choosing subscriber number to call and dialling call, PBX will call extension choosing number(to inform about being ready to set up connection), after picking up handset PBX will set up calling connection.<br />
<br />
==='''Dialing calls to particular number'''===<br />
<center>[[File:MessengerCTI_outgoing_call_window.png]]</center><br />
Making calls can be realised in few different way. Depending on how configured are general setting on application - option "Set double click function".<br />
* from '''Contacts''' tab<br />
**choose subscriber from proper group(if applicable) or from group "All contacts" by double clicking on number or contact<br />
**clicking on [[File:MessengerCTI_tv_green.png | 32px]] or [[File:MessengerCTI_history.png | 32px]]<br />
*'''Search''' field - by directly entering phone number with computer keyboard then clicking on green phone icon.<br />
*'''Recent''' tab - call history:<br />
**history of call with particular subscriber can be seen here, call is dialled by double click on number or contact<br />
**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]]<br />
<br />
==='''Incoming calls'''===<br />
<br />
<center>[[File:MessengerCTI_incoming_window.png]]</center><br />
Calls are displayed on computer screen with pop-up window, ringing application and ringing phone. Depending on applied configuration call can be picked up with application or phone.<br />
<br />
==='''Connecting to camera video preview'''===<br />
Connecting to/from DPH.IP with integrated camera or associated phone or external IP camera(doesn't apply to VoIP phone with integrated cameras)will display automatically new window on computer screen. Connecting to doorphone allows to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.<br />
<br />
<center>[[File:MessengerCTI_camera_preview.png]]</center><br />
<br />
<br />
<br />
===Transfering calls - version 1.03===<br />
Call can be transfered by choosing contact or number from: Recent or Contacts.<br />
* "blind transfer" - without checking target extensions state<br />
<center>[[File:MessengerCTI_blind_transfer.png | 700px]]</center><br />
<br />
<br />
* no announcing - check target extension state without announcing <br />
<center>[[File:MessengerCTI_no_announcing.png | 700px]]</center><br />
<br />
<br />
* with annoucing - check target extension state with announcing <br />
<center>[[File:MessengerCTI_with_announcing.png | 700px]]</center><br />
<br />
==Sending messages==<br />
Application allow sending(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.<br />
<br />
Receving new message is signalised on Windows system task bar with two icons alternating [[File:MessengerCTI_free.png | 32px]], [[File:MessengerCTI_mail.png | 32px]] and popping up [[File:MessengerCTI_new_message.png]].<br />
<br />
Messages history is available through hyper link '''Load previous'''. It is stored on computer local hard drive.<br />
<br />
<center>[[File:MessengerCTI_chat.png]]</center><br />
<br />
==Searching data==<br />
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Contacts''' tab in '''Search''':<br />
<br />
<br />
<center>[[File:MessengerCT_search_field.PNG]]</center><br />
<br />
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'''.<br />
<br />
== Contacts==<br />
This field allows for searching, displaying, customising and running actions related to contact. By default '''Favourites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.<br />
<br />
<center>[[File:MessengerCTI_contacts2.png]]</center><br />
<br />
Adding contacts is possible:<br />
<br />
* from search field - entering number and adding it with green handset icon<br />
* from '''Contacts''' or '''Recent''' tab - right clicking on connection<br />
<br />
From contact list we gain access to:<br />
*favourites<br />
*all contacts<br />
*extensions<br />
*created subscriber groups<br />
*public contacts<br />
*private contacts<br />
<br />
== Call history ==<br />
Choosing '''Recent''' tab - in main program window will display call history of currently logged extension to '''''MessengerCTI.Desktop'''''. Window will look like this.<br />
<br />
<br />
<center>[[File:MessengerCTI_recent.PNG]]</center><br />
<br />
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:<br />
<br />
[[File:MessengerCTI_outgoing_calls.PNG | 32px]]<br />
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.<br />
<br />
[[File:MessengerCTI_incoming_calls.PNG | 32px]]<br />
Downward arrow for incoming call that was picked up.<br />
<br />
[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]<br />
Turned arrow for missed incoming calls, digit is showing number of these calls.<br />
<br />
[[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]] [[File:MessengerCTI_message_amount.PNG | 32px]]<br />
Arrow with listed lines or text bubble for text chat or sent SMS. Digit is showing number of missed messages.<br />
If history contains missed calls or unread messages icon in '''Recent''' field will be in colour red.<br />
<br />
From History window call can be dialled or messages be send to chosen users by right clicking on subscribers text status<br />
, clicking on icons [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] and [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]] [[File:MessengerCTI_missed_calls.PNG | 32px]] [[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]]. If internal subscriber have other number listed in their phone book, choice can be made between them. For internal subscribers there is option of editing, deleting contact and deleting from favourite list.<br />
<br />
=MessengerCTI.Desktop dla agenta Call Center=<br />
Od firmware 1.12 NCP oraz 1.02 MessengerCTI.Desktop w aplikacji pojawiły się funkcjonalności związane z obsługą kolejek Call Center. U użytkownika programu, który w centrali ma włączoną opcję agenta Call Center - w aplikacji na pasku statusu systemu operacyjnego dodatkowo wyświetla się dodatkowa ikona '''Status agenta''' oraz w oknie głównym aplikacji zakładka '''CC'''<br />
<br />
<br />
Ikony statusu aplikacji: <br />
* aplikacja zalogowana: [[File:MessengerCTI.Desktop status zalogowany.png | 40px]]<br />
* aplikacja w stanie: '''Zaraz wracam''' [[File:MessengerCTI.Desktop status zaraz wracam.png | 40px]]<br />
Czerwona kropka przy statusie aplikacji wskazuje na nieodebrane połączenie lub wiadomość do użytkownika numeru.<br />
<br />
<br />
<br />
Ikony statusu Agenta: <br />
* agent zalogowany do kolejki: [[File:MessengerCTI.Desktop agent zalogowany.png | 40px]]<br />
* przerwa agenta: [[File:MessengerCTI.Desktop przerwa agenta.png | 40px]]<br />
* agent wylogowny z kolejki: [[File:MessengerCTI.Desktop agent wylogowany.png | 40px]]<br />
Czerwona kropka przy statusie agenta wskazuje na nieodebrane połączenie przez agentów kolejki CC.<br />
<br />
<br />
<br />
W zakładce '''CC''' aplikacji w zależności od przyjętej konfiguracji wyświetlane są:<br />
* do 4 zaprogramowanych przycisków wraz z aktualnym jej stanem dla danego agenta: '''Logowanie/wylogowanie z kolejki CC''' oraz '''Włączenie/wyłączenie przerwy agenta'''<br />
* obsługiwane kolejki z liczbą zalogowanych do niej agentów oraz oczekujących aktualnie w kolejce<br />
* lista nieodebranych połączeń - numerów/kontaktów do oddzwonienia<br />
<br />
<br />
<center>[[Plik:MessengerCTI.Desktop zakładka CC.png]]</center><br />
<br />
W przypadku korzystania z listy oddzwonienia pojawia się dodatkowe okno z możliwością nawiązania połączenia oraz polem potwierdzenia czy oddzwonienie było skuteczne.<br />
<br />
<br />
<br />
W celu odpowiedniego skonfigurowania zakładki '''CC''' należy w preferencjach aplikacji prawidłowo skonfigurować zakładkę '''Call Center'''<br />
<br />
<center>[[Plik:MessengerCTI.Desktop konfiguracja CC.png]]</center><br />
<br />
=Licensing=<br />
==IPX, MAC, CCT PBX==<br />
MessengerCTI.Desktop application:<br />
* 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.<br />
* for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
* calls made form application in VoIP mode are using VoIP channels just like other VoIP devices<br />
* MessengerCTI.Dekstop configured without VoIP and camera preview access - CTIuser license is required<br />
* MessengerCTI.Desktop configured with VoIP and camera preview access - CTIuserplus license is required<br />
<br />
==NCP PBX==<br />
MessengerCTI.Desktop:<br />
* CAN be associated with any subscriber port - analogue, system or VoIP; each subscriber port is treated as 1 user from Base license, additionally while associating application with VoIP port 1 NCP.VoIPuser license is neccesary<br />
** for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
** MessengerCTI.Desktop configured without VoIP and no camera preview access - NCP.CTIuser is required<br />
** MessengerCTI.Desktop configured with VoIP and camera preview access - NCP.CTIuserPlus license is required<br />
* MessengerCTI.Dekstop as standalone subscriber - MCTI (not associated with subscriber port):<br />
** Messenger.CTI Dekstop with VoIP funcionality and camera preview access - NCP.VoIPuser and NCP.CTIuserPlus licenses are required<br />
<br />
=One user and few different numbers=<br />
Sometimes one computer use must operate with few different extensions umber. On workstation(computer) use of "instance" is neccesary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create seperate configuration.<br />
<br />
* default location of program instalation is: C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe<br />
** 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 llok for MessengerCTI, right click -> More/ Open File Location - program icon will appear, right click -> Properties/Shortcut/Target<br />
* create program shortcut on desktop<br />
* in shortcut properties add instance - Properties/Shortcut/Target: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''<br />
* 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''', ...<br />
* while running aplication from shortcuts we can configure each one seperatly for different numbers</div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI_Manual&diff=7845MessengerCTI Manual2020-02-13T08:27:51Z<p>Marekg: /* Licensing */</p>
<hr />
<div>= Introduction =<br />
Slican '''MessengerCTI.Desktop''' is software which purpose is to assist users of Slican PBX. Thanks to the graphic interface displayed on the computer screen, software allows for convenient access of telephone calls and other functions related to it. Software delivers additional features that allows to expand capabilities of desk phone. Software combines capabilities of controlling desk phone connected to PBX, for example choosing number, receiving calls and also application is able to function as standalone phone. Software also allows to: accessing PBX's phonebook, call history, status of phone and other users of MessengerCTI, text communication and sending or receiving SMS messages. Additionally for new version of DPH.IP doorphone equipped with camera - video preview was added.<br />
<br />
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). Users of analogue phones will benefit from this software because they'll gain access to functions that aren't available on these types of devices.<br />
<br />
= Basic functionalities =<br />
<br />
=== Using cameras and DPH.IP doorphones ===<br />
<br />
Introduction of DPH.IP doorphones that include cameras led to solution that allows display of video from these cameras. Functionality was added with MessengerCTI.Desktop. While connecting to doorphone from software video from camera will appear in new window on computer display. After picking up and finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door,gate, using dedicated button. Reverse is also true, calling doorphone or another telephone number associated with camera, display screen will show video from camera. This allow for temporary observation of surroundings of installed camera, for example person we are calling. There is also option of watching video from any camera without making call, just using application icon. Thanks to MessengerCTI.Desktop user can preview video from camera of other manufacturers but those devices have to support video formats, codec compatible with VLC application libraries.<br />
<br />
{{Attention!|<br />
MessengerCTI.Desktop application was released mainly for displaying video from DPH.IP doorphones and and this time doesn't yet have all fuctionality of PhoneCTI application. Those options will be added gradually}}<br />
<br />
=== VoiP Client===<br />
<br />
MessengerCTI.Desktop can work as VoIP, concurrent phone connected to stationary desk phone(FXS,CTS,IP). User can decide on which device to pick up a call, phone or a computer - using it's integrated audio devices(sound card, microphone, speakers or external headphones). Since 1.11 version of NCP firmware application can be used as standalone SIP phone. For such configuration CTIuserPlus license is required.<br />
<br />
<br />
=== Phone Book ===<br />
<br />
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 possible instantly after adding it. Access to phone book allows to simply search numbers of contacts user want to call. On other hand, during incoming calls computer displaying will be showing clear information about calling person.<br />
<br />
=== Call History ===<br />
<br />
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.<br />
<br />
=== Text messages ===<br />
<br />
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.<br />
<br />
=== Usage alongside mobile version ===<br />
<br />
Application can be used alongside and synchronized to MessengerCTI.Mobile, Android version for mobile devices.<br />
<br />
<br />
= Minimum requirements =<br />
To install SLICAN MessengerCTI.Desktop application, following minimum requirements must be met:<br />
*CPU Frequency - 800 mhz or higher<br />
*Ram - 1 GB or more<br />
*GPU- compatible with DirectX 9 <br />
*Operating System - Windows 7 or more recent<br />
<br />
Application can be installed on computer which doesn't meet minimum requirements but it will run slowly or some option won't work correctly.<br />
{{Attention!|<br />
'''MessengerCTI.Desktop''' application works with IPx, Mac and CCT PBX with firmware 6.52 or newer, or NCP PBX with firmware 1.10}}<br />
<br />
= Installation of application =<br />
<br />
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 computer. After installing, application should be properly configured by entering necessary PBX information to which software should be conencted:<br />
Settings - Connection.<br />
{{Attention!|<br />
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.}}<br />
<br />
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"<br />
<br />
== Running application ==<br />
<br />
MessengerCTI.Dekstop can be run just as any other Windows compatible software. In the program settings automatic start during launch of operating system can bet set. During start of program it is logging to PBX(according to settings set in Settings - Connection tab). After successful login program data is synchronized with PBX data.<br />
<br />
== Updating application ==<br />
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 <br />
compared to version on PBX. If they differ, version from PBX is automaticly downloaded, installed and logged to PBX. Depending on version from PBX it may install newer or old version.<br />
<br />
= Available configurations =<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned off) - calling with phone, application - dialling up outgoing calls for phone(CTS, FXS, SIP) and picking up incoming calls for phone (CTS)<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned on) independent choice of picking/dialing up call with phone or application.<br />
*Autonomous application without desk phone (application VoIP mode on) - picking/dialling calls only with application.<br />
<br />
Other functionalities for example chat, sending and receiving SMS, displaying video from camera, accessing call history and phone book, configuring user status and Messenger aplication are available for each of the above configurations.<br />
<br />
Application '''MessengerCTI.Mobile''' is intended for mobile devices with Android system, its description can be found HERE(manual in progress).<br />
<br />
== '''MessengerCTI.Desktop''' with simultaneous configuration ==<br />
<br />
===Application with VoIP mode turned OFF.===<br />
<br />
Phone calls are made only using phone working alongside application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, dialling with phone speaker using CTS phone<br />
*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.<br />
<br />
For user of FXS nad SIP phones picking up earphone is necessary.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_VoIP.png |800px]]</center><br />
<br />
===Application with VoIP mode turned ON.===<br />
<br />
Phone calls can are made with phone or with computer and application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_with_phone.png |800px]]</center><br />
<br />
== '''MessengerCTI.Desktop''' working as standalone phone (only with NCP)==<br />
<br />
===Application with VoIP mode turned on.===<br />
<br />
Phone calls are made only with computer and application. Standalone applications allows:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_phone.png |800px]]</center><br />
<br />
= Program structure =<br />
==Main window==<br />
Main windows of MessengerCTI.Desktop application contains interface which show information and allows access to chat windows and main functions.<br />
<center>[[File:MessengerCTI_main_window.PNG]]</center><br />
===Upper part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_-_main_window_-_upper.png]]<br />
*left side<br />
**hyperlink to software version<br />
<br />
*right side<br />
**default window position button<br />
**close - minimizing to tray button<br />
<br />
===Middle part of window:===<br />
<br />
[[File:MessengerCTIDesktop_-_main_window_-_middle.png]]<br />
*left side:<br />
**changing application status button<br />
<br />
*middle: program name,below - user status - field that can by user to provide additional urlop, for example to inform about vacation or being busy with project<br />
<br />
*right side:<br />
**searching (magnifying glass) - button/field for searching number or contact<br />
**preferences - access to program settings<br />
<br />
===Lower part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_main_window_lower.PNG]]<br />
*access to tabs:<br />
**contacts - phonebook from bx with sorting options<br />
**recent - history of most recent calls and messages.<br />
<br />
== Status of application and user ==<br />
'''MessengerCTI.Dekstop''' software allows to show current status of user with coloured symbol and display it inside applications of other users. Applications status is informing about user availability, depending on user actions status can be changed by him or application can change it automatically. More information can be added through text status of user. User can choose different icons/symbol to set his status manually. Additionally there is graphic informing about ringing phone or current call.<br />
<br />
===List of icons and symbols===<br />
Chart presents list of icons available in '''Contacts''' and '''Recent''' tabs:<br />
<br />
* [[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.<br />
* [[File:MessengerCTI_history.png | 32px]] - for public subscribers.<br />
* [[File:MessengerCTI_close_door.png | 32px]] - for DPH.IP doorphones connected to open/closed door sensor<br />
<br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Status of application and DPH.IP doorphones<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_green.png | 32px]] ||PBX subscriber; '''MessengerCTI.Desktop''' application is running '''and and LOGGED IN'''from subscriber computer. Clicking icon will allow to send text messeger, SMS or dial a call to another application user.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_chat_tv_yellow.png | 29px]] ||PBX subscriber; '''Be right back''' set by user or application, delay time is definied in general settings of application.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_red.png | 32px]] ||PBX subscriber; '''Do not disturb''' set by user<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_grey.png | 32px]] ||PBX subscriber; '''Invisible''' set by user or application is logged off.<br />
|-<br />
|{{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)<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_history.png | 32px]] ||public subscriber; clicking icon will allow to send SMS or dial call to chosen subscriber.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_close_door.png | 32px]] ||doorphone; current door position - door closed, clicking icon will open door<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_open_door.png | 32px]] ||doorphone; door are open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_alarm_open_door.png | 32px]] ||doorphone; alarm timer for open doors was set off<br />
|-<br />
|}<br />
'''''Chart 1:''''' Meaning of icon status of application, users and doorphones.<br><br />
<br />
Chart is showing list if icon that appear on the left side of subscriber name in tab '''Contacts''' and '''Recent'''. Internal phone will have status icon being displayed<br />
<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Phone status and camera information<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_bell_red.png | 28px]] ||Phone is ringing<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_phone_red.png | 32px]] || During call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_camera.png | 25px]] ||Camera is associeted with phone or doorphone, clicking on icon will allow to preview camera video<br />
|-<br />
|}<br />
</center><br />
<center>'''''Tabela 2:''''' Icons displaying status of phone and camera</center><br />
<br />
== Preferences==<br />
<br />
Clicking '''Preferences''' icon in main program window will display window with program settings. In every tab there is available button with info "About software" and reseting default window position.<br />
<br />
=== Connection===<br />
In '''''Connection''''' field you must enter settings neccesary for application to connect:<br />
<br />
<center>[[File:MessengerCTI_connection.PNG]]</center><br />
<br />
'''Application login setting'''<br />
<br />
To login, application must have correct settings configured by PBX administrator: <br />
* subscriber numbers - extensions from PBX<br />
* CTI access and password:<br />
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/Settings CTI''' - '''CTI - access level''' and pasword'''Pss'''<br />
** for NCP - '''ConfigWEB''' chart '''Extensions/Subscribers/CTI setting''' - '''CTI Access''' and '''Password'''<br />
* Server address - PBX network settings<br />
CTI access level determines what options are available to application:<br />
* CTI.user - MessengerCTI without VoIP and camera preview<br />
* CTI.userPlus - MessengerCTI with VoIP and camera preview<br />
<br />
<br />
These connections settings must be filled:<br />
* '''Subscribers" field - extension number for which '''MessengerCTI.Dekstop''' will login.<br />
* '''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. <br />
* '''server IP address''' - IP address of PBX network interface. IP address of PBX network port. In case of logging outside od PBX network, IP address of edge router(port forwarding on router is necessary, 5529 TCP, 8100-8300 UDP for IPx, 10000-30000 UDP for NCP on PBX LAN interface).<br />
<br />
After user will change his password, administrator no longer will have access to this passowrd. Application can be set to remember user password by checking field while login in, if field wasn't checked application will always ask for password during every login.<br />
<br />
<br />
After proper 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. "Successful login" will apear in lower part of window.<br />
<br />
<br />
If login credentials, configuration settings aren't correct or there are issue with network connection those error messages may appear:<br />
* ''Wrong login or password. Check if correct login or password was used.''<br />
* ''Connecting to PBX'' alternating with<br />
* ''No connection to PBX'' Check IP address that was entered and check computer LAN connection.<br />
<br />
===General===<br />
<br />
<br />
<center>[[File:MessengerCTI_general_settings.PNG]]</center><br />
<br />
This window allows to configure settings defining how program works and startup options.<br />
Available settings:<br />
*Auto start on System startup - automatic start of application.<br />
*Start minimized - application will run hidden in system task bar.<br />
*Set "Be right back" state after - status icon will change automatically, informing about user being away from computer after defined time.<br />
*Set shortcut for application window - changes application from Windows task bar to desktop and vice versa.<br />
*Choose double click function(for contact or number):<br />
**show call window - choice windows is displayed with options - number, phone call, opening chat/SMS window, closing current window<br />
**call primary number - automatic number dialling<br />
**show last events - recent call history to particular subscriber is displayed.<br />
*Set this window position as default - allows to set up default application's window potion on screen.<br />
<br />
===Audio settings===<br />
These setting allow to set up audio notifications informing about incoming calls and messages and audio setting of computer audio devices.<br />
<br />
<br />
<center>[[File:MessengerCTI_audio_settings.PNG]]</center><br />
<br />
*Enable VoIP on when available - allows application to work as VoIP client(VoIP phone)<br />
<br />
<center>[[File:MessengerCTI_voip_settings.PNG]]</center><br />
<br />
==Dialing and picking up calls==<br />
To set up call between two users, particular hardware, software and proper configuration must be supplied:<br />
*Slican PBX<br />
*computer with installed and configured MessengerCTI.Desktop software<br />
**software logged to PBX with subscriber extension(Settings tab, Connection field)<br />
*analog, VoIP or Slican system phone<br />
*for video preview - DPH.IP doorphone with camera or phone associated with external camera(doesn't apply to VoIP phones with integrated camera)<br />
<br />
Call can be dialled using computer mouse and computer screen. Call is made between subscribers through phone connected to PBX and associated with MessengerCTI.Desktop. After choosing subscriber number to call and dialling call, PBX will call extension choosing number(to inform about being ready to set up connection), after picking up handset PBX will set up calling connection.<br />
<br />
==='''Dialing calls to particular number'''===<br />
<center>[[File:MessengerCTI_outgoing_call_window.png]]</center><br />
Making calls can be realised in few different way. Depending on how configured are general setting on application - option "Set double click function".<br />
* from '''Contacts''' tab<br />
**choose subscriber from proper group(if applicable) or from group "All contacts" by double clicking on number or contact<br />
**clicking on [[File:MessengerCTI_tv_green.png | 32px]] or [[File:MessengerCTI_history.png | 32px]]<br />
*'''Search''' field - by directly entering phone number with computer keyboard then clicking on green phone icon.<br />
*'''Recent''' tab - call history:<br />
**history of call with particular subscriber can be seen here, call is dialled by double click on number or contact<br />
**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]]<br />
<br />
==='''Incoming calls'''===<br />
<br />
<center>[[File:MessengerCTI_incoming_window.png]]</center><br />
Calls are displayed on computer screen with pop-up window, ringing application and ringing phone. Depending on applied configuration call can be picked up with application or phone.<br />
<br />
==='''Connecting to camera video preview'''===<br />
Connecting to/from DPH.IP with integrated camera or associated phone or external IP camera(doesn't apply to VoIP phone with integrated cameras)will display automatically new window on computer screen. Connecting to doorphone allows to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.<br />
<br />
<center>[[File:MessengerCTI_camera_preview.png]]</center><br />
<br />
<br />
<br />
===Transfering calls - version 1.03===<br />
Call can be transfered by choosing contact or number from: Recent or Contacts.<br />
* "blind transfer" - without checking target extensions state<br />
<center>[[File:MessengerCTI_blind_transfer.png | 700px]]</center><br />
<br />
<br />
* no announcing - check target extension state without announcing <br />
<center>[[File:MessengerCTI_no_announcing.png | 700px]]</center><br />
<br />
<br />
* with annoucing - check target extension state with announcing <br />
<center>[[File:MessengerCTI_with_announcing.png | 700px]]</center><br />
<br />
==Sending messages==<br />
Application allow sending(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.<br />
<br />
Receving new message is signalised on Windows system task bar with two icons alternating [[File:MessengerCTI_free.png | 32px]], [[File:MessengerCTI_mail.png | 32px]] and popping up [[File:MessengerCTI_new_message.png]].<br />
<br />
Messages history is available through hyper link '''Load previous'''. It is stored on computer local hard drive.<br />
<br />
<center>[[File:MessengerCTI_chat.png]]</center><br />
<br />
==Searching data==<br />
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Contacts''' tab in '''Search''':<br />
<br />
<br />
<center>[[File:MessengerCT_search_field.PNG]]</center><br />
<br />
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'''.<br />
<br />
== Contacts==<br />
This field allows for searching, displaying, customising and running actions related to contact. By default '''Favourites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.<br />
<br />
<center>[[File:MessengerCTI_contacts2.png]]</center><br />
<br />
Adding contacts is possible:<br />
<br />
* from search field - entering number and adding it with green handset icon<br />
* from '''Contacts''' or '''Recent''' tab - right clicking on connection<br />
<br />
From contact list we gain access to:<br />
*favourites<br />
*all contacts<br />
*extensions<br />
*created subscriber groups<br />
*public contacts<br />
*private contacts<br />
<br />
== Call history ==<br />
Choosing '''Recent''' tab - in main program window will display call history of currently logged extension to '''''MessengerCTI.Desktop'''''. Window will look like this.<br />
<br />
<br />
<center>[[File:MessengerCTI_recent.PNG]]</center><br />
<br />
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:<br />
<br />
[[File:MessengerCTI_outgoing_calls.PNG | 32px]]<br />
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.<br />
<br />
[[File:MessengerCTI_incoming_calls.PNG | 32px]]<br />
Downward arrow for incoming call that was picked up.<br />
<br />
[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]<br />
Turned arrow for missed incoming calls, digit is showing number of these calls.<br />
<br />
[[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]] [[File:MessengerCTI_message_amount.PNG | 32px]]<br />
Arrow with listed lines or text bubble for text chat or sent SMS. Digit is showing number of missed messages.<br />
If history contains missed calls or unread messages icon in '''Recent''' field will be in colour red.<br />
<br />
From History window call can be dialled or messages be send to chosen users by right clicking on subscribers text status<br />
, clicking on icons [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] and [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]] [[File:MessengerCTI_missed_calls.PNG | 32px]] [[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]]. If internal subscriber have other number listed in their phone book, choice can be made between them. For internal subscribers there is option of editing, deleting contact and deleting from favourite list.<br />
<br />
=MessengerCTI.Desktop dla agenta Call Center=<br />
Od firmware 1.12 NCP oraz 1.02 MessengerCTI.Desktop w aplikacji pojawiły się funkcjonalności związane z obsługą kolejek Call Center. U użytkownika programu, który w centrali ma włączoną opcję agenta Call Center - w aplikacji na pasku statusu systemu operacyjnego dodatkowo wyświetla się dodatkowa ikona '''Status agenta''' oraz w oknie głównym aplikacji zakładka '''CC'''<br />
<br />
<br />
Ikony statusu aplikacji: <br />
* aplikacja zalogowana: [[Plik:MessengerCTI.Desktop status zalogowany.png | 40px]]<br />
* aplikacja w stanie: '''Zaraz wracam''' [[Plik:MessengerCTI.Desktop status zaraz wracam.png | 40px]]<br />
Czerwona kropka przy statusie aplikacji wskazuje na nieodebrane połączenie lub wiadomość do użytkownika numeru.<br />
<br />
<br />
<br />
Ikony statusu Agenta: <br />
* agent zalogowany do kolejki: [[Plik:MessengerCTI.Desktop agent zalogowany.png | 40px]]<br />
* przerwa agenta: [[Plik:MessengerCTI.Desktop przerwa agenta.png | 40px]]<br />
* agent wylogowny z kolejki: [[Plik:MessengerCTI.Desktop agent wylogowany.png | 40px]]<br />
Czerwona kropka przy statusie agenta wskazuje na nieodebrane połączenie przez agentów kolejki CC.<br />
<br />
<br />
<br />
W zakładce '''CC''' aplikacji w zależności od przyjętej konfiguracji wyświetlane są:<br />
* do 4 zaprogramowanych przycisków wraz z aktualnym jej stanem dla danego agenta: '''Logowanie/wylogowanie z kolejki CC''' oraz '''Włączenie/wyłączenie przerwy agenta'''<br />
* obsługiwane kolejki z liczbą zalogowanych do niej agentów oraz oczekujących aktualnie w kolejce<br />
* lista nieodebranych połączeń - numerów/kontaktów do oddzwonienia<br />
<br />
<br />
<center>[[Plik:MessengerCTI.Desktop zakładka CC.png]]</center><br />
<br />
W przypadku korzystania z listy oddzwonienia pojawia się dodatkowe okno z możliwością nawiązania połączenia oraz polem potwierdzenia czy oddzwonienie było skuteczne.<br />
<br />
<br />
<br />
W celu odpowiedniego skonfigurowania zakładki '''CC''' należy w preferencjach aplikacji prawidłowo skonfigurować zakładkę '''Call Center'''<br />
<br />
<center>[[Plik:MessengerCTI.Desktop konfiguracja CC.png]]</center><br />
<br />
=Licensing=<br />
==IPX, MAC, CCT PBX==<br />
MessengerCTI.Desktop application:<br />
* 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.<br />
* for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
* calls made form application in VoIP mode are using VoIP channels just like other VoIP devices<br />
* MessengerCTI.Dekstop configured without VoIP and camera preview access - CTIuser license is required<br />
* MessengerCTI.Desktop configured with VoIP and camera preview access - CTIuserplus license is required<br />
<br />
==NCP PBX==<br />
MessengerCTI.Desktop:<br />
* CAN be associated with any subscriber port - analogue, system or VoIP; each subscriber port is treated as 1 user from Base license, additionally while associating application with VoIP port 1 NCP.VoIPuser license is neccesary<br />
** for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
** MessengerCTI.Desktop configured without VoIP and no camera preview access - NCP.CTIuser is required<br />
** MessengerCTI.Desktop configured with VoIP and camera preview access - NCP.CTIuserPlus license is required<br />
* MessengerCTI.Dekstop as standalone subscriber - MCTI (not associated with subscriber port):<br />
** Messenger.CTI Dekstop with VoIP funcionality and camera preview access - NCP.VoIPuser and NCP.CTIuserPlus licenses are required<br />
<br />
=One user and few different numbers=<br />
Sometimes one computer use must operate with few different extensions umber. On workstation(computer) use of "instance" is neccesary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create seperate configuration.<br />
<br />
* default location of program instalation is: C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe<br />
** 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 llok for MessengerCTI, right click -> More/ Open File Location - program icon will appear, right click -> Properties/Shortcut/Target<br />
* create program shortcut on desktop<br />
* in shortcut properties add instance - Properties/Shortcut/Target: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''<br />
* 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''', ...<br />
* while running aplication from shortcuts we can configure each one seperatly for different numbers</div>Marekghttp://pubwiki.slican.com/index.php?title=File:MessengerCTI_with_announcing.png&diff=7844File:MessengerCTI with announcing.png2020-02-10T13:49:13Z<p>Marekg: </p>
<hr />
<div></div>Marekghttp://pubwiki.slican.com/index.php?title=File:MessengerCTI_no_announcing.png&diff=7843File:MessengerCTI no announcing.png2020-02-10T13:49:04Z<p>Marekg: </p>
<hr />
<div></div>Marekghttp://pubwiki.slican.com/index.php?title=File:MessengerCTI_blind_transfer.png&diff=7842File:MessengerCTI blind transfer.png2020-02-10T13:47:44Z<p>Marekg: </p>
<hr />
<div></div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI_Manual&diff=7841MessengerCTI Manual2020-02-10T13:31:17Z<p>Marekg: /* Transfering calls - version 1.03 */</p>
<hr />
<div>= Introduction =<br />
Slican '''MessengerCTI.Desktop''' is software which purpose is to assist users of Slican PBX. Thanks to the graphic interface displayed on the computer screen, software allows for convenient access of telephone calls and other functions related to it. Software delivers additional features that allows to expand capabilities of desk phone. Software combines capabilities of controlling desk phone connected to PBX, for example choosing number, receiving calls and also application is able to function as standalone phone. Software also allows to: accessing PBX's phonebook, call history, status of phone and other users of MessengerCTI, text communication and sending or receiving SMS messages. Additionally for new version of DPH.IP doorphone equipped with camera - video preview was added.<br />
<br />
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). Users of analogue phones will benefit from this software because they'll gain access to functions that aren't available on these types of devices.<br />
<br />
= Basic functionalities =<br />
<br />
=== Using cameras and DPH.IP doorphones ===<br />
<br />
Introduction of DPH.IP doorphones that include cameras led to solution that allows display of video from these cameras. Functionality was added with MessengerCTI.Desktop. While connecting to doorphone from software video from camera will appear in new window on computer display. After picking up and finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door,gate, using dedicated button. Reverse is also true, calling doorphone or another telephone number associated with camera, display screen will show video from camera. This allow for temporary observation of surroundings of installed camera, for example person we are calling. There is also option of watching video from any camera without making call, just using application icon. Thanks to MessengerCTI.Desktop user can preview video from camera of other manufacturers but those devices have to support video formats, codec compatible with VLC application libraries.<br />
<br />
{{Attention!|<br />
MessengerCTI.Desktop application was released mainly for displaying video from DPH.IP doorphones and and this time doesn't yet have all fuctionality of PhoneCTI application. Those options will be added gradually}}<br />
<br />
=== VoiP Client===<br />
<br />
MessengerCTI.Desktop can work as VoIP, concurrent phone connected to stationary desk phone(FXS,CTS,IP). User can decide on which device to pick up a call, phone or a computer - using it's integrated audio devices(sound card, microphone, speakers or external headphones). Since 1.11 version of NCP firmware application can be used as standalone SIP phone. For such configuration CTIuserPlus license is required.<br />
<br />
<br />
=== Phone Book ===<br />
<br />
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 possible instantly after adding it. Access to phone book allows to simply search numbers of contacts user want to call. On other hand, during incoming calls computer displaying will be showing clear information about calling person.<br />
<br />
=== Call History ===<br />
<br />
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.<br />
<br />
=== Text messages ===<br />
<br />
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.<br />
<br />
=== Usage alongside mobile version ===<br />
<br />
Application can be used alongside and synchronized to MessengerCTI.Mobile, Android version for mobile devices.<br />
<br />
<br />
= Minimum requirements =<br />
To install SLICAN MessengerCTI.Desktop application, following minimum requirements must be met:<br />
*CPU Frequency - 800 mhz or higher<br />
*Ram - 1 GB or more<br />
*GPU- compatible with DirectX 9 <br />
*Operating System - Windows 7 or more recent<br />
<br />
Application can be installed on computer which doesn't meet minimum requirements but it will run slowly or some option won't work correctly.<br />
{{Attention!|<br />
'''MessengerCTI.Desktop''' application works with IPx, Mac and CCT PBX with firmware 6.52 or newer, or NCP PBX with firmware 1.10}}<br />
<br />
= Installation of application =<br />
<br />
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 computer. After installing, application should be properly configured by entering necessary PBX information to which software should be conencted:<br />
Settings - Connection.<br />
{{Attention!|<br />
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.}}<br />
<br />
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"<br />
<br />
== Running application ==<br />
<br />
MessengerCTI.Dekstop can be run just as any other Windows compatible software. In the program settings automatic start during launch of operating system can bet set. During start of program it is logging to PBX(according to settings set in Settings - Connection tab). After successful login program data is synchronized with PBX data.<br />
<br />
== Updating application ==<br />
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 <br />
compared to version on PBX. If they differ, version from PBX is automaticly downloaded, installed and logged to PBX. Depending on version from PBX it may install newer or old version.<br />
<br />
= Available configurations =<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned off) - calling with phone, application - dialling up outgoing calls for phone(CTS, FXS, SIP) and picking up incoming calls for phone (CTS)<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned on) independent choice of picking/dialing up call with phone or application.<br />
*Autonomous application without desk phone (application VoIP mode on) - picking/dialling calls only with application.<br />
<br />
Other functionalities for example chat, sending and receiving SMS, displaying video from camera, accessing call history and phone book, configuring user status and Messenger aplication are available for each of the above configurations.<br />
<br />
Application '''MessengerCTI.Mobile''' is intended for mobile devices with Android system, its description can be found HERE(manual in progress).<br />
<br />
== '''MessengerCTI.Desktop''' with simultaneous configuration ==<br />
<br />
===Application with VoIP mode turned OFF.===<br />
<br />
Phone calls are made only using phone working alongside application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, dialling with phone speaker using CTS phone<br />
*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.<br />
<br />
For user of FXS nad SIP phones picking up earphone is necessary.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_VoIP.png |800px]]</center><br />
<br />
===Application with VoIP mode turned ON.===<br />
<br />
Phone calls can are made with phone or with computer and application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_with_phone.png |800px]]</center><br />
<br />
== '''MessengerCTI.Desktop''' working as standalone phone (only with NCP)==<br />
<br />
===Application with VoIP mode turned on.===<br />
<br />
Phone calls are made only with computer and application. Standalone applications allows:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_phone.png |800px]]</center><br />
<br />
= Program structure =<br />
==Main window==<br />
Main windows of MessengerCTI.Desktop application contains interface which show information and allows access to chat windows and main functions.<br />
<center>[[File:MessengerCTI_main_window.PNG]]</center><br />
===Upper part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_-_main_window_-_upper.png]]<br />
*left side<br />
**hyperlink to software version<br />
<br />
*right side<br />
**default window position button<br />
**close - minimizing to tray button<br />
<br />
===Middle part of window:===<br />
<br />
[[File:MessengerCTIDesktop_-_main_window_-_middle.png]]<br />
*left side:<br />
**changing application status button<br />
<br />
*middle: program name,below - user status - field that can by user to provide additional urlop, for example to inform about vacation or being busy with project<br />
<br />
*right side:<br />
**searching (magnifying glass) - button/field for searching number or contact<br />
**preferences - access to program settings<br />
<br />
===Lower part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_main_window_lower.PNG]]<br />
*access to tabs:<br />
**contacts - phonebook from bx with sorting options<br />
**recent - history of most recent calls and messages.<br />
<br />
== Status of application and user ==<br />
'''MessengerCTI.Dekstop''' software allows to show current status of user with coloured symbol and display it inside applications of other users. Applications status is informing about user availability, depending on user actions status can be changed by him or application can change it automatically. More information can be added through text status of user. User can choose different icons/symbol to set his status manually. Additionally there is graphic informing about ringing phone or current call.<br />
<br />
===List of icons and symbols===<br />
Chart presents list of icons available in '''Contacts''' and '''Recent''' tabs:<br />
<br />
* [[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.<br />
* [[File:MessengerCTI_history.png | 32px]] - for public subscribers.<br />
* [[File:MessengerCTI_close_door.png | 32px]] - for DPH.IP doorphones connected to open/closed door sensor<br />
<br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Status of application and DPH.IP doorphones<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_green.png | 32px]] ||PBX subscriber; '''MessengerCTI.Desktop''' application is running '''and and LOGGED IN'''from subscriber computer. Clicking icon will allow to send text messeger, SMS or dial a call to another application user.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_chat_tv_yellow.png | 29px]] ||PBX subscriber; '''Be right back''' set by user or application, delay time is definied in general settings of application.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_red.png | 32px]] ||PBX subscriber; '''Do not disturb''' set by user<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_grey.png | 32px]] ||PBX subscriber; '''Invisible''' set by user or application is logged off.<br />
|-<br />
|{{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)<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_history.png | 32px]] ||public subscriber; clicking icon will allow to send SMS or dial call to chosen subscriber.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_close_door.png | 32px]] ||doorphone; current door position - door closed, clicking icon will open door<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_open_door.png | 32px]] ||doorphone; door are open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_alarm_open_door.png | 32px]] ||doorphone; alarm timer for open doors was set off<br />
|-<br />
|}<br />
'''''Chart 1:''''' Meaning of icon status of application, users and doorphones.<br><br />
<br />
Chart is showing list if icon that appear on the left side of subscriber name in tab '''Contacts''' and '''Recent'''. Internal phone will have status icon being displayed<br />
<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Phone status and camera information<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_bell_red.png | 28px]] ||Phone is ringing<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_phone_red.png | 32px]] || During call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_camera.png | 25px]] ||Camera is associeted with phone or doorphone, clicking on icon will allow to preview camera video<br />
|-<br />
|}<br />
</center><br />
<center>'''''Tabela 2:''''' Icons displaying status of phone and camera</center><br />
<br />
== Preferences==<br />
<br />
Clicking '''Preferences''' icon in main program window will display window with program settings. In every tab there is available button with info "About software" and reseting default window position.<br />
<br />
=== Connection===<br />
In '''''Connection''''' field you must enter settings neccesary for application to connect:<br />
<br />
<center>[[File:MessengerCTI_connection.PNG]]</center><br />
<br />
'''Application login setting'''<br />
<br />
To login, application must have correct settings configured by PBX administrator: <br />
* subscriber numbers - extensions from PBX<br />
* CTI access and password:<br />
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/Settings CTI''' - '''CTI - access level''' and pasword'''Pss'''<br />
** for NCP - '''ConfigWEB''' chart '''Extensions/Subscribers/CTI setting''' - '''CTI Access''' and '''Password'''<br />
* Server address - PBX network settings<br />
CTI access level determines what options are available to application:<br />
* CTI.user - MessengerCTI without VoIP and camera preview<br />
* CTI.userPlus - MessengerCTI with VoIP and camera preview<br />
<br />
<br />
These connections settings must be filled:<br />
* '''Subscribers" field - extension number for which '''MessengerCTI.Dekstop''' will login.<br />
* '''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. <br />
* '''server IP address''' - IP address of PBX network interface. IP address of PBX network port. In case of logging outside od PBX network, IP address of edge router(port forwarding on router is necessary, 5529 TCP, 8100-8300 UDP for IPx, 10000-30000 UDP for NCP on PBX LAN interface).<br />
<br />
After user will change his password, administrator no longer will have access to this passowrd. Application can be set to remember user password by checking field while login in, if field wasn't checked application will always ask for password during every login.<br />
<br />
<br />
After proper 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. "Successful login" will apear in lower part of window.<br />
<br />
<br />
If login credentials, configuration settings aren't correct or there are issue with network connection those error messages may appear:<br />
* ''Wrong login or password. Check if correct login or password was used.''<br />
* ''Connecting to PBX'' alternating with<br />
* ''No connection to PBX'' Check IP address that was entered and check computer LAN connection.<br />
<br />
===General===<br />
<br />
<br />
<center>[[File:MessengerCTI_general_settings.PNG]]</center><br />
<br />
This window allows to configure settings defining how program works and startup options.<br />
Available settings:<br />
*Auto start on System startup - automatic start of application.<br />
*Start minimized - application will run hidden in system task bar.<br />
*Set "Be right back" state after - status icon will change automatically, informing about user being away from computer after defined time.<br />
*Set shortcut for application window - changes application from Windows task bar to desktop and vice versa.<br />
*Choose double click function(for contact or number):<br />
**show call window - choice windows is displayed with options - number, phone call, opening chat/SMS window, closing current window<br />
**call primary number - automatic number dialling<br />
**show last events - recent call history to particular subscriber is displayed.<br />
*Set this window position as default - allows to set up default application's window potion on screen.<br />
<br />
===Audio settings===<br />
These setting allow to set up audio notifications informing about incoming calls and messages and audio setting of computer audio devices.<br />
<br />
<br />
<center>[[File:MessengerCTI_audio_settings.PNG]]</center><br />
<br />
*Enable VoIP on when available - allows application to work as VoIP client(VoIP phone)<br />
<br />
<center>[[File:MessengerCTI_voip_settings.PNG]]</center><br />
<br />
==Dialing and picking up calls==<br />
To set up call between two users, particular hardware, software and proper configuration must be supplied:<br />
*Slican PBX<br />
*computer with installed and configured MessengerCTI.Desktop software<br />
**software logged to PBX with subscriber extension(Settings tab, Connection field)<br />
*analog, VoIP or Slican system phone<br />
*for video preview - DPH.IP doorphone with camera or phone associated with external camera(doesn't apply to VoIP phones with integrated camera)<br />
<br />
Call can be dialled using computer mouse and computer screen. Call is made between subscribers through phone connected to PBX and associated with MessengerCTI.Desktop. After choosing subscriber number to call and dialling call, PBX will call extension choosing number(to inform about being ready to set up connection), after picking up handset PBX will set up calling connection.<br />
<br />
==='''Dialing calls to particular number'''===<br />
<center>[[File:MessengerCTI_outgoing_call_window.png]]</center><br />
Making calls can be realised in few different way. Depending on how configured are general setting on application - option "Set double click function".<br />
* from '''Contacts''' tab<br />
**choose subscriber from proper group(if applicable) or from group "All contacts" by double clicking on number or contact<br />
**clicking on [[File:MessengerCTI_tv_green.png | 32px]] or [[File:MessengerCTI_history.png | 32px]]<br />
*'''Search''' field - by directly entering phone number with computer keyboard then clicking on green phone icon.<br />
*'''Recent''' tab - call history:<br />
**history of call with particular subscriber can be seen here, call is dialled by double click on number or contact<br />
**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]]<br />
<br />
==='''Incoming calls'''===<br />
<br />
<center>[[File:MessengerCTI_incoming_window.png]]</center><br />
Calls are displayed on computer screen with pop-up window, ringing application and ringing phone. Depending on applied configuration call can be picked up with application or phone.<br />
<br />
==='''Connecting to camera video preview'''===<br />
Connecting to/from DPH.IP with integrated camera or associated phone or external IP camera(doesn't apply to VoIP phone with integrated cameras)will display automatically new window on computer screen. Connecting to doorphone allows to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.<br />
<br />
<center>[[File:MessengerCTI_camera_preview.png]]</center><br />
<br />
<br />
<br />
===Transfering calls - version 1.03===<br />
Call can be transfered by choosing contact or number from: Recent or Contacts.<br />
* "blind transfer" - without checking target extensions state<br />
<center>[[File:MessengerCTI_blind_transfer.png | 700px]]</center><br />
<br />
<br />
* no announcing - check target extension state without announcing <br />
<center>[[File:MessengerCTI_no_announcing.png | 700px]]</center><br />
<br />
<br />
* with annoucing - check target extension state with announcing <br />
<center>[[File:MessengerCTI_with_announcing.png | 700px]]</center><br />
<br />
==Sending messages==<br />
Application allow sending(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.<br />
<br />
Receving new message is signalised on Windows system task bar with two icons alternating [[File:MessengerCTI_free.png | 32px]], [[File:MessengerCTI_mail.png | 32px]] and popping up [[File:MessengerCTI_new_message.png]].<br />
<br />
Messages history is available through hyper link '''Load previous'''. It is stored on computer local hard drive.<br />
<br />
<center>[[File:MessengerCTI_chat.png]]</center><br />
<br />
==Searching data==<br />
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Contacts''' tab in '''Search''':<br />
<br />
<br />
<center>[[File:MessengerCT_search_field.PNG]]</center><br />
<br />
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'''.<br />
<br />
== Contacts==<br />
This field allows for searching, displaying, customising and running actions related to contact. By default '''Favourites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.<br />
<br />
<center>[[File:MessengerCTI_contacts2.png]]</center><br />
<br />
Adding contacts is possible:<br />
<br />
* from search field - entering number and adding it with green handset icon<br />
* from '''Contacts''' or '''Recent''' tab - right clicking on connection<br />
<br />
From contact list we gain access to:<br />
*favourites<br />
*all contacts<br />
*extensions<br />
*created subscriber groups<br />
*public contacts<br />
*private contacts<br />
<br />
== Call history ==<br />
Choosing '''Recent''' tab - in main program window will display call history of currently logged extension to '''''MessengerCTI.Desktop'''''. Window will look like this.<br />
<br />
<br />
<center>[[File:MessengerCTI_recent.PNG]]</center><br />
<br />
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:<br />
<br />
[[File:MessengerCTI_outgoing_calls.PNG | 32px]]<br />
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.<br />
<br />
[[File:MessengerCTI_incoming_calls.PNG | 32px]]<br />
Downward arrow for incoming call that was picked up.<br />
<br />
[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]<br />
Turned arrow for missed incoming calls, digit is showing number of these calls.<br />
<br />
[[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]] [[File:MessengerCTI_message_amount.PNG | 32px]]<br />
Arrow with listed lines or text bubble for text chat or sent SMS. Digit is showing number of missed messages.<br />
If history contains missed calls or unread messages icon in '''Recent''' field will be in colour red.<br />
<br />
From History window call can be dialled or messages be send to chosen users by right clicking on subscribers text status<br />
, clicking on icons [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] and [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]] [[File:MessengerCTI_missed_calls.PNG | 32px]] [[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]]. If internal subscriber have other number listed in their phone book, choice can be made between them. For internal subscribers there is option of editing, deleting contact and deleting from favourite list.<br />
<br />
=Licensing=<br />
==IPX, MAC, CCT PBX==<br />
MessengerCTI.Desktop application:<br />
* 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.<br />
* for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
* calls made form application in VoIP mode are using VoIP channels just like other VoIP devices<br />
* MessengerCTI.Dekstop configured without VoIP and camera preview access - CTIuser license is required<br />
* MessengerCTI.Desktop configured with VoIP and camera preview access - CTIuserplus license is required<br />
<br />
==NCP PBX==<br />
MessengerCTI.Desktop:<br />
* CAN be associated with any subscriber port - analogue, system or VoIP; each subscriber port is treated as 1 user from Base license, additionally while associating application with VoIP port 1 NCP.VoIPuser license is neccesary<br />
** for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
** MessengerCTI.Desktop configured without VoIP and no camera preview access - NCP.CTIuser is required<br />
** MessengerCTI.Desktop configured with VoIP and camera preview access - NCP.CTIuserPlus license is required<br />
* MessengerCTI.Dekstop as standalone subscriber - MCTI (not associated with subscriber port):<br />
** Messenger.CTI Dekstop with VoIP funcionality and camera preview access - NCP.VoIPuser and NCP.CTIuserPlus licenses are required<br />
<br />
=One user and few different numbers=<br />
Sometimes one computer use must operate with few different extensions umber. On workstation(computer) use of "instance" is neccesary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create seperate configuration.<br />
<br />
* default location of program instalation is: C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe<br />
** 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 llok for MessengerCTI, right click -> More/ Open File Location - program icon will appear, right click -> Properties/Shortcut/Target<br />
* create program shortcut on desktop<br />
* in shortcut properties add instance - Properties/Shortcut/Target: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''<br />
* 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''', ...<br />
* while running aplication from shortcuts we can configure each one seperatly for different numbers</div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI_Manual&diff=7840MessengerCTI Manual2020-02-10T13:30:58Z<p>Marekg: /* Dialing and picking up calls */</p>
<hr />
<div>= Introduction =<br />
Slican '''MessengerCTI.Desktop''' is software which purpose is to assist users of Slican PBX. Thanks to the graphic interface displayed on the computer screen, software allows for convenient access of telephone calls and other functions related to it. Software delivers additional features that allows to expand capabilities of desk phone. Software combines capabilities of controlling desk phone connected to PBX, for example choosing number, receiving calls and also application is able to function as standalone phone. Software also allows to: accessing PBX's phonebook, call history, status of phone and other users of MessengerCTI, text communication and sending or receiving SMS messages. Additionally for new version of DPH.IP doorphone equipped with camera - video preview was added.<br />
<br />
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). Users of analogue phones will benefit from this software because they'll gain access to functions that aren't available on these types of devices.<br />
<br />
= Basic functionalities =<br />
<br />
=== Using cameras and DPH.IP doorphones ===<br />
<br />
Introduction of DPH.IP doorphones that include cameras led to solution that allows display of video from these cameras. Functionality was added with MessengerCTI.Desktop. While connecting to doorphone from software video from camera will appear in new window on computer display. After picking up and finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door,gate, using dedicated button. Reverse is also true, calling doorphone or another telephone number associated with camera, display screen will show video from camera. This allow for temporary observation of surroundings of installed camera, for example person we are calling. There is also option of watching video from any camera without making call, just using application icon. Thanks to MessengerCTI.Desktop user can preview video from camera of other manufacturers but those devices have to support video formats, codec compatible with VLC application libraries.<br />
<br />
{{Attention!|<br />
MessengerCTI.Desktop application was released mainly for displaying video from DPH.IP doorphones and and this time doesn't yet have all fuctionality of PhoneCTI application. Those options will be added gradually}}<br />
<br />
=== VoiP Client===<br />
<br />
MessengerCTI.Desktop can work as VoIP, concurrent phone connected to stationary desk phone(FXS,CTS,IP). User can decide on which device to pick up a call, phone or a computer - using it's integrated audio devices(sound card, microphone, speakers or external headphones). Since 1.11 version of NCP firmware application can be used as standalone SIP phone. For such configuration CTIuserPlus license is required.<br />
<br />
<br />
=== Phone Book ===<br />
<br />
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 possible instantly after adding it. Access to phone book allows to simply search numbers of contacts user want to call. On other hand, during incoming calls computer displaying will be showing clear information about calling person.<br />
<br />
=== Call History ===<br />
<br />
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.<br />
<br />
=== Text messages ===<br />
<br />
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.<br />
<br />
=== Usage alongside mobile version ===<br />
<br />
Application can be used alongside and synchronized to MessengerCTI.Mobile, Android version for mobile devices.<br />
<br />
<br />
= Minimum requirements =<br />
To install SLICAN MessengerCTI.Desktop application, following minimum requirements must be met:<br />
*CPU Frequency - 800 mhz or higher<br />
*Ram - 1 GB or more<br />
*GPU- compatible with DirectX 9 <br />
*Operating System - Windows 7 or more recent<br />
<br />
Application can be installed on computer which doesn't meet minimum requirements but it will run slowly or some option won't work correctly.<br />
{{Attention!|<br />
'''MessengerCTI.Desktop''' application works with IPx, Mac and CCT PBX with firmware 6.52 or newer, or NCP PBX with firmware 1.10}}<br />
<br />
= Installation of application =<br />
<br />
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 computer. After installing, application should be properly configured by entering necessary PBX information to which software should be conencted:<br />
Settings - Connection.<br />
{{Attention!|<br />
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.}}<br />
<br />
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"<br />
<br />
== Running application ==<br />
<br />
MessengerCTI.Dekstop can be run just as any other Windows compatible software. In the program settings automatic start during launch of operating system can bet set. During start of program it is logging to PBX(according to settings set in Settings - Connection tab). After successful login program data is synchronized with PBX data.<br />
<br />
== Updating application ==<br />
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 <br />
compared to version on PBX. If they differ, version from PBX is automaticly downloaded, installed and logged to PBX. Depending on version from PBX it may install newer or old version.<br />
<br />
= Available configurations =<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned off) - calling with phone, application - dialling up outgoing calls for phone(CTS, FXS, SIP) and picking up incoming calls for phone (CTS)<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned on) independent choice of picking/dialing up call with phone or application.<br />
*Autonomous application without desk phone (application VoIP mode on) - picking/dialling calls only with application.<br />
<br />
Other functionalities for example chat, sending and receiving SMS, displaying video from camera, accessing call history and phone book, configuring user status and Messenger aplication are available for each of the above configurations.<br />
<br />
Application '''MessengerCTI.Mobile''' is intended for mobile devices with Android system, its description can be found HERE(manual in progress).<br />
<br />
== '''MessengerCTI.Desktop''' with simultaneous configuration ==<br />
<br />
===Application with VoIP mode turned OFF.===<br />
<br />
Phone calls are made only using phone working alongside application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, dialling with phone speaker using CTS phone<br />
*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.<br />
<br />
For user of FXS nad SIP phones picking up earphone is necessary.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_VoIP.png |800px]]</center><br />
<br />
===Application with VoIP mode turned ON.===<br />
<br />
Phone calls can are made with phone or with computer and application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_with_phone.png |800px]]</center><br />
<br />
== '''MessengerCTI.Desktop''' working as standalone phone (only with NCP)==<br />
<br />
===Application with VoIP mode turned on.===<br />
<br />
Phone calls are made only with computer and application. Standalone applications allows:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_phone.png |800px]]</center><br />
<br />
= Program structure =<br />
==Main window==<br />
Main windows of MessengerCTI.Desktop application contains interface which show information and allows access to chat windows and main functions.<br />
<center>[[File:MessengerCTI_main_window.PNG]]</center><br />
===Upper part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_-_main_window_-_upper.png]]<br />
*left side<br />
**hyperlink to software version<br />
<br />
*right side<br />
**default window position button<br />
**close - minimizing to tray button<br />
<br />
===Middle part of window:===<br />
<br />
[[File:MessengerCTIDesktop_-_main_window_-_middle.png]]<br />
*left side:<br />
**changing application status button<br />
<br />
*middle: program name,below - user status - field that can by user to provide additional urlop, for example to inform about vacation or being busy with project<br />
<br />
*right side:<br />
**searching (magnifying glass) - button/field for searching number or contact<br />
**preferences - access to program settings<br />
<br />
===Lower part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_main_window_lower.PNG]]<br />
*access to tabs:<br />
**contacts - phonebook from bx with sorting options<br />
**recent - history of most recent calls and messages.<br />
<br />
== Status of application and user ==<br />
'''MessengerCTI.Dekstop''' software allows to show current status of user with coloured symbol and display it inside applications of other users. Applications status is informing about user availability, depending on user actions status can be changed by him or application can change it automatically. More information can be added through text status of user. User can choose different icons/symbol to set his status manually. Additionally there is graphic informing about ringing phone or current call.<br />
<br />
===List of icons and symbols===<br />
Chart presents list of icons available in '''Contacts''' and '''Recent''' tabs:<br />
<br />
* [[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.<br />
* [[File:MessengerCTI_history.png | 32px]] - for public subscribers.<br />
* [[File:MessengerCTI_close_door.png | 32px]] - for DPH.IP doorphones connected to open/closed door sensor<br />
<br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Status of application and DPH.IP doorphones<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_green.png | 32px]] ||PBX subscriber; '''MessengerCTI.Desktop''' application is running '''and and LOGGED IN'''from subscriber computer. Clicking icon will allow to send text messeger, SMS or dial a call to another application user.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_chat_tv_yellow.png | 29px]] ||PBX subscriber; '''Be right back''' set by user or application, delay time is definied in general settings of application.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_red.png | 32px]] ||PBX subscriber; '''Do not disturb''' set by user<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_grey.png | 32px]] ||PBX subscriber; '''Invisible''' set by user or application is logged off.<br />
|-<br />
|{{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)<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_history.png | 32px]] ||public subscriber; clicking icon will allow to send SMS or dial call to chosen subscriber.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_close_door.png | 32px]] ||doorphone; current door position - door closed, clicking icon will open door<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_open_door.png | 32px]] ||doorphone; door are open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_alarm_open_door.png | 32px]] ||doorphone; alarm timer for open doors was set off<br />
|-<br />
|}<br />
'''''Chart 1:''''' Meaning of icon status of application, users and doorphones.<br><br />
<br />
Chart is showing list if icon that appear on the left side of subscriber name in tab '''Contacts''' and '''Recent'''. Internal phone will have status icon being displayed<br />
<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Phone status and camera information<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_bell_red.png | 28px]] ||Phone is ringing<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_phone_red.png | 32px]] || During call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_camera.png | 25px]] ||Camera is associeted with phone or doorphone, clicking on icon will allow to preview camera video<br />
|-<br />
|}<br />
</center><br />
<center>'''''Tabela 2:''''' Icons displaying status of phone and camera</center><br />
<br />
== Preferences==<br />
<br />
Clicking '''Preferences''' icon in main program window will display window with program settings. In every tab there is available button with info "About software" and reseting default window position.<br />
<br />
=== Connection===<br />
In '''''Connection''''' field you must enter settings neccesary for application to connect:<br />
<br />
<center>[[File:MessengerCTI_connection.PNG]]</center><br />
<br />
'''Application login setting'''<br />
<br />
To login, application must have correct settings configured by PBX administrator: <br />
* subscriber numbers - extensions from PBX<br />
* CTI access and password:<br />
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/Settings CTI''' - '''CTI - access level''' and pasword'''Pss'''<br />
** for NCP - '''ConfigWEB''' chart '''Extensions/Subscribers/CTI setting''' - '''CTI Access''' and '''Password'''<br />
* Server address - PBX network settings<br />
CTI access level determines what options are available to application:<br />
* CTI.user - MessengerCTI without VoIP and camera preview<br />
* CTI.userPlus - MessengerCTI with VoIP and camera preview<br />
<br />
<br />
These connections settings must be filled:<br />
* '''Subscribers" field - extension number for which '''MessengerCTI.Dekstop''' will login.<br />
* '''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. <br />
* '''server IP address''' - IP address of PBX network interface. IP address of PBX network port. In case of logging outside od PBX network, IP address of edge router(port forwarding on router is necessary, 5529 TCP, 8100-8300 UDP for IPx, 10000-30000 UDP for NCP on PBX LAN interface).<br />
<br />
After user will change his password, administrator no longer will have access to this passowrd. Application can be set to remember user password by checking field while login in, if field wasn't checked application will always ask for password during every login.<br />
<br />
<br />
After proper 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. "Successful login" will apear in lower part of window.<br />
<br />
<br />
If login credentials, configuration settings aren't correct or there are issue with network connection those error messages may appear:<br />
* ''Wrong login or password. Check if correct login or password was used.''<br />
* ''Connecting to PBX'' alternating with<br />
* ''No connection to PBX'' Check IP address that was entered and check computer LAN connection.<br />
<br />
===General===<br />
<br />
<br />
<center>[[File:MessengerCTI_general_settings.PNG]]</center><br />
<br />
This window allows to configure settings defining how program works and startup options.<br />
Available settings:<br />
*Auto start on System startup - automatic start of application.<br />
*Start minimized - application will run hidden in system task bar.<br />
*Set "Be right back" state after - status icon will change automatically, informing about user being away from computer after defined time.<br />
*Set shortcut for application window - changes application from Windows task bar to desktop and vice versa.<br />
*Choose double click function(for contact or number):<br />
**show call window - choice windows is displayed with options - number, phone call, opening chat/SMS window, closing current window<br />
**call primary number - automatic number dialling<br />
**show last events - recent call history to particular subscriber is displayed.<br />
*Set this window position as default - allows to set up default application's window potion on screen.<br />
<br />
===Audio settings===<br />
These setting allow to set up audio notifications informing about incoming calls and messages and audio setting of computer audio devices.<br />
<br />
<br />
<center>[[File:MessengerCTI_audio_settings.PNG]]</center><br />
<br />
*Enable VoIP on when available - allows application to work as VoIP client(VoIP phone)<br />
<br />
<center>[[File:MessengerCTI_voip_settings.PNG]]</center><br />
<br />
==Dialing and picking up calls==<br />
To set up call between two users, particular hardware, software and proper configuration must be supplied:<br />
*Slican PBX<br />
*computer with installed and configured MessengerCTI.Desktop software<br />
**software logged to PBX with subscriber extension(Settings tab, Connection field)<br />
*analog, VoIP or Slican system phone<br />
*for video preview - DPH.IP doorphone with camera or phone associated with external camera(doesn't apply to VoIP phones with integrated camera)<br />
<br />
Call can be dialled using computer mouse and computer screen. Call is made between subscribers through phone connected to PBX and associated with MessengerCTI.Desktop. After choosing subscriber number to call and dialling call, PBX will call extension choosing number(to inform about being ready to set up connection), after picking up handset PBX will set up calling connection.<br />
<br />
==='''Dialing calls to particular number'''===<br />
<center>[[File:MessengerCTI_outgoing_call_window.png]]</center><br />
Making calls can be realised in few different way. Depending on how configured are general setting on application - option "Set double click function".<br />
* from '''Contacts''' tab<br />
**choose subscriber from proper group(if applicable) or from group "All contacts" by double clicking on number or contact<br />
**clicking on [[File:MessengerCTI_tv_green.png | 32px]] or [[File:MessengerCTI_history.png | 32px]]<br />
*'''Search''' field - by directly entering phone number with computer keyboard then clicking on green phone icon.<br />
*'''Recent''' tab - call history:<br />
**history of call with particular subscriber can be seen here, call is dialled by double click on number or contact<br />
**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]]<br />
<br />
==='''Incoming calls'''===<br />
<br />
<center>[[File:MessengerCTI_incoming_window.png]]</center><br />
Calls are displayed on computer screen with pop-up window, ringing application and ringing phone. Depending on applied configuration call can be picked up with application or phone.<br />
<br />
==='''Connecting to camera video preview'''===<br />
Connecting to/from DPH.IP with integrated camera or associated phone or external IP camera(doesn't apply to VoIP phone with integrated cameras)will display automatically new window on computer screen. Connecting to doorphone allows to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.<br />
<br />
<center>[[File:MessengerCTI_camera_preview.png]]</center><br />
<br />
<br />
<br />
===Transfering calls - version 1.03===<br />
Przekazywanie jest możliwe tylko przez wskazanie kontaktu lub numeru znajdującego się w jednej z zakładek: Ostatnie lub Kontakty Call can be transfered by choosing contact or number from: Recent or Contacts.<br />
* "blind transfer" - without checking target extensions state<br />
<center>[[File:MessengerCTI_blind_transfer.png | 700px]]</center><br />
<br />
<br />
* no announcing - check target extension state without announcing <br />
<center>[[File:MessengerCTI_no_announcing.png | 700px]]</center><br />
<br />
<br />
* with annoucing - check target extension state with announcing <br />
<center>[[File:MessengerCTI_with_announcing.png | 700px]]</center><br />
<br />
==Sending messages==<br />
Application allow sending(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.<br />
<br />
Receving new message is signalised on Windows system task bar with two icons alternating [[File:MessengerCTI_free.png | 32px]], [[File:MessengerCTI_mail.png | 32px]] and popping up [[File:MessengerCTI_new_message.png]].<br />
<br />
Messages history is available through hyper link '''Load previous'''. It is stored on computer local hard drive.<br />
<br />
<center>[[File:MessengerCTI_chat.png]]</center><br />
<br />
==Searching data==<br />
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Contacts''' tab in '''Search''':<br />
<br />
<br />
<center>[[File:MessengerCT_search_field.PNG]]</center><br />
<br />
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'''.<br />
<br />
== Contacts==<br />
This field allows for searching, displaying, customising and running actions related to contact. By default '''Favourites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.<br />
<br />
<center>[[File:MessengerCTI_contacts2.png]]</center><br />
<br />
Adding contacts is possible:<br />
<br />
* from search field - entering number and adding it with green handset icon<br />
* from '''Contacts''' or '''Recent''' tab - right clicking on connection<br />
<br />
From contact list we gain access to:<br />
*favourites<br />
*all contacts<br />
*extensions<br />
*created subscriber groups<br />
*public contacts<br />
*private contacts<br />
<br />
== Call history ==<br />
Choosing '''Recent''' tab - in main program window will display call history of currently logged extension to '''''MessengerCTI.Desktop'''''. Window will look like this.<br />
<br />
<br />
<center>[[File:MessengerCTI_recent.PNG]]</center><br />
<br />
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:<br />
<br />
[[File:MessengerCTI_outgoing_calls.PNG | 32px]]<br />
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.<br />
<br />
[[File:MessengerCTI_incoming_calls.PNG | 32px]]<br />
Downward arrow for incoming call that was picked up.<br />
<br />
[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]<br />
Turned arrow for missed incoming calls, digit is showing number of these calls.<br />
<br />
[[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]] [[File:MessengerCTI_message_amount.PNG | 32px]]<br />
Arrow with listed lines or text bubble for text chat or sent SMS. Digit is showing number of missed messages.<br />
If history contains missed calls or unread messages icon in '''Recent''' field will be in colour red.<br />
<br />
From History window call can be dialled or messages be send to chosen users by right clicking on subscribers text status<br />
, clicking on icons [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] and [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]] [[File:MessengerCTI_missed_calls.PNG | 32px]] [[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]]. If internal subscriber have other number listed in their phone book, choice can be made between them. For internal subscribers there is option of editing, deleting contact and deleting from favourite list.<br />
<br />
=Licensing=<br />
==IPX, MAC, CCT PBX==<br />
MessengerCTI.Desktop application:<br />
* 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.<br />
* for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
* calls made form application in VoIP mode are using VoIP channels just like other VoIP devices<br />
* MessengerCTI.Dekstop configured without VoIP and camera preview access - CTIuser license is required<br />
* MessengerCTI.Desktop configured with VoIP and camera preview access - CTIuserplus license is required<br />
<br />
==NCP PBX==<br />
MessengerCTI.Desktop:<br />
* CAN be associated with any subscriber port - analogue, system or VoIP; each subscriber port is treated as 1 user from Base license, additionally while associating application with VoIP port 1 NCP.VoIPuser license is neccesary<br />
** for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
** MessengerCTI.Desktop configured without VoIP and no camera preview access - NCP.CTIuser is required<br />
** MessengerCTI.Desktop configured with VoIP and camera preview access - NCP.CTIuserPlus license is required<br />
* MessengerCTI.Dekstop as standalone subscriber - MCTI (not associated with subscriber port):<br />
** Messenger.CTI Dekstop with VoIP funcionality and camera preview access - NCP.VoIPuser and NCP.CTIuserPlus licenses are required<br />
<br />
=One user and few different numbers=<br />
Sometimes one computer use must operate with few different extensions umber. On workstation(computer) use of "instance" is neccesary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create seperate configuration.<br />
<br />
* default location of program instalation is: C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe<br />
** 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 llok for MessengerCTI, right click -> More/ Open File Location - program icon will appear, right click -> Properties/Shortcut/Target<br />
* create program shortcut on desktop<br />
* in shortcut properties add instance - Properties/Shortcut/Target: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''<br />
* 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''', ...<br />
* while running aplication from shortcuts we can configure each one seperatly for different numbers</div>Marekghttp://pubwiki.slican.com/index.php?title=DPH.IP_doorphone&diff=7826DPH.IP doorphone2019-11-29T09:47:25Z<p>Marekg: /* Doorphone assembly */</p>
<hr />
<div><center>[[File:DPH.IP-CR0RF.png|250px]]</center> <br><br />
<center>[[File:DPH.IP-KS4RF.C.png|200px]] [[File:DPH.IP-KS16RF.C.png|200px]] [[File:DPH.IP-KS1RF.C.png|200px]]</center><br />
<br />
<center>'''Dorphone and RFID reader'''</center><br />
<br />
<center>'''DPH.IP'''</center><br />
<br />
<center>Product manual</center><br />
<br />
<center>Release 1.00</center><br />
<br />
<center>'''Slican Sp. z o.o.'''</center><br />
<br />
<center>[http://www.slican.pl/ www.slican.com] </center><br />
<br />
<center>e-mail: [mailto:office@slican.pl office@slican.pl]</center><br />
<br />
<center>Manufacturer reserves right to make changes without prior notification.</center><br />
<br />
<center>Date of last modification: 2017-06-06</center><br />
<br />
= [[Characteristic of Slican DPH.IP doorphone]] =<br />
<br />
== [[Characteristic and DPH.IP cassettes dimensions]] ==<br />
<br />
==[[DPH.IP Opening housing | Opening doorphone housing]]==<br />
<br />
== [[DPH16 - Doorphone assembly|Doorphone assembly]] ==<br />
===[[DPH16 - Securing against harmful influence of weather conditions | DPH - Securing against harmful influence of weather conditions]]===<br />
<br />
==[[DPH.IP Doorphone keyboard]]==<br />
<br />
== [[DPH.IP Doorphone connection]] ==<br />
=== [[DPH.IP camera plug|Mounting camera module in DPH.IP doorphone]] ===<br />
<br />
== [[PBX configuration for doorphone operation]] ==<br />
<br />
== [[DPH.IP Doorphone programming]] ==<br />
<br />
== [[DPH16 - Doorphone using|Doorphone using]] ==<br />
<br />
= [[Safety requirements while using DPH series doorphones]] =<br />
<br />
= [[DPH.IP certificate of conformity and proper device disposal]] =</div>Marekghttp://pubwiki.slican.com/index.php?title=DPH_1-_and_2-button_doorphone_v1_02&diff=7825DPH 1- and 2-button doorphone v1 022019-11-29T09:41:32Z<p>Marekg: /* DPH - Doorphone assembly */</p>
<hr />
<div><center>[[File:DPH KS1 przod.png|150px]][[File:DPH KS2 przod.png|150px]][[File:DPH KS1RF przod.png|150px]][[File:DPH KS2RF przod.png|150px]]</center><br />
<br />
<center>'''Doorphones'''</center><br />
<br />
<center>'''DPH.AB-KS1, DPH.AB-KS2'''</center><br />
<br />
<center>'''DPH.AB-KS1RF, DPH.AB-KS2RF'''</center><br />
<br />
<center>Installation and maintenance instruction</center><br />
<br />
<center>Issue 1.02</center><br />
<br />
<center>'''Slican Sp. z o.o.'''</center><br />
<br />
<center>[http://www.slican.pl/ www.slican.pl] </center><br />
<br />
<center>e-mail: [mailto:office@slican.pl office@slican.pl]</center><br />
<br />
<center>Manufacturer reserves right to make changes without prior notification.</center><br />
<br />
<center>Date of last modification: 2011-11-22</center><br />
<br />
= [[Characteristic of Slican DPH doorphones]] =<br />
<br />
= [[Doorphone installation]] =<br />
<br />
== [[Characteristic and KS cassettes dimensions]] ==<br />
<br />
== [[DPH - Opening doorphone casing]] ==<br />
<br />
== [[DPH - Doorphone assembly]] ==<br />
===[[DPH - Over-plaster or under-plaster assembly]]===<br />
<br />
===[[DPH - Assembly on fence]]===<br />
===[[DPH16 - Securing against harmful influence of weather conditions | DPH - Securing against harmful influence of weather conditions]]===<br />
<br />
== [[DPH - Doorprone buttons]] ==<br />
<br />
== [http://hpserwer/generatory/generator-dph.php Scheme for creating and printing description label] ==<br />
<br />
== [[DPH - Doorphone connection]] ==<br />
<br />
== [[PBX configuration for doorphone operation]] ==<br />
<br />
== [[DPH - Doorphone programming]] ==<br />
<br />
== [[DPH - RFID cards registration]] ==<br />
== [[DPH - USB interface using]] ==<br />
<br />
= [[DPH - Doorphone using]] =<br />
<br />
= [[Safety requirements while using DPH series doorphones]] =<br />
<br />
= [[DPH certificate of conformity, proper device disposal]] =<br />
= [[Previous versions of Instruction]] =</div>Marekghttp://pubwiki.slican.com/index.php?title=DPH_16-button_doorphone_v1_02&diff=7824DPH 16-button doorphone v1 022019-11-29T09:41:20Z<p>Marekg: /* DPH16 - Securing against harmful influence of weather conditions */</p>
<hr />
<div><center>[[File:DPH KS16 przod.png|150px]]</center><br />
<br />
<center>'''Dorphone'''</center><br />
<br />
<center>'''DPH.AB-KS16'''</center><br />
<br />
<center>Installation and maintenance instruction</center><br />
<br />
<center>Issue 1.02</center><br />
<br />
<center>'''Slican Sp. z o.o.'''</center><br />
<br />
<center>[http://www.slican.pl/ www.slican.com] </center><br />
<br />
<center>e-mail: [mailto:office@slican.pl office@slican.pl]</center><br />
<br />
<center>Manufacturer reserves right to make changes without prior notification.</center><br />
<br />
<center>Date of last modification: 2011-11-23</center><br />
<br />
= [[Characteristic of Slican DPH.AB-KS16 doorphone]] =<br />
<br />
= [[Doorphone installation]] =<br />
<br />
== [[Characteristic and KS cassettes dimensions]] ==<br />
<br />
== [[DPH16 - Opening doorphone casing]] ==<br />
<br />
== [[DPH16 - Doorphone assembly]] ==<br />
===[[DPH16 - Over-plaster or under-plaster assembly]]===<br />
<br />
===[[DPH16 - Assembly on fence]]===<br />
<br />
===[[DPH16 - Securing against harmful influence of weather conditions | DPH - Securing against harmful influence of weather conditions]]===<br />
<br />
== [[DPH16 - Doorphone keyboard]] ==<br />
<br />
== [[DPH16 - Doorphone connection]] ==<br />
<br />
== [[PBX configuration for doorphone operation]] ==<br />
<br />
== [[DPH - Doorphone DPH.AB-KS16 programming]] ==<br />
== [[DPH16 - USB interface using]] ==<br />
<br />
== [[DPH16 - Doorphone using]] ==<br />
<br />
= [[Safety requirements while using DPH series doorphones]] =<br />
<br />
= [[DPH certificate of conformity, proper device disposal]] =<br />
= [[DPH16 - Previous versions of Instruction]] =</div>Marekghttp://pubwiki.slican.com/index.php?title=DPH_16-button_doorphone_v1_02&diff=7823DPH 16-button doorphone v1 022019-11-29T09:40:08Z<p>Marekg: /* DPH - Securing against harmful influence of weather conditions */</p>
<hr />
<div><center>[[File:DPH KS16 przod.png|150px]]</center><br />
<br />
<center>'''Dorphone'''</center><br />
<br />
<center>'''DPH.AB-KS16'''</center><br />
<br />
<center>Installation and maintenance instruction</center><br />
<br />
<center>Issue 1.02</center><br />
<br />
<center>'''Slican Sp. z o.o.'''</center><br />
<br />
<center>[http://www.slican.pl/ www.slican.com] </center><br />
<br />
<center>e-mail: [mailto:office@slican.pl office@slican.pl]</center><br />
<br />
<center>Manufacturer reserves right to make changes without prior notification.</center><br />
<br />
<center>Date of last modification: 2011-11-23</center><br />
<br />
= [[Characteristic of Slican DPH.AB-KS16 doorphone]] =<br />
<br />
= [[Doorphone installation]] =<br />
<br />
== [[Characteristic and KS cassettes dimensions]] ==<br />
<br />
== [[DPH16 - Opening doorphone casing]] ==<br />
<br />
== [[DPH16 - Doorphone assembly]] ==<br />
===[[DPH16 - Over-plaster or under-plaster assembly]]===<br />
<br />
===[[DPH16 - Assembly on fence]]===<br />
<br />
===[[DPH16 - Securing against harmful influence of weather conditions | DPH16 - Securing against harmful influence of weather conditions]]===<br />
<br />
== [[DPH16 - Doorphone keyboard]] ==<br />
<br />
== [[DPH16 - Doorphone connection]] ==<br />
<br />
== [[PBX configuration for doorphone operation]] ==<br />
<br />
== [[DPH - Doorphone DPH.AB-KS16 programming]] ==<br />
== [[DPH16 - USB interface using]] ==<br />
<br />
== [[DPH16 - Doorphone using]] ==<br />
<br />
= [[Safety requirements while using DPH series doorphones]] =<br />
<br />
= [[DPH certificate of conformity, proper device disposal]] =<br />
= [[DPH16 - Previous versions of Instruction]] =</div>Marekghttp://pubwiki.slican.com/index.php?title=File:DPH_natynk_uszczelniac.png&diff=7822File:DPH natynk uszczelniac.png2019-11-29T09:38:20Z<p>Marekg: </p>
<hr />
<div></div>Marekghttp://pubwiki.slican.com/index.php?title=DPH16_-_Securing_against_harmful_influence_of_weather_conditions&diff=7821DPH16 - Securing against harmful influence of weather conditions2019-11-29T09:38:08Z<p>Marekg: </p>
<hr />
<div>Doorphone case is resistant to weather conditions, however when mounting outside build it is recommended to place it while sheltered, to avoid directly failing rain or wind, which can distrupt while talking through doorphone. During surface mounting, it is recommended to apply special rust-resistant cover, sheltering from weather conditions, so called "roof".<br />
<br />
For proper protection against weather, connected cables must be properly routed inside case through opening nr.3. Ater routing cable, opening must be sealed with silicone layer.<br />
<br />
<br><center>[[File:DPH_natynk_uszczelniac.png|500px]]</center></div>Marekghttp://pubwiki.slican.com/index.php?title=DPH16_-_Securing_against_harmful_influence_of_weather_conditions&diff=7820DPH16 - Securing against harmful influence of weather conditions2019-11-29T09:37:40Z<p>Marekg: Created page with "Doorphone case is resistant to weather conditions, however when mounting outside build it is recommended to place it while sheltered, to avoid directly failing rain or wind, w..."</p>
<hr />
<div>Doorphone case is resistant to weather conditions, however when mounting outside build it is recommended to place it while sheltered, to avoid directly failing rain or wind, which can distrupt while talking through doorphone. During surface mounting, it is recommended to apply special rust-resistant cover, sheltering from weather conditions, so called "roof".<br />
<br />
For proper protection against weather, connected cables must be properly routed inside case through opening nr.3. Ater routing cable, opening must be sealed with silicone layer.<br />
<br />
<br><center>[[Plik:DPH_natynk_uszczelniac.png|500px]]</center></div>Marekghttp://pubwiki.slican.com/index.php?title=DPH_16-button_doorphone_v1_02&diff=7819DPH 16-button doorphone v1 022019-11-29T09:18:36Z<p>Marekg: /* DPH16 - Doorphone assembly */</p>
<hr />
<div><center>[[File:DPH KS16 przod.png|150px]]</center><br />
<br />
<center>'''Dorphone'''</center><br />
<br />
<center>'''DPH.AB-KS16'''</center><br />
<br />
<center>Installation and maintenance instruction</center><br />
<br />
<center>Issue 1.02</center><br />
<br />
<center>'''Slican Sp. z o.o.'''</center><br />
<br />
<center>[http://www.slican.pl/ www.slican.com] </center><br />
<br />
<center>e-mail: [mailto:office@slican.pl office@slican.pl]</center><br />
<br />
<center>Manufacturer reserves right to make changes without prior notification.</center><br />
<br />
<center>Date of last modification: 2011-11-23</center><br />
<br />
= [[Characteristic of Slican DPH.AB-KS16 doorphone]] =<br />
<br />
= [[Doorphone installation]] =<br />
<br />
== [[Characteristic and KS cassettes dimensions]] ==<br />
<br />
== [[DPH16 - Opening doorphone casing]] ==<br />
<br />
== [[DPH16 - Doorphone assembly]] ==<br />
===[[DPH16 - Over-plaster or under-plaster assembly]]===<br />
<br />
===[[DPH16 - Assembly on fence]]===<br />
<br />
===[[DPH16 - Securing against harmful influence of weather conditions | DPH - Securing against harmful influence of weather conditions]]===<br />
<br />
== [[DPH16 - Doorphone keyboard]] ==<br />
<br />
== [[DPH16 - Doorphone connection]] ==<br />
<br />
== [[PBX configuration for doorphone operation]] ==<br />
<br />
== [[DPH - Doorphone DPH.AB-KS16 programming]] ==<br />
== [[DPH16 - USB interface using]] ==<br />
<br />
== [[DPH16 - Doorphone using]] ==<br />
<br />
= [[Safety requirements while using DPH series doorphones]] =<br />
<br />
= [[DPH certificate of conformity, proper device disposal]] =<br />
= [[DPH16 - Previous versions of Instruction]] =</div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI_Manual&diff=7818MessengerCTI Manual2019-04-16T10:38:48Z<p>Marekg: Undo revision 7817 by Marekg (talk)</p>
<hr />
<div>= Introduction =<br />
Slican '''MessengerCTI.Desktop''' is software which purpose is to assist users of Slican PBX. Thanks to the graphic interface displayed on the computer screen, software allows for convenient access of telephone calls and other functions related to it. Software delivers additional features that allows to expand capabilities of desk phone. Software combines capabilities of controlling desk phone connected to PBX, for example choosing number, receiving calls and also application is able to function as standalone phone. Software also allows to: accessing PBX's phonebook, call history, status of phone and other users of MessengerCTI, text communication and sending or receiving SMS messages. Additionally for new version of DPH.IP doorphone equipped with camera - video preview was added.<br />
<br />
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). Users of analogue phones will benefit from this software because they'll gain access to functions that aren't available on these types of devices.<br />
<br />
= Basic functionalities =<br />
<br />
=== Using cameras and DPH.IP doorphones ===<br />
<br />
Introduction of DPH.IP doorphones that include cameras led to solution that allows display of video from these cameras. Functionality was added with MessengerCTI.Desktop. While connecting to doorphone from software video from camera will appear in new window on computer display. After picking up and finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door,gate, using dedicated button. Reverse is also true, calling doorphone or another telephone number associated with camera, display screen will show video from camera. This allow for temporary observation of surroundings of installed camera, for example person we are calling. There is also option of watching video from any camera without making call, just using application icon. Thanks to MessengerCTI.Desktop user can preview video from camera of other manufacturers but those devices have to support video formats, codec compatible with VLC application libraries.<br />
<br />
{{Attention!|<br />
MessengerCTI.Desktop application was released mainly for displaying video from DPH.IP doorphones and and this time doesn't yet have all fuctionality of PhoneCTI application. Those options will be added gradually}}<br />
<br />
=== VoiP Client===<br />
<br />
MessengerCTI.Desktop can work as VoIP, concurrent phone connected to stationary desk phone(FXS,CTS,IP). User can decide on which device to pick up a call, phone or a computer - using it's integrated audio devices(sound card, microphone, speakers or external headphones). Since 1.11 version of NCP firmware application can be used as standalone SIP phone. For such configuration CTIuserPlus license is required.<br />
<br />
<br />
=== Phone Book ===<br />
<br />
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 possible instantly after adding it. Access to phone book allows to simply search numbers of contacts user want to call. On other hand, during incoming calls computer displaying will be showing clear information about calling person.<br />
<br />
=== Call History ===<br />
<br />
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.<br />
<br />
=== Text messages ===<br />
<br />
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.<br />
<br />
=== Usage alongside mobile version ===<br />
<br />
Application can be used alongside and synchronized to MessengerCTI.Mobile, Android version for mobile devices.<br />
<br />
<br />
= Minimum requirements =<br />
To install SLICAN MessengerCTI.Desktop application, following minimum requirements must be met:<br />
*CPU Frequency - 800 mhz or higher<br />
*Ram - 1 GB or more<br />
*GPU- compatible with DirectX 9 <br />
*Operating System - Windows 7 or more recent<br />
<br />
Application can be installed on computer which doesn't meet minimum requirements but it will run slowly or some option won't work correctly.<br />
{{Attention!|<br />
'''MessengerCTI.Desktop''' application works with IPx, Mac and CCT PBX with firmware 6.52 or newer, or NCP PBX with firmware 1.10}}<br />
<br />
= Installation of application =<br />
<br />
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 computer. After installing, application should be properly configured by entering necessary PBX information to which software should be conencted:<br />
Settings - Connection.<br />
{{Attention!|<br />
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.}}<br />
<br />
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"<br />
<br />
== Running application ==<br />
<br />
MessengerCTI.Dekstop can be run just as any other Windows compatible software. In the program settings automatic start during launch of operating system can bet set. During start of program it is logging to PBX(according to settings set in Settings - Connection tab). After successful login program data is synchronized with PBX data.<br />
<br />
== Updating application ==<br />
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 <br />
compared to version on PBX. If they differ, version from PBX is automaticly downloaded, installed and logged to PBX. Depending on version from PBX it may install newer or old version.<br />
<br />
= Available configurations =<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned off) - calling with phone, application - dialling up outgoing calls for phone(CTS, FXS, SIP) and picking up incoming calls for phone (CTS)<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned on) independent choice of picking/dialing up call with phone or application.<br />
*Autonomous application without desk phone (application VoIP mode on) - picking/dialling calls only with application.<br />
<br />
Other functionalities for example chat, sending and receiving SMS, displaying video from camera, accessing call history and phone book, configuring user status and Messenger aplication are available for each of the above configurations.<br />
<br />
Application '''MessengerCTI.Mobile''' is intended for mobile devices with Android system, its description can be found HERE(manual in progress).<br />
<br />
== '''MessengerCTI.Desktop''' with simultaneous configuration ==<br />
<br />
===Application with VoIP mode turned OFF.===<br />
<br />
Phone calls are made only using phone working alongside application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, dialling with phone speaker using CTS phone<br />
*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.<br />
<br />
For user of FXS nad SIP phones picking up earphone is necessary.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_VoIP.png |800px]]</center><br />
<br />
===Application with VoIP mode turned ON.===<br />
<br />
Phone calls can are made with phone or with computer and application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_with_phone.png |800px]]</center><br />
<br />
== '''MessengerCTI.Desktop''' working as standalone phone (only with NCP)==<br />
<br />
===Application with VoIP mode turned on.===<br />
<br />
Phone calls are made only with computer and application. Standalone applications allows:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_phone.png |800px]]</center><br />
<br />
= Program structure =<br />
==Main window==<br />
Main windows of MessengerCTI.Desktop application contains interface which show information and allows access to chat windows and main functions.<br />
<center>[[File:MessengerCTI_main_window.PNG]]</center><br />
===Upper part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_-_main_window_-_upper.png]]<br />
*left side<br />
**hyperlink to software version<br />
<br />
*right side<br />
**default window position button<br />
**close - minimizing to tray button<br />
<br />
===Middle part of window:===<br />
<br />
[[File:MessengerCTIDesktop_-_main_window_-_middle.png]]<br />
*left side:<br />
**changing application status button<br />
<br />
*middle: program name,below - user status - field that can by user to provide additional urlop, for example to inform about vacation or being busy with project<br />
<br />
*right side:<br />
**searching (magnifying glass) - button/field for searching number or contact<br />
**preferences - access to program settings<br />
<br />
===Lower part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_main_window_lower.PNG]]<br />
*access to tabs:<br />
**contacts - phonebook from bx with sorting options<br />
**recent - history of most recent calls and messages.<br />
<br />
== Status of application and user ==<br />
'''MessengerCTI.Dekstop''' software allows to show current status of user with coloured symbol and display it inside applications of other users. Applications status is informing about user availability, depending on user actions status can be changed by him or application can change it automatically. More information can be added through text status of user. User can choose different icons/symbol to set his status manually. Additionally there is graphic informing about ringing phone or current call.<br />
<br />
===List of icons and symbols===<br />
Chart presents list of icons available in '''Contacts''' and '''Recent''' tabs:<br />
<br />
* [[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.<br />
* [[File:MessengerCTI_history.png | 32px]] - for public subscribers.<br />
* [[File:MessengerCTI_close_door.png | 32px]] - for DPH.IP doorphones connected to open/closed door sensor<br />
<br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Status of application and DPH.IP doorphones<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_green.png | 32px]] ||PBX subscriber; '''MessengerCTI.Desktop''' application is running '''and and LOGGED IN'''from subscriber computer. Clicking icon will allow to send text messeger, SMS or dial a call to another application user.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_chat_tv_yellow.png | 29px]] ||PBX subscriber; '''Be right back''' set by user or application, delay time is definied in general settings of application.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_red.png | 32px]] ||PBX subscriber; '''Do not disturb''' set by user<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_grey.png | 32px]] ||PBX subscriber; '''Invisible''' set by user or application is logged off.<br />
|-<br />
|{{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)<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_history.png | 32px]] ||public subscriber; clicking icon will allow to send SMS or dial call to chosen subscriber.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_close_door.png | 32px]] ||doorphone; current door position - door closed, clicking icon will open door<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_open_door.png | 32px]] ||doorphone; door are open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_alarm_open_door.png | 32px]] ||doorphone; alarm timer for open doors was set off<br />
|-<br />
|}<br />
'''''Chart 1:''''' Meaning of icon status of application, users and doorphones.<br><br />
<br />
Chart is showing list if icon that appear on the left side of subscriber name in tab '''Contacts''' and '''Recent'''. Internal phone will have status icon being displayed<br />
<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Phone status and camera information<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_bell_red.png | 28px]] ||Phone is ringing<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_phone_red.png | 32px]] || During call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_camera.png | 25px]] ||Camera is associeted with phone or doorphone, clicking on icon will allow to preview camera video<br />
|-<br />
|}<br />
</center><br />
<center>'''''Tabela 2:''''' Icons displaying status of phone and camera</center><br />
<br />
== Preferences==<br />
<br />
Clicking '''Preferences''' icon in main program window will display window with program settings. In every tab there is available button with info "About software" and reseting default window position.<br />
<br />
=== Connection===<br />
In '''''Connection''''' field you must enter settings neccesary for application to connect:<br />
<br />
<center>[[File:MessengerCTI_connection.PNG]]</center><br />
<br />
'''Application login setting'''<br />
<br />
To login, application must have correct settings configured by PBX administrator: <br />
* subscriber numbers - extensions from PBX<br />
* CTI access and password:<br />
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/Settings CTI''' - '''CTI - access level''' and pasword'''Pss'''<br />
** for NCP - '''ConfigWEB''' chart '''Extensions/Subscribers/CTI setting''' - '''CTI Access''' and '''Password'''<br />
* Server address - PBX network settings<br />
CTI access level determines what options are available to application:<br />
* CTI.user - MessengerCTI without VoIP and camera preview<br />
* CTI.userPlus - MessengerCTI with VoIP and camera preview<br />
<br />
<br />
These connections settings must be filled:<br />
* '''Subscribers" field - extension number for which '''MessengerCTI.Dekstop''' will login.<br />
* '''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. <br />
* '''server IP address''' - IP address of PBX network interface. IP address of PBX network port. In case of logging outside od PBX network, IP address of edge router(port forwarding on router is necessary, 5529 TCP, 8100-8300 UDP for IPx, 10000-30000 UDP for NCP on PBX LAN interface).<br />
<br />
After user will change his password, administrator no longer will have access to this passowrd. Application can be set to remember user password by checking field while login in, if field wasn't checked application will always ask for password during every login.<br />
<br />
<br />
After proper 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. "Successful login" will apear in lower part of window.<br />
<br />
<br />
If login credentials, configuration settings aren't correct or there are issue with network connection those error messages may appear:<br />
* ''Wrong login or password. Check if correct login or password was used.''<br />
* ''Connecting to PBX'' alternating with<br />
* ''No connection to PBX'' Check IP address that was entered and check computer LAN connection.<br />
<br />
===General===<br />
<br />
<br />
<center>[[File:MessengerCTI_general_settings.PNG]]</center><br />
<br />
This window allows to configure settings defining how program works and startup options.<br />
Available settings:<br />
*Auto start on System startup - automatic start of application.<br />
*Start minimized - application will run hidden in system task bar.<br />
*Set "Be right back" state after - status icon will change automatically, informing about user being away from computer after defined time.<br />
*Set shortcut for application window - changes application from Windows task bar to desktop and vice versa.<br />
*Choose double click function(for contact or number):<br />
**show call window - choice windows is displayed with options - number, phone call, opening chat/SMS window, closing current window<br />
**call primary number - automatic number dialling<br />
**show last events - recent call history to particular subscriber is displayed.<br />
*Set this window position as default - allows to set up default application's window potion on screen.<br />
<br />
===Audio settings===<br />
These setting allow to set up audio notifications informing about incoming calls and messages and audio setting of computer audio devices.<br />
<br />
<br />
<center>[[File:MessengerCTI_audio_settings.PNG]]</center><br />
<br />
*Enable VoIP on when available - allows application to work as VoIP client(VoIP phone)<br />
<br />
<center>[[File:MessengerCTI_voip_settings.PNG]]</center><br />
<br />
==Dialing and picking up calls==<br />
To set up call between two users, particular hardware, software and proper configuration must be supplied:<br />
*Slican PBX<br />
*computer with installed and configured MessengerCTI.Desktop software<br />
**software logged to PBX with subscriber extension(Settings tab, Connection field)<br />
*analog, VoIP or Slican system phone<br />
*for video preview - DPH.IP doorphone with camera or phone associated with external camera(doesn't apply to VoIP phones with integrated camera)<br />
<br />
Call can be dialled using computer mouse and computer screen. Call is made between subscribers through phone connected to PBX and associated with MessengerCTI.Desktop. After choosing subscriber number to call and dialling call, PBX will call extension choosing number(to inform about being ready to set up connection), after picking up handset PBX will set up calling connection.<br />
<br />
==='''Dialing calls to particular number'''===<br />
<center>[[File:MessengerCTI_outgoing_call_window.png]]</center><br />
Making calls can be realised in few different way. Depending on how configured are general setting on application - option "Set double click function".<br />
* from '''Contacts''' tab<br />
**choose subscriber from proper group(if applicable) or from group "All contacts" by double clicking on number or contact<br />
**clicking on [[File:MessengerCTI_tv_green.png | 32px]] or [[File:MessengerCTI_history.png | 32px]]<br />
*'''Search''' field - by directly entering phone number with computer keyboard then clicking on green phone icon.<br />
*'''Recent''' tab - call history:<br />
**history of call with particular subscriber can be seen here, call is dialled by double click on number or contact<br />
**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]]<br />
<br />
==='''Incoming calls'''===<br />
<br />
<center>[[File:MessengerCTI_incoming_window.png]]</center><br />
Calls are displayed on computer screen with pop-up window, ringing application and ringing phone. Depending on applied configuration call can be picked up with application or phone.<br />
<br />
==='''Connecting to camera video preview'''===<br />
Connecting to/from DPH.IP with integrated camera or associated phone or external IP camera(doesn't apply to VoIP phone with integrated cameras)will display automatically new window on computer screen. Connecting to doorphone allows to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.<br />
<br />
<center>[[FIle:MessengerCTI_camera_preview.png]]</center><br />
<br />
==Sending messages==<br />
Application allow sending(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.<br />
<br />
Receving new message is signalised on Windows system task bar with two icons alternating [[File:MessengerCTI_free.png | 32px]], [[File:MessengerCTI_mail.png | 32px]] and popping up [[File:MessengerCTI_new_message.png]].<br />
<br />
Messages history is available through hyper link '''Load previous'''. It is stored on computer local hard drive.<br />
<br />
<center>[[File:MessengerCTI_chat.png]]</center><br />
<br />
==Searching data==<br />
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Contacts''' tab in '''Search''':<br />
<br />
<br />
<center>[[File:MessengerCT_search_field.PNG]]</center><br />
<br />
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'''.<br />
<br />
== Contacts==<br />
This field allows for searching, displaying, customising and running actions related to contact. By default '''Favourites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.<br />
<br />
<center>[[File:MessengerCTI_contacts2.png]]</center><br />
<br />
Adding contacts is possible:<br />
<br />
* from search field - entering number and adding it with green handset icon<br />
* from '''Contacts''' or '''Recent''' tab - right clicking on connection<br />
<br />
From contact list we gain access to:<br />
*favourites<br />
*all contacts<br />
*extensions<br />
*created subscriber groups<br />
*public contacts<br />
*private contacts<br />
<br />
== Call history ==<br />
Choosing '''Recent''' tab - in main program window will display call history of currently logged extension to '''''MessengerCTI.Desktop'''''. Window will look like this.<br />
<br />
<br />
<center>[[File:MessengerCTI_recent.PNG]]</center><br />
<br />
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:<br />
<br />
[[File:MessengerCTI_outgoing_calls.PNG | 32px]]<br />
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.<br />
<br />
[[File:MessengerCTI_incoming_calls.PNG | 32px]]<br />
Downward arrow for incoming call that was picked up.<br />
<br />
[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]<br />
Turned arrow for missed incoming calls, digit is showing number of these calls.<br />
<br />
[[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]] [[File:MessengerCTI_message_amount.PNG | 32px]]<br />
Arrow with listed lines or text bubble for text chat or sent SMS. Digit is showing number of missed messages.<br />
If history contains missed calls or unread messages icon in '''Recent''' field will be in colour red.<br />
<br />
From History window call can be dialled or messages be send to chosen users by right clicking on subscribers text status<br />
, clicking on icons [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] and [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]] [[File:MessengerCTI_missed_calls.PNG | 32px]] [[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]]. If internal subscriber have other number listed in their phone book, choice can be made between them. For internal subscribers there is option of editing, deleting contact and deleting from favourite list.<br />
<br />
=Licensing=<br />
==IPX, MAC, CCT PBX==<br />
MessengerCTI.Desktop application:<br />
* 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.<br />
* for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
* calls made form application in VoIP mode are using VoIP channels just like other VoIP devices<br />
* MessengerCTI.Dekstop configured without VoIP and camera preview access - CTIuser license is required<br />
* MessengerCTI.Desktop configured with VoIP and camera preview access - CTIuserplus license is required<br />
<br />
==NCP PBX==<br />
MessengerCTI.Desktop:<br />
* CAN be associated with any subscriber port - analogue, system or VoIP; each subscriber port is treated as 1 user from Base license, additionally while associating application with VoIP port 1 NCP.VoIPuser license is neccesary<br />
** for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
** MessengerCTI.Desktop configured without VoIP and no camera preview access - NCP.CTIuser is required<br />
** MessengerCTI.Desktop configured with VoIP and camera preview access - NCP.CTIuserPlus license is required<br />
* MessengerCTI.Dekstop as standalone subscriber - MCTI (not associated with subscriber port):<br />
** Messenger.CTI Dekstop with VoIP funcionality and camera preview access - NCP.VoIPuser and NCP.CTIuserPlus licenses are required<br />
<br />
=One user and few different numbers=<br />
Sometimes one computer use must operate with few different extensions umber. On workstation(computer) use of "instance" is neccesary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create seperate configuration.<br />
<br />
* default location of program instalation is: C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe<br />
** 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 llok for MessengerCTI, right click -> More/ Open File Location - program icon will appear, right click -> Properties/Shortcut/Target<br />
* create program shortcut on desktop<br />
* in shortcut properties add instance - Properties/Shortcut/Target: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''<br />
* 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''', ...<br />
* while running aplication from shortcuts we can configure each one seperatly for different numbers</div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI_Manual&diff=7817MessengerCTI Manual2019-04-16T10:37:47Z<p>Marekg: /* Call history */</p>
<hr />
<div>= Introduction =<br />
Slican '''MessengerCTI.Desktop''' is software which purpose is to assist users of Slican PBX. Thanks to the graphic interface displayed on the computer screen, software allows for convenient access of telephone calls and other functions related to it. Software delivers additional features that allows to expand capabilities of desk phone. Software combines capabilities of controlling desk phone connected to PBX, for example choosing number, receiving calls and also application is able to function as standalone phone. Software also allows to: accessing PBX's phonebook, call history, status of phone and other users of MessengerCTI, text communication and sending or receiving SMS messages. Additionally for new version of DPH.IP doorphone equipped with camera - video preview was added.<br />
<br />
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). Users of analogue phones will benefit from this software because they'll gain access to functions that aren't available on these types of devices.<br />
<br />
= Basic functionalities =<br />
<br />
=== Using cameras and DPH.IP doorphones ===<br />
<br />
Introduction of DPH.IP doorphones that include cameras led to solution that allows display of video from these cameras. Functionality was added with MessengerCTI.Desktop. While connecting to doorphone from software video from camera will appear in new window on computer display. After picking up and finishing call, even after without talking to person standing beside doorphone, just after visual check user can open door,gate, using dedicated button. Reverse is also true, calling doorphone or another telephone number associated with camera, display screen will show video from camera. This allow for temporary observation of surroundings of installed camera, for example person we are calling. There is also option of watching video from any camera without making call, just using application icon. Thanks to MessengerCTI.Desktop user can preview video from camera of other manufacturers but those devices have to support video formats, codec compatible with VLC application libraries.<br />
<br />
{{Attention!|<br />
MessengerCTI.Desktop application was released mainly for displaying video from DPH.IP doorphones and and this time doesn't yet have all fuctionality of PhoneCTI application. Those options will be added gradually}}<br />
<br />
=== VoiP Client===<br />
<br />
MessengerCTI.Desktop can work as VoIP, concurrent phone connected to stationary desk phone(FXS,CTS,IP). User can decide on which device to pick up a call, phone or a computer - using it's integrated audio devices(sound card, microphone, speakers or external headphones). Since 1.11 version of NCP firmware application can be used as standalone SIP phone. For such configuration CTIuserPlus license is required.<br />
<br />
<br />
=== Phone Book ===<br />
<br />
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 possible instantly after adding it. Access to phone book allows to simply search numbers of contacts user want to call. On other hand, during incoming calls computer displaying will be showing clear information about calling person.<br />
<br />
=== Call History ===<br />
<br />
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.<br />
<br />
=== Text messages ===<br />
<br />
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.<br />
<br />
=== Usage alongside mobile version ===<br />
<br />
Application can be used alongside and synchronized to MessengerCTI.Mobile, Android version for mobile devices.<br />
<br />
<br />
= Minimum requirements =<br />
To install SLICAN MessengerCTI.Desktop application, following minimum requirements must be met:<br />
*CPU Frequency - 800 mhz or higher<br />
*Ram - 1 GB or more<br />
*GPU- compatible with DirectX 9 <br />
*Operating System - Windows 7 or more recent<br />
<br />
Application can be installed on computer which doesn't meet minimum requirements but it will run slowly or some option won't work correctly.<br />
{{Attention!|<br />
'''MessengerCTI.Desktop''' application works with IPx, Mac and CCT PBX with firmware 6.52 or newer, or NCP PBX with firmware 1.10}}<br />
<br />
= Installation of application =<br />
<br />
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 computer. After installing, application should be properly configured by entering necessary PBX information to which software should be conencted:<br />
Settings - Connection.<br />
{{Attention!|<br />
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.}}<br />
<br />
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"<br />
<br />
== Running application ==<br />
<br />
MessengerCTI.Dekstop can be run just as any other Windows compatible software. In the program settings automatic start during launch of operating system can bet set. During start of program it is logging to PBX(according to settings set in Settings - Connection tab). After successful login program data is synchronized with PBX data.<br />
<br />
== Updating application ==<br />
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 <br />
compared to version on PBX. If they differ, version from PBX is automaticly downloaded, installed and logged to PBX. Depending on version from PBX it may install newer or old version.<br />
<br />
= Available configurations =<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned off) - calling with phone, application - dialling up outgoing calls for phone(CTS, FXS, SIP) and picking up incoming calls for phone (CTS)<br />
*Simultaneous operation of desk phone and application (application VoIP mode is turned on) independent choice of picking/dialing up call with phone or application.<br />
*Autonomous application without desk phone (application VoIP mode on) - picking/dialling calls only with application.<br />
<br />
Other functionalities for example chat, sending and receiving SMS, displaying video from camera, accessing call history and phone book, configuring user status and Messenger aplication are available for each of the above configurations.<br />
<br />
Application '''MessengerCTI.Mobile''' is intended for mobile devices with Android system, its description can be found HERE(manual in progress).<br />
<br />
== '''MessengerCTI.Desktop''' with simultaneous configuration ==<br />
<br />
===Application with VoIP mode turned OFF.===<br />
<br />
Phone calls are made only using phone working alongside application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, dialling with phone speaker using CTS phone<br />
*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.<br />
<br />
For user of FXS nad SIP phones picking up earphone is necessary.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_VoIP.png |800px]]</center><br />
<br />
===Application with VoIP mode turned ON.===<br />
<br />
Phone calls can are made with phone or with computer and application. Application allows to:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<br />
<center>[[File:MessengerCTI.Desktop_with_phone.png |800px]]</center><br />
<br />
== '''MessengerCTI.Desktop''' working as standalone phone (only with NCP)==<br />
<br />
===Application with VoIP mode turned on.===<br />
<br />
Phone calls are made only with computer and application. Standalone applications allows:<br />
*for outgoing calls - searching for number in phone book or typing phone number using computer keyboard, initiating dialling, calling while using computer microphone and speakers or external headphones<br />
*for incoming calls - triggering sound of incoming call, displaying calling number/name from phonebook, picking up call with computer microphone, speakers or external headphones.<br />
<br />
<center>[[File:MessengerCTI.Desktop_without_phone.png |800px]]</center><br />
<br />
= Program structure =<br />
==Main window==<br />
Main windows of MessengerCTI.Desktop application contains interface which show information and allows access to chat windows and main functions.<br />
<center>[[File:MessengerCTI_main_window.PNG]]</center><br />
===Upper part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_-_main_window_-_upper.png]]<br />
*left side<br />
**hyperlink to software version<br />
<br />
*right side<br />
**default window position button<br />
**close - minimizing to tray button<br />
<br />
===Middle part of window:===<br />
<br />
[[File:MessengerCTIDesktop_-_main_window_-_middle.png]]<br />
*left side:<br />
**changing application status button<br />
<br />
*middle: program name,below - user status - field that can by user to provide additional urlop, for example to inform about vacation or being busy with project<br />
<br />
*right side:<br />
**searching (magnifying glass) - button/field for searching number or contact<br />
**preferences - access to program settings<br />
<br />
===Lower part of window:===<br />
<br />
[[File:MessengerCTI.Desktop_main_window_lower.PNG]]<br />
*access to tabs:<br />
**contacts - phonebook from bx with sorting options<br />
**recent - history of most recent calls and messages.<br />
<br />
== Status of application and user ==<br />
'''MessengerCTI.Dekstop''' software allows to show current status of user with coloured symbol and display it inside applications of other users. Applications status is informing about user availability, depending on user actions status can be changed by him or application can change it automatically. More information can be added through text status of user. User can choose different icons/symbol to set his status manually. Additionally there is graphic informing about ringing phone or current call.<br />
<br />
===List of icons and symbols===<br />
Chart presents list of icons available in '''Contacts''' and '''Recent''' tabs:<br />
<br />
* [[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.<br />
* [[File:MessengerCTI_history.png | 32px]] - for public subscribers.<br />
* [[File:MessengerCTI_close_door.png | 32px]] - for DPH.IP doorphones connected to open/closed door sensor<br />
<br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Status of application and DPH.IP doorphones<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_green.png | 32px]] ||PBX subscriber; '''MessengerCTI.Desktop''' application is running '''and and LOGGED IN'''from subscriber computer. Clicking icon will allow to send text messeger, SMS or dial a call to another application user.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_chat_tv_yellow.png | 29px]] ||PBX subscriber; '''Be right back''' set by user or application, delay time is definied in general settings of application.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_red.png | 32px]] ||PBX subscriber; '''Do not disturb''' set by user<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_tv_grey.png | 32px]] ||PBX subscriber; '''Invisible''' set by user or application is logged off.<br />
|-<br />
|{{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)<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_history.png | 32px]] ||public subscriber; clicking icon will allow to send SMS or dial call to chosen subscriber.<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_close_door.png | 32px]] ||doorphone; current door position - door closed, clicking icon will open door<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_open_door.png | 32px]] ||doorphone; door are open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_alarm_open_door.png | 32px]] ||doorphone; alarm timer for open doors was set off<br />
|-<br />
|}<br />
'''''Chart 1:''''' Meaning of icon status of application, users and doorphones.<br><br />
<br />
Chart is showing list if icon that appear on the left side of subscriber name in tab '''Contacts''' and '''Recent'''. Internal phone will have status icon being displayed<br />
<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl3}} colspan="2" | Phone status and camera information<br />
|-<br />
!{{Hl1}}|Icon!!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_bell_red.png | 28px]] ||Phone is ringing<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_phone_red.png | 32px]] || During call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTI_camera.png | 25px]] ||Camera is associeted with phone or doorphone, clicking on icon will allow to preview camera video<br />
|-<br />
|}<br />
</center><br />
<center>'''''Tabela 2:''''' Icons displaying status of phone and camera</center><br />
<br />
== Preferences==<br />
<br />
Clicking '''Preferences''' icon in main program window will display window with program settings. In every tab there is available button with info "About software" and reseting default window position.<br />
<br />
=== Connection===<br />
In '''''Connection''''' field you must enter settings neccesary for application to connect:<br />
<br />
<center>[[File:MessengerCTI_connection.PNG]]</center><br />
<br />
'''Application login setting'''<br />
<br />
To login, application must have correct settings configured by PBX administrator: <br />
* subscriber numbers - extensions from PBX<br />
* CTI access and password:<br />
** for IPx, MAC, CCT - '''ConfigMAN''' chart '''Subscribers/Settings CTI''' - '''CTI - access level''' and pasword'''Pss'''<br />
** for NCP - '''ConfigWEB''' chart '''Extensions/Subscribers/CTI setting''' - '''CTI Access''' and '''Password'''<br />
* Server address - PBX network settings<br />
CTI access level determines what options are available to application:<br />
* CTI.user - MessengerCTI without VoIP and camera preview<br />
* CTI.userPlus - MessengerCTI with VoIP and camera preview<br />
<br />
<br />
These connections settings must be filled:<br />
* '''Subscribers" field - extension number for which '''MessengerCTI.Dekstop''' will login.<br />
* '''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. <br />
* '''server IP address''' - IP address of PBX network interface. IP address of PBX network port. In case of logging outside od PBX network, IP address of edge router(port forwarding on router is necessary, 5529 TCP, 8100-8300 UDP for IPx, 10000-30000 UDP for NCP on PBX LAN interface).<br />
<br />
After user will change his password, administrator no longer will have access to this passowrd. Application can be set to remember user password by checking field while login in, if field wasn't checked application will always ask for password during every login.<br />
<br />
<br />
After proper 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. "Successful login" will apear in lower part of window.<br />
<br />
<br />
If login credentials, configuration settings aren't correct or there are issue with network connection those error messages may appear:<br />
* ''Wrong login or password. Check if correct login or password was used.''<br />
* ''Connecting to PBX'' alternating with<br />
* ''No connection to PBX'' Check IP address that was entered and check computer LAN connection.<br />
<br />
===General===<br />
<br />
<br />
<center>[[File:MessengerCTI_general_settings.PNG]]</center><br />
<br />
This window allows to configure settings defining how program works and startup options.<br />
Available settings:<br />
*Auto start on System startup - automatic start of application.<br />
*Start minimized - application will run hidden in system task bar.<br />
*Set "Be right back" state after - status icon will change automatically, informing about user being away from computer after defined time.<br />
*Set shortcut for application window - changes application from Windows task bar to desktop and vice versa.<br />
*Choose double click function(for contact or number):<br />
**show call window - choice windows is displayed with options - number, phone call, opening chat/SMS window, closing current window<br />
**call primary number - automatic number dialling<br />
**show last events - recent call history to particular subscriber is displayed.<br />
*Set this window position as default - allows to set up default application's window potion on screen.<br />
<br />
===Audio settings===<br />
These setting allow to set up audio notifications informing about incoming calls and messages and audio setting of computer audio devices.<br />
<br />
<br />
<center>[[File:MessengerCTI_audio_settings.PNG]]</center><br />
<br />
*Enable VoIP on when available - allows application to work as VoIP client(VoIP phone)<br />
<br />
<center>[[File:MessengerCTI_voip_settings.PNG]]</center><br />
<br />
==Dialing and picking up calls==<br />
To set up call between two users, particular hardware, software and proper configuration must be supplied:<br />
*Slican PBX<br />
*computer with installed and configured MessengerCTI.Desktop software<br />
**software logged to PBX with subscriber extension(Settings tab, Connection field)<br />
*analog, VoIP or Slican system phone<br />
*for video preview - DPH.IP doorphone with camera or phone associated with external camera(doesn't apply to VoIP phones with integrated camera)<br />
<br />
Call can be dialled using computer mouse and computer screen. Call is made between subscribers through phone connected to PBX and associated with MessengerCTI.Desktop. After choosing subscriber number to call and dialling call, PBX will call extension choosing number(to inform about being ready to set up connection), after picking up handset PBX will set up calling connection.<br />
<br />
==='''Dialing calls to particular number'''===<br />
<center>[[File:MessengerCTI_outgoing_call_window.png]]</center><br />
Making calls can be realised in few different way. Depending on how configured are general setting on application - option "Set double click function".<br />
* from '''Contacts''' tab<br />
**choose subscriber from proper group(if applicable) or from group "All contacts" by double clicking on number or contact<br />
**clicking on [[File:MessengerCTI_tv_green.png | 32px]] or [[File:MessengerCTI_history.png | 32px]]<br />
*'''Search''' field - by directly entering phone number with computer keyboard then clicking on green phone icon.<br />
*'''Recent''' tab - call history:<br />
**history of call with particular subscriber can be seen here, call is dialled by double click on number or contact<br />
**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]]<br />
<br />
==='''Incoming calls'''===<br />
<br />
<center>[[File:MessengerCTI_incoming_window.png]]</center><br />
Calls are displayed on computer screen with pop-up window, ringing application and ringing phone. Depending on applied configuration call can be picked up with application or phone.<br />
<br />
==='''Connecting to camera video preview'''===<br />
Connecting to/from DPH.IP with integrated camera or associated phone or external IP camera(doesn't apply to VoIP phone with integrated cameras)will display automatically new window on computer screen. Connecting to doorphone allows to identify visible person and open door/gate with [[File:MessengerCTI_close_door.png | 32px]] without picking up call.<br />
<br />
<center>[[FIle:MessengerCTI_camera_preview.png]]</center><br />
<br />
==Sending messages==<br />
Application allow sending(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.<br />
<br />
Receving new message is signalised on Windows system task bar with two icons alternating [[File:MessengerCTI_free.png | 32px]], [[File:MessengerCTI_mail.png | 32px]] and popping up [[File:MessengerCTI_new_message.png]].<br />
<br />
Messages history is available through hyper link '''Load previous'''. It is stored on computer local hard drive.<br />
<br />
<center>[[File:MessengerCTI_chat.png]]</center><br />
<br />
==Searching data==<br />
MessengerCTI is using advanced way or text search. Searching can be accessed through '''Contacts''' tab in '''Search''':<br />
<br />
<br />
<center>[[File:MessengerCT_search_field.PNG]]</center><br />
<br />
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'''.<br />
<br />
== Contacts==<br />
This field allows for searching, displaying, customising and running actions related to contact. By default '''Favourites''' group is displayed. Subscribers from other groups can be accessed by extending groups list with mouse.<br />
<br />
<center>[[File:MessengerCTI_contacts2.png]]</center><br />
<br />
Adding contacts is possible:<br />
<br />
* from search field - entering number and adding it with green handset icon<br />
* from '''Contacts''' or '''Recent''' tab - right clicking on connection<br />
<br />
From contact list we gain access to:<br />
*favourites<br />
*all contacts<br />
*extensions<br />
*created subscriber groups<br />
*public contacts<br />
*private contacts<br />
<br />
== Call history ==<br />
Choosing '''Recent''' tab - in main program window will display call history of currently logged extension to '''''MessengerCTI.Desktop'''''. Window will look like this.<br />
<br />
<br />
<center>[[File:MessengerCTI_recent.PNG]]</center><br />
<br />
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:<br />
<br />
[[File:MessengerCTI_outgoing_calls.PNG | 32px]]<br />
Upward arrow for outgoing call, isn't distinguished between picked up and missed call.<br />
<br />
[[File:MessengerCTI_incoming_calls.PNG | 32px]]<br />
Downward arrow for incoming call that was picked up.<br />
<br />
[[File:MessengerCTI_missed_calls.PNG | 32px]] or[[File:MessengerCTI_missed_calls_amount.PNG | 38px]]<br />
Turned arrow for missed incoming calls, digit is showing number of these calls.<br />
<br />
[[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]] [[File:MessengerCTI_message_amount.PNG | 32px]]<br />
Arrow with listed lines or text bubble for text chat or sent SMS. Digit is showing number of missed messages.<br />
If history contains missed calls or unread messages icon in '''Recent''' field will be in colour red.<br />
<br />
From History window call can be dialled or messages be send to chosen users by right clicking on subscribers text status<br />
, clicking on icons [[File:MessengerCTI_tv_green.png | 32px]] [[File:MessengerCTI_history.png | 32px]] and [[File:MessengerCTI_outgoing_calls.PNG | 32px]] [[File:MessengerCTI_incoming_calls.PNG | 32px]] [[File:MessengerCTI_missed_calls.PNG | 32px]] [[File:MessengerCTI_messege.PNG | 32px]] [[File:MessengerCTI_messege1.PNG | 32px]]. If internal subscriber have other number listed in their phone book, choice can be made between them. For internal subscribers there is option of editing, deleting contact and deleting from favourite list.<br />
<br />
=MessengerCTI.Desktop dla agenta Call Center=<br />
Od firmware 1.12 NCP oraz 1.02 MessengerCTI.Desktop w aplikacji pojawiły się funkcjonalności związane z obsługą kolejek Call Center. U użytkownika programu, który w centrali ma włączoną opcję agenta Call Center - w aplikacji na pasku statusu systemu operacyjnego dodatkowo wyświetla się dodatkowa ikona '''Status agenta''' oraz w oknie głównym aplikacji zakładka '''CC'''<br />
<br />
<br />
Ikony statusu aplikacji: <br />
* aplikacja zalogowana: [[Plik:MessengerCTI.Desktop status zalogowany.png | 40px]]<br />
* aplikacja w stanie: '''Zaraz wracam''' [[Plik:MessengerCTI.Desktop status zaraz wracam.png | 40px]]<br />
Czerwona kropka przy statusie aplikacji wskazuje na nieodebrane połączenie lub wiadomość do użytkownika numeru.<br />
<br />
<br />
<br />
Ikony statusu Agenta: <br />
* agent zalogowany do kolejki: [[Plik:MessengerCTI.Desktop agent zalogowany.png | 40px]]<br />
* przerwa agenta: [[Plik:MessengerCTI.Desktop przerwa agenta.png | 40px]]<br />
* agent wylogowny z kolejki: [[Plik:MessengerCTI.Desktop agent wylogowany.png | 40px]]<br />
Czerwona kropka przy statusie agenta wskazuje na nieodebrane połączenie przez agentów kolejki CC.<br />
<br />
<br />
<br />
W zakładce '''CC''' aplikacji w zależności od przyjętej konfiguracji wyświetlane są:<br />
* do 4 zaprogramowanych przycisków wraz z aktualnym jej stanem dla danego agenta: '''Logowanie/wylogowanie z kolejki CC''' oraz '''Włączenie/wyłączenie przerwy agenta'''<br />
* obsługiwane kolejki z liczbą zalogowanych do niej agentów oraz oczekujących aktualnie w kolejce<br />
* lista nieodebranych połączeń - numerów/kontaktów do oddzwonienia<br />
<br />
<br />
<center>[[Plik:MessengerCTI.Desktop zakładka CC.png]]</center><br />
<br />
W przypadku korzystania z listy oddzwonienia pojawia się dodatkowe okno z możliwością nawiązania połączenia oraz polem potwierdzenia czy oddzwonienie było skuteczne.<br />
<br />
<br />
<br />
W celu odpowiedniego skonfigurowania zakładki '''CC''' należy w preferencjach aplikacji prawidłowo skonfigurować zakładkę '''Call Center'''<br />
<br />
<center>[[Plik:MessengerCTI.Desktop konfiguracja CC.png]]</center><br />
<br />
=Licensing=<br />
==IPX, MAC, CCT PBX==<br />
MessengerCTI.Desktop application:<br />
* 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.<br />
* for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
* calls made form application in VoIP mode are using VoIP channels just like other VoIP devices<br />
* MessengerCTI.Dekstop configured without VoIP and camera preview access - CTIuser license is required<br />
* MessengerCTI.Desktop configured with VoIP and camera preview access - CTIuserplus license is required<br />
<br />
==NCP PBX==<br />
MessengerCTI.Desktop:<br />
* CAN be associated with any subscriber port - analogue, system or VoIP; each subscriber port is treated as 1 user from Base license, additionally while associating application with VoIP port 1 NCP.VoIPuser license is neccesary<br />
** for configuration using VoIP functionality(working as parallel phone) there isn't need to associate plication with VoIP port, it is application functionality, it can be associated with any type of subscriber port<br />
** MessengerCTI.Desktop configured without VoIP and no camera preview access - NCP.CTIuser is required<br />
** MessengerCTI.Desktop configured with VoIP and camera preview access - NCP.CTIuserPlus license is required<br />
* MessengerCTI.Dekstop as standalone subscriber - MCTI (not associated with subscriber port):<br />
** Messenger.CTI Dekstop with VoIP funcionality and camera preview access - NCP.VoIPuser and NCP.CTIuserPlus licenses are required<br />
<br />
=One user and few different numbers=<br />
Sometimes one computer use must operate with few different extensions umber. On workstation(computer) use of "instance" is neccesary. Application has to be installed (just once). User must prepare shortcuts containing extra parameters that will allow to create seperate configuration.<br />
<br />
* default location of program instalation is: C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe<br />
** 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 llok for MessengerCTI, right click -> More/ Open File Location - program icon will appear, right click -> Properties/Shortcut/Target<br />
* create program shortcut on desktop<br />
* in shortcut properties add instance - Properties/Shortcut/Target: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''<br />
* 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''', ...<br />
* while running aplication from shortcuts we can configure each one seperatly for different numbers</div>Marekghttp://pubwiki.slican.com/index.php?title=File:Google_beta.jpg&diff=7816File:Google beta.jpg2019-04-16T10:28:10Z<p>Marekg: </p>
<hr />
<div></div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI.Mobile_Manual&diff=7815MessengerCTI.Mobile Manual2019-04-16T10:27:13Z<p>Marekg: /* Installing beta version */</p>
<hr />
<div><center>[[File:messenger_2.png|250px]]</center><br />
= Introduction=<br />
'''MessengerCTI.Mobile''' Slican Software is mobile application dedicated for '''Android''' operating system, which allow to make incoming or outgoing calls, access to phone book, call history, view status of other subscribers and chat.<br><br />
Application can work together alongside desk phone and smartphone already in use by PBX subscriber. <br><br />
<br />
Application have advantage of being integrated with phone book saved in PBX. '''MessengerCTI.Mobile''' is using phone book stored in PBX but phone book entries can be modified only by using system phone or by computer with ''MessengerCTI.Desktop'' application or '''WebCTI'''. Additionaly '''MessengerCTI.Mobile''' Slican software operates as internal messenger-chat. Messenger can be use by all subscribers of particular PBX if required licenses are supplied.<br />
<br><br />
==Application advantages==<br />
* application available(for free) from Google Play store - only CTI.plus license applied to PBX is required<br />
* phone book with access to subscribers availability(chat, phone status, text status)<br />
* option of adding and removing subscribers from favorite group, synchronised with MessengerCTI.Desktop<br />
* history of recent calls/messages sorted chronologically<br />
* logging with phone simultaneously as desk phone or as separate MessengerCTI subscriber(NCP PBX only)<br />
* chat/messenger<br />
* chat history with phone call history<br />
* voice calling through GSM(two connection options- capture or parallel)<br />
* flexible configuration of audio notifications<br />
* access to PBX services configuration from phone<br />
* rapid access number for fast call forwarding<br />
* option of setting up busy status of desk phone if GSM is buy (on by default)<br />
* option of setting up incoming call denying on GSM if desk phone is busy<br />
* option of copying text from chat<br />
* support of DualSim smartphone or two phones simultaneously (private or business)<br />
* convenient access to opening door/gate if receiving call from doorphone DPH.IP or from context contacts menu<br />
* additional desktop widget for fast access to open DPH.IP doorphone doors<br />
* automatic delay of notifications for MessengerCTI.Mobile if desk phone or MessengerCTI.desktop is active <br />
* option of copying contact from local phone book to PBX phone book<br />
<br />
{{Attention!| <br />
*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.<br />
*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}}<br />
<br />
= Minimum requirements =<br />
'''''MessengerCTI.Mobile''''' application - is available to download from Google Play store.<br />
<br />
For installing application minimum requirements must be met:<br />
* Android operating system - minimum version KitKat (4.4.4)<br />
* PBX and application must have access to internet<br />
Phone with lower version of operating system won't be able to install application. <br />
<br />
{{Attention!|<br />
'''''MessengerCTI.Mobile''''' application works with IPx, MAC and CCT PBX with firmware version '''6.53''' or higher and NCP PBX'''1.11'''<br><br />
VoIP with application is supported for IPx, MAC and CCT with firmware '''6.54''' and NCP firmware '''1.12'''}}<br><br />
<br />
=Application installation =<br />
'''''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).<br />
<br />
{{Attention!|<br />
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.}}<br />
<br />
== Starting application ==<br />
<br />
'''''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). <br />
== Configuring application==<br />
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><br />
<br />
Fields required for configuration can be found here:account, notifications, handy numbers.<br />
===Account===<br />
Configured with information configured by PBX administrator.:<br />
* Your telephone number: internal subscriber number(extensions) with access to CTI communication<br />
* password: CTI user password<br />
* advanced -> Transmission protocol port: port used for communication with PBX - by default set to TCP 5529<br />
* Host: domain address or IP address of local PBX(public IP address for users outside LAN) <br />
<br />
===Notifications===<br />
Configuring call notifications:<br />
* ringtone: ringtone from available ones can be chosen.<br />
* missed call: notify about missed calls on status bar.<br />
Configuring chat messages notifications:<br />
* message tone: tone from available ones can be chosen.<br />
===Handy numbers===<br />
List of handy numbers available during active call, they can be user for fast forward to another number from handy list.<br />
<br />
===Other===<br />
Configuring phone busy status depending on incoming call direction(GSM or CTI call):<br />
* during GSM talk, internal number will be busy<br />
* reject GSM when internal number is busy<br />
Solving issues with proper software operation:<br />
* debug - administrator option which is turned on on software vendor suggestion, for analysing issue logs.<br />
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.<br />
<br />
== Services==<br />
Configuring application services related to connections/calls:<br />
* DND: Do not Disturb<br />
* 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)<br />
* silence application: silent mode<br />
== My description ==<br />
Setting text status that will be visible to other MessengerCTI.Users or on screen of CTS-330 system phone.<br />
== About software ==<br />
Information about: <br />
* current software version<br />
* type of connected PBX<br />
* PBX firmware version<br />
* Own number: CTI account number(internal PBX extension)<br />
* Own comment: user comment made by administrator<br />
<br />
== Updating application ==<br />
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.<br />
<br />
= Application structure =<br />
== Main window ==<br />
Main application windows give access to two tab:<br />
* '''Last/Recent''' - history of calls, chat messages and users statuses.<br />
* '''Contacts''' - access to PBX phone book with sorting options:favourites, internal, external.<br />
* login icon status with text status<br />
* searching contacts<br />
* applications settings menu <br />
<center>[[File:MessengerCTI_opis_new.png|800px]]</center><br />
<br />
== Icons meaning ==<br />
'''''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.<br />
=== Icons and symbols ===<br />
"Last/recent" starting application windows is showing history of calls. Icons located here are:<br />
* left side: application status of other MessengerCTI.Desktop/Mobile users or call history<br />
* right side: information about call direction and message status<br> <br />
<br />
Table 1 describes meaning of particular icons informing about application status of other MessengerCTI.Desktop/Mobile users:<br />
* PBX internal subscribers - icons showing status of logged application, touching icon allows to start chat or check call history<br />
* DPH.IP doorphone - door position, touching icon allows to check history<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl1}}|Ikona !!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTID_free.png|40px]] ||user logged in<br />
|-<br />
|{{align|center}}|[[File:MessengerCTID_be_right_back.png|37px]] ||status: "Be right back" <br />
|-<br />
|{{align|center}}|[[File:MessengerCTID_chat_busy1.png]] ||status set by user "Do not disturb" <br />
|-<br />
|{{align|center}}|[[File:MessengerCTID_chat_no_login.png|40px]] ||user logged our, not available or status is set to "Hidden"<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIMD_chat_free.png|40px]] || Desktop application status with configured Mobile version <br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_chat_DND.png|40px]] ||calls and messages history<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_door_open.png|40px]] ||DPH.IP doorphone: door open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_door_closed.png|40px]] ||DPH.IP doorphone: door closed<br />
|-<br />
|}<br />
'''''Table 1:''''' Icon shows status of application, users and doorphones.<br></center><br><br />
<br />
In case of phones being PBX extensions, icon will show phone status.<br />
<center><br />
<br />
{|{{prettytable}}<br />
!{{Hl1}}|Ikona !!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_call.png|40px]] ||number is busy<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_ringing.png|40px]] ||calling number or making outgoing call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_failure1.png|40px]] ||number is not available or faulty<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_DND.png|40px]] ||DND service is on<br />
|-<br />
|}<br />
'''''Table 2:''''' Icons displaying phone status<br></center><br />
<br />
Table 3 shows meaning of icons displaying calls status: <br />
<center><br />
{|{{prettytable}}<br />
!{{Hl1}}|Icon !!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_incom_call.png|40px]] ||incoming call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_out_call.png|40px]] ||outgoing call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_answer_qty.png|50px]] ||new missed call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_answer.png|45px]] ||missed call<br />
|-<br />
|}<br />
<br />
'''''Table 3:''''' Icons displaying calls.<br></center><br />
<br />
Table 4 shows icons displaying message status:<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl1}}|Icon !!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_incom_chat.png|40px]] ||Message received <br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_out_chat.png|40px]] ||Message sent, read<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_answer_chat.png|50px]] ||New message, received<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_received_chat.png|45px]] ||Message sent, not read<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_send_read_chat_conf.png|40px]] ||Message sent, read - dialogue window view<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_send_notread_chat_conf.png|40px]] ||message sent, not read - dialogue window view<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_send_unav_chat_conf.png|40px]] ||Message sent to logged out user - dialogue window view<br />
|-<br />
|}<br />
'''''Table 4:''''' Icons showing message status.<br></center><br />
<br />
Table 5 shows description of application errors and notifications. Notifications are visible under status icon.<center><br />
{|{{prettytable}}<br />
!{{Hl1}}|Notification !!{{Hl1}}| Meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_internet.png]] ||No connection: check network connection<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_auth.png|236px]] || Wrong login or password: check account settings<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_licen.png|236px]] || App not allowed in PBX: contact PBX administrator<br />
|-<br />
|}<br />
'''''Table 5''''': Error icons meaning.<br />
</center><br />
<br />
=Supporting messages and calls=<br />
For call between two users necessary are:<br />
* proper account configuration of application and PBX<br />
* full connection between application and PBX(full data synchronisation of application with PBX) - application icon should have green color<br />
* installed Slican system phone, VoIP or analog phone for IPx, MAC or NCP PBX or configured MessengerCTI subscriber((only NCP PBX)<br />
<br />
==Making calls==<br />
Two ways of making calls:<br />
* 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. <br />
* from '''Contacts''' tab- searching for phone number in '''Search''' field by using keyboard then touching lower right corner of keyboard<br />
<center>[[File:MessengerCTIM_out_ext1.png|750px]]</center><br />
* 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<br />
<center>[[File:MessengerCTIM_out_number1.png|570px]]</center><br />
<br />
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.<br />
<br />
==Incoming calls==<br />
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.<br />
Process of receiving incoming calls works by making a return call with GSM line to application access number defined by PBX administrator.<br />
<center>[[File:MessengerCTIM_incoming2.png|700px]]</center><br />
<br />
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.<br />
<br />
==Messages support==<br />
Application allows to send and receive text messages between MessengerCTI.Desktop/Mobile user (internal chat). To send message user status icon must be touched or from drop down menu and touching contact tab, then choosing '''chat'''.<br><br />
Receiving messages is displayed on notification bar by proper icon and defined ring tone.<br> <br />
If subscriber is using both versions of MessengerCTI, messages history is stored locally in '''''MessengerCTI.Dekstop''''' application.<br><br />
Below is example of chat window:<br />
<br />
<center>[[File:MessengerCTIM_czat1.png|700px]]</center><br />
<br />
== Contacts==<br />
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: <br />
* favourites<br />
* all groups<br />
* all contacts<br />
* internal<br />
* external<br />
* private<br />
By default '''Favourites''' group is visible.<br />
<center>[[File:MessengerCTIM_contacts1.png|300px]]</center><br />
<br />
== Call history ==<br />
By default '''Last/Recent''' tab will be visible and showing calls and chat messages history.<br><br />
In history every position is at least one call or message. If there is more then one call/message and they come from sam user, on their icon number will be displayed. Every position is displaying caller number, commentary(if number is from phone book outside PBX), time and date of call.<br><br />
If in history there are missed calls or messages, '''Last/Recent''' field will be marked with red dot.<br><br />
History tab allows to call back or reply to messages.<br />
<br />
=Configuring Slican PBX=<br />
For proper communication between application and PBX are required:<br />
* correct manufacturer license<br />
* specific PBX configuration<br />
==IPx, CCT PBX configuration==<br />
With ConfigMan software:<br />
# Inside '''''Themes''''' tab and then '''''Global settings->Global settings/Remain''''': <br />
## '''ANo''':configure access number that application will chose for making call to PBX and setting up incoming call<br />
## '''Adr''' - public host name or PBX IP address for connecting to application(for VoIP calls with application)<br />
# Inside Subscribers menu, '''''Tables''''' then '''''Subscribers->Subscribers/CTI settings:<br />
## '''AwdMbl''': allow access to MessengerCTI.Mobile application<br />
## '''AwdGSM''': allows to connect phone calls through GSM network<br />
## '''IncC''': setting up method of how application connects incoming calls:<br />
### Call pickup - picking up incoming call with application means making outgoing call with GSM phone to number from '''ANo'' field inside ''''' Global settings/Remain''''' <br />
### Parrallel calling - incoming calls to GSM phone from number set in '''ANo'''field inside ''''' Global settings/Remain'''''<br />
## '''MnNo''': configure GSM phone access number, on which application is installed, optionally configure second number(for dual SIM phones)<br />
## '''SecNo''': second GSM phone number with installed application(optional, for dual SIM phones)<br />
<br />
<br />
For application to work with each settings, these fields parameters must be set:<br />
* VoIP network: 1.2, 2.1<br />
* GSM network: 1.1, 2.1, 2.2, 2.2.1, 2.2.2, 2.3 and 2.3.1 or 2.3.2<br />
<br />
<font color=red>'''Minimum PBX firmware version - 6.53, for VoIP - 6.54'''</font><br />
<br />
==NCP PBX configuration==<br />
From ConfigWEB application:<br />
* '''''Extensions->Settings->CTI application settings''''' menu, configure access number that application will use to call to PBX and make accept incoming call <br />
* in subscriber editing for SIP, FXS, CTS, Messenger CTI number in menu '''''Extensions->Subscribers->CTI settings'''''<br />
** configure GSM phone access number which will have installed application<br />
** set up type of handling incoming calls: call pickup (only application is ringing up) or parallel calling(application and internal phone is ringing up)<br />
<br />
<font color=red>'''Minimum software version is: 1.11.'''</font><br />
<br />
From ConfigWEB application:<br />
# '''''Extensions->Settings->CTI application settings''''' menu, configure<br />
## 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<br />
## Public host name or PBX IP address for VoIP calls - domain name or IP address for for configuring VoIP calls<br />
## 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)<br />
# configure subscribers for SIP,FXS, CTS, MCTI with ''''''Extensions/Subscribers/CTI Settings/ MessengerCTI.Mobile'''''<br />
## Allow access to MessengerCTI.Mobile application<br />
## if using GSM network allow phone calls handling using GSM<br />
### set up GSM phone access number for device with installed application<br />
### set up second GSM phone number with installed applicatio (optional, for dual SIM devices)<br />
## set up incoming calls handling<br />
### 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'''' <br />
### Parallel calling - incoming call to GSM phone from number set with '''''Extensions/ Settings/ CTI applications settings / MessengerCTI'''' <br />
<br />
<br />
For application to work, these fields must be set:<br />
* VoIP: 1.1, 1.2, 2.1<br />
* 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<br />
<br />
<br />
<font color=red>'''Minimum PBX firmware version - 1.11, for VoIP - 1.12'''</font><br />
<br />
=Use cases examples=<br />
'''''MessengerCTI.Mobile''''' application is useful tool for companies that employ mobile workers which requires constant access to phone with internal number of phone system. <br> <br />
These employees can be a good example:<br />
* sales department - working in different locations, office <-> outside office<br />
* service support - constant fieldwork<br />
* remote worker - remote work<br />
* mobile worker - working on vast area(production halls, vast areas) -where Wifi or DECT network range won't be adequate<br />
<br />
=Installing beta version=<br />
"Beta" version contains new functionalities which will be added in next production version but not all of planned functions are implemented. This version also cointains fixes for error submited for earlier versions. It was initialy tested.<br><br />
To install beta version:<br><br />
- If on the phone MessengerCTI is installed, uinstall it.<br><br />
- log to Google Play as application tester<br><br />
In this case:<br />
Log in from computer or phone web browser to your Google account. If you hav more then account it is important to log into account which was used to configure your phone.<br><br />
Click this link:<br />
[https://play.google.com/apps/testing/com.slican.messengercti beta version registration]<br><br />
When you will see this info:<br><br />
[[File:google_beta.jpg]]<br><br />
Click BLUE BUTTON to sign up for testing<br><br />
Going back to phone configuration: <br><br />
- Because Google Play updates can be delayed, it is recommend to turn of Play Store application before installing MessengerCTI.<br><br />
- Clicking on shortcut will start Play Store again. Search for MessengerCTI application. It is recommended to search also for Slican due to many other application using "messenger" word in their naming.<br><br />
- Install application.<br><br />
- Configure according to manual.j<br><br />
Use beta version features.</div>Marekghttp://pubwiki.slican.com/index.php?title=MessengerCTI.Mobile_Manual&diff=7814MessengerCTI.Mobile Manual2019-04-16T10:26:35Z<p>Marekg: /* Installing beta version */</p>
<hr />
<div><center>[[File:messenger_2.png|250px]]</center><br />
= Introduction=<br />
'''MessengerCTI.Mobile''' Slican Software is mobile application dedicated for '''Android''' operating system, which allow to make incoming or outgoing calls, access to phone book, call history, view status of other subscribers and chat.<br><br />
Application can work together alongside desk phone and smartphone already in use by PBX subscriber. <br><br />
<br />
Application have advantage of being integrated with phone book saved in PBX. '''MessengerCTI.Mobile''' is using phone book stored in PBX but phone book entries can be modified only by using system phone or by computer with ''MessengerCTI.Desktop'' application or '''WebCTI'''. Additionaly '''MessengerCTI.Mobile''' Slican software operates as internal messenger-chat. Messenger can be use by all subscribers of particular PBX if required licenses are supplied.<br />
<br><br />
==Application advantages==<br />
* application available(for free) from Google Play store - only CTI.plus license applied to PBX is required<br />
* phone book with access to subscribers availability(chat, phone status, text status)<br />
* option of adding and removing subscribers from favorite group, synchronised with MessengerCTI.Desktop<br />
* history of recent calls/messages sorted chronologically<br />
* logging with phone simultaneously as desk phone or as separate MessengerCTI subscriber(NCP PBX only)<br />
* chat/messenger<br />
* chat history with phone call history<br />
* voice calling through GSM(two connection options- capture or parallel)<br />
* flexible configuration of audio notifications<br />
* access to PBX services configuration from phone<br />
* rapid access number for fast call forwarding<br />
* option of setting up busy status of desk phone if GSM is buy (on by default)<br />
* option of setting up incoming call denying on GSM if desk phone is busy<br />
* option of copying text from chat<br />
* support of DualSim smartphone or two phones simultaneously (private or business)<br />
* convenient access to opening door/gate if receiving call from doorphone DPH.IP or from context contacts menu<br />
* additional desktop widget for fast access to open DPH.IP doorphone doors<br />
* automatic delay of notifications for MessengerCTI.Mobile if desk phone or MessengerCTI.desktop is active <br />
* option of copying contact from local phone book to PBX phone book<br />
<br />
{{Attention!| <br />
*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.<br />
*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}}<br />
<br />
= Minimum requirements =<br />
'''''MessengerCTI.Mobile''''' application - is available to download from Google Play store.<br />
<br />
For installing application minimum requirements must be met:<br />
* Android operating system - minimum version KitKat (4.4.4)<br />
* PBX and application must have access to internet<br />
Phone with lower version of operating system won't be able to install application. <br />
<br />
{{Attention!|<br />
'''''MessengerCTI.Mobile''''' application works with IPx, MAC and CCT PBX with firmware version '''6.53''' or higher and NCP PBX'''1.11'''<br><br />
VoIP with application is supported for IPx, MAC and CCT with firmware '''6.54''' and NCP firmware '''1.12'''}}<br><br />
<br />
=Application installation =<br />
'''''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).<br />
<br />
{{Attention!|<br />
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.}}<br />
<br />
== Starting application ==<br />
<br />
'''''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). <br />
== Configuring application==<br />
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><br />
<br />
Fields required for configuration can be found here:account, notifications, handy numbers.<br />
===Account===<br />
Configured with information configured by PBX administrator.:<br />
* Your telephone number: internal subscriber number(extensions) with access to CTI communication<br />
* password: CTI user password<br />
* advanced -> Transmission protocol port: port used for communication with PBX - by default set to TCP 5529<br />
* Host: domain address or IP address of local PBX(public IP address for users outside LAN) <br />
<br />
===Notifications===<br />
Configuring call notifications:<br />
* ringtone: ringtone from available ones can be chosen.<br />
* missed call: notify about missed calls on status bar.<br />
Configuring chat messages notifications:<br />
* message tone: tone from available ones can be chosen.<br />
===Handy numbers===<br />
List of handy numbers available during active call, they can be user for fast forward to another number from handy list.<br />
<br />
===Other===<br />
Configuring phone busy status depending on incoming call direction(GSM or CTI call):<br />
* during GSM talk, internal number will be busy<br />
* reject GSM when internal number is busy<br />
Solving issues with proper software operation:<br />
* debug - administrator option which is turned on on software vendor suggestion, for analysing issue logs.<br />
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.<br />
<br />
== Services==<br />
Configuring application services related to connections/calls:<br />
* DND: Do not Disturb<br />
* 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)<br />
* silence application: silent mode<br />
== My description ==<br />
Setting text status that will be visible to other MessengerCTI.Users or on screen of CTS-330 system phone.<br />
== About software ==<br />
Information about: <br />
* current software version<br />
* type of connected PBX<br />
* PBX firmware version<br />
* Own number: CTI account number(internal PBX extension)<br />
* Own comment: user comment made by administrator<br />
<br />
== Updating application ==<br />
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.<br />
<br />
= Application structure =<br />
== Main window ==<br />
Main application windows give access to two tab:<br />
* '''Last/Recent''' - history of calls, chat messages and users statuses.<br />
* '''Contacts''' - access to PBX phone book with sorting options:favourites, internal, external.<br />
* login icon status with text status<br />
* searching contacts<br />
* applications settings menu <br />
<center>[[File:MessengerCTI_opis_new.png|800px]]</center><br />
<br />
== Icons meaning ==<br />
'''''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.<br />
=== Icons and symbols ===<br />
"Last/recent" starting application windows is showing history of calls. Icons located here are:<br />
* left side: application status of other MessengerCTI.Desktop/Mobile users or call history<br />
* right side: information about call direction and message status<br> <br />
<br />
Table 1 describes meaning of particular icons informing about application status of other MessengerCTI.Desktop/Mobile users:<br />
* PBX internal subscribers - icons showing status of logged application, touching icon allows to start chat or check call history<br />
* DPH.IP doorphone - door position, touching icon allows to check history<br />
<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl1}}|Ikona !!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTID_free.png|40px]] ||user logged in<br />
|-<br />
|{{align|center}}|[[File:MessengerCTID_be_right_back.png|37px]] ||status: "Be right back" <br />
|-<br />
|{{align|center}}|[[File:MessengerCTID_chat_busy1.png]] ||status set by user "Do not disturb" <br />
|-<br />
|{{align|center}}|[[File:MessengerCTID_chat_no_login.png|40px]] ||user logged our, not available or status is set to "Hidden"<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIMD_chat_free.png|40px]] || Desktop application status with configured Mobile version <br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_chat_DND.png|40px]] ||calls and messages history<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_door_open.png|40px]] ||DPH.IP doorphone: door open<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_door_closed.png|40px]] ||DPH.IP doorphone: door closed<br />
|-<br />
|}<br />
'''''Table 1:''''' Icon shows status of application, users and doorphones.<br></center><br><br />
<br />
In case of phones being PBX extensions, icon will show phone status.<br />
<center><br />
<br />
{|{{prettytable}}<br />
!{{Hl1}}|Ikona !!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_call.png|40px]] ||number is busy<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_ringing.png|40px]] ||calling number or making outgoing call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_failure1.png|40px]] ||number is not available or faulty<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_DND.png|40px]] ||DND service is on<br />
|-<br />
|}<br />
'''''Table 2:''''' Icons displaying phone status<br></center><br />
<br />
Table 3 shows meaning of icons displaying calls status: <br />
<center><br />
{|{{prettytable}}<br />
!{{Hl1}}|Icon !!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_incom_call.png|40px]] ||incoming call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_out_call.png|40px]] ||outgoing call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_answer_qty.png|50px]] ||new missed call<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_answer.png|45px]] ||missed call<br />
|-<br />
|}<br />
<br />
'''''Table 3:''''' Icons displaying calls.<br></center><br />
<br />
Table 4 shows icons displaying message status:<br />
<center><br />
{|{{prettytable}}<br />
!{{Hl1}}|Icon !!{{Hl1}}| Icon meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_incom_chat.png|40px]] ||Message received <br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_out_chat.png|40px]] ||Message sent, read<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_answer_chat.png|50px]] ||New message, received<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_received_chat.png|45px]] ||Message sent, not read<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_send_read_chat_conf.png|40px]] ||Message sent, read - dialogue window view<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_send_notread_chat_conf.png|40px]] ||message sent, not read - dialogue window view<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_send_unav_chat_conf.png|40px]] ||Message sent to logged out user - dialogue window view<br />
|-<br />
|}<br />
'''''Table 4:''''' Icons showing message status.<br></center><br />
<br />
Table 5 shows description of application errors and notifications. Notifications are visible under status icon.<center><br />
{|{{prettytable}}<br />
!{{Hl1}}|Notification !!{{Hl1}}| Meaning<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_internet.png]] ||No connection: check network connection<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_auth.png|236px]] || Wrong login or password: check account settings<br />
|-<br />
|{{align|center}}|[[File:MessengerCTIM_no_licen.png|236px]] || App not allowed in PBX: contact PBX administrator<br />
|-<br />
|}<br />
'''''Table 5''''': Error icons meaning.<br />
</center><br />
<br />
=Supporting messages and calls=<br />
For call between two users necessary are:<br />
* proper account configuration of application and PBX<br />
* full connection between application and PBX(full data synchronisation of application with PBX) - application icon should have green color<br />
* installed Slican system phone, VoIP or analog phone for IPx, MAC or NCP PBX or configured MessengerCTI subscriber((only NCP PBX)<br />
<br />
==Making calls==<br />
Two ways of making calls:<br />
* 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. <br />
* from '''Contacts''' tab- searching for phone number in '''Search''' field by using keyboard then touching lower right corner of keyboard<br />
<center>[[File:MessengerCTIM_out_ext1.png|750px]]</center><br />
* 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<br />
<center>[[File:MessengerCTIM_out_number1.png|570px]]</center><br />
<br />
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.<br />
<br />
==Incoming calls==<br />
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.<br />
Process of receiving incoming calls works by making a return call with GSM line to application access number defined by PBX administrator.<br />
<center>[[File:MessengerCTIM_incoming2.png|700px]]</center><br />
<br />
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.<br />
<br />
==Messages support==<br />
Application allows to send and receive text messages between MessengerCTI.Desktop/Mobile user (internal chat). To send message user status icon must be touched or from drop down menu and touching contact tab, then choosing '''chat'''.<br><br />
Receiving messages is displayed on notification bar by proper icon and defined ring tone.<br> <br />
If subscriber is using both versions of MessengerCTI, messages history is stored locally in '''''MessengerCTI.Dekstop''''' application.<br><br />
Below is example of chat window:<br />
<br />
<center>[[File:MessengerCTIM_czat1.png|700px]]</center><br />
<br />
== Contacts==<br />
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: <br />
* favourites<br />
* all groups<br />
* all contacts<br />
* internal<br />
* external<br />
* private<br />
By default '''Favourites''' group is visible.<br />
<center>[[File:MessengerCTIM_contacts1.png|300px]]</center><br />
<br />
== Call history ==<br />
By default '''Last/Recent''' tab will be visible and showing calls and chat messages history.<br><br />
In history every position is at least one call or message. If there is more then one call/message and they come from sam user, on their icon number will be displayed. Every position is displaying caller number, commentary(if number is from phone book outside PBX), time and date of call.<br><br />
If in history there are missed calls or messages, '''Last/Recent''' field will be marked with red dot.<br><br />
History tab allows to call back or reply to messages.<br />
<br />
=Configuring Slican PBX=<br />
For proper communication between application and PBX are required:<br />
* correct manufacturer license<br />
* specific PBX configuration<br />
==IPx, CCT PBX configuration==<br />
With ConfigMan software:<br />
# Inside '''''Themes''''' tab and then '''''Global settings->Global settings/Remain''''': <br />
## '''ANo''':configure access number that application will chose for making call to PBX and setting up incoming call<br />
## '''Adr''' - public host name or PBX IP address for connecting to application(for VoIP calls with application)<br />
# Inside Subscribers menu, '''''Tables''''' then '''''Subscribers->Subscribers/CTI settings:<br />
## '''AwdMbl''': allow access to MessengerCTI.Mobile application<br />
## '''AwdGSM''': allows to connect phone calls through GSM network<br />
## '''IncC''': setting up method of how application connects incoming calls:<br />
### Call pickup - picking up incoming call with application means making outgoing call with GSM phone to number from '''ANo'' field inside ''''' Global settings/Remain''''' <br />
### Parrallel calling - incoming calls to GSM phone from number set in '''ANo'''field inside ''''' Global settings/Remain'''''<br />
## '''MnNo''': configure GSM phone access number, on which application is installed, optionally configure second number(for dual SIM phones)<br />
## '''SecNo''': second GSM phone number with installed application(optional, for dual SIM phones)<br />
<br />
<br />
For application to work with each settings, these fields parameters must be set:<br />
* VoIP network: 1.2, 2.1<br />
* GSM network: 1.1, 2.1, 2.2, 2.2.1, 2.2.2, 2.3 and 2.3.1 or 2.3.2<br />
<br />
<font color=red>'''Minimum PBX firmware version - 6.53, for VoIP - 6.54'''</font><br />
<br />
==NCP PBX configuration==<br />
From ConfigWEB application:<br />
* '''''Extensions->Settings->CTI application settings''''' menu, configure access number that application will use to call to PBX and make accept incoming call <br />
* in subscriber editing for SIP, FXS, CTS, Messenger CTI number in menu '''''Extensions->Subscribers->CTI settings'''''<br />
** configure GSM phone access number which will have installed application<br />
** set up type of handling incoming calls: call pickup (only application is ringing up) or parallel calling(application and internal phone is ringing up)<br />
<br />
<font color=red>'''Minimum software version is: 1.11.'''</font><br />
<br />
From ConfigWEB application:<br />
# '''''Extensions->Settings->CTI application settings''''' menu, configure<br />
## 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<br />
## Public host name or PBX IP address for VoIP calls - domain name or IP address for for configuring VoIP calls<br />
## 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)<br />
# configure subscribers for SIP,FXS, CTS, MCTI with ''''''Extensions/Subscribers/CTI Settings/ MessengerCTI.Mobile'''''<br />
## Allow access to MessengerCTI.Mobile application<br />
## if using GSM network allow phone calls handling using GSM<br />
### set up GSM phone access number for device with installed application<br />
### set up second GSM phone number with installed applicatio (optional, for dual SIM devices)<br />
## set up incoming calls handling<br />
### 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'''' <br />
### Parallel calling - incoming call to GSM phone from number set with '''''Extensions/ Settings/ CTI applications settings / MessengerCTI'''' <br />
<br />
<br />
For application to work, these fields must be set:<br />
* VoIP: 1.1, 1.2, 2.1<br />
* 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<br />
<br />
<br />
<font color=red>'''Minimum PBX firmware version - 1.11, for VoIP - 1.12'''</font><br />
<br />
=Use cases examples=<br />
'''''MessengerCTI.Mobile''''' application is useful tool for companies that employ mobile workers which requires constant access to phone with internal number of phone system. <br> <br />
These employees can be a good example:<br />
* sales department - working in different locations, office <-> outside office<br />
* service support - constant fieldwork<br />
* remote worker - remote work<br />
* mobile worker - working on vast area(production halls, vast areas) -where Wifi or DECT network range won't be adequate<br />
<br />
=Installing beta version=<br />
"Beta" version contains new functionalities which will be added in next production version but not all of planned functions are implemented. This version also cointains fixes for error submited for earlier versions. It was initialy tested.<br><br />
To install beta version:<br><br />
- If on the phone MessengerCTI is installed, uinstall it.<br><br />
- log to Google Play as application tester<br><br />
In this case:<br />
Log in from computer or phone web browser to your Google account. If you hav more then account it is important to log into account which was used to configure your phone.<br><br />
Click this link:<br />
[https://play.google.com/apps/testing/com.slican.messengercti beta version registration]<br><br />
When you will see this info:<br><br />
[[Plik:google_beta.jpg]]<br><br />
Click BLUE BUTTON to sign up for testing<br><br />
Going back to phone configuration: <br><br />
- Because Google Play updates can be delayed, it is recommend to turn of Play Store application before installing MessengerCTI.<br><br />
- Clicking on shortcut will start Play Store again. Search for MessengerCTI application. It is recommended to search also for Slican due to many other application using "messenger" word in their naming.<br><br />
- Install application.<br><br />
- Configure according to manual.j<br><br />
Use beta version features.</div>Marekg