Wiki - Wkład użytkownika [pl]

Instrukcja obsługi MessengerCTI.Mobile

2019-04-15T12:39:49Z

Marekg: /* Konfiguracja centrali NCP */

<center>[[Plik:messenger_2.png|250px]]</center>
= Wstęp =
Aplikacja Slican '''''MessengerCTI.Mobile''''' jest aplikacją mobilną przeznaczona na system '''Android''', który łączy w sobie możliwość wykonywania połączeń przychodzących jak i wychodzących, dostęp do książki telefonicznej, historii, podglądu statusu innych abonentów oraz chatu. 
Zawiera funkcjonalności umożliwiające integrację telefonu biurkowego i smartphone'a używanego przez abonenta centrali. 

Dużą zaletą tej aplikacji jest integracja książek kontaktów telefonicznych zapisanych w centrali. W '''''MessengerCTI.Mobile''''' wykorzystywane są zawsze książki zgromadzone w centrali, przy czym modyfikacja ich wpisów może być dokonywana tylko z telefonu systemowego jak i komputera przy użyciu programu '''''MessengerCTI.Desktop''''' lub aplikacji '''''WebCTI'''''. Ponadto program Slican '''''MessengerCTI.Mobile''''' posiada funkcjonalność komunikatora wewnętrznego - chatu. Użytkownikami komunikatora mogą być wszyscy abonenci danej centrali przy założeniu posiadania odpowiedniej licencji funkcjonalnej.
 
==Zalety aplikacji==
* aplikacja dostępna (bezpłatnie) w sklepie Google Play - wymagana jedynie po stronie centrali licencja CTI.plus
* książka kontaktów z podglądem stanu dostępności abonenta (czat, zajętości telefonu, opisu)
* dodawanie i usuwanie kontaktów z grupy ulubione, z pełną synchronizacją z aplikacją MessengerCTI.Desktop
* historia ostatnich połączeń/czatów posortowana chronologicznie
* logowanie jako telefonu równoległego do telefonu biurkowego lub jako osobny abonent MessengerCTI (tylko centrala NCP)
* komunikator czat
* historia czata połączona z historią połączeń telefonicznych
* połączenia głosowe przez GSM (dwie opcje zestawiania połączenia: przechwytywanie lub połączenie równoległe)
* elastyczne konfigurowanie powiadomień dźwiękowych
* dostęp do konfigurowania usług centrali na swoim telefonie
* numery podręczne do szybkiego przekazywania połączeń
* możliwość ustawiania zajętości telefonu biurkowego jeśli GSM zajęty (domyślnie włączone)
* możliwość ustawienia odrzucania wywołań na GSM jeśli telefon biurkowy zajęty
* możliwość kopiowania tekstu z chata
* możliwość obsługi smartphone'ów DualSIM lub dwóch telefonów jednocześnie (służbowy i prywatny)
* wygodne otwieranie drzwi jeśli dzwoni do nas bramofon DPH.IP oraz z menu kontekstowego dla kontaktu
* dodatkowy widget na pulpicie do szybkiego otwierania bramofonów DPH.IP
* automatyczny mechanizm opóźnienia powiadomienia na MessengerCTI.Mobile jeśli jestem aktywny na telefonie biurkowym lub MessengerCTI.Desktop
* możliwość kopiowania kontaktu z książki centrali telefonicznej do lokalnej książki telefonu

{{Uwaga|
Dla poprawnego działania aplikacji i połączeń wymagane są:
* stały dostęp do Internetu zarówno MessengerCTI.Mobile jak i centrali
* adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowany port 5529 TCP na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej
* w przypadku połączeń VoIP z aplikacji (wersja BETA) - adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowane porty 5060 UDP (sygnalizacja), 10000 - 20000 UDP (ramki głosowe RTP dla centrali NCP), 8100 - 8300 UDP (ramki głosowe RTP dla central IPx, MAC, CCT) na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej}}

= Wymagania minimalne =
Aplikacja '''''MessengerCTI.Mobile''''' - jest ogólnie dostępna do pobrania w sklepie Google Play.
W celu zainstalowania aplikacji spełnione muszą zostać następujące wymagania minimalne:
* system operacyjny Android - Android wersja systemu KitKat (4.4.4)
* dostęp do internetu dla aplikacji jak i centrali
Telefon z niższą wersją systemu Android nie będzie miał możliwości instalacji aplikacji.

{{Uwaga|
Aplikacja '''''MessengerCTI.Mobile''''' współpracuje z centralami IPx, MAC i CCT wyposażonymi w firmware co najmniej w wersji '''6.53''', oraz NCP '''1.11''' 
Obsługę VoIP w aplikacji w centralach IPx, MAC i CCT wprowadzono w wersji '''6.54''' oraz NCP '''1.12'''}} 

=Instalacja aplikacji =
Korzystanie z aplikacji '''''MessengerCTI.Mobile''''' jest licencjonowane więc wymaga wykupienia odpowiedniej licencji. Zakupiony kod jest wprowadzany w trakcie konfiguracji centrali i decyduje o ilości stanowisk, które mogą używać programu. Licencjonowanie aplikacji nie ma wpływu na jej instalację. Po zainstalowaniu aplikacji należy ją odpowiednio skonfigurować wprowadzając niezbędne dane do połączenia aplikacji z centralą: '''''Ustawienia->Konto''''' (opisane poniżej).

{{Uwaga|
Jeżeli numer wewnętrzny wprowadzony w ustawieniach nie posiada uprawnień do korzystania z aplikacji '''''MessengerCTI.Mobile''''' lub nie jest odpowiednio skonfigurowane konto CTI w centrali dla aplikacji mobilnej - nie będzie możliwości połączenia z centralą i synchronizacja danych.}}

== Uruchomienie aplikacji ==
Program '''''MessengerCTI.Mobile''''' uruchamia się identycznie jak każdy inny program w systemie operacyjnym Android. W trakcie uruchomienia następuje zalogowanie się programu do centrali (zgodnie z ustawieniami zakładce '''''Ustawienia->Konto'''''). Po pomyślnym zalogowaniu następuje synchronizacja danych programu z danymi w centrali (historii połączeń oraz czat).

== Konfiguracja aplikacji ==
Dla poprawnej komunikacji aplikacji z centralą należy skonfigurować dane konta CTI oraz pozostałe funkcje. Menu konfiguracji znajduje się w prawym górnym rogu okna aplikacji. Z rozwijanego menu wybieramy menu '''Ustawienia'''. 

==Ustawienia==

===Konto===
Zakładkę wypełniamy danymi do zalogowania aplikacji skonfigurowanymi przez administratora centrali:
* Twój numer telefonu: numer wewnętrzny telefonu użytkownika z odpowiednimi uprawnieniami dla komunikacji CTI
* Hasło: hasło użytkownika CTI
* Serwer: adres domenowy lub publiczny IP centrali dla użytkowników spoza sieci wewnętrznej lub prywatny dla użytkowników sieci lokalnej
* Zaawansowane/Port protokołu sygnalizacyjnego: port komunikacji z centralą - domyślnie dla centrali TCP 5529

===Powiadomienia===
Konfiguracja powiadomień połączeń przychodzących:
* dźwięk dzwonka: wybór jednego z listy dostępnych w aplikacji z możliwością wyciszenia go po określonym czasie
* wibracje przy dzwonku
* powiadomienie na pasku o nieodebranym połączeniu i wiadomości czat
Konfiguracja powiadomień wiadomości czat:
* dźwięk wiadomości: wybór jednego z listy dostępnych w aplikacji
* wibracje przy wiadomości
* powiadomienie na pasku o nowej wiadomości czat

===Numery podręczne===
Lista najważniejszych numerów podręcznych użytkownika wyświetlana podczas rozmowy w celu prostego przekazania połączenia.

===Inne===
Rozwiązywanie problemów z poprawnym działaniem aplikacji:
* debug - opcja dla administratora włączana na prośbę dostawcy oprogramowania w przypadku analizy problemów
Włączenie opcji '''debug''' powoduje iż w Menu głównym ujawnia się dodatkowe pole '''''Wyślij log'''''. Dalej wybieramy klienta pocztowego, z którego wyślemy logi aplikacji do analizy po stronie producenta.

== Usługi ==
Konfiguracja usług związanych z połączeniami:
* Wycisz aplikację: tryb dyskretny pracy aplikacji - bez powiadomień
* Opóźnienie powiadomień - w stosunku do telefonu biurkowego
* Harmonogram powiadomień - możliwość ustawienia tygodniowego planu aktywnego użytkowania aplikacji (włączania rozdzwaniania i powiadamiania w określonych godzinach)
* Domyślny typ połączenia - ustawienia sposobu realizacji połączeń za pomocą sieci GSM, VoIP lub VoIP przez WiFi.
* Usługi globalne dla centrali: DND - nie przeszkadzać, przekierowanie połączeń: wszystkie, gdy zajęty lub gdy nie odpowiada, zachowanie telefonu biurkowego i MCTI w przypadku zajętości jednego z nich

== Mój opis ==
Ustawienie własnego komentarza, który będzie widoczny dla pozostałych użytkowników aplikacji MessengerCTI oraz na ekranie telefonu systemowego CTS-330

== O programie ==
Informacje o:
* numerze własnym: numer wewnętrzny centrali na jaki zalogowana jest aplikacja
* komentarz abonenta
* bieżącej wersji aplikacji
* typ i numer centrali z jaką jest połączona aplikacja
* wersja oprogramowania centrali

== Aktualizacja aplikacji ==
Aktualizacja programu jest dokonywana automatycznie a użytkownik ma wpływ na jej przebieg zgodnie z ustawieniami aktualizacji automatycznych aplikacji danego telefonu dla posiadaczy kont Google. Jeżeli w sklepie Google Play pojawi się nowa wersja następuje automatyczne pobranie nowszej wersji lub powiadomienie o niej.

= Struktura aplikacji =
==Okno główne ==
W oknie głównym aplikacji widoczne są dwie zakładki:
* '''Ostatnie''' - związane z historią połączeń i przesyłanych wiadomości wraz ze statusem abonenta centrali
* '''Kontakty''' - z dostępem do kontaktów książki telefonicznej centrali, z możliwością ich filtrowania: ulubione, wewnętrzne, zewnętrzne
* ikona statusu zalogowania wraz z opisem
* wyszukiwarka kontaktów
* menu ustawień aplikacji
<center>[[Plik:MessengerCTI_opis_new.png|800px]]</center>

== Ikono-grafika ==
W aplikacji '''''MessengerCTI.Mobile''''' przyjęto zasadę intuicyjnego oznaczania stanu telefonu za pomocą ikon widocznych w aplikacji przy każdym z kontaktów lub wpisie historii połączeń. Ikony te umożliwiają wykonywanie wybranej akcji, ocenienie stanu połączenia lub powiadamiają o występowaniu błędów.
=== Ikony i symbole ===
Okno startowe "Ostatnie" aplikacji pokazuje historię ostatnich połączeń. W tym widoku znajdują się ikony:
* po lewej stronie: status aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile lub historia połączeń
* po prawej: informujące o kierunku połączenia i statusie wiadomości czat 

W Tabeli 1 przedstawiono opis znaczenia poszczególnych ikon informujących o statusie aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile:
* dla abonentów wewnętrznych centrali - ikony symbolizujące stan zalogowania aplikacji a, dotknięcie ikony statusu pozwala rozpocząć czat lub sprawdzić historię połączeń
* dla bramofonów DPH.IP - aktualne położenie drzwi, a przez dotknięcie ikony symbolizującej drzwi wejście do historii
* dla kontaktów spoza centrali - sprawdzenie historii połączeń
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTID_free.png|40px]] ||użytkownik zalogowany
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_zaraz_wracam1.png|37px]] ||status: "Zaraz wracam"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_busy1.png]] ||użytkownik ustawił stan "Nie przeszkadzać"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_no_login.png|40px]] ||użytkownik niezalogowany, niedostępny lub status "Niewidoczny"
|-
|{{align|center}}|[[Plik:MessengerCTIMD_chat_free.png|40px]] || jeden z możliwych statusów aplikacji Desktop z skonfigurowaną aplikacją w wersji Mobile
|-
|{{align|center}}|[[Plik:MessengerCTIM_chat_DND.png|40px]] ||historia połączeń oraz wiadomości
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_open.png|40px]] ||bramofon DPH.IP: drzwi otwarte
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_closed.png|40px]] ||bramofon DPH.IP: drzwi zamknięte
|-
|}
'''''Tabela 1:''''' Ikony symbolizujące stany aplikacji, użytkowników i bramofonów. </center> 

W przypadku telefonów będących numerami wewnętrznymi centrali, pojawia się ikona symbolizująca stan telefonu.
<center>

{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_call.png|40px]] ||numer zajęty
|-
|{{align|center}}|[[Plik:MessengerCTIM_ringing.png|40px]] ||dzwonienie na numer lub wykonywanie połączenia wychodzącego z numeru
|-
|{{align|center}}|[[Plik:MessengerCTIM_failure1.png|40px]] ||numer niedostępny lub uszkodzony
|-
|{{align|center}}|[[Plik:MessengerCTIM_DND.png|40px]] ||włączona usługa DND
|-
|}
'''''Tabela 2:''''' Ikony symbolizujące stan telefonu. </center>

W tabeli 3 przedstawiono opis ikon związanych z połączeniami:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_call.png|40px]] ||połączenie przychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_call.png|40px]] ||połączenie wychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_qty.png|50px]] ||nowe nieodebrane połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer.png|45px]] ||połączenie nieodebrane
|-
|}

'''''Tabela 3:''''' Ikony symbolizujące połączenia. </center>

W tabeli 4 przedstawiono opis ikon związanych ze statusem wiadomości:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_chat.png|40px]] ||wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_chat.png|40px]] ||wiadomość wysłana (przeczytana)
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_chat.png|50px]] ||nowa wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_received_chat.png|45px]] ||wiadomość wysłana nieprzeczytana
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_read_chat_conf.png|40px]] ||wiadomość wysłana przeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_notread_chat_conf.png|40px]] ||wiadomość wysłana nieprzeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_unav_chat_conf.png|40px]] ||wiadomość wysłana do niezalogowanego użytkownika - widok w oknie dialogowym
|-
|}
'''''Tabela 4:''''' Ikony symbolizujące status wiadomości. </center>

W tabeli 5 przedstawiono opis powiadomień związanych z błędami w działaniu aplikacji. Powiadomienia widoczne są pod ikoną statusu
<center>
{|{{prettytable}}
!{{Hl1}}|Powiadomienie !!{{Hl1}}| Znaczenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_internet.png]] ||brak połączenia z internetem: sprawdź połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_auth.png]] || błędny login lub hasło: sprawdź ustawienia konta
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_licen.png]] || brak licencji do użytkowania aplikacji: skontaktuj się administratorem centrali
|-
|}
'''''Tabela 5''''': Znaczenie powiadomień o błędach.
</center>

=Obsługa połączeń i wiadomości=
Do przeprowadzenia rozmowy między użytkownikami, niezbędne jest zapewnienie:
* prawidłowej konfiguracji konta po stronie aplikacji oraz centrali
* połączenia aplikacja-centrala (pełna synchronizacja danych aplikacji z centralą) - ikona aplikacji powinna mieć kolor zielony
* zainstalowany telefon systemowy Slican, VoIP lub analogowy dla central IPx, CCT, MAC, NCP lub skonfigurowany abonent typu MessengerCTI (tylko centrala NCP)

==Wykonywanie połączeń==
Dwa sposoby wykonywania połączeń:
* z zakładki '''Kontakty''' - wybieramy abonenta z odpowiedniej grupy (jeśli taka istnieje), bezpośrednio z grupy Wszystkie kontakty. Połączenie wykonujemy przez dotknięcie paska kontaktu wybierając z rozwijanego menu ikonę [[Plik:MessengerCTIM_outgoing.png|25px]]
* z zakładki '''Kontakty''' - bezpośrednio wpisując numer telefonu w polu '''Szukaj''' za pomocą klawiatury a następnie klikając dolny prawy róg klawiatury
<center>[[Plik:MessengerCTIM_out_ext1.png|700px]]</center>
* z zakładki '''Ostatnie''' - odnajdujemy abonenta, z którym mieliśmy kontakt (dzwonił do nas lub my do niego) a następnie połączenie wykonujemy przez dotknięcie paska kontaktu w środkowej części wybierając z rozwijanego menu odpowiednią akcję
<center>[[Plik:MessengerCTIM_out_number1.png|750px]]</center>
Zestawianie połączenia sygnalizowane jest ekranem połączenia jak dla zwykłych połączeń wykonywanych za pomocą linii GSM. Aplikacja zestawia w pierwszej kolejności połączenie do centrali na dedykowany numer dostępowy dla użytkowników '''MessengerCTI.Mobile''', konfigurowany przez administratora centrali. A następnie centrala tranzytem zestawia połączenie z numerem wybranym przez użytkownika '''MessengerCTI.Mobile'''. Z tego powodu w centrali wymaganym łączem miejskim co najmniej jest linia ISDN BRA.

==Połączenie przychodzące==
Połączenie przychodzące sygnalizowane wizualnie jest za pomocą wyskakującego okienka połączenia oraz akustycznie dzwonkiem skonfigurowanym w ustawieniach powiadomień. Połączenia odbieramy przez przesunięcie ikony z zieloną słuchawką. Jeśli połączenie ma być odrzucone to przesuwamy ikonę z czerwoną słuchawką. Dodatkowo jeśli mamy dodane numery podręczne możemy dane połączenie przychodzące przekazać na numer z listy przez przesunięcie ikony z numerem kontaktu podręcznego.
Proces odbierania połączeń przychodzących polega na wykonaniu połączenia zwrotnego do centrali za pomocą linii GSM na numer dostępowy aplikacji zdefiniowany przez administratora centrali.
<center>[[Plik:MessengerCTIM_incoming2.png|700px]]</center>

Nieodebrane połączenie symbolizowane jest ikoną [[Plik:MessengerCTIM_no_answer_qty.png|50px]]. Przejście do historii połączenia lub oddzwonienie powoduje wyczyszczenie informacji o ilości połączeń nieodebranych.

==Obsługa wiadomości==
Aplikacja umożliwia wysyłanie i przyjmowanie wiadomości tekstowych pomiędzy użytkownikami aplikacji MessengerCTI.Desktop/Mobile (czat wewnętrzny). Aby wysłać wiadomość czat klikamy w ikonę statusu aplikacji użytkownika lub z rozwijanego menu po kliknięciu w pasek z kontaktem wybieramy opcję '''chat'''. Otrzymanie nowej wiadomości sygnalizowane jest na pasku powiadomień odpowiednią ikoną oraz zdefiniowanym sygnałem dźwiękowym. 
Jeśli użytkownik używa obu wersji MessengeraCTI, historia wiadomości przechowywana jest także lokalnie w aplikacji '''''MessengerCTI.Desktop'''''.
 Poniżej przykładowe okno dialogowe wiadomości chat:

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

== Kontakty==
Zakładka kontakty umożliwia wyświetlanie i uruchamianie wybranych akcji związanych z kontaktem. Dostęp do numerów z pozostałych grup można uzyskać rozwijając listę pozostałych kontaktów pogrupowanych jako:
* ulubione
* wszystkie grupy
* wszystkie kontakty
* wewnętrzne
* zewnętrzne
* prywatne
Domyślnie widoczna jest grupa '''Ulubione'''.
<center>[[Plik:MessengerCTIM_contacts1.png|300px]]</center>

== Historia połączeń ==
Domyślnie wybrana zakładka '''Ostatnie''' w oknie głównym programu wyświetla historię połączeń jak i wiadomości czat. 
W historii każda pozycja oznacza co najmniej jedno połączenie lub wiadomość. Jeśli połączenie lub wiadomość pochodzi od tego samego użytkownika i jest ich więcej niż jedno, to przy odpowiedniej ikonie wyświetlana jest stosowna liczba. W każdej pozycji widoczny jest numer dzwoniącego, komentarz(jeśli jest on w książce numerów spoza centrali), czas i data realizacji połączenia. 
Jeśli w historii znajdują się nie przejrzane nieodebrane połączenia lub nieprzeczytane wiadomości to zakładka '''Ostatnie''' jest oznaczona czerwoną kropką. 
Z zakładki historii możliwe jest oddzwanianie lub wysyłanie wiadomości zwrotnych.

=Konfiguracja centrali Slican=
Do poprawnej współpracy aplikacji z centralą jest wymagane:
* odpowiednia licencja producenta
* specyficzna konfiguracja centrali
==Konfiguracja central IPx, CCT==
Za pomocą programu ConfgMAN:
# w arkuszu '''''Globalne ustawienia/Pozostałe'''''
## pole '''ANo''' - skonfigurować numer dostępowy, który będzie wybierać telefon GSM z zainstalowaną aplikacją aby dodzwonić się do centrali lub centrala do telefonu celem zestawienia połączenia (w konfiguracji z obsługą połączeń przez sieć GSM)
## pole '''Adr''' - publiczna nazwa hosta lub adres IP centrali dla pracy aplikacji (w konfiguracji z obsługą połączeń przez VoIP)
# w edycji Abonenta - menu '''''Abonenci/Ustawienia CTI:
## '''AwdMbl''': zezwolenie na obsługę aplikacji przez abonenta
## '''AwdGSM''': zezwolenie na obsługę połączeń telefonicznych przez sieć GSM
## '''IncC''': ustawienie sposobu obsługi połączeń przychodzących przez aplikację:
### przechwytywanie wywołań - odebranie połączenia przychodzącego za pomocą aplikacji polega na zestawieniu przez telefon GSM połączenia wychodzącego na numer podany w polu '''ANo''' arkusza '''''Globalne ustawienia/Pozostałe'''''
### dzwonienie równoległe - połączenie przychodzące na telefon GSM z numeru podanego w polu '''ANo''' arkusza '''''Globalne ustawienia/Pozostałe'''''
## '''MnNo''': numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja
## '''SecNo''': drugi numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja (opcjonalny, dla telefonu z dual SIM)

Do pracy aplikacji w odpowiednim trybie wymagane jest uzupełnienie następujących pól:
* przez sieć VoIP: 1.2, 2.1
* przez sieć GSM: 1.1, 2.1, 2.2, 2.2.1, 2.2.2, 2.3 oraz 2.3.1 lub 2.3.2

'''Minimalna wymagana wersja oprogramowania centrali - 6.53, do pracy w trybie VoIP - 6.54'''

==Konfiguracja centrali NCP==

Z poziomu aplikacji ConfigWEB
# w arkuszu '''''Numery wewnętrzne/ Ustawienia/ Konfiguracja aplikacji CTI/ MessengerCTI''''' skonfigurować:
## Publiczna nazwa hosta lub adres IP centrali dla protokołu XML Slican - nazwa domenowa lub adres IP do wymiany/synchronizacji informacji pomiędzy centralą i aplikacją
## Publiczna nazwa hosta lub adres IP centrali dla połączeń VoIP - nazwa domenowa lub adres IP dla konfiguracji z obsługą połączeń przez VoIP
## Numer telefonu do centrali dla połączeń GSM - który będzie wybierać telefon GSM z zainstalowaną aplikacją aby dodzwonić się do centrali lub centrala do telefonu celem zestawienia połączenia (w konfiguracji z obsługą połączeń przez sieć GSM)
# w konfiguracji abonenta SIP, FXS, CTS, MCTI w arkuszu '''''Numery wewnętrzne/ Abonenci/ CTI ustawienia/ MessengerCTI.Mobile'''''
## włączyć dostęp do aplikacji
## w przypadku pracy przez sieć GSM włączyć zezwolenie na obsługę połączeń telefonicznych przez tą sieć
### wprowadzić numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja
### wprowadzić drugi numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja (opcjonalny, dla telefonu z dual SIM)
## ustawić sposób obsługi połączeń przychodzących
### przechwytywanie wywołań - odebranie połączenia przychodzącego za pomocą aplikacji polega na zestawieniu przez telefon GSM połączenia wychodzącego na numer podany w polu '''Numer telefonu do centrali dla połączeń GSM''' arkusza '''''Numery wewnętrzne/ Ustawienia/ Konfiguracja aplikacji CTI/ MessengerCTI'''''
### dzwonienie równoległe - połączenie przychodzące na telefon GSM z numeru podanego w polu '''Numer telefonu do centrali dla połączeń GSM''' arkusza '''''Numery wewnętrzne/ Ustawienia/ Konfiguracja aplikacji CTI/ MessengerCTI'''''

Do pracy aplikacji w odpowiednim trybie wymagane jest uzupełnienie następujących pól:
* przez sieć VoIP: 1.1, 1.2, 2.1
* przez sieć GSM: 1.1, 1.3, 2.1, 2.2, 2.2.1, 2.2.2, 2.3 oraz 2.3.1 lub 2.3.2

'''Minimalna wymagana wersja oprogramowania - 1.11, do pracy w trybie VoIP - 1.12'''

=Przykłady zastosowań=
Aplikacja '''''MessengerCTI.Mobile''''' może być atrakcyjnym narzędziem dla tych firm, które posiadają pracowników mobilnych z wymogiem ciągłego dostępu telefonicznego jako numer wewnętrzny danego systemu telefonicznego. 
Dobry przykładem mogą pracownicy:
* działu handlowego - z pracą w trybie mieszanym biuro <-> poza biurem
* działu serwisowego - z pracą ciągłą w terenie
* pracownicy zdalni - telepraca
* pracownicy mobilni - praca na dużym terenie (hale produkcyjne, obszary rozległe) - gdzie zasięg sieci typu WiFi lub DECT nie obejmuje takich obszarów.

=Instalacja wersji beta aplikacji=
Wersja "beta" aplikacji zawiera nowe funkcjonalności które będą wprowadzane w następnej wersji produkcyjnej, jednak nie wszystkie zaplanowane na wersję funkcje są już wdrożone. Wersja zawiera również poprawki błędów zgłoszone do wersji wcześniejszych. Jest wstępnie przetestowana przez producenta. 
Aby zainstalować wersję beta należy wykonać następujące czyności: 
- Jeśli w telefonie zainstalowana jest już aplikacja MessengerCTI należy ja odinstalować. 
- Zalogować się w Google Play jako tester aplikacji 
W tym celu należy:
Zalogować się z komputera lub przeglądarki telefonu do swojego konta Google. Jeśli masz więcej niż jedno konto to ważne jest aby zalogować się do tego konta które skonfigurowane jest w telefonie. 
Kliknąć następujący link:
[https://play.google.com/apps/testing/com.slican.messengercti rejestracja do wersji beta] 
Na stronie zobaczysz następującą informację: 
[[Plik:google_beta.jpg]] 
Kliknij opcję "ZOSTAŃ TESTEREM" 
Wracamy do konfiguracji telefonu: 
- Ponieważ aktualizacje w Google Play pojawiają się z pewnym opóźnieniem przed zainstalowaniem MessengerCTI dobrze jest wyłączyć aplikacje Sklep Play. 
- Klikając w jego skrót nastąpi ponowne uruchomienie Sklep Play. Wyszukujemy aplikację MessengerCTI. Ze względu na ilość dostępnych tego typu aplikacji warto szukać nazwy Slican. 
- Instalujemy aplikację 
- Konfigurujemy zgodnie z instrukcją opisaną powyżej 
Cieszymy się z nowych funkcji dostępnych tylko dla nielicznych.

Plik:Google beta.jpg

2019-04-08T08:18:46Z

Marekg:

Instrukcja obsługi MessengerCTI.Mobile

2019-04-08T08:18:08Z

Marekg:

<center>[[Plik:messenger_2.png|250px]]</center>
= Wstęp =
Aplikacja Slican '''''MessengerCTI.Mobile''''' jest aplikacją mobilną przeznaczona na system '''Android''', który łączy w sobie możliwość wykonywania połączeń przychodzących jak i wychodzących, dostęp do książki telefonicznej, historii, podglądu statusu innych abonentów oraz chatu. 
Zawiera funkcjonalności umożliwiające integrację telefonu biurkowego i smartphone'a używanego przez abonenta centrali. 

Dużą zaletą tej aplikacji jest integracja książek kontaktów telefonicznych zapisanych w centrali. W '''''MessengerCTI.Mobile''''' wykorzystywane są zawsze książki zgromadzone w centrali, przy czym modyfikacja ich wpisów może być dokonywana tylko z telefonu systemowego jak i komputera przy użyciu programu '''''MessengerCTI.Desktop''''' lub aplikacji '''''WebCTI'''''. Ponadto program Slican '''''MessengerCTI.Mobile''''' posiada funkcjonalność komunikatora wewnętrznego - chatu. Użytkownikami komunikatora mogą być wszyscy abonenci danej centrali przy założeniu posiadania odpowiedniej licencji funkcjonalnej.
 
==Zalety aplikacji==
* aplikacja dostępna (bezpłatnie) w sklepie Google Play - wymagana jedynie po stronie centrali licencja CTI.plus
* książka kontaktów z podglądem stanu dostępności abonenta (czat, zajętości telefonu, opisu)
* dodawanie i usuwanie kontaktów z grupy ulubione, z pełną synchronizacją z aplikacją MessengerCTI.Desktop
* historia ostatnich połączeń/czatów posortowana chronologicznie
* logowanie jako telefonu równoległego do telefonu biurkowego lub jako osobny abonent MessengerCTI (tylko centrala NCP)
* komunikator czat
* historia czata połączona z historią połączeń telefonicznych
* połączenia głosowe przez GSM (dwie opcje zestawiania połączenia: przechwytywanie lub połączenie równoległe)
* elastyczne konfigurowanie powiadomień dźwiękowych
* dostęp do konfigurowania usług centrali na swoim telefonie
* numery podręczne do szybkiego przekazywania połączeń
* możliwość ustawiania zajętości telefonu biurkowego jeśli GSM zajęty (domyślnie włączone)
* możliwość ustawienia odrzucania wywołań na GSM jeśli telefon biurkowy zajęty
* możliwość kopiowania tekstu z chata
* możliwość obsługi smartphone'ów DualSIM lub dwóch telefonów jednocześnie (służbowy i prywatny)
* wygodne otwieranie drzwi jeśli dzwoni do nas bramofon DPH.IP oraz z menu kontekstowego dla kontaktu
* dodatkowy widget na pulpicie do szybkiego otwierania bramofonów DPH.IP
* automatyczny mechanizm opóźnienia powiadomienia na MessengerCTI.Mobile jeśli jestem aktywny na telefonie biurkowym lub MessengerCTI.Desktop
* możliwość kopiowania kontaktu z książki centrali telefonicznej do lokalnej książki telefonu

{{Uwaga|
Dla poprawnego działania aplikacji i połączeń wymagane są:
* stały dostęp do Internetu zarówno MessengerCTI.Mobile jak i centrali
* adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowany port 5529 TCP na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej
* w przypadku połączeń VoIP z aplikacji (wersja BETA) - adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowane porty 5060 UDP (sygnalizacja), 10000 - 20000 UDP (ramki głosowe RTP dla centrali NCP), 8100 - 8300 UDP (ramki głosowe RTP dla central IPx, MAC, CCT) na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej}}

= Wymagania minimalne =
Aplikacja '''''MessengerCTI.Mobile''''' - jest ogólnie dostępna do pobrania w sklepie Google Play.
W celu zainstalowania aplikacji spełnione muszą zostać następujące wymagania minimalne:
* system operacyjny Android - Android wersja systemu KitKat (4.4.4)
* dostęp do internetu dla aplikacji jak i centrali
Telefon z niższą wersją systemu Android nie będzie miał możliwości instalacji aplikacji.

{{Uwaga|
Aplikacja '''''MessengerCTI.Mobile''''' współpracuje z centralami IPx, MAC i CCT wyposażonymi w firmware co najmniej w wersji '''6.53''', oraz NCP '''1.11''' 
Obsługę VoIP w aplikacji w centralach IPx, MAC i CCT wprowadzono w wersji '''6.54''' oraz NCP '''1.12'''}} 

=Instalacja aplikacji =
Korzystanie z aplikacji '''''MessengerCTI.Mobile''''' jest licencjonowane więc wymaga wykupienia odpowiedniej licencji. Zakupiony kod jest wprowadzany w trakcie konfiguracji centrali i decyduje o ilości stanowisk, które mogą używać programu. Licencjonowanie aplikacji nie ma wpływu na jej instalację. Po zainstalowaniu aplikacji należy ją odpowiednio skonfigurować wprowadzając niezbędne dane do połączenia aplikacji z centralą: '''''Ustawienia->Konto''''' (opisane poniżej).

{{Uwaga|
Jeżeli numer wewnętrzny wprowadzony w ustawieniach nie posiada uprawnień do korzystania z aplikacji '''''MessengerCTI.Mobile''''' lub nie jest odpowiednio skonfigurowane konto CTI w centrali dla aplikacji mobilnej - nie będzie możliwości połączenia z centralą i synchronizacja danych.}}

== Uruchomienie aplikacji ==
Program '''''MessengerCTI.Mobile''''' uruchamia się identycznie jak każdy inny program w systemie operacyjnym Android. W trakcie uruchomienia następuje zalogowanie się programu do centrali (zgodnie z ustawieniami zakładce '''''Ustawienia->Konto'''''). Po pomyślnym zalogowaniu następuje synchronizacja danych programu z danymi w centrali (historii połączeń oraz czat).

== Konfiguracja aplikacji ==
Dla poprawnej komunikacji aplikacji z centralą należy skonfigurować dane konta CTI oraz pozostałe funkcje. Menu konfiguracji znajduje się w prawym górnym rogu okna aplikacji. Z rozwijanego menu wybieramy menu '''Ustawienia'''. 

==Ustawienia==

===Konto===
Zakładkę wypełniamy danymi do zalogowania aplikacji skonfigurowanymi przez administratora centrali:
* Twój numer telefonu: numer wewnętrzny telefonu użytkownika z odpowiednimi uprawnieniami dla komunikacji CTI
* Hasło: hasło użytkownika CTI
* Serwer: adres domenowy lub publiczny IP centrali dla użytkowników spoza sieci wewnętrznej lub prywatny dla użytkowników sieci lokalnej
* Zaawansowane/Port protokołu sygnalizacyjnego: port komunikacji z centralą - domyślnie dla centrali TCP 5529

===Powiadomienia===
Konfiguracja powiadomień połączeń przychodzących:
* dźwięk dzwonka: wybór jednego z listy dostępnych w aplikacji z możliwością wyciszenia go po określonym czasie
* wibracje przy dzwonku
* powiadomienie na pasku o nieodebranym połączeniu i wiadomości czat
Konfiguracja powiadomień wiadomości czat:
* dźwięk wiadomości: wybór jednego z listy dostępnych w aplikacji
* wibracje przy wiadomości
* powiadomienie na pasku o nowej wiadomości czat

===Numery podręczne===
Lista najważniejszych numerów podręcznych użytkownika wyświetlana podczas rozmowy w celu prostego przekazania połączenia.

===Inne===
Rozwiązywanie problemów z poprawnym działaniem aplikacji:
* debug - opcja dla administratora włączana na prośbę dostawcy oprogramowania w przypadku analizy problemów
Włączenie opcji '''debug''' powoduje iż w Menu głównym ujawnia się dodatkowe pole '''''Wyślij log'''''. Dalej wybieramy klienta pocztowego, z którego wyślemy logi aplikacji do analizy po stronie producenta.

== Usługi ==
Konfiguracja usług związanych z połączeniami:
* Wycisz aplikację: tryb dyskretny pracy aplikacji - bez powiadomień
* Opóźnienie powiadomień - w stosunku do telefonu biurkowego
* Harmonogram powiadomień - możliwość ustawienia tygodniowego planu aktywnego użytkowania aplikacji (włączania rozdzwaniania i powiadamiania w określonych godzinach)
* Domyślny typ połączenia - ustawienia sposobu realizacji połączeń za pomocą sieci GSM, VoIP lub VoIP przez WiFi.
* Usługi globalne dla centrali: DND - nie przeszkadzać, przekierowanie połączeń: wszystkie, gdy zajęty lub gdy nie odpowiada, zachowanie telefonu biurkowego i MCTI w przypadku zajętości jednego z nich

== Mój opis ==
Ustawienie własnego komentarza, który będzie widoczny dla pozostałych użytkowników aplikacji MessengerCTI oraz na ekranie telefonu systemowego CTS-330

== O programie ==
Informacje o:
* numerze własnym: numer wewnętrzny centrali na jaki zalogowana jest aplikacja
* komentarz abonenta
* bieżącej wersji aplikacji
* typ i numer centrali z jaką jest połączona aplikacja
* wersja oprogramowania centrali

== Aktualizacja aplikacji ==
Aktualizacja programu jest dokonywana automatycznie a użytkownik ma wpływ na jej przebieg zgodnie z ustawieniami aktualizacji automatycznych aplikacji danego telefonu dla posiadaczy kont Google. Jeżeli w sklepie Google Play pojawi się nowa wersja następuje automatyczne pobranie nowszej wersji lub powiadomienie o niej.

= Struktura aplikacji =
==Okno główne ==
W oknie głównym aplikacji widoczne są dwie zakładki:
* '''Ostatnie''' - związane z historią połączeń i przesyłanych wiadomości wraz ze statusem abonenta centrali
* '''Kontakty''' - z dostępem do kontaktów książki telefonicznej centrali, z możliwością ich filtrowania: ulubione, wewnętrzne, zewnętrzne
* ikona statusu zalogowania wraz z opisem
* wyszukiwarka kontaktów
* menu ustawień aplikacji
<center>[[Plik:MessengerCTI_opis_new.png|800px]]</center>

== Ikono-grafika ==
W aplikacji '''''MessengerCTI.Mobile''''' przyjęto zasadę intuicyjnego oznaczania stanu telefonu za pomocą ikon widocznych w aplikacji przy każdym z kontaktów lub wpisie historii połączeń. Ikony te umożliwiają wykonywanie wybranej akcji, ocenienie stanu połączenia lub powiadamiają o występowaniu błędów.
=== Ikony i symbole ===
Okno startowe "Ostatnie" aplikacji pokazuje historię ostatnich połączeń. W tym widoku znajdują się ikony:
* po lewej stronie: status aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile lub historia połączeń
* po prawej: informujące o kierunku połączenia i statusie wiadomości czat 

W Tabeli 1 przedstawiono opis znaczenia poszczególnych ikon informujących o statusie aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile:
* dla abonentów wewnętrznych centrali - ikony symbolizujące stan zalogowania aplikacji a, dotknięcie ikony statusu pozwala rozpocząć czat lub sprawdzić historię połączeń
* dla bramofonów DPH.IP - aktualne położenie drzwi, a przez dotknięcie ikony symbolizującej drzwi wejście do historii
* dla kontaktów spoza centrali - sprawdzenie historii połączeń
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTID_free.png|40px]] ||użytkownik zalogowany
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_zaraz_wracam1.png|37px]] ||status: "Zaraz wracam"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_busy1.png]] ||użytkownik ustawił stan "Nie przeszkadzać"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_no_login.png|40px]] ||użytkownik niezalogowany, niedostępny lub status "Niewidoczny"
|-
|{{align|center}}|[[Plik:MessengerCTIMD_chat_free.png|40px]] || jeden z możliwych statusów aplikacji Desktop z skonfigurowaną aplikacją w wersji Mobile
|-
|{{align|center}}|[[Plik:MessengerCTIM_chat_DND.png|40px]] ||historia połączeń oraz wiadomości
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_open.png|40px]] ||bramofon DPH.IP: drzwi otwarte
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_closed.png|40px]] ||bramofon DPH.IP: drzwi zamknięte
|-
|}
'''''Tabela 1:''''' Ikony symbolizujące stany aplikacji, użytkowników i bramofonów. </center> 

W przypadku telefonów będących numerami wewnętrznymi centrali, pojawia się ikona symbolizująca stan telefonu.
<center>

{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_call.png|40px]] ||numer zajęty
|-
|{{align|center}}|[[Plik:MessengerCTIM_ringing.png|40px]] ||dzwonienie na numer lub wykonywanie połączenia wychodzącego z numeru
|-
|{{align|center}}|[[Plik:MessengerCTIM_failure1.png|40px]] ||numer niedostępny lub uszkodzony
|-
|{{align|center}}|[[Plik:MessengerCTIM_DND.png|40px]] ||włączona usługa DND
|-
|}
'''''Tabela 2:''''' Ikony symbolizujące stan telefonu. </center>

W tabeli 3 przedstawiono opis ikon związanych z połączeniami:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_call.png|40px]] ||połączenie przychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_call.png|40px]] ||połączenie wychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_qty.png|50px]] ||nowe nieodebrane połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer.png|45px]] ||połączenie nieodebrane
|-
|}

'''''Tabela 3:''''' Ikony symbolizujące połączenia. </center>

W tabeli 4 przedstawiono opis ikon związanych ze statusem wiadomości:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_chat.png|40px]] ||wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_chat.png|40px]] ||wiadomość wysłana (przeczytana)
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_chat.png|50px]] ||nowa wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_received_chat.png|45px]] ||wiadomość wysłana nieprzeczytana
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_read_chat_conf.png|40px]] ||wiadomość wysłana przeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_notread_chat_conf.png|40px]] ||wiadomość wysłana nieprzeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_unav_chat_conf.png|40px]] ||wiadomość wysłana do niezalogowanego użytkownika - widok w oknie dialogowym
|-
|}
'''''Tabela 4:''''' Ikony symbolizujące status wiadomości. </center>

W tabeli 5 przedstawiono opis powiadomień związanych z błędami w działaniu aplikacji. Powiadomienia widoczne są pod ikoną statusu
<center>
{|{{prettytable}}
!{{Hl1}}|Powiadomienie !!{{Hl1}}| Znaczenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_internet.png]] ||brak połączenia z internetem: sprawdź połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_auth.png]] || błędny login lub hasło: sprawdź ustawienia konta
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_licen.png]] || brak licencji do użytkowania aplikacji: skontaktuj się administratorem centrali
|-
|}
'''''Tabela 5''''': Znaczenie powiadomień o błędach.
</center>

=Obsługa połączeń i wiadomości=
Do przeprowadzenia rozmowy między użytkownikami, niezbędne jest zapewnienie:
* prawidłowej konfiguracji konta po stronie aplikacji oraz centrali
* połączenia aplikacja-centrala (pełna synchronizacja danych aplikacji z centralą) - ikona aplikacji powinna mieć kolor zielony
* zainstalowany telefon systemowy Slican, VoIP lub analogowy dla central IPx, CCT, MAC, NCP lub skonfigurowany abonent typu MessengerCTI (tylko centrala NCP)

==Wykonywanie połączeń==
Dwa sposoby wykonywania połączeń:
* z zakładki '''Kontakty''' - wybieramy abonenta z odpowiedniej grupy (jeśli taka istnieje), bezpośrednio z grupy Wszystkie kontakty. Połączenie wykonujemy przez dotknięcie paska kontaktu wybierając z rozwijanego menu ikonę [[Plik:MessengerCTIM_outgoing.png|25px]]
* z zakładki '''Kontakty''' - bezpośrednio wpisując numer telefonu w polu '''Szukaj''' za pomocą klawiatury a następnie klikając dolny prawy róg klawiatury
<center>[[Plik:MessengerCTIM_out_ext1.png|700px]]</center>
* z zakładki '''Ostatnie''' - odnajdujemy abonenta, z którym mieliśmy kontakt (dzwonił do nas lub my do niego) a następnie połączenie wykonujemy przez dotknięcie paska kontaktu w środkowej części wybierając z rozwijanego menu odpowiednią akcję
<center>[[Plik:MessengerCTIM_out_number1.png|750px]]</center>
Zestawianie połączenia sygnalizowane jest ekranem połączenia jak dla zwykłych połączeń wykonywanych za pomocą linii GSM. Aplikacja zestawia w pierwszej kolejności połączenie do centrali na dedykowany numer dostępowy dla użytkowników '''MessengerCTI.Mobile''', konfigurowany przez administratora centrali. A następnie centrala tranzytem zestawia połączenie z numerem wybranym przez użytkownika '''MessengerCTI.Mobile'''. Z tego powodu w centrali wymaganym łączem miejskim co najmniej jest linia ISDN BRA.

==Połączenie przychodzące==
Połączenie przychodzące sygnalizowane wizualnie jest za pomocą wyskakującego okienka połączenia oraz akustycznie dzwonkiem skonfigurowanym w ustawieniach powiadomień. Połączenia odbieramy przez przesunięcie ikony z zieloną słuchawką. Jeśli połączenie ma być odrzucone to przesuwamy ikonę z czerwoną słuchawką. Dodatkowo jeśli mamy dodane numery podręczne możemy dane połączenie przychodzące przekazać na numer z listy przez przesunięcie ikony z numerem kontaktu podręcznego.
Proces odbierania połączeń przychodzących polega na wykonaniu połączenia zwrotnego do centrali za pomocą linii GSM na numer dostępowy aplikacji zdefiniowany przez administratora centrali.
<center>[[Plik:MessengerCTIM_incoming2.png|700px]]</center>

Nieodebrane połączenie symbolizowane jest ikoną [[Plik:MessengerCTIM_no_answer_qty.png|50px]]. Przejście do historii połączenia lub oddzwonienie powoduje wyczyszczenie informacji o ilości połączeń nieodebranych.

==Obsługa wiadomości==
Aplikacja umożliwia wysyłanie i przyjmowanie wiadomości tekstowych pomiędzy użytkownikami aplikacji MessengerCTI.Desktop/Mobile (czat wewnętrzny). Aby wysłać wiadomość czat klikamy w ikonę statusu aplikacji użytkownika lub z rozwijanego menu po kliknięciu w pasek z kontaktem wybieramy opcję '''chat'''. Otrzymanie nowej wiadomości sygnalizowane jest na pasku powiadomień odpowiednią ikoną oraz zdefiniowanym sygnałem dźwiękowym. 
Jeśli użytkownik używa obu wersji MessengeraCTI, historia wiadomości przechowywana jest także lokalnie w aplikacji '''''MessengerCTI.Desktop'''''.
 Poniżej przykładowe okno dialogowe wiadomości chat:

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

== Kontakty==
Zakładka kontakty umożliwia wyświetlanie i uruchamianie wybranych akcji związanych z kontaktem. Dostęp do numerów z pozostałych grup można uzyskać rozwijając listę pozostałych kontaktów pogrupowanych jako:
* ulubione
* wszystkie grupy
* wszystkie kontakty
* wewnętrzne
* zewnętrzne
* prywatne
Domyślnie widoczna jest grupa '''Ulubione'''.
<center>[[Plik:MessengerCTIM_contacts1.png|300px]]</center>

== Historia połączeń ==
Domyślnie wybrana zakładka '''Ostatnie''' w oknie głównym programu wyświetla historię połączeń jak i wiadomości czat. 
W historii każda pozycja oznacza co najmniej jedno połączenie lub wiadomość. Jeśli połączenie lub wiadomość pochodzi od tego samego użytkownika i jest ich więcej niż jedno, to przy odpowiedniej ikonie wyświetlana jest stosowna liczba. W każdej pozycji widoczny jest numer dzwoniącego, komentarz(jeśli jest on w książce numerów spoza centrali), czas i data realizacji połączenia. 
Jeśli w historii znajdują się nie przejrzane nieodebrane połączenia lub nieprzeczytane wiadomości to zakładka '''Ostatnie''' jest oznaczona czerwoną kropką. 
Z zakładki historii możliwe jest oddzwanianie lub wysyłanie wiadomości zwrotnych.

=Konfiguracja centrali Slican=
Do poprawnej współpracy aplikacji z centralą jest wymagane:
* odpowiednia licencja producenta
* specyficzna konfiguracja centrali
==Konfiguracja central IPx, CCT==
Za pomocą programu ConfgMAN:
# w arkuszu '''''Globalne ustawienia/Pozostałe'''''
## pole '''ANo''' - skonfigurować numer dostępowy, który będzie wybierać telefon GSM z zainstalowaną aplikacją aby dodzwonić się do centrali lub centrala do telefonu celem zestawienia połączenia (w konfiguracji z obsługą połączeń przez sieć GSM)
## pole '''Adr''' - publiczna nazwa hosta lub adres IP centrali dla pracy aplikacji (w konfiguracji z obsługą połączeń przez VoIP)
# w edycji Abonenta - menu '''''Abonenci/Ustawienia CTI:
## '''AwdMbl''': zezwolenie na obsługę aplikacji przez abonenta
## '''AwdGSM''': zezwolenie na obsługę połączeń telefonicznych przez sieć GSM
## '''IncC''': ustawienie sposobu obsługi połączeń przychodzących przez aplikację:
### przechwytywanie wywołań - odebranie połączenia przychodzącego za pomocą aplikacji polega na zestawieniu przez telefon GSM połączenia wychodzącego na numer podany w polu '''ANo''' arkusza '''''Globalne ustawienia/Pozostałe'''''
### dzwonienie równoległe - połączenie przychodzące na telefon GSM z numeru podanego w polu '''ANo''' arkusza '''''Globalne ustawienia/Pozostałe'''''
## '''MnNo''': numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja
## '''SecNo''': drugi numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja (opcjonalny, dla telefonu z dual SIM)

Do pracy aplikacji w odpowiednim trybie wymagane jest uzupełnienie następujących pól:
* przez sieć VoIP: 1.2, 2.1
* przez sieć GSM: 1.1, 2.1, 2.2, 2.2.1, 2.2.2, 2.3 oraz 2.3.1 lub 2.3.2

'''Minimalna wymagana wersja oprogramowania centrali - 6.53, do pracy w trybie VoIP - 6.54'''

==Konfiguracja centrali NCP==

Z poziomu aplikacji ConfigWEB
# w arkuszu '''''Numery wewnętrzne/ Ustawienia/ Konfiguracja aplikacji CTI/ MessengerCTI'''''" skonfigurować:
## Publiczna nazwa hosta lub adres IP centrali dla protokołu XML Slican - nazwa domenowa lub adres IP do wymiany/synchronizacji informacji pomiędzy centralą i aplikacją
## Publiczna nazwa hosta lub adres IP centrali dla połączeń VoIP - nazwa domenowa lub adres IP dla konfiguracji z obsługą połączeń przez VoIP
## Numer telefonu do centrali dla połączeń GSM - który będzie wybierać telefon GSM z zainstalowaną aplikacją aby dodzwonić się do centrali lub centrala do telefonu celem zestawienia połączenia (w konfiguracji z obsługą połączeń przez sieć GSM)
# w konfiguracji abonenta SIP, FXS, CTS, MCTI w arkuszu '''''Numery wewnętrzne/ Abonenci/ CTI ustawienia/ MessengerCTI.Mobile'''''
## włączyć dostęp do aplikacji
## w przypadku pracy przez sieć GSM włączyć zezwolenie na obsługę połączeń telefonicznych przez tą sieć
### wprowadzić numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja
### wprowadzić drugi numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja (opcjonalny, dla telefonu z dual SIM)
## ustawić sposób obsługi połączeń przychodzących
### przechwytywanie wywołań - odebranie połączenia przychodzącego za pomocą aplikacji polega na zestawieniu przez telefon GSM połączenia wychodzącego na numer podany w polu '''Numer telefonu do centrali dla połączeń GSM''' arkusza '''''Numery wewnętrzne/ Ustawienia/ Konfiguracja aplikacji CTI/ MessengerCTI'''''
### dzwonienie równoległe - połączenie przychodzące na telefon GSM z numeru podanego w polu '''Numer telefonu do centrali dla połączeń GSM''' arkusza '''''Numery wewnętrzne/ Ustawienia/ Konfiguracja aplikacji CTI/ MessengerCTI'''''

Do pracy aplikacji w odpowiednim trybie wymagane jest uzupełnienie następujących pól:
* przez sieć VoIP: 1.1, 1.2, 2.1
* przez sieć GSM: 1.1, 1.3, 2.1, 2.2, 2.2.1, 2.2.2, 2.3 oraz 2.3.1 lub 2.3.2

'''Minimalna wymagana wersja oprogramowania - 1.11, do pracy w trybie VoIP - 1.12'''

=Przykłady zastosowań=
Aplikacja '''''MessengerCTI.Mobile''''' może być atrakcyjnym narzędziem dla tych firm, które posiadają pracowników mobilnych z wymogiem ciągłego dostępu telefonicznego jako numer wewnętrzny danego systemu telefonicznego. 
Dobry przykładem mogą pracownicy:
* działu handlowego - z pracą w trybie mieszanym biuro <-> poza biurem
* działu serwisowego - z pracą ciągłą w terenie
* pracownicy zdalni - telepraca
* pracownicy mobilni - praca na dużym terenie (hale produkcyjne, obszary rozległe) - gdzie zasięg sieci typu WiFi lub DECT nie obejmuje takich obszarów.

=Instalacja wersji beta aplikacji=
Wersja "beta" aplikacji zawiera nowe funkcjonalności które będą wprowadzane w następnej wersji produkcyjnej, jednak nie wszystkie zaplanowane na wersję funkcje są już wdrożone. Wersja zawiera również poprawki błędów zgłoszone do wersji wcześniejszych. Jest wstępnie przetestowana przez producenta. 
Aby zainstalować wersję beta należy wykonać następujące czyności: 
- Jeśli w telefonie zainstalowana jest już aplikacja MessengerCTI należy ja odinstalować. 
- Zalogować się w Google Play jako tester aplikacji 
W tym celu należy:
Zalogować się z komputera lub przeglądarki telefonu do swojego konta Google. Jeśli masz więcej niż jedno konto to ważne jest aby zalogować się do tego konta które skonfigurowane jest w telefonie. 
Kliknąć następujący link:
[https://play.google.com/apps/testing/com.slican.messengercti rejestracja do wersji beta] 
Na stronie zobaczysz następującą informację: 
[[Plik:google_beta.jpg]] 
Kliknij opcję "ZOSTAŃ TESTEREM" 
Wracamy do konfiguracji telefonu: 
- Ponieważ aktualizacje w Google Play pojawiają się z pewnym opóźnieniem przed zainstalowaniem MessengerCTI dobrze jest wyłączyć aplikacje Sklep Play. 
- Klikając w jego skrót nastąpi ponowne uruchomienie Sklep Play. Wyszukujemy aplikację MessengerCTI. Ze względu na ilość dostępnych tego typu aplikacji warto szukać nazwy Slican. 
- Instalujemy aplikację 
- Konfigurujemy zgodnie z instrukcją opisaną powyżej 
Cieszymy się z nowych funkcji dostępnych tylko dla nielicznych.

Instrukcja obsługi MessengerCTI.Mobile

2019-04-08T08:16:46Z

Marekg: /* Konfiguracja centrali NCP */

<center>[[Plik:messenger_2.png|250px]]</center>
= Wstęp =
Aplikacja Slican '''''MessengerCTI.Mobile''''' jest aplikacją mobilną przeznaczona na system '''Android''', który łączy w sobie możliwość wykonywania połączeń przychodzących jak i wychodzących, dostęp do książki telefonicznej, historii, podglądu statusu innych abonentów oraz chatu. 
Zawiera funkcjonalności umożliwiające integrację telefonu biurkowego i smartphone'a używanego przez abonenta centrali. 

Dużą zaletą tej aplikacji jest integracja książek kontaktów telefonicznych zapisanych w centrali. W '''''MessengerCTI.Mobile''''' wykorzystywane są zawsze książki zgromadzone w centrali, przy czym modyfikacja ich wpisów może być dokonywana tylko z telefonu systemowego jak i komputera przy użyciu programu '''''MessengerCTI.Desktop''''' lub aplikacji '''''WebCTI'''''. Ponadto program Slican '''''MessengerCTI.Mobile''''' posiada funkcjonalność komunikatora wewnętrznego - chatu. Użytkownikami komunikatora mogą być wszyscy abonenci danej centrali przy założeniu posiadania odpowiedniej licencji funkcjonalnej.
 
==Zalety aplikacji==
* aplikacja dostępna (bezpłatnie) w sklepie Google Play - wymagana jedynie po stronie centrali licencja CTI.plus
* książka kontaktów z podglądem stanu dostępności abonenta (czat, zajętości telefonu, opisu)
* dodawanie i usuwanie kontaktów z grupy ulubione, z pełną synchronizacją z aplikacją MessengerCTI.Desktop
* historia ostatnich połączeń/czatów posortowana chronologicznie
* logowanie jako telefonu równoległego do telefonu biurkowego lub jako osobny abonent MessengerCTI (tylko centrala NCP)
* komunikator czat
* historia czata połączona z historią połączeń telefonicznych
* połączenia głosowe przez GSM (dwie opcje zestawiania połączenia: przechwytywanie lub połączenie równoległe)
* elastyczne konfigurowanie powiadomień dźwiękowych
* dostęp do konfigurowania usług centrali na swoim telefonie
* numery podręczne do szybkiego przekazywania połączeń
* możliwość ustawiania zajętości telefonu biurkowego jeśli GSM zajęty (domyślnie włączone)
* możliwość ustawienia odrzucania wywołań na GSM jeśli telefon biurkowy zajęty
* możliwość kopiowania tekstu z chata
* możliwość obsługi smartphone'ów DualSIM lub dwóch telefonów jednocześnie (służbowy i prywatny)
* wygodne otwieranie drzwi jeśli dzwoni do nas bramofon DPH.IP oraz z menu kontekstowego dla kontaktu
* dodatkowy widget na pulpicie do szybkiego otwierania bramofonów DPH.IP
* automatyczny mechanizm opóźnienia powiadomienia na MessengerCTI.Mobile jeśli jestem aktywny na telefonie biurkowym lub MessengerCTI.Desktop
* możliwość kopiowania kontaktu z książki centrali telefonicznej do lokalnej książki telefonu

{{Uwaga|
Dla poprawnego działania aplikacji i połączeń wymagane są:
* stały dostęp do Internetu zarówno MessengerCTI.Mobile jak i centrali
* adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowany port 5529 TCP na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej
* w przypadku połączeń VoIP z aplikacji (wersja BETA) - adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowane porty 5060 UDP (sygnalizacja), 10000 - 20000 UDP (ramki głosowe RTP dla centrali NCP), 8100 - 8300 UDP (ramki głosowe RTP dla central IPx, MAC, CCT) na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej}}

= Wymagania minimalne =
Aplikacja '''''MessengerCTI.Mobile''''' - jest ogólnie dostępna do pobrania w sklepie Google Play.
W celu zainstalowania aplikacji spełnione muszą zostać następujące wymagania minimalne:
* system operacyjny Android - Android wersja systemu KitKat (4.4.4)
* dostęp do internetu dla aplikacji jak i centrali
Telefon z niższą wersją systemu Android nie będzie miał możliwości instalacji aplikacji.

{{Uwaga|
Aplikacja '''''MessengerCTI.Mobile''''' współpracuje z centralami IPx, MAC i CCT wyposażonymi w firmware co najmniej w wersji '''6.53''', oraz NCP '''1.11''' 
Obsługę VoIP w aplikacji w centralach IPx, MAC i CCT wprowadzono w wersji '''6.54''' oraz NCP '''1.12'''}} 

=Instalacja aplikacji =
Korzystanie z aplikacji '''''MessengerCTI.Mobile''''' jest licencjonowane więc wymaga wykupienia odpowiedniej licencji. Zakupiony kod jest wprowadzany w trakcie konfiguracji centrali i decyduje o ilości stanowisk, które mogą używać programu. Licencjonowanie aplikacji nie ma wpływu na jej instalację. Po zainstalowaniu aplikacji należy ją odpowiednio skonfigurować wprowadzając niezbędne dane do połączenia aplikacji z centralą: '''''Ustawienia->Konto''''' (opisane poniżej).

{{Uwaga|
Jeżeli numer wewnętrzny wprowadzony w ustawieniach nie posiada uprawnień do korzystania z aplikacji '''''MessengerCTI.Mobile''''' lub nie jest odpowiednio skonfigurowane konto CTI w centrali dla aplikacji mobilnej - nie będzie możliwości połączenia z centralą i synchronizacja danych.}}

== Uruchomienie aplikacji ==
Program '''''MessengerCTI.Mobile''''' uruchamia się identycznie jak każdy inny program w systemie operacyjnym Android. W trakcie uruchomienia następuje zalogowanie się programu do centrali (zgodnie z ustawieniami zakładce '''''Ustawienia->Konto'''''). Po pomyślnym zalogowaniu następuje synchronizacja danych programu z danymi w centrali (historii połączeń oraz czat).

== Konfiguracja aplikacji ==
Dla poprawnej komunikacji aplikacji z centralą należy skonfigurować dane konta CTI oraz pozostałe funkcje. Menu konfiguracji znajduje się w prawym górnym rogu okna aplikacji. Z rozwijanego menu wybieramy menu '''Ustawienia'''. 

==Ustawienia==

===Konto===
Zakładkę wypełniamy danymi do zalogowania aplikacji skonfigurowanymi przez administratora centrali:
* Twój numer telefonu: numer wewnętrzny telefonu użytkownika z odpowiednimi uprawnieniami dla komunikacji CTI
* Hasło: hasło użytkownika CTI
* Serwer: adres domenowy lub publiczny IP centrali dla użytkowników spoza sieci wewnętrznej lub prywatny dla użytkowników sieci lokalnej
* Zaawansowane/Port protokołu sygnalizacyjnego: port komunikacji z centralą - domyślnie dla centrali TCP 5529

===Powiadomienia===
Konfiguracja powiadomień połączeń przychodzących:
* dźwięk dzwonka: wybór jednego z listy dostępnych w aplikacji z możliwością wyciszenia go po określonym czasie
* wibracje przy dzwonku
* powiadomienie na pasku o nieodebranym połączeniu i wiadomości czat
Konfiguracja powiadomień wiadomości czat:
* dźwięk wiadomości: wybór jednego z listy dostępnych w aplikacji
* wibracje przy wiadomości
* powiadomienie na pasku o nowej wiadomości czat

===Numery podręczne===
Lista najważniejszych numerów podręcznych użytkownika wyświetlana podczas rozmowy w celu prostego przekazania połączenia.

===Inne===
Rozwiązywanie problemów z poprawnym działaniem aplikacji:
* debug - opcja dla administratora włączana na prośbę dostawcy oprogramowania w przypadku analizy problemów
Włączenie opcji '''debug''' powoduje iż w Menu głównym ujawnia się dodatkowe pole '''''Wyślij log'''''. Dalej wybieramy klienta pocztowego, z którego wyślemy logi aplikacji do analizy po stronie producenta.

== Usługi ==
Konfiguracja usług związanych z połączeniami:
* Wycisz aplikację: tryb dyskretny pracy aplikacji - bez powiadomień
* Opóźnienie powiadomień - w stosunku do telefonu biurkowego
* Harmonogram powiadomień - możliwość ustawienia tygodniowego planu aktywnego użytkowania aplikacji (włączania rozdzwaniania i powiadamiania w określonych godzinach)
* Domyślny typ połączenia - ustawienia sposobu realizacji połączeń za pomocą sieci GSM, VoIP lub VoIP przez WiFi.
* Usługi globalne dla centrali: DND - nie przeszkadzać, przekierowanie połączeń: wszystkie, gdy zajęty lub gdy nie odpowiada, zachowanie telefonu biurkowego i MCTI w przypadku zajętości jednego z nich

== Mój opis ==
Ustawienie własnego komentarza, który będzie widoczny dla pozostałych użytkowników aplikacji MessengerCTI oraz na ekranie telefonu systemowego CTS-330

== O programie ==
Informacje o:
* numerze własnym: numer wewnętrzny centrali na jaki zalogowana jest aplikacja
* komentarz abonenta
* bieżącej wersji aplikacji
* typ i numer centrali z jaką jest połączona aplikacja
* wersja oprogramowania centrali

== Aktualizacja aplikacji ==
Aktualizacja programu jest dokonywana automatycznie a użytkownik ma wpływ na jej przebieg zgodnie z ustawieniami aktualizacji automatycznych aplikacji danego telefonu dla posiadaczy kont Google. Jeżeli w sklepie Google Play pojawi się nowa wersja następuje automatyczne pobranie nowszej wersji lub powiadomienie o niej.

= Struktura aplikacji =
==Okno główne ==
W oknie głównym aplikacji widoczne są dwie zakładki:
* '''Ostatnie''' - związane z historią połączeń i przesyłanych wiadomości wraz ze statusem abonenta centrali
* '''Kontakty''' - z dostępem do kontaktów książki telefonicznej centrali, z możliwością ich filtrowania: ulubione, wewnętrzne, zewnętrzne
* ikona statusu zalogowania wraz z opisem
* wyszukiwarka kontaktów
* menu ustawień aplikacji
<center>[[Plik:MessengerCTI_opis_new.png|800px]]</center>

== Ikono-grafika ==
W aplikacji '''''MessengerCTI.Mobile''''' przyjęto zasadę intuicyjnego oznaczania stanu telefonu za pomocą ikon widocznych w aplikacji przy każdym z kontaktów lub wpisie historii połączeń. Ikony te umożliwiają wykonywanie wybranej akcji, ocenienie stanu połączenia lub powiadamiają o występowaniu błędów.
=== Ikony i symbole ===
Okno startowe "Ostatnie" aplikacji pokazuje historię ostatnich połączeń. W tym widoku znajdują się ikony:
* po lewej stronie: status aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile lub historia połączeń
* po prawej: informujące o kierunku połączenia i statusie wiadomości czat 

W Tabeli 1 przedstawiono opis znaczenia poszczególnych ikon informujących o statusie aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile:
* dla abonentów wewnętrznych centrali - ikony symbolizujące stan zalogowania aplikacji a, dotknięcie ikony statusu pozwala rozpocząć czat lub sprawdzić historię połączeń
* dla bramofonów DPH.IP - aktualne położenie drzwi, a przez dotknięcie ikony symbolizującej drzwi wejście do historii
* dla kontaktów spoza centrali - sprawdzenie historii połączeń
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTID_free.png|40px]] ||użytkownik zalogowany
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_zaraz_wracam1.png|37px]] ||status: "Zaraz wracam"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_busy1.png]] ||użytkownik ustawił stan "Nie przeszkadzać"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_no_login.png|40px]] ||użytkownik niezalogowany, niedostępny lub status "Niewidoczny"
|-
|{{align|center}}|[[Plik:MessengerCTIMD_chat_free.png|40px]] || jeden z możliwych statusów aplikacji Desktop z skonfigurowaną aplikacją w wersji Mobile
|-
|{{align|center}}|[[Plik:MessengerCTIM_chat_DND.png|40px]] ||historia połączeń oraz wiadomości
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_open.png|40px]] ||bramofon DPH.IP: drzwi otwarte
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_closed.png|40px]] ||bramofon DPH.IP: drzwi zamknięte
|-
|}
'''''Tabela 1:''''' Ikony symbolizujące stany aplikacji, użytkowników i bramofonów. </center> 

W przypadku telefonów będących numerami wewnętrznymi centrali, pojawia się ikona symbolizująca stan telefonu.
<center>

{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_call.png|40px]] ||numer zajęty
|-
|{{align|center}}|[[Plik:MessengerCTIM_ringing.png|40px]] ||dzwonienie na numer lub wykonywanie połączenia wychodzącego z numeru
|-
|{{align|center}}|[[Plik:MessengerCTIM_failure1.png|40px]] ||numer niedostępny lub uszkodzony
|-
|{{align|center}}|[[Plik:MessengerCTIM_DND.png|40px]] ||włączona usługa DND
|-
|}
'''''Tabela 2:''''' Ikony symbolizujące stan telefonu. </center>

W tabeli 3 przedstawiono opis ikon związanych z połączeniami:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_call.png|40px]] ||połączenie przychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_call.png|40px]] ||połączenie wychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_qty.png|50px]] ||nowe nieodebrane połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer.png|45px]] ||połączenie nieodebrane
|-
|}

'''''Tabela 3:''''' Ikony symbolizujące połączenia. </center>

W tabeli 4 przedstawiono opis ikon związanych ze statusem wiadomości:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_chat.png|40px]] ||wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_chat.png|40px]] ||wiadomość wysłana (przeczytana)
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_chat.png|50px]] ||nowa wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_received_chat.png|45px]] ||wiadomość wysłana nieprzeczytana
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_read_chat_conf.png|40px]] ||wiadomość wysłana przeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_notread_chat_conf.png|40px]] ||wiadomość wysłana nieprzeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_unav_chat_conf.png|40px]] ||wiadomość wysłana do niezalogowanego użytkownika - widok w oknie dialogowym
|-
|}
'''''Tabela 4:''''' Ikony symbolizujące status wiadomości. </center>

W tabeli 5 przedstawiono opis powiadomień związanych z błędami w działaniu aplikacji. Powiadomienia widoczne są pod ikoną statusu
<center>
{|{{prettytable}}
!{{Hl1}}|Powiadomienie !!{{Hl1}}| Znaczenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_internet.png]] ||brak połączenia z internetem: sprawdź połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_auth.png]] || błędny login lub hasło: sprawdź ustawienia konta
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_licen.png]] || brak licencji do użytkowania aplikacji: skontaktuj się administratorem centrali
|-
|}
'''''Tabela 5''''': Znaczenie powiadomień o błędach.
</center>

=Obsługa połączeń i wiadomości=
Do przeprowadzenia rozmowy między użytkownikami, niezbędne jest zapewnienie:
* prawidłowej konfiguracji konta po stronie aplikacji oraz centrali
* połączenia aplikacja-centrala (pełna synchronizacja danych aplikacji z centralą) - ikona aplikacji powinna mieć kolor zielony
* zainstalowany telefon systemowy Slican, VoIP lub analogowy dla central IPx, CCT, MAC, NCP lub skonfigurowany abonent typu MessengerCTI (tylko centrala NCP)

==Wykonywanie połączeń==
Dwa sposoby wykonywania połączeń:
* z zakładki '''Kontakty''' - wybieramy abonenta z odpowiedniej grupy (jeśli taka istnieje), bezpośrednio z grupy Wszystkie kontakty. Połączenie wykonujemy przez dotknięcie paska kontaktu wybierając z rozwijanego menu ikonę [[Plik:MessengerCTIM_outgoing.png|25px]]
* z zakładki '''Kontakty''' - bezpośrednio wpisując numer telefonu w polu '''Szukaj''' za pomocą klawiatury a następnie klikając dolny prawy róg klawiatury
<center>[[Plik:MessengerCTIM_out_ext1.png|700px]]</center>
* z zakładki '''Ostatnie''' - odnajdujemy abonenta, z którym mieliśmy kontakt (dzwonił do nas lub my do niego) a następnie połączenie wykonujemy przez dotknięcie paska kontaktu w środkowej części wybierając z rozwijanego menu odpowiednią akcję
<center>[[Plik:MessengerCTIM_out_number1.png|750px]]</center>
Zestawianie połączenia sygnalizowane jest ekranem połączenia jak dla zwykłych połączeń wykonywanych za pomocą linii GSM. Aplikacja zestawia w pierwszej kolejności połączenie do centrali na dedykowany numer dostępowy dla użytkowników '''MessengerCTI.Mobile''', konfigurowany przez administratora centrali. A następnie centrala tranzytem zestawia połączenie z numerem wybranym przez użytkownika '''MessengerCTI.Mobile'''. Z tego powodu w centrali wymaganym łączem miejskim co najmniej jest linia ISDN BRA.

==Połączenie przychodzące==
Połączenie przychodzące sygnalizowane wizualnie jest za pomocą wyskakującego okienka połączenia oraz akustycznie dzwonkiem skonfigurowanym w ustawieniach powiadomień. Połączenia odbieramy przez przesunięcie ikony z zieloną słuchawką. Jeśli połączenie ma być odrzucone to przesuwamy ikonę z czerwoną słuchawką. Dodatkowo jeśli mamy dodane numery podręczne możemy dane połączenie przychodzące przekazać na numer z listy przez przesunięcie ikony z numerem kontaktu podręcznego.
Proces odbierania połączeń przychodzących polega na wykonaniu połączenia zwrotnego do centrali za pomocą linii GSM na numer dostępowy aplikacji zdefiniowany przez administratora centrali.
<center>[[Plik:MessengerCTIM_incoming2.png|700px]]</center>

Nieodebrane połączenie symbolizowane jest ikoną [[Plik:MessengerCTIM_no_answer_qty.png|50px]]. Przejście do historii połączenia lub oddzwonienie powoduje wyczyszczenie informacji o ilości połączeń nieodebranych.

==Obsługa wiadomości==
Aplikacja umożliwia wysyłanie i przyjmowanie wiadomości tekstowych pomiędzy użytkownikami aplikacji MessengerCTI.Desktop/Mobile (czat wewnętrzny). Aby wysłać wiadomość czat klikamy w ikonę statusu aplikacji użytkownika lub z rozwijanego menu po kliknięciu w pasek z kontaktem wybieramy opcję '''chat'''. Otrzymanie nowej wiadomości sygnalizowane jest na pasku powiadomień odpowiednią ikoną oraz zdefiniowanym sygnałem dźwiękowym. 
Jeśli użytkownik używa obu wersji MessengeraCTI, historia wiadomości przechowywana jest także lokalnie w aplikacji '''''MessengerCTI.Desktop'''''.
 Poniżej przykładowe okno dialogowe wiadomości chat:

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

== Kontakty==
Zakładka kontakty umożliwia wyświetlanie i uruchamianie wybranych akcji związanych z kontaktem. Dostęp do numerów z pozostałych grup można uzyskać rozwijając listę pozostałych kontaktów pogrupowanych jako:
* ulubione
* wszystkie grupy
* wszystkie kontakty
* wewnętrzne
* zewnętrzne
* prywatne
Domyślnie widoczna jest grupa '''Ulubione'''.
<center>[[Plik:MessengerCTIM_contacts1.png|300px]]</center>

== Historia połączeń ==
Domyślnie wybrana zakładka '''Ostatnie''' w oknie głównym programu wyświetla historię połączeń jak i wiadomości czat. 
W historii każda pozycja oznacza co najmniej jedno połączenie lub wiadomość. Jeśli połączenie lub wiadomość pochodzi od tego samego użytkownika i jest ich więcej niż jedno, to przy odpowiedniej ikonie wyświetlana jest stosowna liczba. W każdej pozycji widoczny jest numer dzwoniącego, komentarz(jeśli jest on w książce numerów spoza centrali), czas i data realizacji połączenia. 
Jeśli w historii znajdują się nie przejrzane nieodebrane połączenia lub nieprzeczytane wiadomości to zakładka '''Ostatnie''' jest oznaczona czerwoną kropką. 
Z zakładki historii możliwe jest oddzwanianie lub wysyłanie wiadomości zwrotnych.

=Konfiguracja centrali Slican=
Do poprawnej współpracy aplikacji z centralą jest wymagane:
* odpowiednia licencja producenta
* specyficzna konfiguracja centrali
==Konfiguracja central IPx, CCT==
Za pomocą programu ConfgMAN:
# w arkuszu '''''Globalne ustawienia/Pozostałe'''''
## pole '''ANo''' - skonfigurować numer dostępowy, który będzie wybierać telefon GSM z zainstalowaną aplikacją aby dodzwonić się do centrali lub centrala do telefonu celem zestawienia połączenia (w konfiguracji z obsługą połączeń przez sieć GSM)
## pole '''Adr''' - publiczna nazwa hosta lub adres IP centrali dla pracy aplikacji (w konfiguracji z obsługą połączeń przez VoIP)
# w edycji Abonenta - menu '''''Abonenci/Ustawienia CTI:
## '''AwdMbl''': zezwolenie na obsługę aplikacji przez abonenta
## '''AwdGSM''': zezwolenie na obsługę połączeń telefonicznych przez sieć GSM
## '''IncC''': ustawienie sposobu obsługi połączeń przychodzących przez aplikację:
### przechwytywanie wywołań - odebranie połączenia przychodzącego za pomocą aplikacji polega na zestawieniu przez telefon GSM połączenia wychodzącego na numer podany w polu '''ANo''' arkusza '''''Globalne ustawienia/Pozostałe'''''
### dzwonienie równoległe - połączenie przychodzące na telefon GSM z numeru podanego w polu '''ANo''' arkusza '''''Globalne ustawienia/Pozostałe'''''
## '''MnNo''': numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja
## '''SecNo''': drugi numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja (opcjonalny, dla telefonu z dual SIM)

Do pracy aplikacji w odpowiednim trybie wymagane jest uzupełnienie następujących pól:
* przez sieć VoIP: 1.2, 2.1
* przez sieć GSM: 1.1, 2.1, 2.2, 2.2.1, 2.2.2, 2.3 oraz 2.3.1 lub 2.3.2

'''Minimalna wymagana wersja oprogramowania centrali - 6.53, do pracy w trybie VoIP - 6.54'''

==Konfiguracja centrali NCP==

Z poziomu aplikacji ConfigWEB
# w arkuszu '''''Numery wewnętrzne/ Ustawienia/ Konfiguracja aplikacji CTI/ MessengerCTI'''''" skonfigurować:
## Publiczna nazwa hosta lub adres IP centrali dla protokołu XML Slican - nazwa domenowa lub adres IP do wymiany/synchronizacji informacji pomiędzy centralą i aplikacją
## Publiczna nazwa hosta lub adres IP centrali dla połączeń VoIP - nazwa domenowa lub adres IP dla konfiguracji z obsługą połączeń przez VoIP
## Numer telefonu do centrali dla połączeń GSM - który będzie wybierać telefon GSM z zainstalowaną aplikacją aby dodzwonić się do centrali lub centrala do telefonu celem zestawienia połączenia (w konfiguracji z obsługą połączeń przez sieć GSM)
# w konfiguracji abonenta SIP, FXS, CTS, MCTI w arkuszu '''''Numery wewnętrzne/ Abonenci/ CTI ustawienia/ MessengerCTI.Mobile'''''
## włączyć dostęp do aplikacji
## w przypadku pracy przez sieć GSM włączyć zezwolenie na obsługę połączeń telefonicznych przez tą sieć
### wprowadzić numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja
### wprowadzić drugi numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja (opcjonalny, dla telefonu z dual SIM)
## ustawić sposób obsługi połączeń przychodzących
### przechwytywanie wywołań - odebranie połączenia przychodzącego za pomocą aplikacji polega na zestawieniu przez telefon GSM połączenia wychodzącego na numer podany w polu '''Numer telefonu do centrali dla połączeń GSM''' arkusza '''''Numery wewnętrzne/ Ustawienia/ Konfiguracja aplikacji CTI/ MessengerCTI'''''
### dzwonienie równoległe - połączenie przychodzące na telefon GSM z numeru podanego w polu '''Numer telefonu do centrali dla połączeń GSM''' arkusza '''''Numery wewnętrzne/ Ustawienia/ Konfiguracja aplikacji CTI/ MessengerCTI'''''

Do pracy aplikacji w odpowiednim trybie wymagane jest uzupełnienie następujących pól:
* przez sieć VoIP: 1.1, 1.2, 2.1
* przez sieć GSM: 1.1, 1.3, 2.1, 2.2, 2.2.1, 2.2.2, 2.3 oraz 2.3.1 lub 2.3.2

'''Minimalna wymagana wersja oprogramowania - 1.11, do pracy w trybie VoIP - 1.12'''

=Przykłady zastosowań=
Aplikacja '''''MessengerCTI.Mobile''''' może być atrakcyjnym narzędziem dla tych firm, które posiadają pracowników mobilnych z wymogiem ciągłego dostępu telefonicznego jako numer wewnętrzny danego systemu telefonicznego. 
Dobry przykładem mogą pracownicy:
* działu handlowego - z pracą w trybie mieszanym biuro <-> poza biurem
* działu serwisowego - z pracą ciągłą w terenie
* pracownicy zdalni - telepraca
* pracownicy mobilni - praca na dużym terenie (hale produkcyjne, obszary rozległe) - gdzie zasięg sieci typu WiFi lub DECT nie obejmuje takich obszarów.

Instrukcja obsługi MessengerCTI.Mobile

2019-04-08T08:16:04Z

Marekg: /* Konfiguracja central IPx, CCT */

<center>[[Plik:messenger_2.png|250px]]</center>
= Wstęp =
Aplikacja Slican '''''MessengerCTI.Mobile''''' jest aplikacją mobilną przeznaczona na system '''Android''', który łączy w sobie możliwość wykonywania połączeń przychodzących jak i wychodzących, dostęp do książki telefonicznej, historii, podglądu statusu innych abonentów oraz chatu. 
Zawiera funkcjonalności umożliwiające integrację telefonu biurkowego i smartphone'a używanego przez abonenta centrali. 

Dużą zaletą tej aplikacji jest integracja książek kontaktów telefonicznych zapisanych w centrali. W '''''MessengerCTI.Mobile''''' wykorzystywane są zawsze książki zgromadzone w centrali, przy czym modyfikacja ich wpisów może być dokonywana tylko z telefonu systemowego jak i komputera przy użyciu programu '''''MessengerCTI.Desktop''''' lub aplikacji '''''WebCTI'''''. Ponadto program Slican '''''MessengerCTI.Mobile''''' posiada funkcjonalność komunikatora wewnętrznego - chatu. Użytkownikami komunikatora mogą być wszyscy abonenci danej centrali przy założeniu posiadania odpowiedniej licencji funkcjonalnej.
 
==Zalety aplikacji==
* aplikacja dostępna (bezpłatnie) w sklepie Google Play - wymagana jedynie po stronie centrali licencja CTI.plus
* książka kontaktów z podglądem stanu dostępności abonenta (czat, zajętości telefonu, opisu)
* dodawanie i usuwanie kontaktów z grupy ulubione, z pełną synchronizacją z aplikacją MessengerCTI.Desktop
* historia ostatnich połączeń/czatów posortowana chronologicznie
* logowanie jako telefonu równoległego do telefonu biurkowego lub jako osobny abonent MessengerCTI (tylko centrala NCP)
* komunikator czat
* historia czata połączona z historią połączeń telefonicznych
* połączenia głosowe przez GSM (dwie opcje zestawiania połączenia: przechwytywanie lub połączenie równoległe)
* elastyczne konfigurowanie powiadomień dźwiękowych
* dostęp do konfigurowania usług centrali na swoim telefonie
* numery podręczne do szybkiego przekazywania połączeń
* możliwość ustawiania zajętości telefonu biurkowego jeśli GSM zajęty (domyślnie włączone)
* możliwość ustawienia odrzucania wywołań na GSM jeśli telefon biurkowy zajęty
* możliwość kopiowania tekstu z chata
* możliwość obsługi smartphone'ów DualSIM lub dwóch telefonów jednocześnie (służbowy i prywatny)
* wygodne otwieranie drzwi jeśli dzwoni do nas bramofon DPH.IP oraz z menu kontekstowego dla kontaktu
* dodatkowy widget na pulpicie do szybkiego otwierania bramofonów DPH.IP
* automatyczny mechanizm opóźnienia powiadomienia na MessengerCTI.Mobile jeśli jestem aktywny na telefonie biurkowym lub MessengerCTI.Desktop
* możliwość kopiowania kontaktu z książki centrali telefonicznej do lokalnej książki telefonu

{{Uwaga|
Dla poprawnego działania aplikacji i połączeń wymagane są:
* stały dostęp do Internetu zarówno MessengerCTI.Mobile jak i centrali
* adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowany port 5529 TCP na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej
* w przypadku połączeń VoIP z aplikacji (wersja BETA) - adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowane porty 5060 UDP (sygnalizacja), 10000 - 20000 UDP (ramki głosowe RTP dla centrali NCP), 8100 - 8300 UDP (ramki głosowe RTP dla central IPx, MAC, CCT) na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej}}

= Wymagania minimalne =
Aplikacja '''''MessengerCTI.Mobile''''' - jest ogólnie dostępna do pobrania w sklepie Google Play.
W celu zainstalowania aplikacji spełnione muszą zostać następujące wymagania minimalne:
* system operacyjny Android - Android wersja systemu KitKat (4.4.4)
* dostęp do internetu dla aplikacji jak i centrali
Telefon z niższą wersją systemu Android nie będzie miał możliwości instalacji aplikacji.

{{Uwaga|
Aplikacja '''''MessengerCTI.Mobile''''' współpracuje z centralami IPx, MAC i CCT wyposażonymi w firmware co najmniej w wersji '''6.53''', oraz NCP '''1.11''' 
Obsługę VoIP w aplikacji w centralach IPx, MAC i CCT wprowadzono w wersji '''6.54''' oraz NCP '''1.12'''}} 

=Instalacja aplikacji =
Korzystanie z aplikacji '''''MessengerCTI.Mobile''''' jest licencjonowane więc wymaga wykupienia odpowiedniej licencji. Zakupiony kod jest wprowadzany w trakcie konfiguracji centrali i decyduje o ilości stanowisk, które mogą używać programu. Licencjonowanie aplikacji nie ma wpływu na jej instalację. Po zainstalowaniu aplikacji należy ją odpowiednio skonfigurować wprowadzając niezbędne dane do połączenia aplikacji z centralą: '''''Ustawienia->Konto''''' (opisane poniżej).

{{Uwaga|
Jeżeli numer wewnętrzny wprowadzony w ustawieniach nie posiada uprawnień do korzystania z aplikacji '''''MessengerCTI.Mobile''''' lub nie jest odpowiednio skonfigurowane konto CTI w centrali dla aplikacji mobilnej - nie będzie możliwości połączenia z centralą i synchronizacja danych.}}

== Uruchomienie aplikacji ==
Program '''''MessengerCTI.Mobile''''' uruchamia się identycznie jak każdy inny program w systemie operacyjnym Android. W trakcie uruchomienia następuje zalogowanie się programu do centrali (zgodnie z ustawieniami zakładce '''''Ustawienia->Konto'''''). Po pomyślnym zalogowaniu następuje synchronizacja danych programu z danymi w centrali (historii połączeń oraz czat).

== Konfiguracja aplikacji ==
Dla poprawnej komunikacji aplikacji z centralą należy skonfigurować dane konta CTI oraz pozostałe funkcje. Menu konfiguracji znajduje się w prawym górnym rogu okna aplikacji. Z rozwijanego menu wybieramy menu '''Ustawienia'''. 

==Ustawienia==

===Konto===
Zakładkę wypełniamy danymi do zalogowania aplikacji skonfigurowanymi przez administratora centrali:
* Twój numer telefonu: numer wewnętrzny telefonu użytkownika z odpowiednimi uprawnieniami dla komunikacji CTI
* Hasło: hasło użytkownika CTI
* Serwer: adres domenowy lub publiczny IP centrali dla użytkowników spoza sieci wewnętrznej lub prywatny dla użytkowników sieci lokalnej
* Zaawansowane/Port protokołu sygnalizacyjnego: port komunikacji z centralą - domyślnie dla centrali TCP 5529

===Powiadomienia===
Konfiguracja powiadomień połączeń przychodzących:
* dźwięk dzwonka: wybór jednego z listy dostępnych w aplikacji z możliwością wyciszenia go po określonym czasie
* wibracje przy dzwonku
* powiadomienie na pasku o nieodebranym połączeniu i wiadomości czat
Konfiguracja powiadomień wiadomości czat:
* dźwięk wiadomości: wybór jednego z listy dostępnych w aplikacji
* wibracje przy wiadomości
* powiadomienie na pasku o nowej wiadomości czat

===Numery podręczne===
Lista najważniejszych numerów podręcznych użytkownika wyświetlana podczas rozmowy w celu prostego przekazania połączenia.

===Inne===
Rozwiązywanie problemów z poprawnym działaniem aplikacji:
* debug - opcja dla administratora włączana na prośbę dostawcy oprogramowania w przypadku analizy problemów
Włączenie opcji '''debug''' powoduje iż w Menu głównym ujawnia się dodatkowe pole '''''Wyślij log'''''. Dalej wybieramy klienta pocztowego, z którego wyślemy logi aplikacji do analizy po stronie producenta.

== Usługi ==
Konfiguracja usług związanych z połączeniami:
* Wycisz aplikację: tryb dyskretny pracy aplikacji - bez powiadomień
* Opóźnienie powiadomień - w stosunku do telefonu biurkowego
* Harmonogram powiadomień - możliwość ustawienia tygodniowego planu aktywnego użytkowania aplikacji (włączania rozdzwaniania i powiadamiania w określonych godzinach)
* Domyślny typ połączenia - ustawienia sposobu realizacji połączeń za pomocą sieci GSM, VoIP lub VoIP przez WiFi.
* Usługi globalne dla centrali: DND - nie przeszkadzać, przekierowanie połączeń: wszystkie, gdy zajęty lub gdy nie odpowiada, zachowanie telefonu biurkowego i MCTI w przypadku zajętości jednego z nich

== Mój opis ==
Ustawienie własnego komentarza, który będzie widoczny dla pozostałych użytkowników aplikacji MessengerCTI oraz na ekranie telefonu systemowego CTS-330

== O programie ==
Informacje o:
* numerze własnym: numer wewnętrzny centrali na jaki zalogowana jest aplikacja
* komentarz abonenta
* bieżącej wersji aplikacji
* typ i numer centrali z jaką jest połączona aplikacja
* wersja oprogramowania centrali

== Aktualizacja aplikacji ==
Aktualizacja programu jest dokonywana automatycznie a użytkownik ma wpływ na jej przebieg zgodnie z ustawieniami aktualizacji automatycznych aplikacji danego telefonu dla posiadaczy kont Google. Jeżeli w sklepie Google Play pojawi się nowa wersja następuje automatyczne pobranie nowszej wersji lub powiadomienie o niej.

= Struktura aplikacji =
==Okno główne ==
W oknie głównym aplikacji widoczne są dwie zakładki:
* '''Ostatnie''' - związane z historią połączeń i przesyłanych wiadomości wraz ze statusem abonenta centrali
* '''Kontakty''' - z dostępem do kontaktów książki telefonicznej centrali, z możliwością ich filtrowania: ulubione, wewnętrzne, zewnętrzne
* ikona statusu zalogowania wraz z opisem
* wyszukiwarka kontaktów
* menu ustawień aplikacji
<center>[[Plik:MessengerCTI_opis_new.png|800px]]</center>

== Ikono-grafika ==
W aplikacji '''''MessengerCTI.Mobile''''' przyjęto zasadę intuicyjnego oznaczania stanu telefonu za pomocą ikon widocznych w aplikacji przy każdym z kontaktów lub wpisie historii połączeń. Ikony te umożliwiają wykonywanie wybranej akcji, ocenienie stanu połączenia lub powiadamiają o występowaniu błędów.
=== Ikony i symbole ===
Okno startowe "Ostatnie" aplikacji pokazuje historię ostatnich połączeń. W tym widoku znajdują się ikony:
* po lewej stronie: status aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile lub historia połączeń
* po prawej: informujące o kierunku połączenia i statusie wiadomości czat 

W Tabeli 1 przedstawiono opis znaczenia poszczególnych ikon informujących o statusie aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile:
* dla abonentów wewnętrznych centrali - ikony symbolizujące stan zalogowania aplikacji a, dotknięcie ikony statusu pozwala rozpocząć czat lub sprawdzić historię połączeń
* dla bramofonów DPH.IP - aktualne położenie drzwi, a przez dotknięcie ikony symbolizującej drzwi wejście do historii
* dla kontaktów spoza centrali - sprawdzenie historii połączeń
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTID_free.png|40px]] ||użytkownik zalogowany
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_zaraz_wracam1.png|37px]] ||status: "Zaraz wracam"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_busy1.png]] ||użytkownik ustawił stan "Nie przeszkadzać"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_no_login.png|40px]] ||użytkownik niezalogowany, niedostępny lub status "Niewidoczny"
|-
|{{align|center}}|[[Plik:MessengerCTIMD_chat_free.png|40px]] || jeden z możliwych statusów aplikacji Desktop z skonfigurowaną aplikacją w wersji Mobile
|-
|{{align|center}}|[[Plik:MessengerCTIM_chat_DND.png|40px]] ||historia połączeń oraz wiadomości
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_open.png|40px]] ||bramofon DPH.IP: drzwi otwarte
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_closed.png|40px]] ||bramofon DPH.IP: drzwi zamknięte
|-
|}
'''''Tabela 1:''''' Ikony symbolizujące stany aplikacji, użytkowników i bramofonów. </center> 

W przypadku telefonów będących numerami wewnętrznymi centrali, pojawia się ikona symbolizująca stan telefonu.
<center>

{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_call.png|40px]] ||numer zajęty
|-
|{{align|center}}|[[Plik:MessengerCTIM_ringing.png|40px]] ||dzwonienie na numer lub wykonywanie połączenia wychodzącego z numeru
|-
|{{align|center}}|[[Plik:MessengerCTIM_failure1.png|40px]] ||numer niedostępny lub uszkodzony
|-
|{{align|center}}|[[Plik:MessengerCTIM_DND.png|40px]] ||włączona usługa DND
|-
|}
'''''Tabela 2:''''' Ikony symbolizujące stan telefonu. </center>

W tabeli 3 przedstawiono opis ikon związanych z połączeniami:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_call.png|40px]] ||połączenie przychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_call.png|40px]] ||połączenie wychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_qty.png|50px]] ||nowe nieodebrane połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer.png|45px]] ||połączenie nieodebrane
|-
|}

'''''Tabela 3:''''' Ikony symbolizujące połączenia. </center>

W tabeli 4 przedstawiono opis ikon związanych ze statusem wiadomości:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_chat.png|40px]] ||wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_chat.png|40px]] ||wiadomość wysłana (przeczytana)
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_chat.png|50px]] ||nowa wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_received_chat.png|45px]] ||wiadomość wysłana nieprzeczytana
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_read_chat_conf.png|40px]] ||wiadomość wysłana przeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_notread_chat_conf.png|40px]] ||wiadomość wysłana nieprzeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_unav_chat_conf.png|40px]] ||wiadomość wysłana do niezalogowanego użytkownika - widok w oknie dialogowym
|-
|}
'''''Tabela 4:''''' Ikony symbolizujące status wiadomości. </center>

W tabeli 5 przedstawiono opis powiadomień związanych z błędami w działaniu aplikacji. Powiadomienia widoczne są pod ikoną statusu
<center>
{|{{prettytable}}
!{{Hl1}}|Powiadomienie !!{{Hl1}}| Znaczenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_internet.png]] ||brak połączenia z internetem: sprawdź połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_auth.png]] || błędny login lub hasło: sprawdź ustawienia konta
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_licen.png]] || brak licencji do użytkowania aplikacji: skontaktuj się administratorem centrali
|-
|}
'''''Tabela 5''''': Znaczenie powiadomień o błędach.
</center>

=Obsługa połączeń i wiadomości=
Do przeprowadzenia rozmowy między użytkownikami, niezbędne jest zapewnienie:
* prawidłowej konfiguracji konta po stronie aplikacji oraz centrali
* połączenia aplikacja-centrala (pełna synchronizacja danych aplikacji z centralą) - ikona aplikacji powinna mieć kolor zielony
* zainstalowany telefon systemowy Slican, VoIP lub analogowy dla central IPx, CCT, MAC, NCP lub skonfigurowany abonent typu MessengerCTI (tylko centrala NCP)

==Wykonywanie połączeń==
Dwa sposoby wykonywania połączeń:
* z zakładki '''Kontakty''' - wybieramy abonenta z odpowiedniej grupy (jeśli taka istnieje), bezpośrednio z grupy Wszystkie kontakty. Połączenie wykonujemy przez dotknięcie paska kontaktu wybierając z rozwijanego menu ikonę [[Plik:MessengerCTIM_outgoing.png|25px]]
* z zakładki '''Kontakty''' - bezpośrednio wpisując numer telefonu w polu '''Szukaj''' za pomocą klawiatury a następnie klikając dolny prawy róg klawiatury
<center>[[Plik:MessengerCTIM_out_ext1.png|700px]]</center>
* z zakładki '''Ostatnie''' - odnajdujemy abonenta, z którym mieliśmy kontakt (dzwonił do nas lub my do niego) a następnie połączenie wykonujemy przez dotknięcie paska kontaktu w środkowej części wybierając z rozwijanego menu odpowiednią akcję
<center>[[Plik:MessengerCTIM_out_number1.png|750px]]</center>
Zestawianie połączenia sygnalizowane jest ekranem połączenia jak dla zwykłych połączeń wykonywanych za pomocą linii GSM. Aplikacja zestawia w pierwszej kolejności połączenie do centrali na dedykowany numer dostępowy dla użytkowników '''MessengerCTI.Mobile''', konfigurowany przez administratora centrali. A następnie centrala tranzytem zestawia połączenie z numerem wybranym przez użytkownika '''MessengerCTI.Mobile'''. Z tego powodu w centrali wymaganym łączem miejskim co najmniej jest linia ISDN BRA.

==Połączenie przychodzące==
Połączenie przychodzące sygnalizowane wizualnie jest za pomocą wyskakującego okienka połączenia oraz akustycznie dzwonkiem skonfigurowanym w ustawieniach powiadomień. Połączenia odbieramy przez przesunięcie ikony z zieloną słuchawką. Jeśli połączenie ma być odrzucone to przesuwamy ikonę z czerwoną słuchawką. Dodatkowo jeśli mamy dodane numery podręczne możemy dane połączenie przychodzące przekazać na numer z listy przez przesunięcie ikony z numerem kontaktu podręcznego.
Proces odbierania połączeń przychodzących polega na wykonaniu połączenia zwrotnego do centrali za pomocą linii GSM na numer dostępowy aplikacji zdefiniowany przez administratora centrali.
<center>[[Plik:MessengerCTIM_incoming2.png|700px]]</center>

Nieodebrane połączenie symbolizowane jest ikoną [[Plik:MessengerCTIM_no_answer_qty.png|50px]]. Przejście do historii połączenia lub oddzwonienie powoduje wyczyszczenie informacji o ilości połączeń nieodebranych.

==Obsługa wiadomości==
Aplikacja umożliwia wysyłanie i przyjmowanie wiadomości tekstowych pomiędzy użytkownikami aplikacji MessengerCTI.Desktop/Mobile (czat wewnętrzny). Aby wysłać wiadomość czat klikamy w ikonę statusu aplikacji użytkownika lub z rozwijanego menu po kliknięciu w pasek z kontaktem wybieramy opcję '''chat'''. Otrzymanie nowej wiadomości sygnalizowane jest na pasku powiadomień odpowiednią ikoną oraz zdefiniowanym sygnałem dźwiękowym. 
Jeśli użytkownik używa obu wersji MessengeraCTI, historia wiadomości przechowywana jest także lokalnie w aplikacji '''''MessengerCTI.Desktop'''''.
 Poniżej przykładowe okno dialogowe wiadomości chat:

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

== Kontakty==
Zakładka kontakty umożliwia wyświetlanie i uruchamianie wybranych akcji związanych z kontaktem. Dostęp do numerów z pozostałych grup można uzyskać rozwijając listę pozostałych kontaktów pogrupowanych jako:
* ulubione
* wszystkie grupy
* wszystkie kontakty
* wewnętrzne
* zewnętrzne
* prywatne
Domyślnie widoczna jest grupa '''Ulubione'''.
<center>[[Plik:MessengerCTIM_contacts1.png|300px]]</center>

== Historia połączeń ==
Domyślnie wybrana zakładka '''Ostatnie''' w oknie głównym programu wyświetla historię połączeń jak i wiadomości czat. 
W historii każda pozycja oznacza co najmniej jedno połączenie lub wiadomość. Jeśli połączenie lub wiadomość pochodzi od tego samego użytkownika i jest ich więcej niż jedno, to przy odpowiedniej ikonie wyświetlana jest stosowna liczba. W każdej pozycji widoczny jest numer dzwoniącego, komentarz(jeśli jest on w książce numerów spoza centrali), czas i data realizacji połączenia. 
Jeśli w historii znajdują się nie przejrzane nieodebrane połączenia lub nieprzeczytane wiadomości to zakładka '''Ostatnie''' jest oznaczona czerwoną kropką. 
Z zakładki historii możliwe jest oddzwanianie lub wysyłanie wiadomości zwrotnych.

=Konfiguracja centrali Slican=
Do poprawnej współpracy aplikacji z centralą jest wymagane:
* odpowiednia licencja producenta
* specyficzna konfiguracja centrali
==Konfiguracja central IPx, CCT==
Za pomocą programu ConfgMAN:
# w arkuszu '''''Globalne ustawienia/Pozostałe'''''
## pole '''ANo''' - skonfigurować numer dostępowy, który będzie wybierać telefon GSM z zainstalowaną aplikacją aby dodzwonić się do centrali lub centrala do telefonu celem zestawienia połączenia (w konfiguracji z obsługą połączeń przez sieć GSM)
## pole '''Adr''' - publiczna nazwa hosta lub adres IP centrali dla pracy aplikacji (w konfiguracji z obsługą połączeń przez VoIP)
# w edycji Abonenta - menu '''''Abonenci/Ustawienia CTI:
## '''AwdMbl''': zezwolenie na obsługę aplikacji przez abonenta
## '''AwdGSM''': zezwolenie na obsługę połączeń telefonicznych przez sieć GSM
## '''IncC''': ustawienie sposobu obsługi połączeń przychodzących przez aplikację:
### przechwytywanie wywołań - odebranie połączenia przychodzącego za pomocą aplikacji polega na zestawieniu przez telefon GSM połączenia wychodzącego na numer podany w polu '''ANo''' arkusza '''''Globalne ustawienia/Pozostałe'''''
### dzwonienie równoległe - połączenie przychodzące na telefon GSM z numeru podanego w polu '''ANo''' arkusza '''''Globalne ustawienia/Pozostałe'''''
## '''MnNo''': numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja
## '''SecNo''': drugi numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja (opcjonalny, dla telefonu z dual SIM)

Do pracy aplikacji w odpowiednim trybie wymagane jest uzupełnienie następujących pól:
* przez sieć VoIP: 1.2, 2.1
* przez sieć GSM: 1.1, 2.1, 2.2, 2.2.1, 2.2.2, 2.3 oraz 2.3.1 lub 2.3.2

'''Minimalna wymagana wersja oprogramowania centrali - 6.53, do pracy w trybie VoIP - 6.54'''

==Konfiguracja centrali NCP==
Z poziomu aplikacji ConfigWEB
* w menu '''''Numery wewnętrzne->Ustawienia->Konfiguracja aplikacji CTI'''''" skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji abonenta SIP, FXS, CTS, Numer MessengerCTI w menu '''''Numery wewnętrzne->Abonenci->CTI ustawienia'''''
** skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja
** ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji i telefonu wewnętrznego central) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 1.11.'''

=Przykłady zastosowań=
Aplikacja '''''MessengerCTI.Mobile''''' może być atrakcyjnym narzędziem dla tych firm, które posiadają pracowników mobilnych z wymogiem ciągłego dostępu telefonicznego jako numer wewnętrzny danego systemu telefonicznego. 
Dobry przykładem mogą pracownicy:
* działu handlowego - z pracą w trybie mieszanym biuro <-> poza biurem
* działu serwisowego - z pracą ciągłą w terenie
* pracownicy zdalni - telepraca
* pracownicy mobilni - praca na dużym terenie (hale produkcyjne, obszary rozległe) - gdzie zasięg sieci typu WiFi lub DECT nie obejmuje takich obszarów.

Plik:MessengerCTIM outgoing.png

2019-04-08T08:04:09Z

Marekg:

Instrukcja obsługi MessengerCTI.Mobile

2019-04-08T07:56:51Z

Marekg: /* O programie */

<center>[[Plik:messenger_2.png|250px]]</center>
= Wstęp =
Aplikacja Slican '''''MessengerCTI.Mobile''''' jest aplikacją mobilną przeznaczona na system '''Android''', który łączy w sobie możliwość wykonywania połączeń przychodzących jak i wychodzących, dostęp do książki telefonicznej, historii, podglądu statusu innych abonentów oraz chatu. 
Zawiera funkcjonalności umożliwiające integrację telefonu biurkowego i smartphone'a używanego przez abonenta centrali. 

Dużą zaletą tej aplikacji jest integracja książek kontaktów telefonicznych zapisanych w centrali. W '''''MessengerCTI.Mobile''''' wykorzystywane są zawsze książki zgromadzone w centrali, przy czym modyfikacja ich wpisów może być dokonywana tylko z telefonu systemowego jak i komputera przy użyciu programu '''''MessengerCTI.Desktop''''' lub aplikacji '''''WebCTI'''''. Ponadto program Slican '''''MessengerCTI.Mobile''''' posiada funkcjonalność komunikatora wewnętrznego - chatu. Użytkownikami komunikatora mogą być wszyscy abonenci danej centrali przy założeniu posiadania odpowiedniej licencji funkcjonalnej.
 
==Zalety aplikacji==
* aplikacja dostępna (bezpłatnie) w sklepie Google Play - wymagana jedynie po stronie centrali licencja CTI.plus
* książka kontaktów z podglądem stanu dostępności abonenta (czat, zajętości telefonu, opisu)
* dodawanie i usuwanie kontaktów z grupy ulubione, z pełną synchronizacją z aplikacją MessengerCTI.Desktop
* historia ostatnich połączeń/czatów posortowana chronologicznie
* logowanie jako telefonu równoległego do telefonu biurkowego lub jako osobny abonent MessengerCTI (tylko centrala NCP)
* komunikator czat
* historia czata połączona z historią połączeń telefonicznych
* połączenia głosowe przez GSM (dwie opcje zestawiania połączenia: przechwytywanie lub połączenie równoległe)
* elastyczne konfigurowanie powiadomień dźwiękowych
* dostęp do konfigurowania usług centrali na swoim telefonie
* numery podręczne do szybkiego przekazywania połączeń
* możliwość ustawiania zajętości telefonu biurkowego jeśli GSM zajęty (domyślnie włączone)
* możliwość ustawienia odrzucania wywołań na GSM jeśli telefon biurkowy zajęty
* możliwość kopiowania tekstu z chata
* możliwość obsługi smartphone'ów DualSIM lub dwóch telefonów jednocześnie (służbowy i prywatny)
* wygodne otwieranie drzwi jeśli dzwoni do nas bramofon DPH.IP oraz z menu kontekstowego dla kontaktu
* dodatkowy widget na pulpicie do szybkiego otwierania bramofonów DPH.IP
* automatyczny mechanizm opóźnienia powiadomienia na MessengerCTI.Mobile jeśli jestem aktywny na telefonie biurkowym lub MessengerCTI.Desktop
* możliwość kopiowania kontaktu z książki centrali telefonicznej do lokalnej książki telefonu

{{Uwaga|
Dla poprawnego działania aplikacji i połączeń wymagane są:
* stały dostęp do Internetu zarówno MessengerCTI.Mobile jak i centrali
* adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowany port 5529 TCP na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej
* w przypadku połączeń VoIP z aplikacji (wersja BETA) - adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowane porty 5060 UDP (sygnalizacja), 10000 - 20000 UDP (ramki głosowe RTP dla centrali NCP), 8100 - 8300 UDP (ramki głosowe RTP dla central IPx, MAC, CCT) na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej}}

= Wymagania minimalne =
Aplikacja '''''MessengerCTI.Mobile''''' - jest ogólnie dostępna do pobrania w sklepie Google Play.
W celu zainstalowania aplikacji spełnione muszą zostać następujące wymagania minimalne:
* system operacyjny Android - Android wersja systemu KitKat (4.4.4)
* dostęp do internetu dla aplikacji jak i centrali
Telefon z niższą wersją systemu Android nie będzie miał możliwości instalacji aplikacji.

{{Uwaga|
Aplikacja '''''MessengerCTI.Mobile''''' współpracuje z centralami IPx, MAC i CCT wyposażonymi w firmware co najmniej w wersji '''6.53''', oraz NCP '''1.11''' 
Obsługę VoIP w aplikacji w centralach IPx, MAC i CCT wprowadzono w wersji '''6.54''' oraz NCP '''1.12'''}} 

=Instalacja aplikacji =
Korzystanie z aplikacji '''''MessengerCTI.Mobile''''' jest licencjonowane więc wymaga wykupienia odpowiedniej licencji. Zakupiony kod jest wprowadzany w trakcie konfiguracji centrali i decyduje o ilości stanowisk, które mogą używać programu. Licencjonowanie aplikacji nie ma wpływu na jej instalację. Po zainstalowaniu aplikacji należy ją odpowiednio skonfigurować wprowadzając niezbędne dane do połączenia aplikacji z centralą: '''''Ustawienia->Konto''''' (opisane poniżej).

{{Uwaga|
Jeżeli numer wewnętrzny wprowadzony w ustawieniach nie posiada uprawnień do korzystania z aplikacji '''''MessengerCTI.Mobile''''' lub nie jest odpowiednio skonfigurowane konto CTI w centrali dla aplikacji mobilnej - nie będzie możliwości połączenia z centralą i synchronizacja danych.}}

== Uruchomienie aplikacji ==
Program '''''MessengerCTI.Mobile''''' uruchamia się identycznie jak każdy inny program w systemie operacyjnym Android. W trakcie uruchomienia następuje zalogowanie się programu do centrali (zgodnie z ustawieniami zakładce '''''Ustawienia->Konto'''''). Po pomyślnym zalogowaniu następuje synchronizacja danych programu z danymi w centrali (historii połączeń oraz czat).

== Konfiguracja aplikacji ==
Dla poprawnej komunikacji aplikacji z centralą należy skonfigurować dane konta CTI oraz pozostałe funkcje. Menu konfiguracji znajduje się w prawym górnym rogu okna aplikacji. Z rozwijanego menu wybieramy menu '''Ustawienia'''. 

==Ustawienia==

===Konto===
Zakładkę wypełniamy danymi do zalogowania aplikacji skonfigurowanymi przez administratora centrali:
* Twój numer telefonu: numer wewnętrzny telefonu użytkownika z odpowiednimi uprawnieniami dla komunikacji CTI
* Hasło: hasło użytkownika CTI
* Serwer: adres domenowy lub publiczny IP centrali dla użytkowników spoza sieci wewnętrznej lub prywatny dla użytkowników sieci lokalnej
* Zaawansowane/Port protokołu sygnalizacyjnego: port komunikacji z centralą - domyślnie dla centrali TCP 5529

===Powiadomienia===
Konfiguracja powiadomień połączeń przychodzących:
* dźwięk dzwonka: wybór jednego z listy dostępnych w aplikacji z możliwością wyciszenia go po określonym czasie
* wibracje przy dzwonku
* powiadomienie na pasku o nieodebranym połączeniu i wiadomości czat
Konfiguracja powiadomień wiadomości czat:
* dźwięk wiadomości: wybór jednego z listy dostępnych w aplikacji
* wibracje przy wiadomości
* powiadomienie na pasku o nowej wiadomości czat

===Numery podręczne===
Lista najważniejszych numerów podręcznych użytkownika wyświetlana podczas rozmowy w celu prostego przekazania połączenia.

===Inne===
Rozwiązywanie problemów z poprawnym działaniem aplikacji:
* debug - opcja dla administratora włączana na prośbę dostawcy oprogramowania w przypadku analizy problemów
Włączenie opcji '''debug''' powoduje iż w Menu głównym ujawnia się dodatkowe pole '''''Wyślij log'''''. Dalej wybieramy klienta pocztowego, z którego wyślemy logi aplikacji do analizy po stronie producenta.

== Usługi ==
Konfiguracja usług związanych z połączeniami:
* Wycisz aplikację: tryb dyskretny pracy aplikacji - bez powiadomień
* Opóźnienie powiadomień - w stosunku do telefonu biurkowego
* Harmonogram powiadomień - możliwość ustawienia tygodniowego planu aktywnego użytkowania aplikacji (włączania rozdzwaniania i powiadamiania w określonych godzinach)
* Domyślny typ połączenia - ustawienia sposobu realizacji połączeń za pomocą sieci GSM, VoIP lub VoIP przez WiFi.
* Usługi globalne dla centrali: DND - nie przeszkadzać, przekierowanie połączeń: wszystkie, gdy zajęty lub gdy nie odpowiada, zachowanie telefonu biurkowego i MCTI w przypadku zajętości jednego z nich

== Mój opis ==
Ustawienie własnego komentarza, który będzie widoczny dla pozostałych użytkowników aplikacji MessengerCTI oraz na ekranie telefonu systemowego CTS-330

== O programie ==
Informacje o:
* numerze własnym: numer wewnętrzny centrali na jaki zalogowana jest aplikacja
* komentarz abonenta
* bieżącej wersji aplikacji
* typ i numer centrali z jaką jest połączona aplikacja
* wersja oprogramowania centrali

== Aktualizacja aplikacji ==
Aktualizacja programu jest dokonywana automatycznie a użytkownik ma wpływ na jej przebieg zgodnie z ustawieniami aktualizacji automatycznych aplikacji danego telefonu dla posiadaczy kont Google. Jeżeli w sklepie Google Play pojawi się nowa wersja następuje automatyczne pobranie nowszej wersji lub powiadomienie o niej.

= Struktura aplikacji =
==Okno główne ==
W oknie głównym aplikacji widoczne są dwie zakładki:
* '''Ostatnie''' - związane z historią połączeń i przesyłanych wiadomości wraz ze statusem abonenta centrali
* '''Kontakty''' - z dostępem do kontaktów książki telefonicznej centrali, z możliwością ich filtrowania: ulubione, wewnętrzne, zewnętrzne
* ikona statusu zalogowania wraz z opisem
* wyszukiwarka kontaktów
* menu ustawień aplikacji
<center>[[Plik:MessengerCTI_opis_new.png|800px]]</center>

== Ikono-grafika ==
W aplikacji '''''MessengerCTI.Mobile''''' przyjęto zasadę intuicyjnego oznaczania stanu telefonu za pomocą ikon widocznych w aplikacji przy każdym z kontaktów lub wpisie historii połączeń. Ikony te umożliwiają wykonywanie wybranej akcji, ocenienie stanu połączenia lub powiadamiają o występowaniu błędów.
=== Ikony i symbole ===
Okno startowe "Ostatnie" aplikacji pokazuje historię ostatnich połączeń. W tym widoku znajdują się ikony:
* po lewej stronie: status aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile lub historia połączeń
* po prawej: informujące o kierunku połączenia i statusie wiadomości czat 

W Tabeli 1 przedstawiono opis znaczenia poszczególnych ikon informujących o statusie aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile:
* dla abonentów wewnętrznych centrali - ikony symbolizujące stan zalogowania aplikacji a, dotknięcie ikony statusu pozwala rozpocząć czat lub sprawdzić historię połączeń
* dla bramofonów DPH.IP - aktualne położenie drzwi, a przez dotknięcie ikony symbolizującej drzwi wejście do historii
* dla kontaktów spoza centrali - sprawdzenie historii połączeń
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTID_free.png|40px]] ||użytkownik zalogowany
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_zaraz_wracam1.png|37px]] ||status: "Zaraz wracam"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_busy1.png]] ||użytkownik ustawił stan "Nie przeszkadzać"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_no_login.png|40px]] ||użytkownik niezalogowany, niedostępny lub status "Niewidoczny"
|-
|{{align|center}}|[[Plik:MessengerCTIMD_chat_free.png|40px]] || jeden z możliwych statusów aplikacji Desktop z skonfigurowaną aplikacją w wersji Mobile
|-
|{{align|center}}|[[Plik:MessengerCTIM_chat_DND.png|40px]] ||historia połączeń oraz wiadomości
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_open.png|40px]] ||bramofon DPH.IP: drzwi otwarte
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_closed.png|40px]] ||bramofon DPH.IP: drzwi zamknięte
|-
|}
'''''Tabela 1:''''' Ikony symbolizujące stany aplikacji, użytkowników i bramofonów. </center> 

W przypadku telefonów będących numerami wewnętrznymi centrali, pojawia się ikona symbolizująca stan telefonu.
<center>

{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_call.png|40px]] ||numer zajęty
|-
|{{align|center}}|[[Plik:MessengerCTIM_ringing.png|40px]] ||dzwonienie na numer lub wykonywanie połączenia wychodzącego z numeru
|-
|{{align|center}}|[[Plik:MessengerCTIM_failure1.png|40px]] ||numer niedostępny lub uszkodzony
|-
|{{align|center}}|[[Plik:MessengerCTIM_DND.png|40px]] ||włączona usługa DND
|-
|}
'''''Tabela 2:''''' Ikony symbolizujące stan telefonu. </center>

W tabeli 3 przedstawiono opis ikon związanych z połączeniami:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_call.png|40px]] ||połączenie przychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_call.png|40px]] ||połączenie wychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_qty.png|50px]] ||nowe nieodebrane połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer.png|45px]] ||połączenie nieodebrane
|-
|}

'''''Tabela 3:''''' Ikony symbolizujące połączenia. </center>

W tabeli 4 przedstawiono opis ikon związanych ze statusem wiadomości:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_chat.png|40px]] ||wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_chat.png|40px]] ||wiadomość wysłana (przeczytana)
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_chat.png|50px]] ||nowa wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_received_chat.png|45px]] ||wiadomość wysłana nieprzeczytana
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_read_chat_conf.png|40px]] ||wiadomość wysłana przeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_notread_chat_conf.png|40px]] ||wiadomość wysłana nieprzeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_unav_chat_conf.png|40px]] ||wiadomość wysłana do niezalogowanego użytkownika - widok w oknie dialogowym
|-
|}
'''''Tabela 4:''''' Ikony symbolizujące status wiadomości. </center>

W tabeli 5 przedstawiono opis powiadomień związanych z błędami w działaniu aplikacji. Powiadomienia widoczne są pod ikoną statusu
<center>
{|{{prettytable}}
!{{Hl1}}|Powiadomienie !!{{Hl1}}| Znaczenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_internet.png]] ||brak połączenia z internetem: sprawdź połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_auth.png]] || błędny login lub hasło: sprawdź ustawienia konta
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_licen.png]] || brak licencji do użytkowania aplikacji: skontaktuj się administratorem centrali
|-
|}
'''''Tabela 5''''': Znaczenie powiadomień o błędach.
</center>

=Obsługa połączeń i wiadomości=
Do przeprowadzenia rozmowy między użytkownikami, niezbędne jest zapewnienie:
* prawidłowej konfiguracji konta po stronie aplikacji oraz centrali
* połączenia aplikacja-centrala (pełna synchronizacja danych aplikacji z centralą) - ikona aplikacji powinna mieć kolor zielony
* zainstalowany telefon systemowy Slican, VoIP lub analogowy dla central IPx, CCT, MAC, NCP lub skonfigurowany abonent typu MessengerCTI (tylko centrala NCP)

==Wykonywanie połączeń==
Dwa sposoby wykonywania połączeń:
* z zakładki '''Kontakty''' - wybieramy abonenta z odpowiedniej grupy (jeśli taka istnieje), bezpośrednio z grupy Wszystkie kontakty. Połączenie wykonujemy przez dotknięcie paska kontaktu wybierając z rozwijanego menu ikonę [[Plik:MessengerCTIM_outgoing.png|25px]]
* z zakładki '''Kontakty''' - bezpośrednio wpisując numer telefonu w polu '''Szukaj''' za pomocą klawiatury a następnie klikając dolny prawy róg klawiatury
<center>[[Plik:MessengerCTIM_out_ext1.png|700px]]</center>
* z zakładki '''Ostatnie''' - odnajdujemy abonenta, z którym mieliśmy kontakt (dzwonił do nas lub my do niego) a następnie połączenie wykonujemy przez dotknięcie paska kontaktu w środkowej części wybierając z rozwijanego menu odpowiednią akcję
<center>[[Plik:MessengerCTIM_out_number1.png|750px]]</center>
Zestawianie połączenia sygnalizowane jest ekranem połączenia jak dla zwykłych połączeń wykonywanych za pomocą linii GSM. Aplikacja zestawia w pierwszej kolejności połączenie do centrali na dedykowany numer dostępowy dla użytkowników '''MessengerCTI.Mobile''', konfigurowany przez administratora centrali. A następnie centrala tranzytem zestawia połączenie z numerem wybranym przez użytkownika '''MessengerCTI.Mobile'''. Z tego powodu w centrali wymaganym łączem miejskim co najmniej jest linia ISDN BRA.

==Połączenie przychodzące==
Połączenie przychodzące sygnalizowane wizualnie jest za pomocą wyskakującego okienka połączenia oraz akustycznie dzwonkiem skonfigurowanym w ustawieniach powiadomień. Połączenia odbieramy przez przesunięcie ikony z zieloną słuchawką. Jeśli połączenie ma być odrzucone to przesuwamy ikonę z czerwoną słuchawką. Dodatkowo jeśli mamy dodane numery podręczne możemy dane połączenie przychodzące przekazać na numer z listy przez przesunięcie ikony z numerem kontaktu podręcznego.
Proces odbierania połączeń przychodzących polega na wykonaniu połączenia zwrotnego do centrali za pomocą linii GSM na numer dostępowy aplikacji zdefiniowany przez administratora centrali.
<center>[[Plik:MessengerCTIM_incoming2.png|700px]]</center>

Nieodebrane połączenie symbolizowane jest ikoną [[Plik:MessengerCTIM_no_answer_qty.png|50px]]. Przejście do historii połączenia lub oddzwonienie powoduje wyczyszczenie informacji o ilości połączeń nieodebranych.

==Obsługa wiadomości==
Aplikacja umożliwia wysyłanie i przyjmowanie wiadomości tekstowych pomiędzy użytkownikami aplikacji MessengerCTI.Desktop/Mobile (czat wewnętrzny). Aby wysłać wiadomość czat klikamy w ikonę statusu aplikacji użytkownika lub z rozwijanego menu po kliknięciu w pasek z kontaktem wybieramy opcję '''chat'''. Otrzymanie nowej wiadomości sygnalizowane jest na pasku powiadomień odpowiednią ikoną oraz zdefiniowanym sygnałem dźwiękowym. 
Jeśli użytkownik używa obu wersji MessengeraCTI, historia wiadomości przechowywana jest także lokalnie w aplikacji '''''MessengerCTI.Desktop'''''.
 Poniżej przykładowe okno dialogowe wiadomości chat:

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

== Kontakty==
Zakładka kontakty umożliwia wyświetlanie i uruchamianie wybranych akcji związanych z kontaktem. Dostęp do numerów z pozostałych grup można uzyskać rozwijając listę pozostałych kontaktów pogrupowanych jako:
* ulubione
* wszystkie grupy
* wszystkie kontakty
* wewnętrzne
* zewnętrzne
* prywatne
Domyślnie widoczna jest grupa '''Ulubione'''.
<center>[[Plik:MessengerCTIM_contacts1.png|300px]]</center>

== Historia połączeń ==
Domyślnie wybrana zakładka '''Ostatnie''' w oknie głównym programu wyświetla historię połączeń jak i wiadomości czat. 
W historii każda pozycja oznacza co najmniej jedno połączenie lub wiadomość. Jeśli połączenie lub wiadomość pochodzi od tego samego użytkownika i jest ich więcej niż jedno, to przy odpowiedniej ikonie wyświetlana jest stosowna liczba. W każdej pozycji widoczny jest numer dzwoniącego, komentarz(jeśli jest on w książce numerów spoza centrali), czas i data realizacji połączenia. 
Jeśli w historii znajdują się nie przejrzane nieodebrane połączenia lub nieprzeczytane wiadomości to zakładka '''Ostatnie''' jest oznaczona czerwoną kropką. 
Z zakładki historii możliwe jest oddzwanianie lub wysyłanie wiadomości zwrotnych.

=Konfiguracja centrali Slican=
Do poprawnej współpracy aplikacji z centralą jest wymagane:
* odpowiednia licencja producenta
* specyficzna konfiguracja centrali
==Konfiguracja central IPx, CCT==
Za pomocą programu ConfgMAN:
* w menu '''''Globalne ustawienia->Globalne ustawienia/Pozostałe->ANo''''': skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji Abonenta menu '''''Abonenci->Abonenci/Ustawienia CTI
** '''AwdMbl''': włączyć zezwolenie na obsługę aplikacji
** '''MnNo''': skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja oraz ewentualnie drugi numer (dla telefonu z dual SIM)
** '''IncC''': ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 6.53.'''

==Konfiguracja centrali NCP==
Z poziomu aplikacji ConfigWEB
* w menu '''''Numery wewnętrzne->Ustawienia->Konfiguracja aplikacji CTI'''''" skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji abonenta SIP, FXS, CTS, Numer MessengerCTI w menu '''''Numery wewnętrzne->Abonenci->CTI ustawienia'''''
** skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja
** ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji i telefonu wewnętrznego central) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 1.11.'''

=Przykłady zastosowań=
Aplikacja '''''MessengerCTI.Mobile''''' może być atrakcyjnym narzędziem dla tych firm, które posiadają pracowników mobilnych z wymogiem ciągłego dostępu telefonicznego jako numer wewnętrzny danego systemu telefonicznego. 
Dobry przykładem mogą pracownicy:
* działu handlowego - z pracą w trybie mieszanym biuro <-> poza biurem
* działu serwisowego - z pracą ciągłą w terenie
* pracownicy zdalni - telepraca
* pracownicy mobilni - praca na dużym terenie (hale produkcyjne, obszary rozległe) - gdzie zasięg sieci typu WiFi lub DECT nie obejmuje takich obszarów.

Instrukcja obsługi MessengerCTI.Mobile

2019-04-08T07:54:21Z

Marekg: /* Status */

<center>[[Plik:messenger_2.png|250px]]</center>
= Wstęp =
Aplikacja Slican '''''MessengerCTI.Mobile''''' jest aplikacją mobilną przeznaczona na system '''Android''', który łączy w sobie możliwość wykonywania połączeń przychodzących jak i wychodzących, dostęp do książki telefonicznej, historii, podglądu statusu innych abonentów oraz chatu. 
Zawiera funkcjonalności umożliwiające integrację telefonu biurkowego i smartphone'a używanego przez abonenta centrali. 

Dużą zaletą tej aplikacji jest integracja książek kontaktów telefonicznych zapisanych w centrali. W '''''MessengerCTI.Mobile''''' wykorzystywane są zawsze książki zgromadzone w centrali, przy czym modyfikacja ich wpisów może być dokonywana tylko z telefonu systemowego jak i komputera przy użyciu programu '''''MessengerCTI.Desktop''''' lub aplikacji '''''WebCTI'''''. Ponadto program Slican '''''MessengerCTI.Mobile''''' posiada funkcjonalność komunikatora wewnętrznego - chatu. Użytkownikami komunikatora mogą być wszyscy abonenci danej centrali przy założeniu posiadania odpowiedniej licencji funkcjonalnej.
 
==Zalety aplikacji==
* aplikacja dostępna (bezpłatnie) w sklepie Google Play - wymagana jedynie po stronie centrali licencja CTI.plus
* książka kontaktów z podglądem stanu dostępności abonenta (czat, zajętości telefonu, opisu)
* dodawanie i usuwanie kontaktów z grupy ulubione, z pełną synchronizacją z aplikacją MessengerCTI.Desktop
* historia ostatnich połączeń/czatów posortowana chronologicznie
* logowanie jako telefonu równoległego do telefonu biurkowego lub jako osobny abonent MessengerCTI (tylko centrala NCP)
* komunikator czat
* historia czata połączona z historią połączeń telefonicznych
* połączenia głosowe przez GSM (dwie opcje zestawiania połączenia: przechwytywanie lub połączenie równoległe)
* elastyczne konfigurowanie powiadomień dźwiękowych
* dostęp do konfigurowania usług centrali na swoim telefonie
* numery podręczne do szybkiego przekazywania połączeń
* możliwość ustawiania zajętości telefonu biurkowego jeśli GSM zajęty (domyślnie włączone)
* możliwość ustawienia odrzucania wywołań na GSM jeśli telefon biurkowy zajęty
* możliwość kopiowania tekstu z chata
* możliwość obsługi smartphone'ów DualSIM lub dwóch telefonów jednocześnie (służbowy i prywatny)
* wygodne otwieranie drzwi jeśli dzwoni do nas bramofon DPH.IP oraz z menu kontekstowego dla kontaktu
* dodatkowy widget na pulpicie do szybkiego otwierania bramofonów DPH.IP
* automatyczny mechanizm opóźnienia powiadomienia na MessengerCTI.Mobile jeśli jestem aktywny na telefonie biurkowym lub MessengerCTI.Desktop
* możliwość kopiowania kontaktu z książki centrali telefonicznej do lokalnej książki telefonu

{{Uwaga|
Dla poprawnego działania aplikacji i połączeń wymagane są:
* stały dostęp do Internetu zarówno MessengerCTI.Mobile jak i centrali
* adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowany port 5529 TCP na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej
* w przypadku połączeń VoIP z aplikacji (wersja BETA) - adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowane porty 5060 UDP (sygnalizacja), 10000 - 20000 UDP (ramki głosowe RTP dla centrali NCP), 8100 - 8300 UDP (ramki głosowe RTP dla central IPx, MAC, CCT) na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej}}

= Wymagania minimalne =
Aplikacja '''''MessengerCTI.Mobile''''' - jest ogólnie dostępna do pobrania w sklepie Google Play.
W celu zainstalowania aplikacji spełnione muszą zostać następujące wymagania minimalne:
* system operacyjny Android - Android wersja systemu KitKat (4.4.4)
* dostęp do internetu dla aplikacji jak i centrali
Telefon z niższą wersją systemu Android nie będzie miał możliwości instalacji aplikacji.

{{Uwaga|
Aplikacja '''''MessengerCTI.Mobile''''' współpracuje z centralami IPx, MAC i CCT wyposażonymi w firmware co najmniej w wersji '''6.53''', oraz NCP '''1.11''' 
Obsługę VoIP w aplikacji w centralach IPx, MAC i CCT wprowadzono w wersji '''6.54''' oraz NCP '''1.12'''}} 

=Instalacja aplikacji =
Korzystanie z aplikacji '''''MessengerCTI.Mobile''''' jest licencjonowane więc wymaga wykupienia odpowiedniej licencji. Zakupiony kod jest wprowadzany w trakcie konfiguracji centrali i decyduje o ilości stanowisk, które mogą używać programu. Licencjonowanie aplikacji nie ma wpływu na jej instalację. Po zainstalowaniu aplikacji należy ją odpowiednio skonfigurować wprowadzając niezbędne dane do połączenia aplikacji z centralą: '''''Ustawienia->Konto''''' (opisane poniżej).

{{Uwaga|
Jeżeli numer wewnętrzny wprowadzony w ustawieniach nie posiada uprawnień do korzystania z aplikacji '''''MessengerCTI.Mobile''''' lub nie jest odpowiednio skonfigurowane konto CTI w centrali dla aplikacji mobilnej - nie będzie możliwości połączenia z centralą i synchronizacja danych.}}

== Uruchomienie aplikacji ==
Program '''''MessengerCTI.Mobile''''' uruchamia się identycznie jak każdy inny program w systemie operacyjnym Android. W trakcie uruchomienia następuje zalogowanie się programu do centrali (zgodnie z ustawieniami zakładce '''''Ustawienia->Konto'''''). Po pomyślnym zalogowaniu następuje synchronizacja danych programu z danymi w centrali (historii połączeń oraz czat).

== Konfiguracja aplikacji ==
Dla poprawnej komunikacji aplikacji z centralą należy skonfigurować dane konta CTI oraz pozostałe funkcje. Menu konfiguracji znajduje się w prawym górnym rogu okna aplikacji. Z rozwijanego menu wybieramy menu '''Ustawienia'''. 

==Ustawienia==

===Konto===
Zakładkę wypełniamy danymi do zalogowania aplikacji skonfigurowanymi przez administratora centrali:
* Twój numer telefonu: numer wewnętrzny telefonu użytkownika z odpowiednimi uprawnieniami dla komunikacji CTI
* Hasło: hasło użytkownika CTI
* Serwer: adres domenowy lub publiczny IP centrali dla użytkowników spoza sieci wewnętrznej lub prywatny dla użytkowników sieci lokalnej
* Zaawansowane/Port protokołu sygnalizacyjnego: port komunikacji z centralą - domyślnie dla centrali TCP 5529

===Powiadomienia===
Konfiguracja powiadomień połączeń przychodzących:
* dźwięk dzwonka: wybór jednego z listy dostępnych w aplikacji z możliwością wyciszenia go po określonym czasie
* wibracje przy dzwonku
* powiadomienie na pasku o nieodebranym połączeniu i wiadomości czat
Konfiguracja powiadomień wiadomości czat:
* dźwięk wiadomości: wybór jednego z listy dostępnych w aplikacji
* wibracje przy wiadomości
* powiadomienie na pasku o nowej wiadomości czat

===Numery podręczne===
Lista najważniejszych numerów podręcznych użytkownika wyświetlana podczas rozmowy w celu prostego przekazania połączenia.

===Inne===
Rozwiązywanie problemów z poprawnym działaniem aplikacji:
* debug - opcja dla administratora włączana na prośbę dostawcy oprogramowania w przypadku analizy problemów
Włączenie opcji '''debug''' powoduje iż w Menu głównym ujawnia się dodatkowe pole '''''Wyślij log'''''. Dalej wybieramy klienta pocztowego, z którego wyślemy logi aplikacji do analizy po stronie producenta.

== Usługi ==
Konfiguracja usług związanych z połączeniami:
* Wycisz aplikację: tryb dyskretny pracy aplikacji - bez powiadomień
* Opóźnienie powiadomień - w stosunku do telefonu biurkowego
* Harmonogram powiadomień - możliwość ustawienia tygodniowego planu aktywnego użytkowania aplikacji (włączania rozdzwaniania i powiadamiania w określonych godzinach)
* Domyślny typ połączenia - ustawienia sposobu realizacji połączeń za pomocą sieci GSM, VoIP lub VoIP przez WiFi.
* Usługi globalne dla centrali: DND - nie przeszkadzać, przekierowanie połączeń: wszystkie, gdy zajęty lub gdy nie odpowiada, zachowanie telefonu biurkowego i MCTI w przypadku zajętości jednego z nich

== Mój opis ==
Ustawienie własnego komentarza, który będzie widoczny dla pozostałych użytkowników aplikacji MessengerCTI oraz na ekranie telefonu systemowego CTS-330

== O programie ==
Informacje o:
* bieżącej wersji aplikacji
* typ centrali z jaką jest aplikacja połączona
* wersja oprogramowania centrali
* numer własny: numer konta CTI (numer wewnętrzny centrali)
* komentarz: opis własny numeru wewnętrznego

== Aktualizacja aplikacji ==
Aktualizacja programu jest dokonywana automatycznie a użytkownik ma wpływ na jej przebieg zgodnie z ustawieniami aktualizacji automatycznych aplikacji danego telefonu dla posiadaczy kont Google. Jeżeli w sklepie Google Play pojawi się nowa wersja następuje automatyczne pobranie nowszej wersji lub powiadomienie o niej.

= Struktura aplikacji =
==Okno główne ==
W oknie głównym aplikacji widoczne są dwie zakładki:
* '''Ostatnie''' - związane z historią połączeń i przesyłanych wiadomości wraz ze statusem abonenta centrali
* '''Kontakty''' - z dostępem do kontaktów książki telefonicznej centrali, z możliwością ich filtrowania: ulubione, wewnętrzne, zewnętrzne
* ikona statusu zalogowania wraz z opisem
* wyszukiwarka kontaktów
* menu ustawień aplikacji
<center>[[Plik:MessengerCTI_opis_new.png|800px]]</center>

== Ikono-grafika ==
W aplikacji '''''MessengerCTI.Mobile''''' przyjęto zasadę intuicyjnego oznaczania stanu telefonu za pomocą ikon widocznych w aplikacji przy każdym z kontaktów lub wpisie historii połączeń. Ikony te umożliwiają wykonywanie wybranej akcji, ocenienie stanu połączenia lub powiadamiają o występowaniu błędów.
=== Ikony i symbole ===
Okno startowe "Ostatnie" aplikacji pokazuje historię ostatnich połączeń. W tym widoku znajdują się ikony:
* po lewej stronie: status aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile lub historia połączeń
* po prawej: informujące o kierunku połączenia i statusie wiadomości czat 

W Tabeli 1 przedstawiono opis znaczenia poszczególnych ikon informujących o statusie aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile:
* dla abonentów wewnętrznych centrali - ikony symbolizujące stan zalogowania aplikacji a, dotknięcie ikony statusu pozwala rozpocząć czat lub sprawdzić historię połączeń
* dla bramofonów DPH.IP - aktualne położenie drzwi, a przez dotknięcie ikony symbolizującej drzwi wejście do historii
* dla kontaktów spoza centrali - sprawdzenie historii połączeń
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTID_free.png|40px]] ||użytkownik zalogowany
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_zaraz_wracam1.png|37px]] ||status: "Zaraz wracam"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_busy1.png]] ||użytkownik ustawił stan "Nie przeszkadzać"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_no_login.png|40px]] ||użytkownik niezalogowany, niedostępny lub status "Niewidoczny"
|-
|{{align|center}}|[[Plik:MessengerCTIMD_chat_free.png|40px]] || jeden z możliwych statusów aplikacji Desktop z skonfigurowaną aplikacją w wersji Mobile
|-
|{{align|center}}|[[Plik:MessengerCTIM_chat_DND.png|40px]] ||historia połączeń oraz wiadomości
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_open.png|40px]] ||bramofon DPH.IP: drzwi otwarte
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_closed.png|40px]] ||bramofon DPH.IP: drzwi zamknięte
|-
|}
'''''Tabela 1:''''' Ikony symbolizujące stany aplikacji, użytkowników i bramofonów. </center> 

W przypadku telefonów będących numerami wewnętrznymi centrali, pojawia się ikona symbolizująca stan telefonu.
<center>

{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_call.png|40px]] ||numer zajęty
|-
|{{align|center}}|[[Plik:MessengerCTIM_ringing.png|40px]] ||dzwonienie na numer lub wykonywanie połączenia wychodzącego z numeru
|-
|{{align|center}}|[[Plik:MessengerCTIM_failure1.png|40px]] ||numer niedostępny lub uszkodzony
|-
|{{align|center}}|[[Plik:MessengerCTIM_DND.png|40px]] ||włączona usługa DND
|-
|}
'''''Tabela 2:''''' Ikony symbolizujące stan telefonu. </center>

W tabeli 3 przedstawiono opis ikon związanych z połączeniami:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_call.png|40px]] ||połączenie przychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_call.png|40px]] ||połączenie wychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_qty.png|50px]] ||nowe nieodebrane połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer.png|45px]] ||połączenie nieodebrane
|-
|}

'''''Tabela 3:''''' Ikony symbolizujące połączenia. </center>

W tabeli 4 przedstawiono opis ikon związanych ze statusem wiadomości:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_chat.png|40px]] ||wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_chat.png|40px]] ||wiadomość wysłana (przeczytana)
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_chat.png|50px]] ||nowa wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_received_chat.png|45px]] ||wiadomość wysłana nieprzeczytana
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_read_chat_conf.png|40px]] ||wiadomość wysłana przeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_notread_chat_conf.png|40px]] ||wiadomość wysłana nieprzeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_unav_chat_conf.png|40px]] ||wiadomość wysłana do niezalogowanego użytkownika - widok w oknie dialogowym
|-
|}
'''''Tabela 4:''''' Ikony symbolizujące status wiadomości. </center>

W tabeli 5 przedstawiono opis powiadomień związanych z błędami w działaniu aplikacji. Powiadomienia widoczne są pod ikoną statusu
<center>
{|{{prettytable}}
!{{Hl1}}|Powiadomienie !!{{Hl1}}| Znaczenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_internet.png]] ||brak połączenia z internetem: sprawdź połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_auth.png]] || błędny login lub hasło: sprawdź ustawienia konta
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_licen.png]] || brak licencji do użytkowania aplikacji: skontaktuj się administratorem centrali
|-
|}
'''''Tabela 5''''': Znaczenie powiadomień o błędach.
</center>

=Obsługa połączeń i wiadomości=
Do przeprowadzenia rozmowy między użytkownikami, niezbędne jest zapewnienie:
* prawidłowej konfiguracji konta po stronie aplikacji oraz centrali
* połączenia aplikacja-centrala (pełna synchronizacja danych aplikacji z centralą) - ikona aplikacji powinna mieć kolor zielony
* zainstalowany telefon systemowy Slican, VoIP lub analogowy dla central IPx, CCT, MAC, NCP lub skonfigurowany abonent typu MessengerCTI (tylko centrala NCP)

==Wykonywanie połączeń==
Dwa sposoby wykonywania połączeń:
* z zakładki '''Kontakty''' - wybieramy abonenta z odpowiedniej grupy (jeśli taka istnieje), bezpośrednio z grupy Wszystkie kontakty. Połączenie wykonujemy przez dotknięcie paska kontaktu wybierając z rozwijanego menu ikonę [[Plik:MessengerCTIM_outgoing.png|25px]]
* z zakładki '''Kontakty''' - bezpośrednio wpisując numer telefonu w polu '''Szukaj''' za pomocą klawiatury a następnie klikając dolny prawy róg klawiatury
<center>[[Plik:MessengerCTIM_out_ext1.png|700px]]</center>
* z zakładki '''Ostatnie''' - odnajdujemy abonenta, z którym mieliśmy kontakt (dzwonił do nas lub my do niego) a następnie połączenie wykonujemy przez dotknięcie paska kontaktu w środkowej części wybierając z rozwijanego menu odpowiednią akcję
<center>[[Plik:MessengerCTIM_out_number1.png|750px]]</center>
Zestawianie połączenia sygnalizowane jest ekranem połączenia jak dla zwykłych połączeń wykonywanych za pomocą linii GSM. Aplikacja zestawia w pierwszej kolejności połączenie do centrali na dedykowany numer dostępowy dla użytkowników '''MessengerCTI.Mobile''', konfigurowany przez administratora centrali. A następnie centrala tranzytem zestawia połączenie z numerem wybranym przez użytkownika '''MessengerCTI.Mobile'''. Z tego powodu w centrali wymaganym łączem miejskim co najmniej jest linia ISDN BRA.

==Połączenie przychodzące==
Połączenie przychodzące sygnalizowane wizualnie jest za pomocą wyskakującego okienka połączenia oraz akustycznie dzwonkiem skonfigurowanym w ustawieniach powiadomień. Połączenia odbieramy przez przesunięcie ikony z zieloną słuchawką. Jeśli połączenie ma być odrzucone to przesuwamy ikonę z czerwoną słuchawką. Dodatkowo jeśli mamy dodane numery podręczne możemy dane połączenie przychodzące przekazać na numer z listy przez przesunięcie ikony z numerem kontaktu podręcznego.
Proces odbierania połączeń przychodzących polega na wykonaniu połączenia zwrotnego do centrali za pomocą linii GSM na numer dostępowy aplikacji zdefiniowany przez administratora centrali.
<center>[[Plik:MessengerCTIM_incoming2.png|700px]]</center>

Nieodebrane połączenie symbolizowane jest ikoną [[Plik:MessengerCTIM_no_answer_qty.png|50px]]. Przejście do historii połączenia lub oddzwonienie powoduje wyczyszczenie informacji o ilości połączeń nieodebranych.

==Obsługa wiadomości==
Aplikacja umożliwia wysyłanie i przyjmowanie wiadomości tekstowych pomiędzy użytkownikami aplikacji MessengerCTI.Desktop/Mobile (czat wewnętrzny). Aby wysłać wiadomość czat klikamy w ikonę statusu aplikacji użytkownika lub z rozwijanego menu po kliknięciu w pasek z kontaktem wybieramy opcję '''chat'''. Otrzymanie nowej wiadomości sygnalizowane jest na pasku powiadomień odpowiednią ikoną oraz zdefiniowanym sygnałem dźwiękowym. 
Jeśli użytkownik używa obu wersji MessengeraCTI, historia wiadomości przechowywana jest także lokalnie w aplikacji '''''MessengerCTI.Desktop'''''.
 Poniżej przykładowe okno dialogowe wiadomości chat:

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

== Kontakty==
Zakładka kontakty umożliwia wyświetlanie i uruchamianie wybranych akcji związanych z kontaktem. Dostęp do numerów z pozostałych grup można uzyskać rozwijając listę pozostałych kontaktów pogrupowanych jako:
* ulubione
* wszystkie grupy
* wszystkie kontakty
* wewnętrzne
* zewnętrzne
* prywatne
Domyślnie widoczna jest grupa '''Ulubione'''.
<center>[[Plik:MessengerCTIM_contacts1.png|300px]]</center>

== Historia połączeń ==
Domyślnie wybrana zakładka '''Ostatnie''' w oknie głównym programu wyświetla historię połączeń jak i wiadomości czat. 
W historii każda pozycja oznacza co najmniej jedno połączenie lub wiadomość. Jeśli połączenie lub wiadomość pochodzi od tego samego użytkownika i jest ich więcej niż jedno, to przy odpowiedniej ikonie wyświetlana jest stosowna liczba. W każdej pozycji widoczny jest numer dzwoniącego, komentarz(jeśli jest on w książce numerów spoza centrali), czas i data realizacji połączenia. 
Jeśli w historii znajdują się nie przejrzane nieodebrane połączenia lub nieprzeczytane wiadomości to zakładka '''Ostatnie''' jest oznaczona czerwoną kropką. 
Z zakładki historii możliwe jest oddzwanianie lub wysyłanie wiadomości zwrotnych.

=Konfiguracja centrali Slican=
Do poprawnej współpracy aplikacji z centralą jest wymagane:
* odpowiednia licencja producenta
* specyficzna konfiguracja centrali
==Konfiguracja central IPx, CCT==
Za pomocą programu ConfgMAN:
* w menu '''''Globalne ustawienia->Globalne ustawienia/Pozostałe->ANo''''': skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji Abonenta menu '''''Abonenci->Abonenci/Ustawienia CTI
** '''AwdMbl''': włączyć zezwolenie na obsługę aplikacji
** '''MnNo''': skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja oraz ewentualnie drugi numer (dla telefonu z dual SIM)
** '''IncC''': ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 6.53.'''

==Konfiguracja centrali NCP==
Z poziomu aplikacji ConfigWEB
* w menu '''''Numery wewnętrzne->Ustawienia->Konfiguracja aplikacji CTI'''''" skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji abonenta SIP, FXS, CTS, Numer MessengerCTI w menu '''''Numery wewnętrzne->Abonenci->CTI ustawienia'''''
** skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja
** ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji i telefonu wewnętrznego central) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 1.11.'''

=Przykłady zastosowań=
Aplikacja '''''MessengerCTI.Mobile''''' może być atrakcyjnym narzędziem dla tych firm, które posiadają pracowników mobilnych z wymogiem ciągłego dostępu telefonicznego jako numer wewnętrzny danego systemu telefonicznego. 
Dobry przykładem mogą pracownicy:
* działu handlowego - z pracą w trybie mieszanym biuro <-> poza biurem
* działu serwisowego - z pracą ciągłą w terenie
* pracownicy zdalni - telepraca
* pracownicy mobilni - praca na dużym terenie (hale produkcyjne, obszary rozległe) - gdzie zasięg sieci typu WiFi lub DECT nie obejmuje takich obszarów.

Instrukcja obsługi MessengerCTI.Mobile

2019-04-08T07:50:48Z

Marekg: /* Usługi */

<center>[[Plik:messenger_2.png|250px]]</center>
= Wstęp =
Aplikacja Slican '''''MessengerCTI.Mobile''''' jest aplikacją mobilną przeznaczona na system '''Android''', który łączy w sobie możliwość wykonywania połączeń przychodzących jak i wychodzących, dostęp do książki telefonicznej, historii, podglądu statusu innych abonentów oraz chatu. 
Zawiera funkcjonalności umożliwiające integrację telefonu biurkowego i smartphone'a używanego przez abonenta centrali. 

Dużą zaletą tej aplikacji jest integracja książek kontaktów telefonicznych zapisanych w centrali. W '''''MessengerCTI.Mobile''''' wykorzystywane są zawsze książki zgromadzone w centrali, przy czym modyfikacja ich wpisów może być dokonywana tylko z telefonu systemowego jak i komputera przy użyciu programu '''''MessengerCTI.Desktop''''' lub aplikacji '''''WebCTI'''''. Ponadto program Slican '''''MessengerCTI.Mobile''''' posiada funkcjonalność komunikatora wewnętrznego - chatu. Użytkownikami komunikatora mogą być wszyscy abonenci danej centrali przy założeniu posiadania odpowiedniej licencji funkcjonalnej.
 
==Zalety aplikacji==
* aplikacja dostępna (bezpłatnie) w sklepie Google Play - wymagana jedynie po stronie centrali licencja CTI.plus
* książka kontaktów z podglądem stanu dostępności abonenta (czat, zajętości telefonu, opisu)
* dodawanie i usuwanie kontaktów z grupy ulubione, z pełną synchronizacją z aplikacją MessengerCTI.Desktop
* historia ostatnich połączeń/czatów posortowana chronologicznie
* logowanie jako telefonu równoległego do telefonu biurkowego lub jako osobny abonent MessengerCTI (tylko centrala NCP)
* komunikator czat
* historia czata połączona z historią połączeń telefonicznych
* połączenia głosowe przez GSM (dwie opcje zestawiania połączenia: przechwytywanie lub połączenie równoległe)
* elastyczne konfigurowanie powiadomień dźwiękowych
* dostęp do konfigurowania usług centrali na swoim telefonie
* numery podręczne do szybkiego przekazywania połączeń
* możliwość ustawiania zajętości telefonu biurkowego jeśli GSM zajęty (domyślnie włączone)
* możliwość ustawienia odrzucania wywołań na GSM jeśli telefon biurkowy zajęty
* możliwość kopiowania tekstu z chata
* możliwość obsługi smartphone'ów DualSIM lub dwóch telefonów jednocześnie (służbowy i prywatny)
* wygodne otwieranie drzwi jeśli dzwoni do nas bramofon DPH.IP oraz z menu kontekstowego dla kontaktu
* dodatkowy widget na pulpicie do szybkiego otwierania bramofonów DPH.IP
* automatyczny mechanizm opóźnienia powiadomienia na MessengerCTI.Mobile jeśli jestem aktywny na telefonie biurkowym lub MessengerCTI.Desktop
* możliwość kopiowania kontaktu z książki centrali telefonicznej do lokalnej książki telefonu

{{Uwaga|
Dla poprawnego działania aplikacji i połączeń wymagane są:
* stały dostęp do Internetu zarówno MessengerCTI.Mobile jak i centrali
* adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowany port 5529 TCP na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej
* w przypadku połączeń VoIP z aplikacji (wersja BETA) - adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowane porty 5060 UDP (sygnalizacja), 10000 - 20000 UDP (ramki głosowe RTP dla centrali NCP), 8100 - 8300 UDP (ramki głosowe RTP dla central IPx, MAC, CCT) na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej}}

= Wymagania minimalne =
Aplikacja '''''MessengerCTI.Mobile''''' - jest ogólnie dostępna do pobrania w sklepie Google Play.
W celu zainstalowania aplikacji spełnione muszą zostać następujące wymagania minimalne:
* system operacyjny Android - Android wersja systemu KitKat (4.4.4)
* dostęp do internetu dla aplikacji jak i centrali
Telefon z niższą wersją systemu Android nie będzie miał możliwości instalacji aplikacji.

{{Uwaga|
Aplikacja '''''MessengerCTI.Mobile''''' współpracuje z centralami IPx, MAC i CCT wyposażonymi w firmware co najmniej w wersji '''6.53''', oraz NCP '''1.11''' 
Obsługę VoIP w aplikacji w centralach IPx, MAC i CCT wprowadzono w wersji '''6.54''' oraz NCP '''1.12'''}} 

=Instalacja aplikacji =
Korzystanie z aplikacji '''''MessengerCTI.Mobile''''' jest licencjonowane więc wymaga wykupienia odpowiedniej licencji. Zakupiony kod jest wprowadzany w trakcie konfiguracji centrali i decyduje o ilości stanowisk, które mogą używać programu. Licencjonowanie aplikacji nie ma wpływu na jej instalację. Po zainstalowaniu aplikacji należy ją odpowiednio skonfigurować wprowadzając niezbędne dane do połączenia aplikacji z centralą: '''''Ustawienia->Konto''''' (opisane poniżej).

{{Uwaga|
Jeżeli numer wewnętrzny wprowadzony w ustawieniach nie posiada uprawnień do korzystania z aplikacji '''''MessengerCTI.Mobile''''' lub nie jest odpowiednio skonfigurowane konto CTI w centrali dla aplikacji mobilnej - nie będzie możliwości połączenia z centralą i synchronizacja danych.}}

== Uruchomienie aplikacji ==
Program '''''MessengerCTI.Mobile''''' uruchamia się identycznie jak każdy inny program w systemie operacyjnym Android. W trakcie uruchomienia następuje zalogowanie się programu do centrali (zgodnie z ustawieniami zakładce '''''Ustawienia->Konto'''''). Po pomyślnym zalogowaniu następuje synchronizacja danych programu z danymi w centrali (historii połączeń oraz czat).

== Konfiguracja aplikacji ==
Dla poprawnej komunikacji aplikacji z centralą należy skonfigurować dane konta CTI oraz pozostałe funkcje. Menu konfiguracji znajduje się w prawym górnym rogu okna aplikacji. Z rozwijanego menu wybieramy menu '''Ustawienia'''. 

==Ustawienia==

===Konto===
Zakładkę wypełniamy danymi do zalogowania aplikacji skonfigurowanymi przez administratora centrali:
* Twój numer telefonu: numer wewnętrzny telefonu użytkownika z odpowiednimi uprawnieniami dla komunikacji CTI
* Hasło: hasło użytkownika CTI
* Serwer: adres domenowy lub publiczny IP centrali dla użytkowników spoza sieci wewnętrznej lub prywatny dla użytkowników sieci lokalnej
* Zaawansowane/Port protokołu sygnalizacyjnego: port komunikacji z centralą - domyślnie dla centrali TCP 5529

===Powiadomienia===
Konfiguracja powiadomień połączeń przychodzących:
* dźwięk dzwonka: wybór jednego z listy dostępnych w aplikacji z możliwością wyciszenia go po określonym czasie
* wibracje przy dzwonku
* powiadomienie na pasku o nieodebranym połączeniu i wiadomości czat
Konfiguracja powiadomień wiadomości czat:
* dźwięk wiadomości: wybór jednego z listy dostępnych w aplikacji
* wibracje przy wiadomości
* powiadomienie na pasku o nowej wiadomości czat

===Numery podręczne===
Lista najważniejszych numerów podręcznych użytkownika wyświetlana podczas rozmowy w celu prostego przekazania połączenia.

===Inne===
Rozwiązywanie problemów z poprawnym działaniem aplikacji:
* debug - opcja dla administratora włączana na prośbę dostawcy oprogramowania w przypadku analizy problemów
Włączenie opcji '''debug''' powoduje iż w Menu głównym ujawnia się dodatkowe pole '''''Wyślij log'''''. Dalej wybieramy klienta pocztowego, z którego wyślemy logi aplikacji do analizy po stronie producenta.

== Usługi ==
Konfiguracja usług związanych z połączeniami:
* Wycisz aplikację: tryb dyskretny pracy aplikacji - bez powiadomień
* Opóźnienie powiadomień - w stosunku do telefonu biurkowego
* Harmonogram powiadomień - możliwość ustawienia tygodniowego planu aktywnego użytkowania aplikacji (włączania rozdzwaniania i powiadamiania w określonych godzinach)
* Domyślny typ połączenia - ustawienia sposobu realizacji połączeń za pomocą sieci GSM, VoIP lub VoIP przez WiFi.
* Usługi globalne dla centrali: DND - nie przeszkadzać, przekierowanie połączeń: wszystkie, gdy zajęty lub gdy nie odpowiada, zachowanie telefonu biurkowego i MCTI w przypadku zajętości jednego z nich

== Status ==
Ustawienie własnego opisu, który będzie widoczny dla pozostałych użytkowników aplikacji MessengerCTI oraz na ekranie telefonu systemowego CTS-330
== O programie ==
Informacje o:
* bieżącej wersji aplikacji
* typ centrali z jaką jest aplikacja połączona
* wersja oprogramowania centrali
* numer własny: numer konta CTI (numer wewnętrzny centrali)
* komentarz: opis własny numeru wewnętrznego

== Aktualizacja aplikacji ==
Aktualizacja programu jest dokonywana automatycznie a użytkownik ma wpływ na jej przebieg zgodnie z ustawieniami aktualizacji automatycznych aplikacji danego telefonu dla posiadaczy kont Google. Jeżeli w sklepie Google Play pojawi się nowa wersja następuje automatyczne pobranie nowszej wersji lub powiadomienie o niej.

= Struktura aplikacji =
==Okno główne ==
W oknie głównym aplikacji widoczne są dwie zakładki:
* '''Ostatnie''' - związane z historią połączeń i przesyłanych wiadomości wraz ze statusem abonenta centrali
* '''Kontakty''' - z dostępem do kontaktów książki telefonicznej centrali, z możliwością ich filtrowania: ulubione, wewnętrzne, zewnętrzne
* ikona statusu zalogowania wraz z opisem
* wyszukiwarka kontaktów
* menu ustawień aplikacji
<center>[[Plik:MessengerCTI_opis_new.png|800px]]</center>

== Ikono-grafika ==
W aplikacji '''''MessengerCTI.Mobile''''' przyjęto zasadę intuicyjnego oznaczania stanu telefonu za pomocą ikon widocznych w aplikacji przy każdym z kontaktów lub wpisie historii połączeń. Ikony te umożliwiają wykonywanie wybranej akcji, ocenienie stanu połączenia lub powiadamiają o występowaniu błędów.
=== Ikony i symbole ===
Okno startowe "Ostatnie" aplikacji pokazuje historię ostatnich połączeń. W tym widoku znajdują się ikony:
* po lewej stronie: status aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile lub historia połączeń
* po prawej: informujące o kierunku połączenia i statusie wiadomości czat 

W Tabeli 1 przedstawiono opis znaczenia poszczególnych ikon informujących o statusie aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile:
* dla abonentów wewnętrznych centrali - ikony symbolizujące stan zalogowania aplikacji a, dotknięcie ikony statusu pozwala rozpocząć czat lub sprawdzić historię połączeń
* dla bramofonów DPH.IP - aktualne położenie drzwi, a przez dotknięcie ikony symbolizującej drzwi wejście do historii
* dla kontaktów spoza centrali - sprawdzenie historii połączeń
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTID_free.png|40px]] ||użytkownik zalogowany
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_zaraz_wracam1.png|37px]] ||status: "Zaraz wracam"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_busy1.png]] ||użytkownik ustawił stan "Nie przeszkadzać"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_no_login.png|40px]] ||użytkownik niezalogowany, niedostępny lub status "Niewidoczny"
|-
|{{align|center}}|[[Plik:MessengerCTIMD_chat_free.png|40px]] || jeden z możliwych statusów aplikacji Desktop z skonfigurowaną aplikacją w wersji Mobile
|-
|{{align|center}}|[[Plik:MessengerCTIM_chat_DND.png|40px]] ||historia połączeń oraz wiadomości
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_open.png|40px]] ||bramofon DPH.IP: drzwi otwarte
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_closed.png|40px]] ||bramofon DPH.IP: drzwi zamknięte
|-
|}
'''''Tabela 1:''''' Ikony symbolizujące stany aplikacji, użytkowników i bramofonów. </center> 

W przypadku telefonów będących numerami wewnętrznymi centrali, pojawia się ikona symbolizująca stan telefonu.
<center>

{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_call.png|40px]] ||numer zajęty
|-
|{{align|center}}|[[Plik:MessengerCTIM_ringing.png|40px]] ||dzwonienie na numer lub wykonywanie połączenia wychodzącego z numeru
|-
|{{align|center}}|[[Plik:MessengerCTIM_failure1.png|40px]] ||numer niedostępny lub uszkodzony
|-
|{{align|center}}|[[Plik:MessengerCTIM_DND.png|40px]] ||włączona usługa DND
|-
|}
'''''Tabela 2:''''' Ikony symbolizujące stan telefonu. </center>

W tabeli 3 przedstawiono opis ikon związanych z połączeniami:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_call.png|40px]] ||połączenie przychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_call.png|40px]] ||połączenie wychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_qty.png|50px]] ||nowe nieodebrane połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer.png|45px]] ||połączenie nieodebrane
|-
|}

'''''Tabela 3:''''' Ikony symbolizujące połączenia. </center>

W tabeli 4 przedstawiono opis ikon związanych ze statusem wiadomości:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_chat.png|40px]] ||wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_chat.png|40px]] ||wiadomość wysłana (przeczytana)
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_chat.png|50px]] ||nowa wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_received_chat.png|45px]] ||wiadomość wysłana nieprzeczytana
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_read_chat_conf.png|40px]] ||wiadomość wysłana przeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_notread_chat_conf.png|40px]] ||wiadomość wysłana nieprzeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_unav_chat_conf.png|40px]] ||wiadomość wysłana do niezalogowanego użytkownika - widok w oknie dialogowym
|-
|}
'''''Tabela 4:''''' Ikony symbolizujące status wiadomości. </center>

W tabeli 5 przedstawiono opis powiadomień związanych z błędami w działaniu aplikacji. Powiadomienia widoczne są pod ikoną statusu
<center>
{|{{prettytable}}
!{{Hl1}}|Powiadomienie !!{{Hl1}}| Znaczenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_internet.png]] ||brak połączenia z internetem: sprawdź połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_auth.png]] || błędny login lub hasło: sprawdź ustawienia konta
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_licen.png]] || brak licencji do użytkowania aplikacji: skontaktuj się administratorem centrali
|-
|}
'''''Tabela 5''''': Znaczenie powiadomień o błędach.
</center>

=Obsługa połączeń i wiadomości=
Do przeprowadzenia rozmowy między użytkownikami, niezbędne jest zapewnienie:
* prawidłowej konfiguracji konta po stronie aplikacji oraz centrali
* połączenia aplikacja-centrala (pełna synchronizacja danych aplikacji z centralą) - ikona aplikacji powinna mieć kolor zielony
* zainstalowany telefon systemowy Slican, VoIP lub analogowy dla central IPx, CCT, MAC, NCP lub skonfigurowany abonent typu MessengerCTI (tylko centrala NCP)

==Wykonywanie połączeń==
Dwa sposoby wykonywania połączeń:
* z zakładki '''Kontakty''' - wybieramy abonenta z odpowiedniej grupy (jeśli taka istnieje), bezpośrednio z grupy Wszystkie kontakty. Połączenie wykonujemy przez dotknięcie paska kontaktu wybierając z rozwijanego menu ikonę [[Plik:MessengerCTIM_outgoing.png|25px]]
* z zakładki '''Kontakty''' - bezpośrednio wpisując numer telefonu w polu '''Szukaj''' za pomocą klawiatury a następnie klikając dolny prawy róg klawiatury
<center>[[Plik:MessengerCTIM_out_ext1.png|700px]]</center>
* z zakładki '''Ostatnie''' - odnajdujemy abonenta, z którym mieliśmy kontakt (dzwonił do nas lub my do niego) a następnie połączenie wykonujemy przez dotknięcie paska kontaktu w środkowej części wybierając z rozwijanego menu odpowiednią akcję
<center>[[Plik:MessengerCTIM_out_number1.png|750px]]</center>
Zestawianie połączenia sygnalizowane jest ekranem połączenia jak dla zwykłych połączeń wykonywanych za pomocą linii GSM. Aplikacja zestawia w pierwszej kolejności połączenie do centrali na dedykowany numer dostępowy dla użytkowników '''MessengerCTI.Mobile''', konfigurowany przez administratora centrali. A następnie centrala tranzytem zestawia połączenie z numerem wybranym przez użytkownika '''MessengerCTI.Mobile'''. Z tego powodu w centrali wymaganym łączem miejskim co najmniej jest linia ISDN BRA.

==Połączenie przychodzące==
Połączenie przychodzące sygnalizowane wizualnie jest za pomocą wyskakującego okienka połączenia oraz akustycznie dzwonkiem skonfigurowanym w ustawieniach powiadomień. Połączenia odbieramy przez przesunięcie ikony z zieloną słuchawką. Jeśli połączenie ma być odrzucone to przesuwamy ikonę z czerwoną słuchawką. Dodatkowo jeśli mamy dodane numery podręczne możemy dane połączenie przychodzące przekazać na numer z listy przez przesunięcie ikony z numerem kontaktu podręcznego.
Proces odbierania połączeń przychodzących polega na wykonaniu połączenia zwrotnego do centrali za pomocą linii GSM na numer dostępowy aplikacji zdefiniowany przez administratora centrali.
<center>[[Plik:MessengerCTIM_incoming2.png|700px]]</center>

Nieodebrane połączenie symbolizowane jest ikoną [[Plik:MessengerCTIM_no_answer_qty.png|50px]]. Przejście do historii połączenia lub oddzwonienie powoduje wyczyszczenie informacji o ilości połączeń nieodebranych.

==Obsługa wiadomości==
Aplikacja umożliwia wysyłanie i przyjmowanie wiadomości tekstowych pomiędzy użytkownikami aplikacji MessengerCTI.Desktop/Mobile (czat wewnętrzny). Aby wysłać wiadomość czat klikamy w ikonę statusu aplikacji użytkownika lub z rozwijanego menu po kliknięciu w pasek z kontaktem wybieramy opcję '''chat'''. Otrzymanie nowej wiadomości sygnalizowane jest na pasku powiadomień odpowiednią ikoną oraz zdefiniowanym sygnałem dźwiękowym. 
Jeśli użytkownik używa obu wersji MessengeraCTI, historia wiadomości przechowywana jest także lokalnie w aplikacji '''''MessengerCTI.Desktop'''''.
 Poniżej przykładowe okno dialogowe wiadomości chat:

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

== Kontakty==
Zakładka kontakty umożliwia wyświetlanie i uruchamianie wybranych akcji związanych z kontaktem. Dostęp do numerów z pozostałych grup można uzyskać rozwijając listę pozostałych kontaktów pogrupowanych jako:
* ulubione
* wszystkie grupy
* wszystkie kontakty
* wewnętrzne
* zewnętrzne
* prywatne
Domyślnie widoczna jest grupa '''Ulubione'''.
<center>[[Plik:MessengerCTIM_contacts1.png|300px]]</center>

== Historia połączeń ==
Domyślnie wybrana zakładka '''Ostatnie''' w oknie głównym programu wyświetla historię połączeń jak i wiadomości czat. 
W historii każda pozycja oznacza co najmniej jedno połączenie lub wiadomość. Jeśli połączenie lub wiadomość pochodzi od tego samego użytkownika i jest ich więcej niż jedno, to przy odpowiedniej ikonie wyświetlana jest stosowna liczba. W każdej pozycji widoczny jest numer dzwoniącego, komentarz(jeśli jest on w książce numerów spoza centrali), czas i data realizacji połączenia. 
Jeśli w historii znajdują się nie przejrzane nieodebrane połączenia lub nieprzeczytane wiadomości to zakładka '''Ostatnie''' jest oznaczona czerwoną kropką. 
Z zakładki historii możliwe jest oddzwanianie lub wysyłanie wiadomości zwrotnych.

=Konfiguracja centrali Slican=
Do poprawnej współpracy aplikacji z centralą jest wymagane:
* odpowiednia licencja producenta
* specyficzna konfiguracja centrali
==Konfiguracja central IPx, CCT==
Za pomocą programu ConfgMAN:
* w menu '''''Globalne ustawienia->Globalne ustawienia/Pozostałe->ANo''''': skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji Abonenta menu '''''Abonenci->Abonenci/Ustawienia CTI
** '''AwdMbl''': włączyć zezwolenie na obsługę aplikacji
** '''MnNo''': skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja oraz ewentualnie drugi numer (dla telefonu z dual SIM)
** '''IncC''': ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 6.53.'''

==Konfiguracja centrali NCP==
Z poziomu aplikacji ConfigWEB
* w menu '''''Numery wewnętrzne->Ustawienia->Konfiguracja aplikacji CTI'''''" skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji abonenta SIP, FXS, CTS, Numer MessengerCTI w menu '''''Numery wewnętrzne->Abonenci->CTI ustawienia'''''
** skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja
** ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji i telefonu wewnętrznego central) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 1.11.'''

=Przykłady zastosowań=
Aplikacja '''''MessengerCTI.Mobile''''' może być atrakcyjnym narzędziem dla tych firm, które posiadają pracowników mobilnych z wymogiem ciągłego dostępu telefonicznego jako numer wewnętrzny danego systemu telefonicznego. 
Dobry przykładem mogą pracownicy:
* działu handlowego - z pracą w trybie mieszanym biuro <-> poza biurem
* działu serwisowego - z pracą ciągłą w terenie
* pracownicy zdalni - telepraca
* pracownicy mobilni - praca na dużym terenie (hale produkcyjne, obszary rozległe) - gdzie zasięg sieci typu WiFi lub DECT nie obejmuje takich obszarów.

Instrukcja obsługi MessengerCTI.Mobile

2019-04-08T07:47:27Z

Marekg: /* Ustawienia */

<center>[[Plik:messenger_2.png|250px]]</center>
= Wstęp =
Aplikacja Slican '''''MessengerCTI.Mobile''''' jest aplikacją mobilną przeznaczona na system '''Android''', który łączy w sobie możliwość wykonywania połączeń przychodzących jak i wychodzących, dostęp do książki telefonicznej, historii, podglądu statusu innych abonentów oraz chatu. 
Zawiera funkcjonalności umożliwiające integrację telefonu biurkowego i smartphone'a używanego przez abonenta centrali. 

Dużą zaletą tej aplikacji jest integracja książek kontaktów telefonicznych zapisanych w centrali. W '''''MessengerCTI.Mobile''''' wykorzystywane są zawsze książki zgromadzone w centrali, przy czym modyfikacja ich wpisów może być dokonywana tylko z telefonu systemowego jak i komputera przy użyciu programu '''''MessengerCTI.Desktop''''' lub aplikacji '''''WebCTI'''''. Ponadto program Slican '''''MessengerCTI.Mobile''''' posiada funkcjonalność komunikatora wewnętrznego - chatu. Użytkownikami komunikatora mogą być wszyscy abonenci danej centrali przy założeniu posiadania odpowiedniej licencji funkcjonalnej.
 
==Zalety aplikacji==
* aplikacja dostępna (bezpłatnie) w sklepie Google Play - wymagana jedynie po stronie centrali licencja CTI.plus
* książka kontaktów z podglądem stanu dostępności abonenta (czat, zajętości telefonu, opisu)
* dodawanie i usuwanie kontaktów z grupy ulubione, z pełną synchronizacją z aplikacją MessengerCTI.Desktop
* historia ostatnich połączeń/czatów posortowana chronologicznie
* logowanie jako telefonu równoległego do telefonu biurkowego lub jako osobny abonent MessengerCTI (tylko centrala NCP)
* komunikator czat
* historia czata połączona z historią połączeń telefonicznych
* połączenia głosowe przez GSM (dwie opcje zestawiania połączenia: przechwytywanie lub połączenie równoległe)
* elastyczne konfigurowanie powiadomień dźwiękowych
* dostęp do konfigurowania usług centrali na swoim telefonie
* numery podręczne do szybkiego przekazywania połączeń
* możliwość ustawiania zajętości telefonu biurkowego jeśli GSM zajęty (domyślnie włączone)
* możliwość ustawienia odrzucania wywołań na GSM jeśli telefon biurkowy zajęty
* możliwość kopiowania tekstu z chata
* możliwość obsługi smartphone'ów DualSIM lub dwóch telefonów jednocześnie (służbowy i prywatny)
* wygodne otwieranie drzwi jeśli dzwoni do nas bramofon DPH.IP oraz z menu kontekstowego dla kontaktu
* dodatkowy widget na pulpicie do szybkiego otwierania bramofonów DPH.IP
* automatyczny mechanizm opóźnienia powiadomienia na MessengerCTI.Mobile jeśli jestem aktywny na telefonie biurkowym lub MessengerCTI.Desktop
* możliwość kopiowania kontaktu z książki centrali telefonicznej do lokalnej książki telefonu

{{Uwaga|
Dla poprawnego działania aplikacji i połączeń wymagane są:
* stały dostęp do Internetu zarówno MessengerCTI.Mobile jak i centrali
* adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowany port 5529 TCP na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej
* w przypadku połączeń VoIP z aplikacji (wersja BETA) - adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowane porty 5060 UDP (sygnalizacja), 10000 - 20000 UDP (ramki głosowe RTP dla centrali NCP), 8100 - 8300 UDP (ramki głosowe RTP dla central IPx, MAC, CCT) na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej}}

= Wymagania minimalne =
Aplikacja '''''MessengerCTI.Mobile''''' - jest ogólnie dostępna do pobrania w sklepie Google Play.
W celu zainstalowania aplikacji spełnione muszą zostać następujące wymagania minimalne:
* system operacyjny Android - Android wersja systemu KitKat (4.4.4)
* dostęp do internetu dla aplikacji jak i centrali
Telefon z niższą wersją systemu Android nie będzie miał możliwości instalacji aplikacji.

{{Uwaga|
Aplikacja '''''MessengerCTI.Mobile''''' współpracuje z centralami IPx, MAC i CCT wyposażonymi w firmware co najmniej w wersji '''6.53''', oraz NCP '''1.11''' 
Obsługę VoIP w aplikacji w centralach IPx, MAC i CCT wprowadzono w wersji '''6.54''' oraz NCP '''1.12'''}} 

=Instalacja aplikacji =
Korzystanie z aplikacji '''''MessengerCTI.Mobile''''' jest licencjonowane więc wymaga wykupienia odpowiedniej licencji. Zakupiony kod jest wprowadzany w trakcie konfiguracji centrali i decyduje o ilości stanowisk, które mogą używać programu. Licencjonowanie aplikacji nie ma wpływu na jej instalację. Po zainstalowaniu aplikacji należy ją odpowiednio skonfigurować wprowadzając niezbędne dane do połączenia aplikacji z centralą: '''''Ustawienia->Konto''''' (opisane poniżej).

{{Uwaga|
Jeżeli numer wewnętrzny wprowadzony w ustawieniach nie posiada uprawnień do korzystania z aplikacji '''''MessengerCTI.Mobile''''' lub nie jest odpowiednio skonfigurowane konto CTI w centrali dla aplikacji mobilnej - nie będzie możliwości połączenia z centralą i synchronizacja danych.}}

== Uruchomienie aplikacji ==
Program '''''MessengerCTI.Mobile''''' uruchamia się identycznie jak każdy inny program w systemie operacyjnym Android. W trakcie uruchomienia następuje zalogowanie się programu do centrali (zgodnie z ustawieniami zakładce '''''Ustawienia->Konto'''''). Po pomyślnym zalogowaniu następuje synchronizacja danych programu z danymi w centrali (historii połączeń oraz czat).

== Konfiguracja aplikacji ==
Dla poprawnej komunikacji aplikacji z centralą należy skonfigurować dane konta CTI oraz pozostałe funkcje. Menu konfiguracji znajduje się w prawym górnym rogu okna aplikacji. Z rozwijanego menu wybieramy menu '''Ustawienia'''. 

==Ustawienia==

===Konto===
Zakładkę wypełniamy danymi do zalogowania aplikacji skonfigurowanymi przez administratora centrali:
* Twój numer telefonu: numer wewnętrzny telefonu użytkownika z odpowiednimi uprawnieniami dla komunikacji CTI
* Hasło: hasło użytkownika CTI
* Serwer: adres domenowy lub publiczny IP centrali dla użytkowników spoza sieci wewnętrznej lub prywatny dla użytkowników sieci lokalnej
* Zaawansowane/Port protokołu sygnalizacyjnego: port komunikacji z centralą - domyślnie dla centrali TCP 5529

===Powiadomienia===
Konfiguracja powiadomień połączeń przychodzących:
* dźwięk dzwonka: wybór jednego z listy dostępnych w aplikacji z możliwością wyciszenia go po określonym czasie
* wibracje przy dzwonku
* powiadomienie na pasku o nieodebranym połączeniu i wiadomości czat
Konfiguracja powiadomień wiadomości czat:
* dźwięk wiadomości: wybór jednego z listy dostępnych w aplikacji
* wibracje przy wiadomości
* powiadomienie na pasku o nowej wiadomości czat

===Numery podręczne===
Lista najważniejszych numerów podręcznych użytkownika wyświetlana podczas rozmowy w celu prostego przekazania połączenia.

===Inne===
Rozwiązywanie problemów z poprawnym działaniem aplikacji:
* debug - opcja dla administratora włączana na prośbę dostawcy oprogramowania w przypadku analizy problemów
Włączenie opcji '''debug''' powoduje iż w Menu głównym ujawnia się dodatkowe pole '''''Wyślij log'''''. Dalej wybieramy klienta pocztowego, z którego wyślemy logi aplikacji do analizy po stronie producenta.

== Usługi ==
Konfiguracja usług aplikacji związanych z połączeniami:
* DND: nie przeszkadzać
* przekierowanie połączeń: wszystkie, gdy zajęty lub gdy nie odpowiada ze wskazaniem numeru na jaki ma być wykonane przekierowanie (należy pamiętać iż w pierwszej kolejności podaje numer a następnie aktywujemy przekierowanie)
* wycisz aplikację: tryb dyskretny

== Status ==
Ustawienie własnego opisu, który będzie widoczny dla pozostałych użytkowników aplikacji MessengerCTI oraz na ekranie telefonu systemowego CTS-330
== O programie ==
Informacje o:
* bieżącej wersji aplikacji
* typ centrali z jaką jest aplikacja połączona
* wersja oprogramowania centrali
* numer własny: numer konta CTI (numer wewnętrzny centrali)
* komentarz: opis własny numeru wewnętrznego

== Aktualizacja aplikacji ==
Aktualizacja programu jest dokonywana automatycznie a użytkownik ma wpływ na jej przebieg zgodnie z ustawieniami aktualizacji automatycznych aplikacji danego telefonu dla posiadaczy kont Google. Jeżeli w sklepie Google Play pojawi się nowa wersja następuje automatyczne pobranie nowszej wersji lub powiadomienie o niej.

= Struktura aplikacji =
==Okno główne ==
W oknie głównym aplikacji widoczne są dwie zakładki:
* '''Ostatnie''' - związane z historią połączeń i przesyłanych wiadomości wraz ze statusem abonenta centrali
* '''Kontakty''' - z dostępem do kontaktów książki telefonicznej centrali, z możliwością ich filtrowania: ulubione, wewnętrzne, zewnętrzne
* ikona statusu zalogowania wraz z opisem
* wyszukiwarka kontaktów
* menu ustawień aplikacji
<center>[[Plik:MessengerCTI_opis_new.png|800px]]</center>

== Ikono-grafika ==
W aplikacji '''''MessengerCTI.Mobile''''' przyjęto zasadę intuicyjnego oznaczania stanu telefonu za pomocą ikon widocznych w aplikacji przy każdym z kontaktów lub wpisie historii połączeń. Ikony te umożliwiają wykonywanie wybranej akcji, ocenienie stanu połączenia lub powiadamiają o występowaniu błędów.
=== Ikony i symbole ===
Okno startowe "Ostatnie" aplikacji pokazuje historię ostatnich połączeń. W tym widoku znajdują się ikony:
* po lewej stronie: status aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile lub historia połączeń
* po prawej: informujące o kierunku połączenia i statusie wiadomości czat 

W Tabeli 1 przedstawiono opis znaczenia poszczególnych ikon informujących o statusie aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile:
* dla abonentów wewnętrznych centrali - ikony symbolizujące stan zalogowania aplikacji a, dotknięcie ikony statusu pozwala rozpocząć czat lub sprawdzić historię połączeń
* dla bramofonów DPH.IP - aktualne położenie drzwi, a przez dotknięcie ikony symbolizującej drzwi wejście do historii
* dla kontaktów spoza centrali - sprawdzenie historii połączeń
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTID_free.png|40px]] ||użytkownik zalogowany
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_zaraz_wracam1.png|37px]] ||status: "Zaraz wracam"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_busy1.png]] ||użytkownik ustawił stan "Nie przeszkadzać"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_no_login.png|40px]] ||użytkownik niezalogowany, niedostępny lub status "Niewidoczny"
|-
|{{align|center}}|[[Plik:MessengerCTIMD_chat_free.png|40px]] || jeden z możliwych statusów aplikacji Desktop z skonfigurowaną aplikacją w wersji Mobile
|-
|{{align|center}}|[[Plik:MessengerCTIM_chat_DND.png|40px]] ||historia połączeń oraz wiadomości
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_open.png|40px]] ||bramofon DPH.IP: drzwi otwarte
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_closed.png|40px]] ||bramofon DPH.IP: drzwi zamknięte
|-
|}
'''''Tabela 1:''''' Ikony symbolizujące stany aplikacji, użytkowników i bramofonów. </center> 

W przypadku telefonów będących numerami wewnętrznymi centrali, pojawia się ikona symbolizująca stan telefonu.
<center>

{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_call.png|40px]] ||numer zajęty
|-
|{{align|center}}|[[Plik:MessengerCTIM_ringing.png|40px]] ||dzwonienie na numer lub wykonywanie połączenia wychodzącego z numeru
|-
|{{align|center}}|[[Plik:MessengerCTIM_failure1.png|40px]] ||numer niedostępny lub uszkodzony
|-
|{{align|center}}|[[Plik:MessengerCTIM_DND.png|40px]] ||włączona usługa DND
|-
|}
'''''Tabela 2:''''' Ikony symbolizujące stan telefonu. </center>

W tabeli 3 przedstawiono opis ikon związanych z połączeniami:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_call.png|40px]] ||połączenie przychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_call.png|40px]] ||połączenie wychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_qty.png|50px]] ||nowe nieodebrane połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer.png|45px]] ||połączenie nieodebrane
|-
|}

'''''Tabela 3:''''' Ikony symbolizujące połączenia. </center>

W tabeli 4 przedstawiono opis ikon związanych ze statusem wiadomości:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_chat.png|40px]] ||wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_chat.png|40px]] ||wiadomość wysłana (przeczytana)
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_chat.png|50px]] ||nowa wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_received_chat.png|45px]] ||wiadomość wysłana nieprzeczytana
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_read_chat_conf.png|40px]] ||wiadomość wysłana przeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_notread_chat_conf.png|40px]] ||wiadomość wysłana nieprzeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_unav_chat_conf.png|40px]] ||wiadomość wysłana do niezalogowanego użytkownika - widok w oknie dialogowym
|-
|}
'''''Tabela 4:''''' Ikony symbolizujące status wiadomości. </center>

W tabeli 5 przedstawiono opis powiadomień związanych z błędami w działaniu aplikacji. Powiadomienia widoczne są pod ikoną statusu
<center>
{|{{prettytable}}
!{{Hl1}}|Powiadomienie !!{{Hl1}}| Znaczenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_internet.png]] ||brak połączenia z internetem: sprawdź połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_auth.png]] || błędny login lub hasło: sprawdź ustawienia konta
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_licen.png]] || brak licencji do użytkowania aplikacji: skontaktuj się administratorem centrali
|-
|}
'''''Tabela 5''''': Znaczenie powiadomień o błędach.
</center>

=Obsługa połączeń i wiadomości=
Do przeprowadzenia rozmowy między użytkownikami, niezbędne jest zapewnienie:
* prawidłowej konfiguracji konta po stronie aplikacji oraz centrali
* połączenia aplikacja-centrala (pełna synchronizacja danych aplikacji z centralą) - ikona aplikacji powinna mieć kolor zielony
* zainstalowany telefon systemowy Slican, VoIP lub analogowy dla central IPx, CCT, MAC, NCP lub skonfigurowany abonent typu MessengerCTI (tylko centrala NCP)

==Wykonywanie połączeń==
Dwa sposoby wykonywania połączeń:
* z zakładki '''Kontakty''' - wybieramy abonenta z odpowiedniej grupy (jeśli taka istnieje), bezpośrednio z grupy Wszystkie kontakty. Połączenie wykonujemy przez dotknięcie paska kontaktu wybierając z rozwijanego menu ikonę [[Plik:MessengerCTIM_outgoing.png|25px]]
* z zakładki '''Kontakty''' - bezpośrednio wpisując numer telefonu w polu '''Szukaj''' za pomocą klawiatury a następnie klikając dolny prawy róg klawiatury
<center>[[Plik:MessengerCTIM_out_ext1.png|700px]]</center>
* z zakładki '''Ostatnie''' - odnajdujemy abonenta, z którym mieliśmy kontakt (dzwonił do nas lub my do niego) a następnie połączenie wykonujemy przez dotknięcie paska kontaktu w środkowej części wybierając z rozwijanego menu odpowiednią akcję
<center>[[Plik:MessengerCTIM_out_number1.png|750px]]</center>
Zestawianie połączenia sygnalizowane jest ekranem połączenia jak dla zwykłych połączeń wykonywanych za pomocą linii GSM. Aplikacja zestawia w pierwszej kolejności połączenie do centrali na dedykowany numer dostępowy dla użytkowników '''MessengerCTI.Mobile''', konfigurowany przez administratora centrali. A następnie centrala tranzytem zestawia połączenie z numerem wybranym przez użytkownika '''MessengerCTI.Mobile'''. Z tego powodu w centrali wymaganym łączem miejskim co najmniej jest linia ISDN BRA.

==Połączenie przychodzące==
Połączenie przychodzące sygnalizowane wizualnie jest za pomocą wyskakującego okienka połączenia oraz akustycznie dzwonkiem skonfigurowanym w ustawieniach powiadomień. Połączenia odbieramy przez przesunięcie ikony z zieloną słuchawką. Jeśli połączenie ma być odrzucone to przesuwamy ikonę z czerwoną słuchawką. Dodatkowo jeśli mamy dodane numery podręczne możemy dane połączenie przychodzące przekazać na numer z listy przez przesunięcie ikony z numerem kontaktu podręcznego.
Proces odbierania połączeń przychodzących polega na wykonaniu połączenia zwrotnego do centrali za pomocą linii GSM na numer dostępowy aplikacji zdefiniowany przez administratora centrali.
<center>[[Plik:MessengerCTIM_incoming2.png|700px]]</center>

Nieodebrane połączenie symbolizowane jest ikoną [[Plik:MessengerCTIM_no_answer_qty.png|50px]]. Przejście do historii połączenia lub oddzwonienie powoduje wyczyszczenie informacji o ilości połączeń nieodebranych.

==Obsługa wiadomości==
Aplikacja umożliwia wysyłanie i przyjmowanie wiadomości tekstowych pomiędzy użytkownikami aplikacji MessengerCTI.Desktop/Mobile (czat wewnętrzny). Aby wysłać wiadomość czat klikamy w ikonę statusu aplikacji użytkownika lub z rozwijanego menu po kliknięciu w pasek z kontaktem wybieramy opcję '''chat'''. Otrzymanie nowej wiadomości sygnalizowane jest na pasku powiadomień odpowiednią ikoną oraz zdefiniowanym sygnałem dźwiękowym. 
Jeśli użytkownik używa obu wersji MessengeraCTI, historia wiadomości przechowywana jest także lokalnie w aplikacji '''''MessengerCTI.Desktop'''''.
 Poniżej przykładowe okno dialogowe wiadomości chat:

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

== Kontakty==
Zakładka kontakty umożliwia wyświetlanie i uruchamianie wybranych akcji związanych z kontaktem. Dostęp do numerów z pozostałych grup można uzyskać rozwijając listę pozostałych kontaktów pogrupowanych jako:
* ulubione
* wszystkie grupy
* wszystkie kontakty
* wewnętrzne
* zewnętrzne
* prywatne
Domyślnie widoczna jest grupa '''Ulubione'''.
<center>[[Plik:MessengerCTIM_contacts1.png|300px]]</center>

== Historia połączeń ==
Domyślnie wybrana zakładka '''Ostatnie''' w oknie głównym programu wyświetla historię połączeń jak i wiadomości czat. 
W historii każda pozycja oznacza co najmniej jedno połączenie lub wiadomość. Jeśli połączenie lub wiadomość pochodzi od tego samego użytkownika i jest ich więcej niż jedno, to przy odpowiedniej ikonie wyświetlana jest stosowna liczba. W każdej pozycji widoczny jest numer dzwoniącego, komentarz(jeśli jest on w książce numerów spoza centrali), czas i data realizacji połączenia. 
Jeśli w historii znajdują się nie przejrzane nieodebrane połączenia lub nieprzeczytane wiadomości to zakładka '''Ostatnie''' jest oznaczona czerwoną kropką. 
Z zakładki historii możliwe jest oddzwanianie lub wysyłanie wiadomości zwrotnych.

=Konfiguracja centrali Slican=
Do poprawnej współpracy aplikacji z centralą jest wymagane:
* odpowiednia licencja producenta
* specyficzna konfiguracja centrali
==Konfiguracja central IPx, CCT==
Za pomocą programu ConfgMAN:
* w menu '''''Globalne ustawienia->Globalne ustawienia/Pozostałe->ANo''''': skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji Abonenta menu '''''Abonenci->Abonenci/Ustawienia CTI
** '''AwdMbl''': włączyć zezwolenie na obsługę aplikacji
** '''MnNo''': skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja oraz ewentualnie drugi numer (dla telefonu z dual SIM)
** '''IncC''': ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 6.53.'''

==Konfiguracja centrali NCP==
Z poziomu aplikacji ConfigWEB
* w menu '''''Numery wewnętrzne->Ustawienia->Konfiguracja aplikacji CTI'''''" skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji abonenta SIP, FXS, CTS, Numer MessengerCTI w menu '''''Numery wewnętrzne->Abonenci->CTI ustawienia'''''
** skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja
** ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji i telefonu wewnętrznego central) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 1.11.'''

=Przykłady zastosowań=
Aplikacja '''''MessengerCTI.Mobile''''' może być atrakcyjnym narzędziem dla tych firm, które posiadają pracowników mobilnych z wymogiem ciągłego dostępu telefonicznego jako numer wewnętrzny danego systemu telefonicznego. 
Dobry przykładem mogą pracownicy:
* działu handlowego - z pracą w trybie mieszanym biuro <-> poza biurem
* działu serwisowego - z pracą ciągłą w terenie
* pracownicy zdalni - telepraca
* pracownicy mobilni - praca na dużym terenie (hale produkcyjne, obszary rozległe) - gdzie zasięg sieci typu WiFi lub DECT nie obejmuje takich obszarów.

Instrukcja obsługi MessengerCTI.Mobile

2019-04-08T07:46:18Z

Marekg: /* Ustawienia */

<center>[[Plik:messenger_2.png|250px]]</center>
= Wstęp =
Aplikacja Slican '''''MessengerCTI.Mobile''''' jest aplikacją mobilną przeznaczona na system '''Android''', który łączy w sobie możliwość wykonywania połączeń przychodzących jak i wychodzących, dostęp do książki telefonicznej, historii, podglądu statusu innych abonentów oraz chatu. 
Zawiera funkcjonalności umożliwiające integrację telefonu biurkowego i smartphone'a używanego przez abonenta centrali. 

Dużą zaletą tej aplikacji jest integracja książek kontaktów telefonicznych zapisanych w centrali. W '''''MessengerCTI.Mobile''''' wykorzystywane są zawsze książki zgromadzone w centrali, przy czym modyfikacja ich wpisów może być dokonywana tylko z telefonu systemowego jak i komputera przy użyciu programu '''''MessengerCTI.Desktop''''' lub aplikacji '''''WebCTI'''''. Ponadto program Slican '''''MessengerCTI.Mobile''''' posiada funkcjonalność komunikatora wewnętrznego - chatu. Użytkownikami komunikatora mogą być wszyscy abonenci danej centrali przy założeniu posiadania odpowiedniej licencji funkcjonalnej.
 
==Zalety aplikacji==
* aplikacja dostępna (bezpłatnie) w sklepie Google Play - wymagana jedynie po stronie centrali licencja CTI.plus
* książka kontaktów z podglądem stanu dostępności abonenta (czat, zajętości telefonu, opisu)
* dodawanie i usuwanie kontaktów z grupy ulubione, z pełną synchronizacją z aplikacją MessengerCTI.Desktop
* historia ostatnich połączeń/czatów posortowana chronologicznie
* logowanie jako telefonu równoległego do telefonu biurkowego lub jako osobny abonent MessengerCTI (tylko centrala NCP)
* komunikator czat
* historia czata połączona z historią połączeń telefonicznych
* połączenia głosowe przez GSM (dwie opcje zestawiania połączenia: przechwytywanie lub połączenie równoległe)
* elastyczne konfigurowanie powiadomień dźwiękowych
* dostęp do konfigurowania usług centrali na swoim telefonie
* numery podręczne do szybkiego przekazywania połączeń
* możliwość ustawiania zajętości telefonu biurkowego jeśli GSM zajęty (domyślnie włączone)
* możliwość ustawienia odrzucania wywołań na GSM jeśli telefon biurkowy zajęty
* możliwość kopiowania tekstu z chata
* możliwość obsługi smartphone'ów DualSIM lub dwóch telefonów jednocześnie (służbowy i prywatny)
* wygodne otwieranie drzwi jeśli dzwoni do nas bramofon DPH.IP oraz z menu kontekstowego dla kontaktu
* dodatkowy widget na pulpicie do szybkiego otwierania bramofonów DPH.IP
* automatyczny mechanizm opóźnienia powiadomienia na MessengerCTI.Mobile jeśli jestem aktywny na telefonie biurkowym lub MessengerCTI.Desktop
* możliwość kopiowania kontaktu z książki centrali telefonicznej do lokalnej książki telefonu

{{Uwaga|
Dla poprawnego działania aplikacji i połączeń wymagane są:
* stały dostęp do Internetu zarówno MessengerCTI.Mobile jak i centrali
* adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowany port 5529 TCP na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej
* w przypadku połączeń VoIP z aplikacji (wersja BETA) - adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowane porty 5060 UDP (sygnalizacja), 10000 - 20000 UDP (ramki głosowe RTP dla centrali NCP), 8100 - 8300 UDP (ramki głosowe RTP dla central IPx, MAC, CCT) na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej}}

= Wymagania minimalne =
Aplikacja '''''MessengerCTI.Mobile''''' - jest ogólnie dostępna do pobrania w sklepie Google Play.
W celu zainstalowania aplikacji spełnione muszą zostać następujące wymagania minimalne:
* system operacyjny Android - Android wersja systemu KitKat (4.4.4)
* dostęp do internetu dla aplikacji jak i centrali
Telefon z niższą wersją systemu Android nie będzie miał możliwości instalacji aplikacji.

{{Uwaga|
Aplikacja '''''MessengerCTI.Mobile''''' współpracuje z centralami IPx, MAC i CCT wyposażonymi w firmware co najmniej w wersji '''6.53''', oraz NCP '''1.11''' 
Obsługę VoIP w aplikacji w centralach IPx, MAC i CCT wprowadzono w wersji '''6.54''' oraz NCP '''1.12'''}} 

=Instalacja aplikacji =
Korzystanie z aplikacji '''''MessengerCTI.Mobile''''' jest licencjonowane więc wymaga wykupienia odpowiedniej licencji. Zakupiony kod jest wprowadzany w trakcie konfiguracji centrali i decyduje o ilości stanowisk, które mogą używać programu. Licencjonowanie aplikacji nie ma wpływu na jej instalację. Po zainstalowaniu aplikacji należy ją odpowiednio skonfigurować wprowadzając niezbędne dane do połączenia aplikacji z centralą: '''''Ustawienia->Konto''''' (opisane poniżej).

{{Uwaga|
Jeżeli numer wewnętrzny wprowadzony w ustawieniach nie posiada uprawnień do korzystania z aplikacji '''''MessengerCTI.Mobile''''' lub nie jest odpowiednio skonfigurowane konto CTI w centrali dla aplikacji mobilnej - nie będzie możliwości połączenia z centralą i synchronizacja danych.}}

== Uruchomienie aplikacji ==
Program '''''MessengerCTI.Mobile''''' uruchamia się identycznie jak każdy inny program w systemie operacyjnym Android. W trakcie uruchomienia następuje zalogowanie się programu do centrali (zgodnie z ustawieniami zakładce '''''Ustawienia->Konto'''''). Po pomyślnym zalogowaniu następuje synchronizacja danych programu z danymi w centrali (historii połączeń oraz czat).

== Konfiguracja aplikacji ==
Dla poprawnej komunikacji aplikacji z centralą należy skonfigurować dane konta CTI oraz pozostałe funkcje. Menu konfiguracji znajduje się w prawym górnym rogu okna aplikacji. Z rozwijanego menu wybieramy menu '''Ustawienia'''. 

==Ustawienia==

===Konto===
Zakładkę wypełniamy danymi do zalogowania aplikacji skonfigurowanymi przez administratora centrali:
* Twój numer telefonu: numer wewnętrzny telefonu użytkownika z odpowiednimi uprawnieniami dla komunikacji CTI
* Hasło: hasło użytkownika CTI
* Serwer: adres domenowy lub publiczny IP centrali dla użytkowników spoza sieci wewnętrznej lub prywatny dla użytkowników sieci lokalnej
* Zaawansowane/Port protokołu sygnalizacyjnego: port komunikacji z centralą - domyślnie dla centrali TCP 5529

===Powiadomienia===
Konfiguracja powiadomień połączeń przychodzących:
* dźwięk dzwonka: wybór jednego z listy dostępnych w aplikacji z możliwością wyciszenia go po określonym czasie
* wibracje przy dzwonku
* powiadomienie na pasku o nieodebranym połączeniu i wiadomości czat
Konfiguracja powiadomień wiadomości czat:
* dźwięk wiadomości: wybór jednego z listy dostępnych w aplikacji
* wibracje przy wiadomości
* powiadomienie na pasku o nowej wiadomości czat

===Numery podręczne===
Lista najważniejszych numerów podręcznych użytkownika wyświetlana podczas rozmowy w celu prostego przekazania połączenia.

===Inne===Rozwiązywanie problemów z poprawnym działaniem aplikacji:
* debug - opcja dla administratora włączana na prośbę dostawcy oprogramowania w przypadku analizy problemów
Włączenie opcji '''debug''' powoduje iż w Menu głównym ujawnia się dodatkowe pole '''''Wyślij log'''''. Dalej wybieramy klienta pocztowego, z którego wyślemy logi aplikacji do analizy po stronie producenta.

== Usługi ==
Konfiguracja usług aplikacji związanych z połączeniami:
* DND: nie przeszkadzać
* przekierowanie połączeń: wszystkie, gdy zajęty lub gdy nie odpowiada ze wskazaniem numeru na jaki ma być wykonane przekierowanie (należy pamiętać iż w pierwszej kolejności podaje numer a następnie aktywujemy przekierowanie)
* wycisz aplikację: tryb dyskretny

== Status ==
Ustawienie własnego opisu, który będzie widoczny dla pozostałych użytkowników aplikacji MessengerCTI oraz na ekranie telefonu systemowego CTS-330
== O programie ==
Informacje o:
* bieżącej wersji aplikacji
* typ centrali z jaką jest aplikacja połączona
* wersja oprogramowania centrali
* numer własny: numer konta CTI (numer wewnętrzny centrali)
* komentarz: opis własny numeru wewnętrznego

== Aktualizacja aplikacji ==
Aktualizacja programu jest dokonywana automatycznie a użytkownik ma wpływ na jej przebieg zgodnie z ustawieniami aktualizacji automatycznych aplikacji danego telefonu dla posiadaczy kont Google. Jeżeli w sklepie Google Play pojawi się nowa wersja następuje automatyczne pobranie nowszej wersji lub powiadomienie o niej.

= Struktura aplikacji =
==Okno główne ==
W oknie głównym aplikacji widoczne są dwie zakładki:
* '''Ostatnie''' - związane z historią połączeń i przesyłanych wiadomości wraz ze statusem abonenta centrali
* '''Kontakty''' - z dostępem do kontaktów książki telefonicznej centrali, z możliwością ich filtrowania: ulubione, wewnętrzne, zewnętrzne
* ikona statusu zalogowania wraz z opisem
* wyszukiwarka kontaktów
* menu ustawień aplikacji
<center>[[Plik:MessengerCTI_opis_new.png|800px]]</center>

== Ikono-grafika ==
W aplikacji '''''MessengerCTI.Mobile''''' przyjęto zasadę intuicyjnego oznaczania stanu telefonu za pomocą ikon widocznych w aplikacji przy każdym z kontaktów lub wpisie historii połączeń. Ikony te umożliwiają wykonywanie wybranej akcji, ocenienie stanu połączenia lub powiadamiają o występowaniu błędów.
=== Ikony i symbole ===
Okno startowe "Ostatnie" aplikacji pokazuje historię ostatnich połączeń. W tym widoku znajdują się ikony:
* po lewej stronie: status aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile lub historia połączeń
* po prawej: informujące o kierunku połączenia i statusie wiadomości czat 

W Tabeli 1 przedstawiono opis znaczenia poszczególnych ikon informujących o statusie aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile:
* dla abonentów wewnętrznych centrali - ikony symbolizujące stan zalogowania aplikacji a, dotknięcie ikony statusu pozwala rozpocząć czat lub sprawdzić historię połączeń
* dla bramofonów DPH.IP - aktualne położenie drzwi, a przez dotknięcie ikony symbolizującej drzwi wejście do historii
* dla kontaktów spoza centrali - sprawdzenie historii połączeń
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTID_free.png|40px]] ||użytkownik zalogowany
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_zaraz_wracam1.png|37px]] ||status: "Zaraz wracam"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_busy1.png]] ||użytkownik ustawił stan "Nie przeszkadzać"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_no_login.png|40px]] ||użytkownik niezalogowany, niedostępny lub status "Niewidoczny"
|-
|{{align|center}}|[[Plik:MessengerCTIMD_chat_free.png|40px]] || jeden z możliwych statusów aplikacji Desktop z skonfigurowaną aplikacją w wersji Mobile
|-
|{{align|center}}|[[Plik:MessengerCTIM_chat_DND.png|40px]] ||historia połączeń oraz wiadomości
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_open.png|40px]] ||bramofon DPH.IP: drzwi otwarte
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_closed.png|40px]] ||bramofon DPH.IP: drzwi zamknięte
|-
|}
'''''Tabela 1:''''' Ikony symbolizujące stany aplikacji, użytkowników i bramofonów. </center> 

W przypadku telefonów będących numerami wewnętrznymi centrali, pojawia się ikona symbolizująca stan telefonu.
<center>

{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_call.png|40px]] ||numer zajęty
|-
|{{align|center}}|[[Plik:MessengerCTIM_ringing.png|40px]] ||dzwonienie na numer lub wykonywanie połączenia wychodzącego z numeru
|-
|{{align|center}}|[[Plik:MessengerCTIM_failure1.png|40px]] ||numer niedostępny lub uszkodzony
|-
|{{align|center}}|[[Plik:MessengerCTIM_DND.png|40px]] ||włączona usługa DND
|-
|}
'''''Tabela 2:''''' Ikony symbolizujące stan telefonu. </center>

W tabeli 3 przedstawiono opis ikon związanych z połączeniami:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_call.png|40px]] ||połączenie przychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_call.png|40px]] ||połączenie wychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_qty.png|50px]] ||nowe nieodebrane połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer.png|45px]] ||połączenie nieodebrane
|-
|}

'''''Tabela 3:''''' Ikony symbolizujące połączenia. </center>

W tabeli 4 przedstawiono opis ikon związanych ze statusem wiadomości:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_chat.png|40px]] ||wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_chat.png|40px]] ||wiadomość wysłana (przeczytana)
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_chat.png|50px]] ||nowa wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_received_chat.png|45px]] ||wiadomość wysłana nieprzeczytana
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_read_chat_conf.png|40px]] ||wiadomość wysłana przeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_notread_chat_conf.png|40px]] ||wiadomość wysłana nieprzeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_unav_chat_conf.png|40px]] ||wiadomość wysłana do niezalogowanego użytkownika - widok w oknie dialogowym
|-
|}
'''''Tabela 4:''''' Ikony symbolizujące status wiadomości. </center>

W tabeli 5 przedstawiono opis powiadomień związanych z błędami w działaniu aplikacji. Powiadomienia widoczne są pod ikoną statusu
<center>
{|{{prettytable}}
!{{Hl1}}|Powiadomienie !!{{Hl1}}| Znaczenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_internet.png]] ||brak połączenia z internetem: sprawdź połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_auth.png]] || błędny login lub hasło: sprawdź ustawienia konta
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_licen.png]] || brak licencji do użytkowania aplikacji: skontaktuj się administratorem centrali
|-
|}
'''''Tabela 5''''': Znaczenie powiadomień o błędach.
</center>

=Obsługa połączeń i wiadomości=
Do przeprowadzenia rozmowy między użytkownikami, niezbędne jest zapewnienie:
* prawidłowej konfiguracji konta po stronie aplikacji oraz centrali
* połączenia aplikacja-centrala (pełna synchronizacja danych aplikacji z centralą) - ikona aplikacji powinna mieć kolor zielony
* zainstalowany telefon systemowy Slican, VoIP lub analogowy dla central IPx, CCT, MAC, NCP lub skonfigurowany abonent typu MessengerCTI (tylko centrala NCP)

==Wykonywanie połączeń==
Dwa sposoby wykonywania połączeń:
* z zakładki '''Kontakty''' - wybieramy abonenta z odpowiedniej grupy (jeśli taka istnieje), bezpośrednio z grupy Wszystkie kontakty. Połączenie wykonujemy przez dotknięcie paska kontaktu wybierając z rozwijanego menu ikonę [[Plik:MessengerCTIM_outgoing.png|25px]]
* z zakładki '''Kontakty''' - bezpośrednio wpisując numer telefonu w polu '''Szukaj''' za pomocą klawiatury a następnie klikając dolny prawy róg klawiatury
<center>[[Plik:MessengerCTIM_out_ext1.png|700px]]</center>
* z zakładki '''Ostatnie''' - odnajdujemy abonenta, z którym mieliśmy kontakt (dzwonił do nas lub my do niego) a następnie połączenie wykonujemy przez dotknięcie paska kontaktu w środkowej części wybierając z rozwijanego menu odpowiednią akcję
<center>[[Plik:MessengerCTIM_out_number1.png|750px]]</center>
Zestawianie połączenia sygnalizowane jest ekranem połączenia jak dla zwykłych połączeń wykonywanych za pomocą linii GSM. Aplikacja zestawia w pierwszej kolejności połączenie do centrali na dedykowany numer dostępowy dla użytkowników '''MessengerCTI.Mobile''', konfigurowany przez administratora centrali. A następnie centrala tranzytem zestawia połączenie z numerem wybranym przez użytkownika '''MessengerCTI.Mobile'''. Z tego powodu w centrali wymaganym łączem miejskim co najmniej jest linia ISDN BRA.

==Połączenie przychodzące==
Połączenie przychodzące sygnalizowane wizualnie jest za pomocą wyskakującego okienka połączenia oraz akustycznie dzwonkiem skonfigurowanym w ustawieniach powiadomień. Połączenia odbieramy przez przesunięcie ikony z zieloną słuchawką. Jeśli połączenie ma być odrzucone to przesuwamy ikonę z czerwoną słuchawką. Dodatkowo jeśli mamy dodane numery podręczne możemy dane połączenie przychodzące przekazać na numer z listy przez przesunięcie ikony z numerem kontaktu podręcznego.
Proces odbierania połączeń przychodzących polega na wykonaniu połączenia zwrotnego do centrali za pomocą linii GSM na numer dostępowy aplikacji zdefiniowany przez administratora centrali.
<center>[[Plik:MessengerCTIM_incoming2.png|700px]]</center>

Nieodebrane połączenie symbolizowane jest ikoną [[Plik:MessengerCTIM_no_answer_qty.png|50px]]. Przejście do historii połączenia lub oddzwonienie powoduje wyczyszczenie informacji o ilości połączeń nieodebranych.

==Obsługa wiadomości==
Aplikacja umożliwia wysyłanie i przyjmowanie wiadomości tekstowych pomiędzy użytkownikami aplikacji MessengerCTI.Desktop/Mobile (czat wewnętrzny). Aby wysłać wiadomość czat klikamy w ikonę statusu aplikacji użytkownika lub z rozwijanego menu po kliknięciu w pasek z kontaktem wybieramy opcję '''chat'''. Otrzymanie nowej wiadomości sygnalizowane jest na pasku powiadomień odpowiednią ikoną oraz zdefiniowanym sygnałem dźwiękowym. 
Jeśli użytkownik używa obu wersji MessengeraCTI, historia wiadomości przechowywana jest także lokalnie w aplikacji '''''MessengerCTI.Desktop'''''.
 Poniżej przykładowe okno dialogowe wiadomości chat:

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

== Kontakty==
Zakładka kontakty umożliwia wyświetlanie i uruchamianie wybranych akcji związanych z kontaktem. Dostęp do numerów z pozostałych grup można uzyskać rozwijając listę pozostałych kontaktów pogrupowanych jako:
* ulubione
* wszystkie grupy
* wszystkie kontakty
* wewnętrzne
* zewnętrzne
* prywatne
Domyślnie widoczna jest grupa '''Ulubione'''.
<center>[[Plik:MessengerCTIM_contacts1.png|300px]]</center>

== Historia połączeń ==
Domyślnie wybrana zakładka '''Ostatnie''' w oknie głównym programu wyświetla historię połączeń jak i wiadomości czat. 
W historii każda pozycja oznacza co najmniej jedno połączenie lub wiadomość. Jeśli połączenie lub wiadomość pochodzi od tego samego użytkownika i jest ich więcej niż jedno, to przy odpowiedniej ikonie wyświetlana jest stosowna liczba. W każdej pozycji widoczny jest numer dzwoniącego, komentarz(jeśli jest on w książce numerów spoza centrali), czas i data realizacji połączenia. 
Jeśli w historii znajdują się nie przejrzane nieodebrane połączenia lub nieprzeczytane wiadomości to zakładka '''Ostatnie''' jest oznaczona czerwoną kropką. 
Z zakładki historii możliwe jest oddzwanianie lub wysyłanie wiadomości zwrotnych.

=Konfiguracja centrali Slican=
Do poprawnej współpracy aplikacji z centralą jest wymagane:
* odpowiednia licencja producenta
* specyficzna konfiguracja centrali
==Konfiguracja central IPx, CCT==
Za pomocą programu ConfgMAN:
* w menu '''''Globalne ustawienia->Globalne ustawienia/Pozostałe->ANo''''': skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji Abonenta menu '''''Abonenci->Abonenci/Ustawienia CTI
** '''AwdMbl''': włączyć zezwolenie na obsługę aplikacji
** '''MnNo''': skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja oraz ewentualnie drugi numer (dla telefonu z dual SIM)
** '''IncC''': ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 6.53.'''

==Konfiguracja centrali NCP==
Z poziomu aplikacji ConfigWEB
* w menu '''''Numery wewnętrzne->Ustawienia->Konfiguracja aplikacji CTI'''''" skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji abonenta SIP, FXS, CTS, Numer MessengerCTI w menu '''''Numery wewnętrzne->Abonenci->CTI ustawienia'''''
** skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja
** ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji i telefonu wewnętrznego central) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 1.11.'''

=Przykłady zastosowań=
Aplikacja '''''MessengerCTI.Mobile''''' może być atrakcyjnym narzędziem dla tych firm, które posiadają pracowników mobilnych z wymogiem ciągłego dostępu telefonicznego jako numer wewnętrzny danego systemu telefonicznego. 
Dobry przykładem mogą pracownicy:
* działu handlowego - z pracą w trybie mieszanym biuro <-> poza biurem
* działu serwisowego - z pracą ciągłą w terenie
* pracownicy zdalni - telepraca
* pracownicy mobilni - praca na dużym terenie (hale produkcyjne, obszary rozległe) - gdzie zasięg sieci typu WiFi lub DECT nie obejmuje takich obszarów.

Instrukcja obsługi MessengerCTI.Mobile

2019-04-08T07:30:43Z

Marekg: /* Ustawienia */

<center>[[Plik:messenger_2.png|250px]]</center>
= Wstęp =
Aplikacja Slican '''''MessengerCTI.Mobile''''' jest aplikacją mobilną przeznaczona na system '''Android''', który łączy w sobie możliwość wykonywania połączeń przychodzących jak i wychodzących, dostęp do książki telefonicznej, historii, podglądu statusu innych abonentów oraz chatu. 
Zawiera funkcjonalności umożliwiające integrację telefonu biurkowego i smartphone'a używanego przez abonenta centrali. 

Dużą zaletą tej aplikacji jest integracja książek kontaktów telefonicznych zapisanych w centrali. W '''''MessengerCTI.Mobile''''' wykorzystywane są zawsze książki zgromadzone w centrali, przy czym modyfikacja ich wpisów może być dokonywana tylko z telefonu systemowego jak i komputera przy użyciu programu '''''MessengerCTI.Desktop''''' lub aplikacji '''''WebCTI'''''. Ponadto program Slican '''''MessengerCTI.Mobile''''' posiada funkcjonalność komunikatora wewnętrznego - chatu. Użytkownikami komunikatora mogą być wszyscy abonenci danej centrali przy założeniu posiadania odpowiedniej licencji funkcjonalnej.
 
==Zalety aplikacji==
* aplikacja dostępna (bezpłatnie) w sklepie Google Play - wymagana jedynie po stronie centrali licencja CTI.plus
* książka kontaktów z podglądem stanu dostępności abonenta (czat, zajętości telefonu, opisu)
* dodawanie i usuwanie kontaktów z grupy ulubione, z pełną synchronizacją z aplikacją MessengerCTI.Desktop
* historia ostatnich połączeń/czatów posortowana chronologicznie
* logowanie jako telefonu równoległego do telefonu biurkowego lub jako osobny abonent MessengerCTI (tylko centrala NCP)
* komunikator czat
* historia czata połączona z historią połączeń telefonicznych
* połączenia głosowe przez GSM (dwie opcje zestawiania połączenia: przechwytywanie lub połączenie równoległe)
* elastyczne konfigurowanie powiadomień dźwiękowych
* dostęp do konfigurowania usług centrali na swoim telefonie
* numery podręczne do szybkiego przekazywania połączeń
* możliwość ustawiania zajętości telefonu biurkowego jeśli GSM zajęty (domyślnie włączone)
* możliwość ustawienia odrzucania wywołań na GSM jeśli telefon biurkowy zajęty
* możliwość kopiowania tekstu z chata
* możliwość obsługi smartphone'ów DualSIM lub dwóch telefonów jednocześnie (służbowy i prywatny)
* wygodne otwieranie drzwi jeśli dzwoni do nas bramofon DPH.IP oraz z menu kontekstowego dla kontaktu
* dodatkowy widget na pulpicie do szybkiego otwierania bramofonów DPH.IP
* automatyczny mechanizm opóźnienia powiadomienia na MessengerCTI.Mobile jeśli jestem aktywny na telefonie biurkowym lub MessengerCTI.Desktop
* możliwość kopiowania kontaktu z książki centrali telefonicznej do lokalnej książki telefonu

{{Uwaga|
Dla poprawnego działania aplikacji i połączeń wymagane są:
* stały dostęp do Internetu zarówno MessengerCTI.Mobile jak i centrali
* adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowany port 5529 TCP na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej
* w przypadku połączeń VoIP z aplikacji (wersja BETA) - adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowane porty 5060 UDP (sygnalizacja), 10000 - 20000 UDP (ramki głosowe RTP dla centrali NCP), 8100 - 8300 UDP (ramki głosowe RTP dla central IPx, MAC, CCT) na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej}}

= Wymagania minimalne =
Aplikacja '''''MessengerCTI.Mobile''''' - jest ogólnie dostępna do pobrania w sklepie Google Play.
W celu zainstalowania aplikacji spełnione muszą zostać następujące wymagania minimalne:
* system operacyjny Android - Android wersja systemu KitKat (4.4.4)
* dostęp do internetu dla aplikacji jak i centrali
Telefon z niższą wersją systemu Android nie będzie miał możliwości instalacji aplikacji.

{{Uwaga|
Aplikacja '''''MessengerCTI.Mobile''''' współpracuje z centralami IPx, MAC i CCT wyposażonymi w firmware co najmniej w wersji '''6.53''', oraz NCP '''1.11''' 
Obsługę VoIP w aplikacji w centralach IPx, MAC i CCT wprowadzono w wersji '''6.54''' oraz NCP '''1.12'''}} 

=Instalacja aplikacji =
Korzystanie z aplikacji '''''MessengerCTI.Mobile''''' jest licencjonowane więc wymaga wykupienia odpowiedniej licencji. Zakupiony kod jest wprowadzany w trakcie konfiguracji centrali i decyduje o ilości stanowisk, które mogą używać programu. Licencjonowanie aplikacji nie ma wpływu na jej instalację. Po zainstalowaniu aplikacji należy ją odpowiednio skonfigurować wprowadzając niezbędne dane do połączenia aplikacji z centralą: '''''Ustawienia->Konto''''' (opisane poniżej).

{{Uwaga|
Jeżeli numer wewnętrzny wprowadzony w ustawieniach nie posiada uprawnień do korzystania z aplikacji '''''MessengerCTI.Mobile''''' lub nie jest odpowiednio skonfigurowane konto CTI w centrali dla aplikacji mobilnej - nie będzie możliwości połączenia z centralą i synchronizacja danych.}}

== Uruchomienie aplikacji ==
Program '''''MessengerCTI.Mobile''''' uruchamia się identycznie jak każdy inny program w systemie operacyjnym Android. W trakcie uruchomienia następuje zalogowanie się programu do centrali (zgodnie z ustawieniami zakładce '''''Ustawienia->Konto'''''). Po pomyślnym zalogowaniu następuje synchronizacja danych programu z danymi w centrali (historii połączeń oraz czat).

== Konfiguracja aplikacji ==
Dla poprawnej komunikacji aplikacji z centralą należy skonfigurować dane konta CTI oraz pozostałe funkcje. Menu konfiguracji znajduje się w prawym górnym rogu okna aplikacji. Z rozwijanego menu wybieramy menu '''Ustawienia'''. 

==Ustawienia==

===Konto===
Wypełniamy danymi do zalogowania aplikacji skonfigurowanymi przez administratora centrali:
* numer wyposażenia: numer wewnętrzny użytkownika z uprawnieniami dla komunikacji CTI
* hasło: hasło użytkownika CTI
* port: port komunikacji z centralą - domyślnie na centrali TCP 5529
* serwer: adres domenowy lub IP centrali lokalny lub publiczny dla użytkowników spoza sieci wewnętrznej

===Powiadomienia===
Konfiguracja powiadomień połączeń:
* dźwięk dzwonka: wybieramy z jeden z listy dostępnych w telefonie
* połączenia nieodebrane: powiadomienie na pasku
Konfiguracja powiadomień wiadomości czat:
* dźwięk wiadomości: wybieramy z jeden z listy dostępnych w telefonie

===Numery podręczne===
Lista numerów podręcznych dostępna podczas aktywnego połączenia celem szybkiego przekazania na numer z listy.

===Inne===
Konfiguracja zajętości telefonu w zależności od kierunku (połączenie z GSM lub z CTI) z jakiego przyszło połączenie:
* gdy rozmawia GSM to numer wewnętrzny będzie zajęty
* odrzucanie połączeń z GSM gdy wewnętrzny rozmawia
Rozwiązywanie problemów z poprawnym działaniem aplikacji:
* debug - opcja dla administratora włączana na prośbę dostawcy oprogramowania w przypadku analizy problemów
Włączenie opcji '''debug''' powoduje iż w Menu głównym ujawnia się dodatkowe pole '''''Wyślij log'''''. Dalej wybieramy klienta pocztowego, z którego wyślemy logi aplikacji do analizy po stornie producenta.

== Usługi ==
Konfiguracja usług aplikacji związanych z połączeniami:
* DND: nie przeszkadzać
* przekierowanie połączeń: wszystkie, gdy zajęty lub gdy nie odpowiada ze wskazaniem numeru na jaki ma być wykonane przekierowanie (należy pamiętać iż w pierwszej kolejności podaje numer a następnie aktywujemy przekierowanie)
* wycisz aplikację: tryb dyskretny

== Status ==
Ustawienie własnego opisu, który będzie widoczny dla pozostałych użytkowników aplikacji MessengerCTI oraz na ekranie telefonu systemowego CTS-330
== O programie ==
Informacje o:
* bieżącej wersji aplikacji
* typ centrali z jaką jest aplikacja połączona
* wersja oprogramowania centrali
* numer własny: numer konta CTI (numer wewnętrzny centrali)
* komentarz: opis własny numeru wewnętrznego

== Aktualizacja aplikacji ==
Aktualizacja programu jest dokonywana automatycznie a użytkownik ma wpływ na jej przebieg zgodnie z ustawieniami aktualizacji automatycznych aplikacji danego telefonu dla posiadaczy kont Google. Jeżeli w sklepie Google Play pojawi się nowa wersja następuje automatyczne pobranie nowszej wersji lub powiadomienie o niej.

= Struktura aplikacji =
==Okno główne ==
W oknie głównym aplikacji widoczne są dwie zakładki:
* '''Ostatnie''' - związane z historią połączeń i przesyłanych wiadomości wraz ze statusem abonenta centrali
* '''Kontakty''' - z dostępem do kontaktów książki telefonicznej centrali, z możliwością ich filtrowania: ulubione, wewnętrzne, zewnętrzne
* ikona statusu zalogowania wraz z opisem
* wyszukiwarka kontaktów
* menu ustawień aplikacji
<center>[[Plik:MessengerCTI_opis_new.png|800px]]</center>

== Ikono-grafika ==
W aplikacji '''''MessengerCTI.Mobile''''' przyjęto zasadę intuicyjnego oznaczania stanu telefonu za pomocą ikon widocznych w aplikacji przy każdym z kontaktów lub wpisie historii połączeń. Ikony te umożliwiają wykonywanie wybranej akcji, ocenienie stanu połączenia lub powiadamiają o występowaniu błędów.
=== Ikony i symbole ===
Okno startowe "Ostatnie" aplikacji pokazuje historię ostatnich połączeń. W tym widoku znajdują się ikony:
* po lewej stronie: status aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile lub historia połączeń
* po prawej: informujące o kierunku połączenia i statusie wiadomości czat 

W Tabeli 1 przedstawiono opis znaczenia poszczególnych ikon informujących o statusie aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile:
* dla abonentów wewnętrznych centrali - ikony symbolizujące stan zalogowania aplikacji a, dotknięcie ikony statusu pozwala rozpocząć czat lub sprawdzić historię połączeń
* dla bramofonów DPH.IP - aktualne położenie drzwi, a przez dotknięcie ikony symbolizującej drzwi wejście do historii
* dla kontaktów spoza centrali - sprawdzenie historii połączeń
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTID_free.png|40px]] ||użytkownik zalogowany
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_zaraz_wracam1.png|37px]] ||status: "Zaraz wracam"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_busy1.png]] ||użytkownik ustawił stan "Nie przeszkadzać"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_no_login.png|40px]] ||użytkownik niezalogowany, niedostępny lub status "Niewidoczny"
|-
|{{align|center}}|[[Plik:MessengerCTIMD_chat_free.png|40px]] || jeden z możliwych statusów aplikacji Desktop z skonfigurowaną aplikacją w wersji Mobile
|-
|{{align|center}}|[[Plik:MessengerCTIM_chat_DND.png|40px]] ||historia połączeń oraz wiadomości
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_open.png|40px]] ||bramofon DPH.IP: drzwi otwarte
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_closed.png|40px]] ||bramofon DPH.IP: drzwi zamknięte
|-
|}
'''''Tabela 1:''''' Ikony symbolizujące stany aplikacji, użytkowników i bramofonów. </center> 

W przypadku telefonów będących numerami wewnętrznymi centrali, pojawia się ikona symbolizująca stan telefonu.
<center>

{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_call.png|40px]] ||numer zajęty
|-
|{{align|center}}|[[Plik:MessengerCTIM_ringing.png|40px]] ||dzwonienie na numer lub wykonywanie połączenia wychodzącego z numeru
|-
|{{align|center}}|[[Plik:MessengerCTIM_failure1.png|40px]] ||numer niedostępny lub uszkodzony
|-
|{{align|center}}|[[Plik:MessengerCTIM_DND.png|40px]] ||włączona usługa DND
|-
|}
'''''Tabela 2:''''' Ikony symbolizujące stan telefonu. </center>

W tabeli 3 przedstawiono opis ikon związanych z połączeniami:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_call.png|40px]] ||połączenie przychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_call.png|40px]] ||połączenie wychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_qty.png|50px]] ||nowe nieodebrane połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer.png|45px]] ||połączenie nieodebrane
|-
|}

'''''Tabela 3:''''' Ikony symbolizujące połączenia. </center>

W tabeli 4 przedstawiono opis ikon związanych ze statusem wiadomości:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_chat.png|40px]] ||wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_chat.png|40px]] ||wiadomość wysłana (przeczytana)
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_chat.png|50px]] ||nowa wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_received_chat.png|45px]] ||wiadomość wysłana nieprzeczytana
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_read_chat_conf.png|40px]] ||wiadomość wysłana przeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_notread_chat_conf.png|40px]] ||wiadomość wysłana nieprzeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_unav_chat_conf.png|40px]] ||wiadomość wysłana do niezalogowanego użytkownika - widok w oknie dialogowym
|-
|}
'''''Tabela 4:''''' Ikony symbolizujące status wiadomości. </center>

W tabeli 5 przedstawiono opis powiadomień związanych z błędami w działaniu aplikacji. Powiadomienia widoczne są pod ikoną statusu
<center>
{|{{prettytable}}
!{{Hl1}}|Powiadomienie !!{{Hl1}}| Znaczenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_internet.png]] ||brak połączenia z internetem: sprawdź połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_auth.png]] || błędny login lub hasło: sprawdź ustawienia konta
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_licen.png]] || brak licencji do użytkowania aplikacji: skontaktuj się administratorem centrali
|-
|}
'''''Tabela 5''''': Znaczenie powiadomień o błędach.
</center>

=Obsługa połączeń i wiadomości=
Do przeprowadzenia rozmowy między użytkownikami, niezbędne jest zapewnienie:
* prawidłowej konfiguracji konta po stronie aplikacji oraz centrali
* połączenia aplikacja-centrala (pełna synchronizacja danych aplikacji z centralą) - ikona aplikacji powinna mieć kolor zielony
* zainstalowany telefon systemowy Slican, VoIP lub analogowy dla central IPx, CCT, MAC, NCP lub skonfigurowany abonent typu MessengerCTI (tylko centrala NCP)

==Wykonywanie połączeń==
Dwa sposoby wykonywania połączeń:
* z zakładki '''Kontakty''' - wybieramy abonenta z odpowiedniej grupy (jeśli taka istnieje), bezpośrednio z grupy Wszystkie kontakty. Połączenie wykonujemy przez dotknięcie paska kontaktu wybierając z rozwijanego menu ikonę [[Plik:MessengerCTIM_outgoing.png|25px]]
* z zakładki '''Kontakty''' - bezpośrednio wpisując numer telefonu w polu '''Szukaj''' za pomocą klawiatury a następnie klikając dolny prawy róg klawiatury
<center>[[Plik:MessengerCTIM_out_ext1.png|700px]]</center>
* z zakładki '''Ostatnie''' - odnajdujemy abonenta, z którym mieliśmy kontakt (dzwonił do nas lub my do niego) a następnie połączenie wykonujemy przez dotknięcie paska kontaktu w środkowej części wybierając z rozwijanego menu odpowiednią akcję
<center>[[Plik:MessengerCTIM_out_number1.png|750px]]</center>
Zestawianie połączenia sygnalizowane jest ekranem połączenia jak dla zwykłych połączeń wykonywanych za pomocą linii GSM. Aplikacja zestawia w pierwszej kolejności połączenie do centrali na dedykowany numer dostępowy dla użytkowników '''MessengerCTI.Mobile''', konfigurowany przez administratora centrali. A następnie centrala tranzytem zestawia połączenie z numerem wybranym przez użytkownika '''MessengerCTI.Mobile'''. Z tego powodu w centrali wymaganym łączem miejskim co najmniej jest linia ISDN BRA.

==Połączenie przychodzące==
Połączenie przychodzące sygnalizowane wizualnie jest za pomocą wyskakującego okienka połączenia oraz akustycznie dzwonkiem skonfigurowanym w ustawieniach powiadomień. Połączenia odbieramy przez przesunięcie ikony z zieloną słuchawką. Jeśli połączenie ma być odrzucone to przesuwamy ikonę z czerwoną słuchawką. Dodatkowo jeśli mamy dodane numery podręczne możemy dane połączenie przychodzące przekazać na numer z listy przez przesunięcie ikony z numerem kontaktu podręcznego.
Proces odbierania połączeń przychodzących polega na wykonaniu połączenia zwrotnego do centrali za pomocą linii GSM na numer dostępowy aplikacji zdefiniowany przez administratora centrali.
<center>[[Plik:MessengerCTIM_incoming2.png|700px]]</center>

Nieodebrane połączenie symbolizowane jest ikoną [[Plik:MessengerCTIM_no_answer_qty.png|50px]]. Przejście do historii połączenia lub oddzwonienie powoduje wyczyszczenie informacji o ilości połączeń nieodebranych.

==Obsługa wiadomości==
Aplikacja umożliwia wysyłanie i przyjmowanie wiadomości tekstowych pomiędzy użytkownikami aplikacji MessengerCTI.Desktop/Mobile (czat wewnętrzny). Aby wysłać wiadomość czat klikamy w ikonę statusu aplikacji użytkownika lub z rozwijanego menu po kliknięciu w pasek z kontaktem wybieramy opcję '''chat'''. Otrzymanie nowej wiadomości sygnalizowane jest na pasku powiadomień odpowiednią ikoną oraz zdefiniowanym sygnałem dźwiękowym. 
Jeśli użytkownik używa obu wersji MessengeraCTI, historia wiadomości przechowywana jest także lokalnie w aplikacji '''''MessengerCTI.Desktop'''''.
 Poniżej przykładowe okno dialogowe wiadomości chat:

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

== Kontakty==
Zakładka kontakty umożliwia wyświetlanie i uruchamianie wybranych akcji związanych z kontaktem. Dostęp do numerów z pozostałych grup można uzyskać rozwijając listę pozostałych kontaktów pogrupowanych jako:
* ulubione
* wszystkie grupy
* wszystkie kontakty
* wewnętrzne
* zewnętrzne
* prywatne
Domyślnie widoczna jest grupa '''Ulubione'''.
<center>[[Plik:MessengerCTIM_contacts1.png|300px]]</center>

== Historia połączeń ==
Domyślnie wybrana zakładka '''Ostatnie''' w oknie głównym programu wyświetla historię połączeń jak i wiadomości czat. 
W historii każda pozycja oznacza co najmniej jedno połączenie lub wiadomość. Jeśli połączenie lub wiadomość pochodzi od tego samego użytkownika i jest ich więcej niż jedno, to przy odpowiedniej ikonie wyświetlana jest stosowna liczba. W każdej pozycji widoczny jest numer dzwoniącego, komentarz(jeśli jest on w książce numerów spoza centrali), czas i data realizacji połączenia. 
Jeśli w historii znajdują się nie przejrzane nieodebrane połączenia lub nieprzeczytane wiadomości to zakładka '''Ostatnie''' jest oznaczona czerwoną kropką. 
Z zakładki historii możliwe jest oddzwanianie lub wysyłanie wiadomości zwrotnych.

=Konfiguracja centrali Slican=
Do poprawnej współpracy aplikacji z centralą jest wymagane:
* odpowiednia licencja producenta
* specyficzna konfiguracja centrali
==Konfiguracja central IPx, CCT==
Za pomocą programu ConfgMAN:
* w menu '''''Globalne ustawienia->Globalne ustawienia/Pozostałe->ANo''''': skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji Abonenta menu '''''Abonenci->Abonenci/Ustawienia CTI
** '''AwdMbl''': włączyć zezwolenie na obsługę aplikacji
** '''MnNo''': skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja oraz ewentualnie drugi numer (dla telefonu z dual SIM)
** '''IncC''': ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 6.53.'''

==Konfiguracja centrali NCP==
Z poziomu aplikacji ConfigWEB
* w menu '''''Numery wewnętrzne->Ustawienia->Konfiguracja aplikacji CTI'''''" skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji abonenta SIP, FXS, CTS, Numer MessengerCTI w menu '''''Numery wewnętrzne->Abonenci->CTI ustawienia'''''
** skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja
** ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji i telefonu wewnętrznego central) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 1.11.'''

=Przykłady zastosowań=
Aplikacja '''''MessengerCTI.Mobile''''' może być atrakcyjnym narzędziem dla tych firm, które posiadają pracowników mobilnych z wymogiem ciągłego dostępu telefonicznego jako numer wewnętrzny danego systemu telefonicznego. 
Dobry przykładem mogą pracownicy:
* działu handlowego - z pracą w trybie mieszanym biuro <-> poza biurem
* działu serwisowego - z pracą ciągłą w terenie
* pracownicy zdalni - telepraca
* pracownicy mobilni - praca na dużym terenie (hale produkcyjne, obszary rozległe) - gdzie zasięg sieci typu WiFi lub DECT nie obejmuje takich obszarów.

Instrukcja obsługi MessengerCTI.Mobile

2019-04-08T07:22:22Z

Marekg: /* Konfiguracja aplikacji */

<center>[[Plik:messenger_2.png|250px]]</center>
= Wstęp =
Aplikacja Slican '''''MessengerCTI.Mobile''''' jest aplikacją mobilną przeznaczona na system '''Android''', który łączy w sobie możliwość wykonywania połączeń przychodzących jak i wychodzących, dostęp do książki telefonicznej, historii, podglądu statusu innych abonentów oraz chatu. 
Zawiera funkcjonalności umożliwiające integrację telefonu biurkowego i smartphone'a używanego przez abonenta centrali. 

Dużą zaletą tej aplikacji jest integracja książek kontaktów telefonicznych zapisanych w centrali. W '''''MessengerCTI.Mobile''''' wykorzystywane są zawsze książki zgromadzone w centrali, przy czym modyfikacja ich wpisów może być dokonywana tylko z telefonu systemowego jak i komputera przy użyciu programu '''''MessengerCTI.Desktop''''' lub aplikacji '''''WebCTI'''''. Ponadto program Slican '''''MessengerCTI.Mobile''''' posiada funkcjonalność komunikatora wewnętrznego - chatu. Użytkownikami komunikatora mogą być wszyscy abonenci danej centrali przy założeniu posiadania odpowiedniej licencji funkcjonalnej.
 
==Zalety aplikacji==
* aplikacja dostępna (bezpłatnie) w sklepie Google Play - wymagana jedynie po stronie centrali licencja CTI.plus
* książka kontaktów z podglądem stanu dostępności abonenta (czat, zajętości telefonu, opisu)
* dodawanie i usuwanie kontaktów z grupy ulubione, z pełną synchronizacją z aplikacją MessengerCTI.Desktop
* historia ostatnich połączeń/czatów posortowana chronologicznie
* logowanie jako telefonu równoległego do telefonu biurkowego lub jako osobny abonent MessengerCTI (tylko centrala NCP)
* komunikator czat
* historia czata połączona z historią połączeń telefonicznych
* połączenia głosowe przez GSM (dwie opcje zestawiania połączenia: przechwytywanie lub połączenie równoległe)
* elastyczne konfigurowanie powiadomień dźwiękowych
* dostęp do konfigurowania usług centrali na swoim telefonie
* numery podręczne do szybkiego przekazywania połączeń
* możliwość ustawiania zajętości telefonu biurkowego jeśli GSM zajęty (domyślnie włączone)
* możliwość ustawienia odrzucania wywołań na GSM jeśli telefon biurkowy zajęty
* możliwość kopiowania tekstu z chata
* możliwość obsługi smartphone'ów DualSIM lub dwóch telefonów jednocześnie (służbowy i prywatny)
* wygodne otwieranie drzwi jeśli dzwoni do nas bramofon DPH.IP oraz z menu kontekstowego dla kontaktu
* dodatkowy widget na pulpicie do szybkiego otwierania bramofonów DPH.IP
* automatyczny mechanizm opóźnienia powiadomienia na MessengerCTI.Mobile jeśli jestem aktywny na telefonie biurkowym lub MessengerCTI.Desktop
* możliwość kopiowania kontaktu z książki centrali telefonicznej do lokalnej książki telefonu

{{Uwaga|
Dla poprawnego działania aplikacji i połączeń wymagane są:
* stały dostęp do Internetu zarówno MessengerCTI.Mobile jak i centrali
* adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowany port 5529 TCP na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej
* w przypadku połączeń VoIP z aplikacji (wersja BETA) - adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowane porty 5060 UDP (sygnalizacja), 10000 - 20000 UDP (ramki głosowe RTP dla centrali NCP), 8100 - 8300 UDP (ramki głosowe RTP dla central IPx, MAC, CCT) na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej}}

= Wymagania minimalne =
Aplikacja '''''MessengerCTI.Mobile''''' - jest ogólnie dostępna do pobrania w sklepie Google Play.
W celu zainstalowania aplikacji spełnione muszą zostać następujące wymagania minimalne:
* system operacyjny Android - Android wersja systemu KitKat (4.4.4)
* dostęp do internetu dla aplikacji jak i centrali
Telefon z niższą wersją systemu Android nie będzie miał możliwości instalacji aplikacji.

{{Uwaga|
Aplikacja '''''MessengerCTI.Mobile''''' współpracuje z centralami IPx, MAC i CCT wyposażonymi w firmware co najmniej w wersji '''6.53''', oraz NCP '''1.11''' 
Obsługę VoIP w aplikacji w centralach IPx, MAC i CCT wprowadzono w wersji '''6.54''' oraz NCP '''1.12'''}} 

=Instalacja aplikacji =
Korzystanie z aplikacji '''''MessengerCTI.Mobile''''' jest licencjonowane więc wymaga wykupienia odpowiedniej licencji. Zakupiony kod jest wprowadzany w trakcie konfiguracji centrali i decyduje o ilości stanowisk, które mogą używać programu. Licencjonowanie aplikacji nie ma wpływu na jej instalację. Po zainstalowaniu aplikacji należy ją odpowiednio skonfigurować wprowadzając niezbędne dane do połączenia aplikacji z centralą: '''''Ustawienia->Konto''''' (opisane poniżej).

{{Uwaga|
Jeżeli numer wewnętrzny wprowadzony w ustawieniach nie posiada uprawnień do korzystania z aplikacji '''''MessengerCTI.Mobile''''' lub nie jest odpowiednio skonfigurowane konto CTI w centrali dla aplikacji mobilnej - nie będzie możliwości połączenia z centralą i synchronizacja danych.}}

== Uruchomienie aplikacji ==
Program '''''MessengerCTI.Mobile''''' uruchamia się identycznie jak każdy inny program w systemie operacyjnym Android. W trakcie uruchomienia następuje zalogowanie się programu do centrali (zgodnie z ustawieniami zakładce '''''Ustawienia->Konto'''''). Po pomyślnym zalogowaniu następuje synchronizacja danych programu z danymi w centrali (historii połączeń oraz czat).

== Konfiguracja aplikacji ==
Dla poprawnej komunikacji aplikacji z centralą należy skonfigurować dane konta CTI oraz pozostałe funkcje. Menu konfiguracji znajduje się w prawym górnym rogu okna aplikacji. Z rozwijanego menu wybieramy menu '''Ustawienia'''. 

==Ustawienia==

Znajdziemy tu wymagane pola do konfiguracji: konta, powiadomień, numerów podręcznych.
===Konto===
Wypełniamy danymi do zalogowania aplikacji skonfigurowanymi przez administratora centrali:
* numer wyposażenia: numer wewnętrzny użytkownika z uprawnieniami dla komunikacji CTI
* hasło: hasło użytkownika CTI
* port: port komunikacji z centralą - domyślnie na centrali TCP 5529
* serwer: adres domenowy lub IP centrali lokalny lub publiczny dla użytkowników spoza sieci wewnętrznej

===Powiadomienia===
Konfiguracja powiadomień połączeń:
* dźwięk dzwonka: wybieramy z jeden z listy dostępnych w telefonie
* połączenia nieodebrane: powiadomienie na pasku
Konfiguracja powiadomień wiadomości czat:
* dźwięk wiadomości: wybieramy z jeden z listy dostępnych w telefonie

===Numery podręczne===
Lista numerów podręcznych dostępna podczas aktywnego połączenia celem szybkiego przekazania na numer z listy.

===Inne===
Konfiguracja zajętości telefonu w zależności od kierunku (połączenie z GSM lub z CTI) z jakiego przyszło połączenie:
* gdy rozmawia GSM to numer wewnętrzny będzie zajęty
* odrzucanie połączeń z GSM gdy wewnętrzny rozmawia
Rozwiązywanie problemów z poprawnym działaniem aplikacji:
* debug - opcja dla administratora włączana na prośbę dostawcy oprogramowania w przypadku analizy problemów
Włączenie opcji '''debug''' powoduje iż w Menu głównym ujawnia się dodatkowe pole '''''Wyślij log'''''. Dalej wybieramy klienta pocztowego, z którego wyślemy logi aplikacji do analizy po stornie producenta.

== Usługi ==
Konfiguracja usług aplikacji związanych z połączeniami:
* DND: nie przeszkadzać
* przekierowanie połączeń: wszystkie, gdy zajęty lub gdy nie odpowiada ze wskazaniem numeru na jaki ma być wykonane przekierowanie (należy pamiętać iż w pierwszej kolejności podaje numer a następnie aktywujemy przekierowanie)
* wycisz aplikację: tryb dyskretny

== Status ==
Ustawienie własnego opisu, który będzie widoczny dla pozostałych użytkowników aplikacji MessengerCTI oraz na ekranie telefonu systemowego CTS-330
== O programie ==
Informacje o:
* bieżącej wersji aplikacji
* typ centrali z jaką jest aplikacja połączona
* wersja oprogramowania centrali
* numer własny: numer konta CTI (numer wewnętrzny centrali)
* komentarz: opis własny numeru wewnętrznego

== Aktualizacja aplikacji ==
Aktualizacja programu jest dokonywana automatycznie a użytkownik ma wpływ na jej przebieg zgodnie z ustawieniami aktualizacji automatycznych aplikacji danego telefonu dla posiadaczy kont Google. Jeżeli w sklepie Google Play pojawi się nowa wersja następuje automatyczne pobranie nowszej wersji lub powiadomienie o niej.

= Struktura aplikacji =
==Okno główne ==
W oknie głównym aplikacji widoczne są dwie zakładki:
* '''Ostatnie''' - związane z historią połączeń i przesyłanych wiadomości wraz ze statusem abonenta centrali
* '''Kontakty''' - z dostępem do kontaktów książki telefonicznej centrali, z możliwością ich filtrowania: ulubione, wewnętrzne, zewnętrzne
* ikona statusu zalogowania wraz z opisem
* wyszukiwarka kontaktów
* menu ustawień aplikacji
<center>[[Plik:MessengerCTI_opis_new.png|800px]]</center>

== Ikono-grafika ==
W aplikacji '''''MessengerCTI.Mobile''''' przyjęto zasadę intuicyjnego oznaczania stanu telefonu za pomocą ikon widocznych w aplikacji przy każdym z kontaktów lub wpisie historii połączeń. Ikony te umożliwiają wykonywanie wybranej akcji, ocenienie stanu połączenia lub powiadamiają o występowaniu błędów.
=== Ikony i symbole ===
Okno startowe "Ostatnie" aplikacji pokazuje historię ostatnich połączeń. W tym widoku znajdują się ikony:
* po lewej stronie: status aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile lub historia połączeń
* po prawej: informujące o kierunku połączenia i statusie wiadomości czat 

W Tabeli 1 przedstawiono opis znaczenia poszczególnych ikon informujących o statusie aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile:
* dla abonentów wewnętrznych centrali - ikony symbolizujące stan zalogowania aplikacji a, dotknięcie ikony statusu pozwala rozpocząć czat lub sprawdzić historię połączeń
* dla bramofonów DPH.IP - aktualne położenie drzwi, a przez dotknięcie ikony symbolizującej drzwi wejście do historii
* dla kontaktów spoza centrali - sprawdzenie historii połączeń
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTID_free.png|40px]] ||użytkownik zalogowany
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_zaraz_wracam1.png|37px]] ||status: "Zaraz wracam"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_busy1.png]] ||użytkownik ustawił stan "Nie przeszkadzać"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_no_login.png|40px]] ||użytkownik niezalogowany, niedostępny lub status "Niewidoczny"
|-
|{{align|center}}|[[Plik:MessengerCTIMD_chat_free.png|40px]] || jeden z możliwych statusów aplikacji Desktop z skonfigurowaną aplikacją w wersji Mobile
|-
|{{align|center}}|[[Plik:MessengerCTIM_chat_DND.png|40px]] ||historia połączeń oraz wiadomości
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_open.png|40px]] ||bramofon DPH.IP: drzwi otwarte
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_closed.png|40px]] ||bramofon DPH.IP: drzwi zamknięte
|-
|}
'''''Tabela 1:''''' Ikony symbolizujące stany aplikacji, użytkowników i bramofonów. </center> 

W przypadku telefonów będących numerami wewnętrznymi centrali, pojawia się ikona symbolizująca stan telefonu.
<center>

{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_call.png|40px]] ||numer zajęty
|-
|{{align|center}}|[[Plik:MessengerCTIM_ringing.png|40px]] ||dzwonienie na numer lub wykonywanie połączenia wychodzącego z numeru
|-
|{{align|center}}|[[Plik:MessengerCTIM_failure1.png|40px]] ||numer niedostępny lub uszkodzony
|-
|{{align|center}}|[[Plik:MessengerCTIM_DND.png|40px]] ||włączona usługa DND
|-
|}
'''''Tabela 2:''''' Ikony symbolizujące stan telefonu. </center>

W tabeli 3 przedstawiono opis ikon związanych z połączeniami:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_call.png|40px]] ||połączenie przychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_call.png|40px]] ||połączenie wychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_qty.png|50px]] ||nowe nieodebrane połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer.png|45px]] ||połączenie nieodebrane
|-
|}

'''''Tabela 3:''''' Ikony symbolizujące połączenia. </center>

W tabeli 4 przedstawiono opis ikon związanych ze statusem wiadomości:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_chat.png|40px]] ||wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_chat.png|40px]] ||wiadomość wysłana (przeczytana)
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_chat.png|50px]] ||nowa wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_received_chat.png|45px]] ||wiadomość wysłana nieprzeczytana
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_read_chat_conf.png|40px]] ||wiadomość wysłana przeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_notread_chat_conf.png|40px]] ||wiadomość wysłana nieprzeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_unav_chat_conf.png|40px]] ||wiadomość wysłana do niezalogowanego użytkownika - widok w oknie dialogowym
|-
|}
'''''Tabela 4:''''' Ikony symbolizujące status wiadomości. </center>

W tabeli 5 przedstawiono opis powiadomień związanych z błędami w działaniu aplikacji. Powiadomienia widoczne są pod ikoną statusu
<center>
{|{{prettytable}}
!{{Hl1}}|Powiadomienie !!{{Hl1}}| Znaczenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_internet.png]] ||brak połączenia z internetem: sprawdź połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_auth.png]] || błędny login lub hasło: sprawdź ustawienia konta
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_licen.png]] || brak licencji do użytkowania aplikacji: skontaktuj się administratorem centrali
|-
|}
'''''Tabela 5''''': Znaczenie powiadomień o błędach.
</center>

=Obsługa połączeń i wiadomości=
Do przeprowadzenia rozmowy między użytkownikami, niezbędne jest zapewnienie:
* prawidłowej konfiguracji konta po stronie aplikacji oraz centrali
* połączenia aplikacja-centrala (pełna synchronizacja danych aplikacji z centralą) - ikona aplikacji powinna mieć kolor zielony
* zainstalowany telefon systemowy Slican, VoIP lub analogowy dla central IPx, CCT, MAC, NCP lub skonfigurowany abonent typu MessengerCTI (tylko centrala NCP)

==Wykonywanie połączeń==
Dwa sposoby wykonywania połączeń:
* z zakładki '''Kontakty''' - wybieramy abonenta z odpowiedniej grupy (jeśli taka istnieje), bezpośrednio z grupy Wszystkie kontakty. Połączenie wykonujemy przez dotknięcie paska kontaktu wybierając z rozwijanego menu ikonę [[Plik:MessengerCTIM_outgoing.png|25px]]
* z zakładki '''Kontakty''' - bezpośrednio wpisując numer telefonu w polu '''Szukaj''' za pomocą klawiatury a następnie klikając dolny prawy róg klawiatury
<center>[[Plik:MessengerCTIM_out_ext1.png|700px]]</center>
* z zakładki '''Ostatnie''' - odnajdujemy abonenta, z którym mieliśmy kontakt (dzwonił do nas lub my do niego) a następnie połączenie wykonujemy przez dotknięcie paska kontaktu w środkowej części wybierając z rozwijanego menu odpowiednią akcję
<center>[[Plik:MessengerCTIM_out_number1.png|750px]]</center>
Zestawianie połączenia sygnalizowane jest ekranem połączenia jak dla zwykłych połączeń wykonywanych za pomocą linii GSM. Aplikacja zestawia w pierwszej kolejności połączenie do centrali na dedykowany numer dostępowy dla użytkowników '''MessengerCTI.Mobile''', konfigurowany przez administratora centrali. A następnie centrala tranzytem zestawia połączenie z numerem wybranym przez użytkownika '''MessengerCTI.Mobile'''. Z tego powodu w centrali wymaganym łączem miejskim co najmniej jest linia ISDN BRA.

==Połączenie przychodzące==
Połączenie przychodzące sygnalizowane wizualnie jest za pomocą wyskakującego okienka połączenia oraz akustycznie dzwonkiem skonfigurowanym w ustawieniach powiadomień. Połączenia odbieramy przez przesunięcie ikony z zieloną słuchawką. Jeśli połączenie ma być odrzucone to przesuwamy ikonę z czerwoną słuchawką. Dodatkowo jeśli mamy dodane numery podręczne możemy dane połączenie przychodzące przekazać na numer z listy przez przesunięcie ikony z numerem kontaktu podręcznego.
Proces odbierania połączeń przychodzących polega na wykonaniu połączenia zwrotnego do centrali za pomocą linii GSM na numer dostępowy aplikacji zdefiniowany przez administratora centrali.
<center>[[Plik:MessengerCTIM_incoming2.png|700px]]</center>

Nieodebrane połączenie symbolizowane jest ikoną [[Plik:MessengerCTIM_no_answer_qty.png|50px]]. Przejście do historii połączenia lub oddzwonienie powoduje wyczyszczenie informacji o ilości połączeń nieodebranych.

==Obsługa wiadomości==
Aplikacja umożliwia wysyłanie i przyjmowanie wiadomości tekstowych pomiędzy użytkownikami aplikacji MessengerCTI.Desktop/Mobile (czat wewnętrzny). Aby wysłać wiadomość czat klikamy w ikonę statusu aplikacji użytkownika lub z rozwijanego menu po kliknięciu w pasek z kontaktem wybieramy opcję '''chat'''. Otrzymanie nowej wiadomości sygnalizowane jest na pasku powiadomień odpowiednią ikoną oraz zdefiniowanym sygnałem dźwiękowym. 
Jeśli użytkownik używa obu wersji MessengeraCTI, historia wiadomości przechowywana jest także lokalnie w aplikacji '''''MessengerCTI.Desktop'''''.
 Poniżej przykładowe okno dialogowe wiadomości chat:

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

== Kontakty==
Zakładka kontakty umożliwia wyświetlanie i uruchamianie wybranych akcji związanych z kontaktem. Dostęp do numerów z pozostałych grup można uzyskać rozwijając listę pozostałych kontaktów pogrupowanych jako:
* ulubione
* wszystkie grupy
* wszystkie kontakty
* wewnętrzne
* zewnętrzne
* prywatne
Domyślnie widoczna jest grupa '''Ulubione'''.
<center>[[Plik:MessengerCTIM_contacts1.png|300px]]</center>

== Historia połączeń ==
Domyślnie wybrana zakładka '''Ostatnie''' w oknie głównym programu wyświetla historię połączeń jak i wiadomości czat. 
W historii każda pozycja oznacza co najmniej jedno połączenie lub wiadomość. Jeśli połączenie lub wiadomość pochodzi od tego samego użytkownika i jest ich więcej niż jedno, to przy odpowiedniej ikonie wyświetlana jest stosowna liczba. W każdej pozycji widoczny jest numer dzwoniącego, komentarz(jeśli jest on w książce numerów spoza centrali), czas i data realizacji połączenia. 
Jeśli w historii znajdują się nie przejrzane nieodebrane połączenia lub nieprzeczytane wiadomości to zakładka '''Ostatnie''' jest oznaczona czerwoną kropką. 
Z zakładki historii możliwe jest oddzwanianie lub wysyłanie wiadomości zwrotnych.

=Konfiguracja centrali Slican=
Do poprawnej współpracy aplikacji z centralą jest wymagane:
* odpowiednia licencja producenta
* specyficzna konfiguracja centrali
==Konfiguracja central IPx, CCT==
Za pomocą programu ConfgMAN:
* w menu '''''Globalne ustawienia->Globalne ustawienia/Pozostałe->ANo''''': skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji Abonenta menu '''''Abonenci->Abonenci/Ustawienia CTI
** '''AwdMbl''': włączyć zezwolenie na obsługę aplikacji
** '''MnNo''': skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja oraz ewentualnie drugi numer (dla telefonu z dual SIM)
** '''IncC''': ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 6.53.'''

==Konfiguracja centrali NCP==
Z poziomu aplikacji ConfigWEB
* w menu '''''Numery wewnętrzne->Ustawienia->Konfiguracja aplikacji CTI'''''" skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji abonenta SIP, FXS, CTS, Numer MessengerCTI w menu '''''Numery wewnętrzne->Abonenci->CTI ustawienia'''''
** skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja
** ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji i telefonu wewnętrznego central) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 1.11.'''

=Przykłady zastosowań=
Aplikacja '''''MessengerCTI.Mobile''''' może być atrakcyjnym narzędziem dla tych firm, które posiadają pracowników mobilnych z wymogiem ciągłego dostępu telefonicznego jako numer wewnętrzny danego systemu telefonicznego. 
Dobry przykładem mogą pracownicy:
* działu handlowego - z pracą w trybie mieszanym biuro <-> poza biurem
* działu serwisowego - z pracą ciągłą w terenie
* pracownicy zdalni - telepraca
* pracownicy mobilni - praca na dużym terenie (hale produkcyjne, obszary rozległe) - gdzie zasięg sieci typu WiFi lub DECT nie obejmuje takich obszarów.

Instrukcja obsługi MessengerCTI.Mobile

2019-04-08T07:20:30Z

Marekg: /* Wymagania minimalne */

<center>[[Plik:messenger_2.png|250px]]</center>
= Wstęp =
Aplikacja Slican '''''MessengerCTI.Mobile''''' jest aplikacją mobilną przeznaczona na system '''Android''', który łączy w sobie możliwość wykonywania połączeń przychodzących jak i wychodzących, dostęp do książki telefonicznej, historii, podglądu statusu innych abonentów oraz chatu. 
Zawiera funkcjonalności umożliwiające integrację telefonu biurkowego i smartphone'a używanego przez abonenta centrali. 

Dużą zaletą tej aplikacji jest integracja książek kontaktów telefonicznych zapisanych w centrali. W '''''MessengerCTI.Mobile''''' wykorzystywane są zawsze książki zgromadzone w centrali, przy czym modyfikacja ich wpisów może być dokonywana tylko z telefonu systemowego jak i komputera przy użyciu programu '''''MessengerCTI.Desktop''''' lub aplikacji '''''WebCTI'''''. Ponadto program Slican '''''MessengerCTI.Mobile''''' posiada funkcjonalność komunikatora wewnętrznego - chatu. Użytkownikami komunikatora mogą być wszyscy abonenci danej centrali przy założeniu posiadania odpowiedniej licencji funkcjonalnej.
 
==Zalety aplikacji==
* aplikacja dostępna (bezpłatnie) w sklepie Google Play - wymagana jedynie po stronie centrali licencja CTI.plus
* książka kontaktów z podglądem stanu dostępności abonenta (czat, zajętości telefonu, opisu)
* dodawanie i usuwanie kontaktów z grupy ulubione, z pełną synchronizacją z aplikacją MessengerCTI.Desktop
* historia ostatnich połączeń/czatów posortowana chronologicznie
* logowanie jako telefonu równoległego do telefonu biurkowego lub jako osobny abonent MessengerCTI (tylko centrala NCP)
* komunikator czat
* historia czata połączona z historią połączeń telefonicznych
* połączenia głosowe przez GSM (dwie opcje zestawiania połączenia: przechwytywanie lub połączenie równoległe)
* elastyczne konfigurowanie powiadomień dźwiękowych
* dostęp do konfigurowania usług centrali na swoim telefonie
* numery podręczne do szybkiego przekazywania połączeń
* możliwość ustawiania zajętości telefonu biurkowego jeśli GSM zajęty (domyślnie włączone)
* możliwość ustawienia odrzucania wywołań na GSM jeśli telefon biurkowy zajęty
* możliwość kopiowania tekstu z chata
* możliwość obsługi smartphone'ów DualSIM lub dwóch telefonów jednocześnie (służbowy i prywatny)
* wygodne otwieranie drzwi jeśli dzwoni do nas bramofon DPH.IP oraz z menu kontekstowego dla kontaktu
* dodatkowy widget na pulpicie do szybkiego otwierania bramofonów DPH.IP
* automatyczny mechanizm opóźnienia powiadomienia na MessengerCTI.Mobile jeśli jestem aktywny na telefonie biurkowym lub MessengerCTI.Desktop
* możliwość kopiowania kontaktu z książki centrali telefonicznej do lokalnej książki telefonu

{{Uwaga|
Dla poprawnego działania aplikacji i połączeń wymagane są:
* stały dostęp do Internetu zarówno MessengerCTI.Mobile jak i centrali
* adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowany port 5529 TCP na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej
* w przypadku połączeń VoIP z aplikacji (wersja BETA) - adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowane porty 5060 UDP (sygnalizacja), 10000 - 20000 UDP (ramki głosowe RTP dla centrali NCP), 8100 - 8300 UDP (ramki głosowe RTP dla central IPx, MAC, CCT) na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej}}

= Wymagania minimalne =
Aplikacja '''''MessengerCTI.Mobile''''' - jest ogólnie dostępna do pobrania w sklepie Google Play.
W celu zainstalowania aplikacji spełnione muszą zostać następujące wymagania minimalne:
* system operacyjny Android - Android wersja systemu KitKat (4.4.4)
* dostęp do internetu dla aplikacji jak i centrali
Telefon z niższą wersją systemu Android nie będzie miał możliwości instalacji aplikacji.

{{Uwaga|
Aplikacja '''''MessengerCTI.Mobile''''' współpracuje z centralami IPx, MAC i CCT wyposażonymi w firmware co najmniej w wersji '''6.53''', oraz NCP '''1.11''' 
Obsługę VoIP w aplikacji w centralach IPx, MAC i CCT wprowadzono w wersji '''6.54''' oraz NCP '''1.12'''}} 

=Instalacja aplikacji =
Korzystanie z aplikacji '''''MessengerCTI.Mobile''''' jest licencjonowane więc wymaga wykupienia odpowiedniej licencji. Zakupiony kod jest wprowadzany w trakcie konfiguracji centrali i decyduje o ilości stanowisk, które mogą używać programu. Licencjonowanie aplikacji nie ma wpływu na jej instalację. Po zainstalowaniu aplikacji należy ją odpowiednio skonfigurować wprowadzając niezbędne dane do połączenia aplikacji z centralą: '''''Ustawienia->Konto''''' (opisane poniżej).

{{Uwaga|
Jeżeli numer wewnętrzny wprowadzony w ustawieniach nie posiada uprawnień do korzystania z aplikacji '''''MessengerCTI.Mobile''''' lub nie jest odpowiednio skonfigurowane konto CTI w centrali dla aplikacji mobilnej - nie będzie możliwości połączenia z centralą i synchronizacja danych.}}

== Uruchomienie aplikacji ==
Program '''''MessengerCTI.Mobile''''' uruchamia się identycznie jak każdy inny program w systemie operacyjnym Android. W trakcie uruchomienia następuje zalogowanie się programu do centrali (zgodnie z ustawieniami zakładce '''''Ustawienia->Konto'''''). Po pomyślnym zalogowaniu następuje synchronizacja danych programu z danymi w centrali (historii połączeń oraz czat).

== Konfiguracja aplikacji ==
Dla poprawnej komunikacji aplikacji z centralą należy skonfigurować dane konta CTI oraz pozostałe funkcje. Menu konfiguracji znajduje się w prawym górnym rogu okna aplikacji. Z rozwijanego menu wybieramy menu '''Ustawienia'''. 

Znajdziemy tu wymagane pola do konfiguracji: konta, powiadomień, numerów podręcznych.
===Konto===
Wypełniamy danymi do zalogowania aplikacji skonfigurowanymi przez administratora centrali:
* numer wyposażenia: numer wewnętrzny użytkownika z uprawnieniami dla komunikacji CTI
* hasło: hasło użytkownika CTI
* port: port komunikacji z centralą - domyślnie na centrali TCP 5529
* serwer: adres domenowy lub IP centrali lokalny lub publiczny dla użytkowników spoza sieci wewnętrznej

===Powiadomienia===
Konfiguracja powiadomień połączeń:
* dźwięk dzwonka: wybieramy z jeden z listy dostępnych w telefonie
* połączenia nieodebrane: powiadomienie na pasku
Konfiguracja powiadomień wiadomości czat:
* dźwięk wiadomości: wybieramy z jeden z listy dostępnych w telefonie

===Numery podręczne===
Lista numerów podręcznych dostępna podczas aktywnego połączenia celem szybkiego przekazania na numer z listy.

===Inne===
Konfiguracja zajętości telefonu w zależności od kierunku (połączenie z GSM lub z CTI) z jakiego przyszło połączenie:
* gdy rozmawia GSM to numer wewnętrzny będzie zajęty
* odrzucanie połączeń z GSM gdy wewnętrzny rozmawia
Rozwiązywanie problemów z poprawnym działaniem aplikacji:
* debug - opcja dla administratora włączana na prośbę dostawcy oprogramowania w przypadku analizy problemów
Włączenie opcji '''debug''' powoduje iż w Menu głównym ujawnia się dodatkowe pole '''''Wyślij log'''''. Dalej wybieramy klienta pocztowego, z którego wyślemy logi aplikacji do analizy po stornie producenta.

== Usługi ==
Konfiguracja usług aplikacji związanych z połączeniami:
* DND: nie przeszkadzać
* przekierowanie połączeń: wszystkie, gdy zajęty lub gdy nie odpowiada ze wskazaniem numeru na jaki ma być wykonane przekierowanie (należy pamiętać iż w pierwszej kolejności podaje numer a następnie aktywujemy przekierowanie)
* wycisz aplikację: tryb dyskretny

== Status ==
Ustawienie własnego opisu, który będzie widoczny dla pozostałych użytkowników aplikacji MessengerCTI oraz na ekranie telefonu systemowego CTS-330
== O programie ==
Informacje o:
* bieżącej wersji aplikacji
* typ centrali z jaką jest aplikacja połączona
* wersja oprogramowania centrali
* numer własny: numer konta CTI (numer wewnętrzny centrali)
* komentarz: opis własny numeru wewnętrznego

== Aktualizacja aplikacji ==
Aktualizacja programu jest dokonywana automatycznie a użytkownik ma wpływ na jej przebieg zgodnie z ustawieniami aktualizacji automatycznych aplikacji danego telefonu dla posiadaczy kont Google. Jeżeli w sklepie Google Play pojawi się nowa wersja następuje automatyczne pobranie nowszej wersji lub powiadomienie o niej.

= Struktura aplikacji =
==Okno główne ==
W oknie głównym aplikacji widoczne są dwie zakładki:
* '''Ostatnie''' - związane z historią połączeń i przesyłanych wiadomości wraz ze statusem abonenta centrali
* '''Kontakty''' - z dostępem do kontaktów książki telefonicznej centrali, z możliwością ich filtrowania: ulubione, wewnętrzne, zewnętrzne
* ikona statusu zalogowania wraz z opisem
* wyszukiwarka kontaktów
* menu ustawień aplikacji
<center>[[Plik:MessengerCTI_opis_new.png|800px]]</center>

== Ikono-grafika ==
W aplikacji '''''MessengerCTI.Mobile''''' przyjęto zasadę intuicyjnego oznaczania stanu telefonu za pomocą ikon widocznych w aplikacji przy każdym z kontaktów lub wpisie historii połączeń. Ikony te umożliwiają wykonywanie wybranej akcji, ocenienie stanu połączenia lub powiadamiają o występowaniu błędów.
=== Ikony i symbole ===
Okno startowe "Ostatnie" aplikacji pokazuje historię ostatnich połączeń. W tym widoku znajdują się ikony:
* po lewej stronie: status aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile lub historia połączeń
* po prawej: informujące o kierunku połączenia i statusie wiadomości czat 

W Tabeli 1 przedstawiono opis znaczenia poszczególnych ikon informujących o statusie aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile:
* dla abonentów wewnętrznych centrali - ikony symbolizujące stan zalogowania aplikacji a, dotknięcie ikony statusu pozwala rozpocząć czat lub sprawdzić historię połączeń
* dla bramofonów DPH.IP - aktualne położenie drzwi, a przez dotknięcie ikony symbolizującej drzwi wejście do historii
* dla kontaktów spoza centrali - sprawdzenie historii połączeń
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTID_free.png|40px]] ||użytkownik zalogowany
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_zaraz_wracam1.png|37px]] ||status: "Zaraz wracam"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_busy1.png]] ||użytkownik ustawił stan "Nie przeszkadzać"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_no_login.png|40px]] ||użytkownik niezalogowany, niedostępny lub status "Niewidoczny"
|-
|{{align|center}}|[[Plik:MessengerCTIMD_chat_free.png|40px]] || jeden z możliwych statusów aplikacji Desktop z skonfigurowaną aplikacją w wersji Mobile
|-
|{{align|center}}|[[Plik:MessengerCTIM_chat_DND.png|40px]] ||historia połączeń oraz wiadomości
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_open.png|40px]] ||bramofon DPH.IP: drzwi otwarte
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_closed.png|40px]] ||bramofon DPH.IP: drzwi zamknięte
|-
|}
'''''Tabela 1:''''' Ikony symbolizujące stany aplikacji, użytkowników i bramofonów. </center> 

W przypadku telefonów będących numerami wewnętrznymi centrali, pojawia się ikona symbolizująca stan telefonu.
<center>

{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_call.png|40px]] ||numer zajęty
|-
|{{align|center}}|[[Plik:MessengerCTIM_ringing.png|40px]] ||dzwonienie na numer lub wykonywanie połączenia wychodzącego z numeru
|-
|{{align|center}}|[[Plik:MessengerCTIM_failure1.png|40px]] ||numer niedostępny lub uszkodzony
|-
|{{align|center}}|[[Plik:MessengerCTIM_DND.png|40px]] ||włączona usługa DND
|-
|}
'''''Tabela 2:''''' Ikony symbolizujące stan telefonu. </center>

W tabeli 3 przedstawiono opis ikon związanych z połączeniami:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_call.png|40px]] ||połączenie przychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_call.png|40px]] ||połączenie wychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_qty.png|50px]] ||nowe nieodebrane połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer.png|45px]] ||połączenie nieodebrane
|-
|}

'''''Tabela 3:''''' Ikony symbolizujące połączenia. </center>

W tabeli 4 przedstawiono opis ikon związanych ze statusem wiadomości:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_chat.png|40px]] ||wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_chat.png|40px]] ||wiadomość wysłana (przeczytana)
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_chat.png|50px]] ||nowa wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_received_chat.png|45px]] ||wiadomość wysłana nieprzeczytana
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_read_chat_conf.png|40px]] ||wiadomość wysłana przeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_notread_chat_conf.png|40px]] ||wiadomość wysłana nieprzeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_unav_chat_conf.png|40px]] ||wiadomość wysłana do niezalogowanego użytkownika - widok w oknie dialogowym
|-
|}
'''''Tabela 4:''''' Ikony symbolizujące status wiadomości. </center>

W tabeli 5 przedstawiono opis powiadomień związanych z błędami w działaniu aplikacji. Powiadomienia widoczne są pod ikoną statusu
<center>
{|{{prettytable}}
!{{Hl1}}|Powiadomienie !!{{Hl1}}| Znaczenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_internet.png]] ||brak połączenia z internetem: sprawdź połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_auth.png]] || błędny login lub hasło: sprawdź ustawienia konta
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_licen.png]] || brak licencji do użytkowania aplikacji: skontaktuj się administratorem centrali
|-
|}
'''''Tabela 5''''': Znaczenie powiadomień o błędach.
</center>

=Obsługa połączeń i wiadomości=
Do przeprowadzenia rozmowy między użytkownikami, niezbędne jest zapewnienie:
* prawidłowej konfiguracji konta po stronie aplikacji oraz centrali
* połączenia aplikacja-centrala (pełna synchronizacja danych aplikacji z centralą) - ikona aplikacji powinna mieć kolor zielony
* zainstalowany telefon systemowy Slican, VoIP lub analogowy dla central IPx, CCT, MAC, NCP lub skonfigurowany abonent typu MessengerCTI (tylko centrala NCP)

==Wykonywanie połączeń==
Dwa sposoby wykonywania połączeń:
* z zakładki '''Kontakty''' - wybieramy abonenta z odpowiedniej grupy (jeśli taka istnieje), bezpośrednio z grupy Wszystkie kontakty. Połączenie wykonujemy przez dotknięcie paska kontaktu wybierając z rozwijanego menu ikonę [[Plik:MessengerCTIM_outgoing.png|25px]]
* z zakładki '''Kontakty''' - bezpośrednio wpisując numer telefonu w polu '''Szukaj''' za pomocą klawiatury a następnie klikając dolny prawy róg klawiatury
<center>[[Plik:MessengerCTIM_out_ext1.png|700px]]</center>
* z zakładki '''Ostatnie''' - odnajdujemy abonenta, z którym mieliśmy kontakt (dzwonił do nas lub my do niego) a następnie połączenie wykonujemy przez dotknięcie paska kontaktu w środkowej części wybierając z rozwijanego menu odpowiednią akcję
<center>[[Plik:MessengerCTIM_out_number1.png|750px]]</center>
Zestawianie połączenia sygnalizowane jest ekranem połączenia jak dla zwykłych połączeń wykonywanych za pomocą linii GSM. Aplikacja zestawia w pierwszej kolejności połączenie do centrali na dedykowany numer dostępowy dla użytkowników '''MessengerCTI.Mobile''', konfigurowany przez administratora centrali. A następnie centrala tranzytem zestawia połączenie z numerem wybranym przez użytkownika '''MessengerCTI.Mobile'''. Z tego powodu w centrali wymaganym łączem miejskim co najmniej jest linia ISDN BRA.

==Połączenie przychodzące==
Połączenie przychodzące sygnalizowane wizualnie jest za pomocą wyskakującego okienka połączenia oraz akustycznie dzwonkiem skonfigurowanym w ustawieniach powiadomień. Połączenia odbieramy przez przesunięcie ikony z zieloną słuchawką. Jeśli połączenie ma być odrzucone to przesuwamy ikonę z czerwoną słuchawką. Dodatkowo jeśli mamy dodane numery podręczne możemy dane połączenie przychodzące przekazać na numer z listy przez przesunięcie ikony z numerem kontaktu podręcznego.
Proces odbierania połączeń przychodzących polega na wykonaniu połączenia zwrotnego do centrali za pomocą linii GSM na numer dostępowy aplikacji zdefiniowany przez administratora centrali.
<center>[[Plik:MessengerCTIM_incoming2.png|700px]]</center>

Nieodebrane połączenie symbolizowane jest ikoną [[Plik:MessengerCTIM_no_answer_qty.png|50px]]. Przejście do historii połączenia lub oddzwonienie powoduje wyczyszczenie informacji o ilości połączeń nieodebranych.

==Obsługa wiadomości==
Aplikacja umożliwia wysyłanie i przyjmowanie wiadomości tekstowych pomiędzy użytkownikami aplikacji MessengerCTI.Desktop/Mobile (czat wewnętrzny). Aby wysłać wiadomość czat klikamy w ikonę statusu aplikacji użytkownika lub z rozwijanego menu po kliknięciu w pasek z kontaktem wybieramy opcję '''chat'''. Otrzymanie nowej wiadomości sygnalizowane jest na pasku powiadomień odpowiednią ikoną oraz zdefiniowanym sygnałem dźwiękowym. 
Jeśli użytkownik używa obu wersji MessengeraCTI, historia wiadomości przechowywana jest także lokalnie w aplikacji '''''MessengerCTI.Desktop'''''.
 Poniżej przykładowe okno dialogowe wiadomości chat:

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

== Kontakty==
Zakładka kontakty umożliwia wyświetlanie i uruchamianie wybranych akcji związanych z kontaktem. Dostęp do numerów z pozostałych grup można uzyskać rozwijając listę pozostałych kontaktów pogrupowanych jako:
* ulubione
* wszystkie grupy
* wszystkie kontakty
* wewnętrzne
* zewnętrzne
* prywatne
Domyślnie widoczna jest grupa '''Ulubione'''.
<center>[[Plik:MessengerCTIM_contacts1.png|300px]]</center>

== Historia połączeń ==
Domyślnie wybrana zakładka '''Ostatnie''' w oknie głównym programu wyświetla historię połączeń jak i wiadomości czat. 
W historii każda pozycja oznacza co najmniej jedno połączenie lub wiadomość. Jeśli połączenie lub wiadomość pochodzi od tego samego użytkownika i jest ich więcej niż jedno, to przy odpowiedniej ikonie wyświetlana jest stosowna liczba. W każdej pozycji widoczny jest numer dzwoniącego, komentarz(jeśli jest on w książce numerów spoza centrali), czas i data realizacji połączenia. 
Jeśli w historii znajdują się nie przejrzane nieodebrane połączenia lub nieprzeczytane wiadomości to zakładka '''Ostatnie''' jest oznaczona czerwoną kropką. 
Z zakładki historii możliwe jest oddzwanianie lub wysyłanie wiadomości zwrotnych.

=Konfiguracja centrali Slican=
Do poprawnej współpracy aplikacji z centralą jest wymagane:
* odpowiednia licencja producenta
* specyficzna konfiguracja centrali
==Konfiguracja central IPx, CCT==
Za pomocą programu ConfgMAN:
* w menu '''''Globalne ustawienia->Globalne ustawienia/Pozostałe->ANo''''': skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji Abonenta menu '''''Abonenci->Abonenci/Ustawienia CTI
** '''AwdMbl''': włączyć zezwolenie na obsługę aplikacji
** '''MnNo''': skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja oraz ewentualnie drugi numer (dla telefonu z dual SIM)
** '''IncC''': ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 6.53.'''

==Konfiguracja centrali NCP==
Z poziomu aplikacji ConfigWEB
* w menu '''''Numery wewnętrzne->Ustawienia->Konfiguracja aplikacji CTI'''''" skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji abonenta SIP, FXS, CTS, Numer MessengerCTI w menu '''''Numery wewnętrzne->Abonenci->CTI ustawienia'''''
** skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja
** ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji i telefonu wewnętrznego central) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 1.11.'''

=Przykłady zastosowań=
Aplikacja '''''MessengerCTI.Mobile''''' może być atrakcyjnym narzędziem dla tych firm, które posiadają pracowników mobilnych z wymogiem ciągłego dostępu telefonicznego jako numer wewnętrzny danego systemu telefonicznego. 
Dobry przykładem mogą pracownicy:
* działu handlowego - z pracą w trybie mieszanym biuro <-> poza biurem
* działu serwisowego - z pracą ciągłą w terenie
* pracownicy zdalni - telepraca
* pracownicy mobilni - praca na dużym terenie (hale produkcyjne, obszary rozległe) - gdzie zasięg sieci typu WiFi lub DECT nie obejmuje takich obszarów.

Instrukcja obsługi MessengerCTI.Mobile

2019-04-08T07:18:33Z

Marekg: /* Zalety aplikacji */

<center>[[Plik:messenger_2.png|250px]]</center>
= Wstęp =
Aplikacja Slican '''''MessengerCTI.Mobile''''' jest aplikacją mobilną przeznaczona na system '''Android''', który łączy w sobie możliwość wykonywania połączeń przychodzących jak i wychodzących, dostęp do książki telefonicznej, historii, podglądu statusu innych abonentów oraz chatu. 
Zawiera funkcjonalności umożliwiające integrację telefonu biurkowego i smartphone'a używanego przez abonenta centrali. 

Dużą zaletą tej aplikacji jest integracja książek kontaktów telefonicznych zapisanych w centrali. W '''''MessengerCTI.Mobile''''' wykorzystywane są zawsze książki zgromadzone w centrali, przy czym modyfikacja ich wpisów może być dokonywana tylko z telefonu systemowego jak i komputera przy użyciu programu '''''MessengerCTI.Desktop''''' lub aplikacji '''''WebCTI'''''. Ponadto program Slican '''''MessengerCTI.Mobile''''' posiada funkcjonalność komunikatora wewnętrznego - chatu. Użytkownikami komunikatora mogą być wszyscy abonenci danej centrali przy założeniu posiadania odpowiedniej licencji funkcjonalnej.
 
==Zalety aplikacji==
* aplikacja dostępna (bezpłatnie) w sklepie Google Play - wymagana jedynie po stronie centrali licencja CTI.plus
* książka kontaktów z podglądem stanu dostępności abonenta (czat, zajętości telefonu, opisu)
* dodawanie i usuwanie kontaktów z grupy ulubione, z pełną synchronizacją z aplikacją MessengerCTI.Desktop
* historia ostatnich połączeń/czatów posortowana chronologicznie
* logowanie jako telefonu równoległego do telefonu biurkowego lub jako osobny abonent MessengerCTI (tylko centrala NCP)
* komunikator czat
* historia czata połączona z historią połączeń telefonicznych
* połączenia głosowe przez GSM (dwie opcje zestawiania połączenia: przechwytywanie lub połączenie równoległe)
* elastyczne konfigurowanie powiadomień dźwiękowych
* dostęp do konfigurowania usług centrali na swoim telefonie
* numery podręczne do szybkiego przekazywania połączeń
* możliwość ustawiania zajętości telefonu biurkowego jeśli GSM zajęty (domyślnie włączone)
* możliwość ustawienia odrzucania wywołań na GSM jeśli telefon biurkowy zajęty
* możliwość kopiowania tekstu z chata
* możliwość obsługi smartphone'ów DualSIM lub dwóch telefonów jednocześnie (służbowy i prywatny)
* wygodne otwieranie drzwi jeśli dzwoni do nas bramofon DPH.IP oraz z menu kontekstowego dla kontaktu
* dodatkowy widget na pulpicie do szybkiego otwierania bramofonów DPH.IP
* automatyczny mechanizm opóźnienia powiadomienia na MessengerCTI.Mobile jeśli jestem aktywny na telefonie biurkowym lub MessengerCTI.Desktop
* możliwość kopiowania kontaktu z książki centrali telefonicznej do lokalnej książki telefonu

{{Uwaga|
Dla poprawnego działania aplikacji i połączeń wymagane są:
* stały dostęp do Internetu zarówno MessengerCTI.Mobile jak i centrali
* adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowany port 5529 TCP na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej
* w przypadku połączeń VoIP z aplikacji (wersja BETA) - adres domenowy lub stały publiczny adres IP centrali, ewentualnie na routerze brzegowym przekierowane porty 5060 UDP (sygnalizacja), 10000 - 20000 UDP (ramki głosowe RTP dla centrali NCP), 8100 - 8300 UDP (ramki głosowe RTP dla central IPx, MAC, CCT) na adres centrali w przypadku gdy znajduje się ona za NAT w sieci lokalnej}}

= Wymagania minimalne =
Aplikacja '''''MessengerCTI.Mobile''''' - jest ogólnie dostępna do pobrania w sklepie Google Play.
W celu zainstalowania aplikacji spełnione muszą zostać następujące wymagania minimalne:
* system operacyjny Android - Android wersja systemu KitKat (4.4.4)
* dostęp do internetu dla aplikacji jak i centrali
Telefon z wyższą wersją systemu Android nie będzie miał możliwości instalacji aplikacji.

{{Uwaga|
Aplikacja '''''MessengerCTI.Mobile''''' współpracuje z centralami IPx, MAC i CCT wyposażonymi w firmware od wersji '''6.53''', oraz NCP od fw. '''1.11'''}} 

=Instalacja aplikacji =
Korzystanie z aplikacji '''''MessengerCTI.Mobile''''' jest licencjonowane więc wymaga wykupienia odpowiedniej licencji. Zakupiony kod jest wprowadzany w trakcie konfiguracji centrali i decyduje o ilości stanowisk, które mogą używać programu. Licencjonowanie aplikacji nie ma wpływu na jej instalację. Po zainstalowaniu aplikacji należy ją odpowiednio skonfigurować wprowadzając niezbędne dane do połączenia aplikacji z centralą: '''''Ustawienia->Konto''''' (opisane poniżej).

{{Uwaga|
Jeżeli numer wewnętrzny wprowadzony w ustawieniach nie posiada uprawnień do korzystania z aplikacji '''''MessengerCTI.Mobile''''' lub nie jest odpowiednio skonfigurowane konto CTI w centrali dla aplikacji mobilnej - nie będzie możliwości połączenia z centralą i synchronizacja danych.}}

== Uruchomienie aplikacji ==
Program '''''MessengerCTI.Mobile''''' uruchamia się identycznie jak każdy inny program w systemie operacyjnym Android. W trakcie uruchomienia następuje zalogowanie się programu do centrali (zgodnie z ustawieniami zakładce '''''Ustawienia->Konto'''''). Po pomyślnym zalogowaniu następuje synchronizacja danych programu z danymi w centrali (historii połączeń oraz czat).

== Konfiguracja aplikacji ==
Dla poprawnej komunikacji aplikacji z centralą należy skonfigurować dane konta CTI oraz pozostałe funkcje. Menu konfiguracji znajduje się w prawym górnym rogu okna aplikacji. Z rozwijanego menu wybieramy menu '''Ustawienia'''. 

Znajdziemy tu wymagane pola do konfiguracji: konta, powiadomień, numerów podręcznych.
===Konto===
Wypełniamy danymi do zalogowania aplikacji skonfigurowanymi przez administratora centrali:
* numer wyposażenia: numer wewnętrzny użytkownika z uprawnieniami dla komunikacji CTI
* hasło: hasło użytkownika CTI
* port: port komunikacji z centralą - domyślnie na centrali TCP 5529
* serwer: adres domenowy lub IP centrali lokalny lub publiczny dla użytkowników spoza sieci wewnętrznej

===Powiadomienia===
Konfiguracja powiadomień połączeń:
* dźwięk dzwonka: wybieramy z jeden z listy dostępnych w telefonie
* połączenia nieodebrane: powiadomienie na pasku
Konfiguracja powiadomień wiadomości czat:
* dźwięk wiadomości: wybieramy z jeden z listy dostępnych w telefonie

===Numery podręczne===
Lista numerów podręcznych dostępna podczas aktywnego połączenia celem szybkiego przekazania na numer z listy.

===Inne===
Konfiguracja zajętości telefonu w zależności od kierunku (połączenie z GSM lub z CTI) z jakiego przyszło połączenie:
* gdy rozmawia GSM to numer wewnętrzny będzie zajęty
* odrzucanie połączeń z GSM gdy wewnętrzny rozmawia
Rozwiązywanie problemów z poprawnym działaniem aplikacji:
* debug - opcja dla administratora włączana na prośbę dostawcy oprogramowania w przypadku analizy problemów
Włączenie opcji '''debug''' powoduje iż w Menu głównym ujawnia się dodatkowe pole '''''Wyślij log'''''. Dalej wybieramy klienta pocztowego, z którego wyślemy logi aplikacji do analizy po stornie producenta.

== Usługi ==
Konfiguracja usług aplikacji związanych z połączeniami:
* DND: nie przeszkadzać
* przekierowanie połączeń: wszystkie, gdy zajęty lub gdy nie odpowiada ze wskazaniem numeru na jaki ma być wykonane przekierowanie (należy pamiętać iż w pierwszej kolejności podaje numer a następnie aktywujemy przekierowanie)
* wycisz aplikację: tryb dyskretny

== Status ==
Ustawienie własnego opisu, który będzie widoczny dla pozostałych użytkowników aplikacji MessengerCTI oraz na ekranie telefonu systemowego CTS-330
== O programie ==
Informacje o:
* bieżącej wersji aplikacji
* typ centrali z jaką jest aplikacja połączona
* wersja oprogramowania centrali
* numer własny: numer konta CTI (numer wewnętrzny centrali)
* komentarz: opis własny numeru wewnętrznego

== Aktualizacja aplikacji ==
Aktualizacja programu jest dokonywana automatycznie a użytkownik ma wpływ na jej przebieg zgodnie z ustawieniami aktualizacji automatycznych aplikacji danego telefonu dla posiadaczy kont Google. Jeżeli w sklepie Google Play pojawi się nowa wersja następuje automatyczne pobranie nowszej wersji lub powiadomienie o niej.

= Struktura aplikacji =
==Okno główne ==
W oknie głównym aplikacji widoczne są dwie zakładki:
* '''Ostatnie''' - związane z historią połączeń i przesyłanych wiadomości wraz ze statusem abonenta centrali
* '''Kontakty''' - z dostępem do kontaktów książki telefonicznej centrali, z możliwością ich filtrowania: ulubione, wewnętrzne, zewnętrzne
* ikona statusu zalogowania wraz z opisem
* wyszukiwarka kontaktów
* menu ustawień aplikacji
<center>[[Plik:MessengerCTI_opis_new.png|800px]]</center>

== Ikono-grafika ==
W aplikacji '''''MessengerCTI.Mobile''''' przyjęto zasadę intuicyjnego oznaczania stanu telefonu za pomocą ikon widocznych w aplikacji przy każdym z kontaktów lub wpisie historii połączeń. Ikony te umożliwiają wykonywanie wybranej akcji, ocenienie stanu połączenia lub powiadamiają o występowaniu błędów.
=== Ikony i symbole ===
Okno startowe "Ostatnie" aplikacji pokazuje historię ostatnich połączeń. W tym widoku znajdują się ikony:
* po lewej stronie: status aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile lub historia połączeń
* po prawej: informujące o kierunku połączenia i statusie wiadomości czat 

W Tabeli 1 przedstawiono opis znaczenia poszczególnych ikon informujących o statusie aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile:
* dla abonentów wewnętrznych centrali - ikony symbolizujące stan zalogowania aplikacji a, dotknięcie ikony statusu pozwala rozpocząć czat lub sprawdzić historię połączeń
* dla bramofonów DPH.IP - aktualne położenie drzwi, a przez dotknięcie ikony symbolizującej drzwi wejście do historii
* dla kontaktów spoza centrali - sprawdzenie historii połączeń
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTID_free.png|40px]] ||użytkownik zalogowany
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_zaraz_wracam1.png|37px]] ||status: "Zaraz wracam"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_busy1.png]] ||użytkownik ustawił stan "Nie przeszkadzać"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_no_login.png|40px]] ||użytkownik niezalogowany, niedostępny lub status "Niewidoczny"
|-
|{{align|center}}|[[Plik:MessengerCTIMD_chat_free.png|40px]] || jeden z możliwych statusów aplikacji Desktop z skonfigurowaną aplikacją w wersji Mobile
|-
|{{align|center}}|[[Plik:MessengerCTIM_chat_DND.png|40px]] ||historia połączeń oraz wiadomości
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_open.png|40px]] ||bramofon DPH.IP: drzwi otwarte
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_closed.png|40px]] ||bramofon DPH.IP: drzwi zamknięte
|-
|}
'''''Tabela 1:''''' Ikony symbolizujące stany aplikacji, użytkowników i bramofonów. </center> 

W przypadku telefonów będących numerami wewnętrznymi centrali, pojawia się ikona symbolizująca stan telefonu.
<center>

{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_call.png|40px]] ||numer zajęty
|-
|{{align|center}}|[[Plik:MessengerCTIM_ringing.png|40px]] ||dzwonienie na numer lub wykonywanie połączenia wychodzącego z numeru
|-
|{{align|center}}|[[Plik:MessengerCTIM_failure1.png|40px]] ||numer niedostępny lub uszkodzony
|-
|{{align|center}}|[[Plik:MessengerCTIM_DND.png|40px]] ||włączona usługa DND
|-
|}
'''''Tabela 2:''''' Ikony symbolizujące stan telefonu. </center>

W tabeli 3 przedstawiono opis ikon związanych z połączeniami:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_call.png|40px]] ||połączenie przychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_call.png|40px]] ||połączenie wychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_qty.png|50px]] ||nowe nieodebrane połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer.png|45px]] ||połączenie nieodebrane
|-
|}

'''''Tabela 3:''''' Ikony symbolizujące połączenia. </center>

W tabeli 4 przedstawiono opis ikon związanych ze statusem wiadomości:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_chat.png|40px]] ||wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_chat.png|40px]] ||wiadomość wysłana (przeczytana)
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_chat.png|50px]] ||nowa wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_received_chat.png|45px]] ||wiadomość wysłana nieprzeczytana
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_read_chat_conf.png|40px]] ||wiadomość wysłana przeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_notread_chat_conf.png|40px]] ||wiadomość wysłana nieprzeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_unav_chat_conf.png|40px]] ||wiadomość wysłana do niezalogowanego użytkownika - widok w oknie dialogowym
|-
|}
'''''Tabela 4:''''' Ikony symbolizujące status wiadomości. </center>

W tabeli 5 przedstawiono opis powiadomień związanych z błędami w działaniu aplikacji. Powiadomienia widoczne są pod ikoną statusu
<center>
{|{{prettytable}}
!{{Hl1}}|Powiadomienie !!{{Hl1}}| Znaczenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_internet.png]] ||brak połączenia z internetem: sprawdź połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_auth.png]] || błędny login lub hasło: sprawdź ustawienia konta
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_licen.png]] || brak licencji do użytkowania aplikacji: skontaktuj się administratorem centrali
|-
|}
'''''Tabela 5''''': Znaczenie powiadomień o błędach.
</center>

=Obsługa połączeń i wiadomości=
Do przeprowadzenia rozmowy między użytkownikami, niezbędne jest zapewnienie:
* prawidłowej konfiguracji konta po stronie aplikacji oraz centrali
* połączenia aplikacja-centrala (pełna synchronizacja danych aplikacji z centralą) - ikona aplikacji powinna mieć kolor zielony
* zainstalowany telefon systemowy Slican, VoIP lub analogowy dla central IPx, CCT, MAC, NCP lub skonfigurowany abonent typu MessengerCTI (tylko centrala NCP)

==Wykonywanie połączeń==
Dwa sposoby wykonywania połączeń:
* z zakładki '''Kontakty''' - wybieramy abonenta z odpowiedniej grupy (jeśli taka istnieje), bezpośrednio z grupy Wszystkie kontakty. Połączenie wykonujemy przez dotknięcie paska kontaktu wybierając z rozwijanego menu ikonę [[Plik:MessengerCTIM_outgoing.png|25px]]
* z zakładki '''Kontakty''' - bezpośrednio wpisując numer telefonu w polu '''Szukaj''' za pomocą klawiatury a następnie klikając dolny prawy róg klawiatury
<center>[[Plik:MessengerCTIM_out_ext1.png|700px]]</center>
* z zakładki '''Ostatnie''' - odnajdujemy abonenta, z którym mieliśmy kontakt (dzwonił do nas lub my do niego) a następnie połączenie wykonujemy przez dotknięcie paska kontaktu w środkowej części wybierając z rozwijanego menu odpowiednią akcję
<center>[[Plik:MessengerCTIM_out_number1.png|750px]]</center>
Zestawianie połączenia sygnalizowane jest ekranem połączenia jak dla zwykłych połączeń wykonywanych za pomocą linii GSM. Aplikacja zestawia w pierwszej kolejności połączenie do centrali na dedykowany numer dostępowy dla użytkowników '''MessengerCTI.Mobile''', konfigurowany przez administratora centrali. A następnie centrala tranzytem zestawia połączenie z numerem wybranym przez użytkownika '''MessengerCTI.Mobile'''. Z tego powodu w centrali wymaganym łączem miejskim co najmniej jest linia ISDN BRA.

==Połączenie przychodzące==
Połączenie przychodzące sygnalizowane wizualnie jest za pomocą wyskakującego okienka połączenia oraz akustycznie dzwonkiem skonfigurowanym w ustawieniach powiadomień. Połączenia odbieramy przez przesunięcie ikony z zieloną słuchawką. Jeśli połączenie ma być odrzucone to przesuwamy ikonę z czerwoną słuchawką. Dodatkowo jeśli mamy dodane numery podręczne możemy dane połączenie przychodzące przekazać na numer z listy przez przesunięcie ikony z numerem kontaktu podręcznego.
Proces odbierania połączeń przychodzących polega na wykonaniu połączenia zwrotnego do centrali za pomocą linii GSM na numer dostępowy aplikacji zdefiniowany przez administratora centrali.
<center>[[Plik:MessengerCTIM_incoming2.png|700px]]</center>

Nieodebrane połączenie symbolizowane jest ikoną [[Plik:MessengerCTIM_no_answer_qty.png|50px]]. Przejście do historii połączenia lub oddzwonienie powoduje wyczyszczenie informacji o ilości połączeń nieodebranych.

==Obsługa wiadomości==
Aplikacja umożliwia wysyłanie i przyjmowanie wiadomości tekstowych pomiędzy użytkownikami aplikacji MessengerCTI.Desktop/Mobile (czat wewnętrzny). Aby wysłać wiadomość czat klikamy w ikonę statusu aplikacji użytkownika lub z rozwijanego menu po kliknięciu w pasek z kontaktem wybieramy opcję '''chat'''. Otrzymanie nowej wiadomości sygnalizowane jest na pasku powiadomień odpowiednią ikoną oraz zdefiniowanym sygnałem dźwiękowym. 
Jeśli użytkownik używa obu wersji MessengeraCTI, historia wiadomości przechowywana jest także lokalnie w aplikacji '''''MessengerCTI.Desktop'''''.
 Poniżej przykładowe okno dialogowe wiadomości chat:

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

== Kontakty==
Zakładka kontakty umożliwia wyświetlanie i uruchamianie wybranych akcji związanych z kontaktem. Dostęp do numerów z pozostałych grup można uzyskać rozwijając listę pozostałych kontaktów pogrupowanych jako:
* ulubione
* wszystkie grupy
* wszystkie kontakty
* wewnętrzne
* zewnętrzne
* prywatne
Domyślnie widoczna jest grupa '''Ulubione'''.
<center>[[Plik:MessengerCTIM_contacts1.png|300px]]</center>

== Historia połączeń ==
Domyślnie wybrana zakładka '''Ostatnie''' w oknie głównym programu wyświetla historię połączeń jak i wiadomości czat. 
W historii każda pozycja oznacza co najmniej jedno połączenie lub wiadomość. Jeśli połączenie lub wiadomość pochodzi od tego samego użytkownika i jest ich więcej niż jedno, to przy odpowiedniej ikonie wyświetlana jest stosowna liczba. W każdej pozycji widoczny jest numer dzwoniącego, komentarz(jeśli jest on w książce numerów spoza centrali), czas i data realizacji połączenia. 
Jeśli w historii znajdują się nie przejrzane nieodebrane połączenia lub nieprzeczytane wiadomości to zakładka '''Ostatnie''' jest oznaczona czerwoną kropką. 
Z zakładki historii możliwe jest oddzwanianie lub wysyłanie wiadomości zwrotnych.

=Konfiguracja centrali Slican=
Do poprawnej współpracy aplikacji z centralą jest wymagane:
* odpowiednia licencja producenta
* specyficzna konfiguracja centrali
==Konfiguracja central IPx, CCT==
Za pomocą programu ConfgMAN:
* w menu '''''Globalne ustawienia->Globalne ustawienia/Pozostałe->ANo''''': skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji Abonenta menu '''''Abonenci->Abonenci/Ustawienia CTI
** '''AwdMbl''': włączyć zezwolenie na obsługę aplikacji
** '''MnNo''': skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja oraz ewentualnie drugi numer (dla telefonu z dual SIM)
** '''IncC''': ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 6.53.'''

==Konfiguracja centrali NCP==
Z poziomu aplikacji ConfigWEB
* w menu '''''Numery wewnętrzne->Ustawienia->Konfiguracja aplikacji CTI'''''" skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji abonenta SIP, FXS, CTS, Numer MessengerCTI w menu '''''Numery wewnętrzne->Abonenci->CTI ustawienia'''''
** skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja
** ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji i telefonu wewnętrznego central) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 1.11.'''

=Przykłady zastosowań=
Aplikacja '''''MessengerCTI.Mobile''''' może być atrakcyjnym narzędziem dla tych firm, które posiadają pracowników mobilnych z wymogiem ciągłego dostępu telefonicznego jako numer wewnętrzny danego systemu telefonicznego. 
Dobry przykładem mogą pracownicy:
* działu handlowego - z pracą w trybie mieszanym biuro <-> poza biurem
* działu serwisowego - z pracą ciągłą w terenie
* pracownicy zdalni - telepraca
* pracownicy mobilni - praca na dużym terenie (hale produkcyjne, obszary rozległe) - gdzie zasięg sieci typu WiFi lub DECT nie obejmuje takich obszarów.

Instrukcja obsługi MessengerCTI.Mobile

2019-03-18T10:27:51Z

Marekg: /* Wymagania minimalne */

<center>[[Plik:messenger_2.png|250px]]</center>
= Wstęp =
Aplikacja Slican '''''MessengerCTI.Mobile''''' jest aplikacją mobilną przeznaczona na system '''Android''', który łączy w sobie możliwość wykonywania połączeń przychodzących jak i wychodzących, dostęp do książki telefonicznej, historii, podglądu statusu innych abonentów oraz chatu. 
Zawiera funkcjonalności umożliwiające integrację telefonu biurkowego i smartphone'a używanego przez abonenta centrali. 

Dużą zaletą tej aplikacji jest integracja książek kontaktów telefonicznych zapisanych w centrali. W '''''MessengerCTI.Mobile''''' wykorzystywane są zawsze książki zgromadzone w centrali, przy czym modyfikacja ich wpisów może być dokonywana tylko z telefonu systemowego jak i komputera przy użyciu programu '''''MessengerCTI.Desktop''''' lub aplikacji '''''WebCTI'''''. Ponadto program Slican '''''MessengerCTI.Mobile''''' posiada funkcjonalność komunikatora wewnętrznego - chatu. Użytkownikami komunikatora mogą być wszyscy abonenci danej centrali przy założeniu posiadania odpowiedniej licencji funkcjonalnej.
 
==Zalety aplikacji==
* aplikacja dostępna (bezpłatnie) w sklepie Google Play - wymagana jedynie po stronie centrali licencja CTI.plus
* książka kontaktów z podglądem stanu dostępności abonenta (czat, zajętości telefonu, opisu)
* dodawanie i usuwanie kontaktów z grupy ulubione, z pełną synchronizacją z aplikacją MessengerCTI.Desktop
* historia ostatnich połączeń/czatów posortowana chronologicznie
* logowanie jako telefonu równoległego do telefonu biurkowego lub jako osobny abonent MessengerCTI (tylko centrala NCP)
* komunikator czat
* historia czata połączona z historią połączeń telefonicznych
* połączenia głosowe przez GSM (dwie opcje zestawiania połączenia: przechwytywanie lub połączenie równoległe)
* elastyczne konfigurowanie powiadomień dźwiękowych
* dostęp do konfigurowania usług centrali na swoim telefonie
* numery podręczne do szybkiego przekazywania połączeń
* możliwość ustawiania zajętości telefonu biurkowego jeśli GSM zajęty (domyślnie włączone)
* możliwość ustawienia odrzucania wywołań na GSM jeśli telefon biurkowy zajęty
* możliwość kopiowania tekstu z chata
* możliwość obsługi smartphone'ów DualSIM lub dwóch telefonów jednocześnie (służbowy i prywatny)
* wygodne otwieranie drzwi jeśli dzwoni do nas bramofon DPH.IP oraz z menu kontekstowego dla kontaktu
* dodatkowy widget na pulpicie do szybkiego otwierania bramofonów DPH.IP
* automatyczny mechanizm opóźnienia powiadomienia na MessengerCTI.Mobile jeśli jestem aktywny na telefonie biurkowym lub MessengerCTI.Desktop
* możliwość kopiowania kontaktu z książki centrali telefonicznej do lokalnej książki telefonu

{{Uwaga|
Dla poprawnego działania wymagany jest ciągły dostęp do Internetu zarówno aplikacji MessengerCTI.Mobile jak i centrali, stały publiczny adres IP centrali lub ewentualnie przekierowanie portu 5529 na routerze brzegowym, gdy centrala jest za NAT w sieci lokalnej.}}

= Wymagania minimalne =
Aplikacja '''''MessengerCTI.Mobile''''' - jest ogólnie dostępna do pobrania w sklepie Google Play.
W celu zainstalowania aplikacji spełnione muszą zostać następujące wymagania minimalne:
* system operacyjny Android - Android wersja systemu KitKat (4.4.4)
* dostęp do internetu dla aplikacji jak i centrali
Telefon z wyższą wersją systemu Android nie będzie miał możliwości instalacji aplikacji.

{{Uwaga|
Aplikacja '''''MessengerCTI.Mobile''''' współpracuje z centralami IPx, MAC i CCT wyposażonymi w firmware od wersji '''6.53''', oraz NCP od fw. '''1.11'''}} 

=Instalacja aplikacji =
Korzystanie z aplikacji '''''MessengerCTI.Mobile''''' jest licencjonowane więc wymaga wykupienia odpowiedniej licencji. Zakupiony kod jest wprowadzany w trakcie konfiguracji centrali i decyduje o ilości stanowisk, które mogą używać programu. Licencjonowanie aplikacji nie ma wpływu na jej instalację. Po zainstalowaniu aplikacji należy ją odpowiednio skonfigurować wprowadzając niezbędne dane do połączenia aplikacji z centralą: '''''Ustawienia->Konto''''' (opisane poniżej).

{{Uwaga|
Jeżeli numer wewnętrzny wprowadzony w ustawieniach nie posiada uprawnień do korzystania z aplikacji '''''MessengerCTI.Mobile''''' lub nie jest odpowiednio skonfigurowane konto CTI w centrali dla aplikacji mobilnej - nie będzie możliwości połączenia z centralą i synchronizacja danych.}}

== Uruchomienie aplikacji ==
Program '''''MessengerCTI.Mobile''''' uruchamia się identycznie jak każdy inny program w systemie operacyjnym Android. W trakcie uruchomienia następuje zalogowanie się programu do centrali (zgodnie z ustawieniami zakładce '''''Ustawienia->Konto'''''). Po pomyślnym zalogowaniu następuje synchronizacja danych programu z danymi w centrali (historii połączeń oraz czat).

== Konfiguracja aplikacji ==
Dla poprawnej komunikacji aplikacji z centralą należy skonfigurować dane konta CTI oraz pozostałe funkcje. Menu konfiguracji znajduje się w prawym górnym rogu okna aplikacji. Z rozwijanego menu wybieramy menu '''Ustawienia'''. 

Znajdziemy tu wymagane pola do konfiguracji: konta, powiadomień, numerów podręcznych.
===Konto===
Wypełniamy danymi do zalogowania aplikacji skonfigurowanymi przez administratora centrali:
* numer wyposażenia: numer wewnętrzny użytkownika z uprawnieniami dla komunikacji CTI
* hasło: hasło użytkownika CTI
* port: port komunikacji z centralą - domyślnie na centrali TCP 5529
* serwer: adres domenowy lub IP centrali lokalny lub publiczny dla użytkowników spoza sieci wewnętrznej

===Powiadomienia===
Konfiguracja powiadomień połączeń:
* dźwięk dzwonka: wybieramy z jeden z listy dostępnych w telefonie
* połączenia nieodebrane: powiadomienie na pasku
Konfiguracja powiadomień wiadomości czat:
* dźwięk wiadomości: wybieramy z jeden z listy dostępnych w telefonie

===Numery podręczne===
Lista numerów podręcznych dostępna podczas aktywnego połączenia celem szybkiego przekazania na numer z listy.

===Inne===
Konfiguracja zajętości telefonu w zależności od kierunku (połączenie z GSM lub z CTI) z jakiego przyszło połączenie:
* gdy rozmawia GSM to numer wewnętrzny będzie zajęty
* odrzucanie połączeń z GSM gdy wewnętrzny rozmawia
Rozwiązywanie problemów z poprawnym działaniem aplikacji:
* debug - opcja dla administratora włączana na prośbę dostawcy oprogramowania w przypadku analizy problemów
Włączenie opcji '''debug''' powoduje iż w Menu głównym ujawnia się dodatkowe pole '''''Wyślij log'''''. Dalej wybieramy klienta pocztowego, z którego wyślemy logi aplikacji do analizy po stornie producenta.

== Usługi ==
Konfiguracja usług aplikacji związanych z połączeniami:
* DND: nie przeszkadzać
* przekierowanie połączeń: wszystkie, gdy zajęty lub gdy nie odpowiada ze wskazaniem numeru na jaki ma być wykonane przekierowanie (należy pamiętać iż w pierwszej kolejności podaje numer a następnie aktywujemy przekierowanie)
* wycisz aplikację: tryb dyskretny

== Status ==
Ustawienie własnego opisu, który będzie widoczny dla pozostałych użytkowników aplikacji MessengerCTI oraz na ekranie telefonu systemowego CTS-330
== O programie ==
Informacje o:
* bieżącej wersji aplikacji
* typ centrali z jaką jest aplikacja połączona
* wersja oprogramowania centrali
* numer własny: numer konta CTI (numer wewnętrzny centrali)
* komentarz: opis własny numeru wewnętrznego

== Aktualizacja aplikacji ==
Aktualizacja programu jest dokonywana automatycznie a użytkownik ma wpływ na jej przebieg zgodnie z ustawieniami aktualizacji automatycznych aplikacji danego telefonu dla posiadaczy kont Google. Jeżeli w sklepie Google Play pojawi się nowa wersja następuje automatyczne pobranie nowszej wersji lub powiadomienie o niej.

= Struktura aplikacji =
==Okno główne ==
W oknie głównym aplikacji widoczne są dwie zakładki:
* '''Ostatnie''' - związane z historią połączeń i przesyłanych wiadomości wraz ze statusem abonenta centrali
* '''Kontakty''' - z dostępem do kontaktów książki telefonicznej centrali, z możliwością ich filtrowania: ulubione, wewnętrzne, zewnętrzne
* ikona statusu zalogowania wraz z opisem
* wyszukiwarka kontaktów
* menu ustawień aplikacji
<center>[[Plik:MessengerCTI_opis_new.png|800px]]</center>

== Ikono-grafika ==
W aplikacji '''''MessengerCTI.Mobile''''' przyjęto zasadę intuicyjnego oznaczania stanu telefonu za pomocą ikon widocznych w aplikacji przy każdym z kontaktów lub wpisie historii połączeń. Ikony te umożliwiają wykonywanie wybranej akcji, ocenienie stanu połączenia lub powiadamiają o występowaniu błędów.
=== Ikony i symbole ===
Okno startowe "Ostatnie" aplikacji pokazuje historię ostatnich połączeń. W tym widoku znajdują się ikony:
* po lewej stronie: status aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile lub historia połączeń
* po prawej: informujące o kierunku połączenia i statusie wiadomości czat 

W Tabeli 1 przedstawiono opis znaczenia poszczególnych ikon informujących o statusie aplikacji pozostałych użytkowników MessengerCTI.Desktop/Mobile:
* dla abonentów wewnętrznych centrali - ikony symbolizujące stan zalogowania aplikacji a, dotknięcie ikony statusu pozwala rozpocząć czat lub sprawdzić historię połączeń
* dla bramofonów DPH.IP - aktualne położenie drzwi, a przez dotknięcie ikony symbolizującej drzwi wejście do historii
* dla kontaktów spoza centrali - sprawdzenie historii połączeń
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTID_free.png|40px]] ||użytkownik zalogowany
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_zaraz_wracam1.png|37px]] ||status: "Zaraz wracam"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_busy1.png]] ||użytkownik ustawił stan "Nie przeszkadzać"
|-
|{{align|center}}|[[Plik:MessengerCTID_chat_no_login.png|40px]] ||użytkownik niezalogowany, niedostępny lub status "Niewidoczny"
|-
|{{align|center}}|[[Plik:MessengerCTIMD_chat_free.png|40px]] || jeden z możliwych statusów aplikacji Desktop z skonfigurowaną aplikacją w wersji Mobile
|-
|{{align|center}}|[[Plik:MessengerCTIM_chat_DND.png|40px]] ||historia połączeń oraz wiadomości
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_open.png|40px]] ||bramofon DPH.IP: drzwi otwarte
|-
|{{align|center}}|[[Plik:MessengerCTIM_door_closed.png|40px]] ||bramofon DPH.IP: drzwi zamknięte
|-
|}
'''''Tabela 1:''''' Ikony symbolizujące stany aplikacji, użytkowników i bramofonów. </center> 

W przypadku telefonów będących numerami wewnętrznymi centrali, pojawia się ikona symbolizująca stan telefonu.
<center>

{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_call.png|40px]] ||numer zajęty
|-
|{{align|center}}|[[Plik:MessengerCTIM_ringing.png|40px]] ||dzwonienie na numer lub wykonywanie połączenia wychodzącego z numeru
|-
|{{align|center}}|[[Plik:MessengerCTIM_failure1.png|40px]] ||numer niedostępny lub uszkodzony
|-
|{{align|center}}|[[Plik:MessengerCTIM_DND.png|40px]] ||włączona usługa DND
|-
|}
'''''Tabela 2:''''' Ikony symbolizujące stan telefonu. </center>

W tabeli 3 przedstawiono opis ikon związanych z połączeniami:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_call.png|40px]] ||połączenie przychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_call.png|40px]] ||połączenie wychodzące
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_qty.png|50px]] ||nowe nieodebrane połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer.png|45px]] ||połączenie nieodebrane
|-
|}

'''''Tabela 3:''''' Ikony symbolizujące połączenia. </center>

W tabeli 4 przedstawiono opis ikon związanych ze statusem wiadomości:
<center>
{|{{prettytable}}
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTIM_incom_chat.png|40px]] ||wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_out_chat.png|40px]] ||wiadomość wysłana (przeczytana)
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_answer_chat.png|50px]] ||nowa wiadomość odebrana
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_received_chat.png|45px]] ||wiadomość wysłana nieprzeczytana
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_read_chat_conf.png|40px]] ||wiadomość wysłana przeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_notread_chat_conf.png|40px]] ||wiadomość wysłana nieprzeczytana - widok w oknie dialogowym
|-
|{{align|center}}|[[Plik:MessengerCTIM_send_unav_chat_conf.png|40px]] ||wiadomość wysłana do niezalogowanego użytkownika - widok w oknie dialogowym
|-
|}
'''''Tabela 4:''''' Ikony symbolizujące status wiadomości. </center>

W tabeli 5 przedstawiono opis powiadomień związanych z błędami w działaniu aplikacji. Powiadomienia widoczne są pod ikoną statusu
<center>
{|{{prettytable}}
!{{Hl1}}|Powiadomienie !!{{Hl1}}| Znaczenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_internet.png]] ||brak połączenia z internetem: sprawdź połączenie
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_auth.png]] || błędny login lub hasło: sprawdź ustawienia konta
|-
|{{align|center}}|[[Plik:MessengerCTIM_no_licen.png]] || brak licencji do użytkowania aplikacji: skontaktuj się administratorem centrali
|-
|}
'''''Tabela 5''''': Znaczenie powiadomień o błędach.
</center>

=Obsługa połączeń i wiadomości=
Do przeprowadzenia rozmowy między użytkownikami, niezbędne jest zapewnienie:
* prawidłowej konfiguracji konta po stronie aplikacji oraz centrali
* połączenia aplikacja-centrala (pełna synchronizacja danych aplikacji z centralą) - ikona aplikacji powinna mieć kolor zielony
* zainstalowany telefon systemowy Slican, VoIP lub analogowy dla central IPx, CCT, MAC, NCP lub skonfigurowany abonent typu MessengerCTI (tylko centrala NCP)

==Wykonywanie połączeń==
Dwa sposoby wykonywania połączeń:
* z zakładki '''Kontakty''' - wybieramy abonenta z odpowiedniej grupy (jeśli taka istnieje), bezpośrednio z grupy Wszystkie kontakty. Połączenie wykonujemy przez dotknięcie paska kontaktu wybierając z rozwijanego menu ikonę [[Plik:MessengerCTIM_outgoing.png|25px]]
* z zakładki '''Kontakty''' - bezpośrednio wpisując numer telefonu w polu '''Szukaj''' za pomocą klawiatury a następnie klikając dolny prawy róg klawiatury
<center>[[Plik:MessengerCTIM_out_ext1.png|700px]]</center>
* z zakładki '''Ostatnie''' - odnajdujemy abonenta, z którym mieliśmy kontakt (dzwonił do nas lub my do niego) a następnie połączenie wykonujemy przez dotknięcie paska kontaktu w środkowej części wybierając z rozwijanego menu odpowiednią akcję
<center>[[Plik:MessengerCTIM_out_number1.png|750px]]</center>
Zestawianie połączenia sygnalizowane jest ekranem połączenia jak dla zwykłych połączeń wykonywanych za pomocą linii GSM. Aplikacja zestawia w pierwszej kolejności połączenie do centrali na dedykowany numer dostępowy dla użytkowników '''MessengerCTI.Mobile''', konfigurowany przez administratora centrali. A następnie centrala tranzytem zestawia połączenie z numerem wybranym przez użytkownika '''MessengerCTI.Mobile'''. Z tego powodu w centrali wymaganym łączem miejskim co najmniej jest linia ISDN BRA.

==Połączenie przychodzące==
Połączenie przychodzące sygnalizowane wizualnie jest za pomocą wyskakującego okienka połączenia oraz akustycznie dzwonkiem skonfigurowanym w ustawieniach powiadomień. Połączenia odbieramy przez przesunięcie ikony z zieloną słuchawką. Jeśli połączenie ma być odrzucone to przesuwamy ikonę z czerwoną słuchawką. Dodatkowo jeśli mamy dodane numery podręczne możemy dane połączenie przychodzące przekazać na numer z listy przez przesunięcie ikony z numerem kontaktu podręcznego.
Proces odbierania połączeń przychodzących polega na wykonaniu połączenia zwrotnego do centrali za pomocą linii GSM na numer dostępowy aplikacji zdefiniowany przez administratora centrali.
<center>[[Plik:MessengerCTIM_incoming2.png|700px]]</center>

Nieodebrane połączenie symbolizowane jest ikoną [[Plik:MessengerCTIM_no_answer_qty.png|50px]]. Przejście do historii połączenia lub oddzwonienie powoduje wyczyszczenie informacji o ilości połączeń nieodebranych.

==Obsługa wiadomości==
Aplikacja umożliwia wysyłanie i przyjmowanie wiadomości tekstowych pomiędzy użytkownikami aplikacji MessengerCTI.Desktop/Mobile (czat wewnętrzny). Aby wysłać wiadomość czat klikamy w ikonę statusu aplikacji użytkownika lub z rozwijanego menu po kliknięciu w pasek z kontaktem wybieramy opcję '''chat'''. Otrzymanie nowej wiadomości sygnalizowane jest na pasku powiadomień odpowiednią ikoną oraz zdefiniowanym sygnałem dźwiękowym. 
Jeśli użytkownik używa obu wersji MessengeraCTI, historia wiadomości przechowywana jest także lokalnie w aplikacji '''''MessengerCTI.Desktop'''''.
 Poniżej przykładowe okno dialogowe wiadomości chat:

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

== Kontakty==
Zakładka kontakty umożliwia wyświetlanie i uruchamianie wybranych akcji związanych z kontaktem. Dostęp do numerów z pozostałych grup można uzyskać rozwijając listę pozostałych kontaktów pogrupowanych jako:
* ulubione
* wszystkie grupy
* wszystkie kontakty
* wewnętrzne
* zewnętrzne
* prywatne
Domyślnie widoczna jest grupa '''Ulubione'''.
<center>[[Plik:MessengerCTIM_contacts1.png|300px]]</center>

== Historia połączeń ==
Domyślnie wybrana zakładka '''Ostatnie''' w oknie głównym programu wyświetla historię połączeń jak i wiadomości czat. 
W historii każda pozycja oznacza co najmniej jedno połączenie lub wiadomość. Jeśli połączenie lub wiadomość pochodzi od tego samego użytkownika i jest ich więcej niż jedno, to przy odpowiedniej ikonie wyświetlana jest stosowna liczba. W każdej pozycji widoczny jest numer dzwoniącego, komentarz(jeśli jest on w książce numerów spoza centrali), czas i data realizacji połączenia. 
Jeśli w historii znajdują się nie przejrzane nieodebrane połączenia lub nieprzeczytane wiadomości to zakładka '''Ostatnie''' jest oznaczona czerwoną kropką. 
Z zakładki historii możliwe jest oddzwanianie lub wysyłanie wiadomości zwrotnych.

=Konfiguracja centrali Slican=
Do poprawnej współpracy aplikacji z centralą jest wymagane:
* odpowiednia licencja producenta
* specyficzna konfiguracja centrali
==Konfiguracja central IPx, CCT==
Za pomocą programu ConfgMAN:
* w menu '''''Globalne ustawienia->Globalne ustawienia/Pozostałe->ANo''''': skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji Abonenta menu '''''Abonenci->Abonenci/Ustawienia CTI
** '''AwdMbl''': włączyć zezwolenie na obsługę aplikacji
** '''MnNo''': skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja oraz ewentualnie drugi numer (dla telefonu z dual SIM)
** '''IncC''': ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 6.53.'''

==Konfiguracja centrali NCP==
Z poziomu aplikacji ConfigWEB
* w menu '''''Numery wewnętrzne->Ustawienia->Konfiguracja aplikacji CTI'''''" skonfigurować numer dostępowy, który wybierze aplikacja aby dodzwonić się do centrali celem zestawienia połączenia przychodzącego
* w edycji abonenta SIP, FXS, CTS, Numer MessengerCTI w menu '''''Numery wewnętrzne->Abonenci->CTI ustawienia'''''
** skonfigurować numer dostępowy GSM telefonu, na którym zainstalowana jest aplikacja
** ustawić typ obsługi połączeń przychodzących: przechwytywanie wywołań (rozdzwanianie tylko aplikacji i telefonu wewnętrznego central) lub dzwonienie równoległe (rozdzwanianie aplikacji i telefonu wewnętrznego centrali)

'''Minimalna wymagana wersja oprogramowania to: 1.11.'''

=Przykłady zastosowań=
Aplikacja '''''MessengerCTI.Mobile''''' może być atrakcyjnym narzędziem dla tych firm, które posiadają pracowników mobilnych z wymogiem ciągłego dostępu telefonicznego jako numer wewnętrzny danego systemu telefonicznego. 
Dobry przykładem mogą pracownicy:
* działu handlowego - z pracą w trybie mieszanym biuro <-> poza biurem
* działu serwisowego - z pracą ciągłą w terenie
* pracownicy zdalni - telepraca
* pracownicy mobilni - praca na dużym terenie (hale produkcyjne, obszary rozległe) - gdzie zasięg sieci typu WiFi lub DECT nie obejmuje takich obszarów.

Instrukcja obsługi MessengerCTI

2019-02-21T09:36:43Z

Marekg:

= Wstęp =
Slican '''MessengerCTI.Desktop''' to aplikacja komputerowa, której zadaniem jest ułatwienie pracy abonenta centrali Slican. Dzięki zastosowaniu interfejsu graficznego wyświetlanego na ekranie monitora komputerowego aplikacja pozwala na wygodną obsługę połączeń telefonicznych oraz innych czynności związanych z telefonią. Posiada kilka dodatkowych funkcji pozwalających na rozszerzenie możliwości telefonu stacjonarnego. Łączy w sobie funkcje sterowania telefonem stacjonarnym podłączonym do centrali, np. wybierania numeru, odbierania połączeń oraz pracy jako telefonu równoległego do niego. Aplikacja pozwala również na: dostęp do książki telefonicznej centrali, historii połączeń, podglądu statusów telefonów i aplikacji MessengerCTI innych abonentów, czatów tekstowych oraz wysyłania i odbierania wiadomości SMS. Dodatkowo, specjalnie dla nowej wersji bramofonów DPH.IP wyposażonych w kamerę - wprowadzono funkcję podglądu obrazu wideo.

Aplikacja może być używana we współpracy z wszystkimi rodzajami telefonów przyłączonych do central Slican: systemowymi CTS, analogowymi i telefonami VoIP. W najnowszej obecnie wersji firmware central (6.53 IPx i 1.11 NCP) może pracować również jako samodzielny telefon VoIP. W zależności od rodzaju skojarzonego telefonu obsługa połączeń za pomocą aplikacji nieznacznie różni się. W połączeniu z systemowym CTS integracja jest pełna, sterowanie połączeniem odbywa się łącznie z włączeniem trybu głośnomówiącego (wybranie numeru, zestawienie, odebranie i rozłączenie połaczenia). Na telefonie analogowym i SIP czynności te zawsze są związane z fizycznym podniesieniem słuchawki telefonu. Niemniej niewątpliwie największą korzyść przy korzystaniu z niej odniosą użytkownicy telefonów analogowych, ponieważ uzyskują oni dostęp do funkcjonalności zupełnie niedostępnych dla tej klasy telefonów.

=Podstawowe funkcjonalności=

===Obsługa kamer i bramofonu DPH.IP===
Wprowadzenie do sprzedaży bramofonów DPH.IP z obsługą kamer wymusiło stworzenie opcji dla wyświetlania z nich obrazu wideo. Możliwość taką wprowadzono w aplikacji '''MessengerCTI.Desktop'''. W przypadku połączenia z bramofonu do użytkownika aplikacji obraz z jego kamery pojawia się w nowym okienku na monitorze komputera. Po odebraniu i przeprowadzeniu rozmowy, a także bez konieczności rozmowy z osobą przy bramofonie, tylko po jej identyfikacji wizualnej, można za pomocą specjalnego przycisku otworzyć drzwi, bramę lub szlaban. Również w przeciwną stronę, dzwoniąc do bramofonu lub na inny dowolny numer wewnętrzny skojarzony z kamerą, na ekranie monitora pojawia się obraz z kamery. Pozwala to na czasową obserwację otoczenia zainstalowanej kamery, np.: osoby do której dzwonimy. Możliwe jest również wybranie i obserwację obrazu z dowolnej kamery bez konieczności wykonywania połączenia, tylko przez wskazanie skojarzonej ikony w aplikacji. Za pomocą '''MessengerCTI.Desktop''' możliwe jest korzystanie również z kamer innych producentów ale muszą one obsługiwać formaty wideo i kodeki zgodne z bibliotekami aplikacji VLC.

{{Uwaga|
Aplikacja '''MessengerCTI.Desktop''' została wydana głównie na potrzeby wyświetlania obrazu wideo z bramofonów DPH.IP i obecnie nie posiada jeszcze wszystkich funkcjonalności obsługiwanych przez aplikację '''PhoneCTI'''. Będą one sukcesywnie wdrażane}}

===Klient VoIP===
'''MessengerCTI.Desktop''' może pracować jako klient VoIP - telefon równoległy, powiązany z wyposażeniem telefonu biurkowego, stacjonarnego (FXS, CTS, SIP). Użytkownik sam decyduje na którym urządzeniu odebrać połączenie i przeprowadzić rozmowę - telefonie czy komputerze - wykorzystując jego wbudowane urządzenia audio (kartę dźwiękową, mikrofon, głośniki, ewentualnie zewnętrzne słuchawki). Od wersji 1.11 NCP nowością jest możliwość wykorzystania aplikacji jako samodzielnego telefonu SIP. Do pracy w takiej konfiguracji wymagana jest licencja CTIuserPlus.

===Książka kontaktów===
Dużą zaletą oprogramowania jest łatwy i wygodny dostęp do kontaktów z książek telefonicznych i wyświetlanie ich na komputerze użytkownika. W MessengerCTI.Desktop wykorzystywane są tylko książki zgromadzone w centrali. Kontakty mogą być pogrupowane zgodnie z wymaganiami użytkownika. Wprowadzanie nowych abonentów oraz modyfikacja wpisów istniejących może być dokonywana zarówno z telefonu systemowego jak i w wygodniejszy sposób, z komputera - programu '''MessengerCTI.Desktop''' lub '''WebCTI'''. Modyfikacja jest widoczna natychmiast po jej wprowadzeniu. Dostęp do książki pozwala na proste i wygodne wyszukiwanie w bazie numeru osoby, do której chcemy zadzwonić. W przeciwną stronę, przy połączeniach przychodzących na ekranie monitora wyświetla się nam czytelna informacja o osobie dzwoniącej.

===Historia połączeń===
Użytkownik programu posiada wgląd do historii wszystkich swoich połączeń, zarówno odebranych jak i nieodebranych. Zapisana jest ona w centrali Slican. Za pomocą '''MessengerCTI''' można ją wyświetlić, uzyskać informację o kolejności połączeń, dacie i godzinie ich przeprowadzenia a także o sumie połączeń nieodebranych wykonanych z tego samego numeru.

===Wiadomości tekstowe===
Przy pomocy '''MessengerCTI''' można przesyłać informacje tekstowe - z komunikatora wewnętrznego (czatu) przez siec komputerową - do innej osoby posiadającej '''MessengerCTI''', jak i w formie SMS na telefon i z telefonu GSM. Z czatu mogą korzystać wszyscy abonenci danej centrali oraz central z nią zlinkowanych systemem eSSL ver.2. Funkcjonalność ta jest szczególnie atrakcyjna dla tych firm, które posiadając centrale Slican nie zezwalają ze względów bezpieczeństwa na korzystanie z komunikatorów ogólnodostępnych. Dla zapewnienia równoległego dostępu z różnych urządzeń (komputer, smartfon) historia czatów i SMS zapisuje się bezpośrednio w centrali i na bieżąco synchronizuje z aplikacją MessengerCTI.Mobile.

===Współpraca z wersją mobilną===
Aplikację można również używać równolegle oraz zsynchronizować z '''MessengerCTI.Mobile''', czyli wersją Android na urządzenia mobilne.

= Wymagania minimalne =
W celu zainstalowania aplikacji SLICAN '''MessengerCTI.Desktop''' spełnione muszą zostać następujące wymagania minimalne:
* Procesor z taktowaniem - > 800MHz
* Pamięć RAM - 1GB
* Karta graficzna - zgodna z DirectX 9
* System operacyjny - Windows 7 lub nowszy
Na komputerze, który nie spełnia powyższych wymagań minimalnych możliwe jest zainstalowanie aplikacji, ale będzie ona działała wolno lub nie będzie w pełni funkcjonalna.

{{Uwaga|
Aplikacja '''''MessengerCTI.Desktop''''' współpracuje z centralami IPx, MAC i CCT wyposażonymi w firmware 6.52 lub wyższy, oraz NCP od fw. 1.10}}

=Instalacja aplikacji =
Używanie aplikacji '''MessengerCTI.Desktop''' jest licencjonowane więc wymaga wykupienia odpowiedniej licencji. Zakupiony kod jest wprowadzany w trakcie konfiguracji centrali i decyduje o ilości stanowisk, które mogą używać programu. Licencjonowanie aplikacji nie ma wpływu na jej instalację. Wersję instalacyjną programu można pobrać ze strefy ServNET [https://slican.pl/servnet] i zainstalować go na swoim komputerze. Po zainstalowaniu należy go odpowiednio skonfigurować wprowadzając niezbędne dane do połączenia aplikacji z centralą: '''[[Instrukcja obsługi MessengerCTI#Ustawienia - Połączenie|Ustawienia - Połączenie]]'''.

{{Uwaga|
Jeżeli numer wewnętrzny wprowadzony w zakładce '''[[Instrukcja obsługi MessengerCTI#Ustawienia - Połączenie|Ustawienia - Połączenie]]''' nie posiada uprawnień do korzystania z aplikacji '''''MessengerCTI''''' - nie będzie możliwości połączenia z centralą i synchronizacji danych.}}

Drugi etap (nieobowiązkowy) polega na wgraniu do zasobów centrali odpowiednio przygotowanego pliku zawierającego aplikację '''MessengerCTI.Desktop'''. Może to zostać wykonane przez administratora centrali, posiadającego uprawnienia administratora WebCTI. Operacja ta, jeżeli zostanie wykonana, umożliwia automatyczną aktualizację oprogramowania na stanowiskach roboczych. Aktualizacja została opisana w rozdziale [[Instrukcja obsługi MessengerCTI#Aktualizacja aplikacji|Aktualizacja aplikacji]].

== Uruchomienie aplikacji ==
Program '''MessengerCTI.Desktop''' uruchamia się identycznie jak każdy inny program w systemie operacyjnym Windows. W ustawieniach programu można aktywować funkcję automatycznego uruchamiania programu po starcie systemu operacyjnego. W trakcie uruchomienia następuje zalogowanie się programu do centrali (zgodnie z ustawieniami określonymi w zakładce [[Instrukcja obsługi MessengerCTI#Ustawienia - Połączenie|Ustawienia - Połączenie]]). Po pomyślnym zalogowaniu następuje synchronizacja danych programu z danymi w centrali.

== Aktualizacja aplikacji ==
Aktualizacja programu jest dokonywana automatycznie i użytkownik nie ma wpływu na jej przebieg. Podobnie jak aktualizacja firmware centrali, karty VoIP lub karty REC dokonywana jest również aktualizacja programu '''MessengerCTI.Desktop''' (przez administratora centrali). Każdorazowo podczas uruchomienia programu następuje porównanie wersji programu w centrali i programu zainstalowanego na komputerze. Jeżeli są różne, następuje automatyczne pobranie wersji znajdującej się w centrali, zainstalowanie jej, a następnie logowanie się aplikacji do centrali. W zależności od wersji programu znajdującego się w centrali aktualizacja może spowodować zainstalowanie nowszej lub starszej wersji.

=Dostępne konfiguracje=

Możliwości oferowane przez aplikację '''MessengerCTI.Desktop''' są uzależnione od przyjętej konfiguracji:
* równoległa praca telefonu stacjonarnego i aplikacji (aplikacja z wyłączonym trybem VoIP) - rozmowa za pomocą telefonu, aplikacja - aranżowanie dla telefonu połączeń wychodzących (CTS, FXS, SIP) oraz odbieranie na telefonie połączeń przychodzących (CTS)
* równoległa praca telefonu stacjonarnego i aplikacji (aplikacja w trybie VoIP) - niezależna obsługa połączeń telefonicznych - albo za pomocą telefonu, albo aplikacji
* autonomiczna praca aplikacji, bez telefonu stacjonarnego (aplikacja w trybie VoIP) - obsługa połączeń tylko za pomocą aplikacji

Pozostałe funkcjonalności, np.: czat tekstowy, wysyłanie i odbieranie SMS, wyświetlanie obrazu z kamer, korzystanie z historii połączeń i i książki kontaktów, konfiguracja statusu abonenta i aplikacji Messenger dostępne są w każdej z powyższych konfiguracji

Aplikacja '''MessengerCTI.Mobile''' jest przeznaczona dla mobilnych urządzeń z systemem Android i jej opis znajduje się na: '''[http://pubwiki.slican.pl/index.php/Instrukcja_obs%C5%82ugi_MessengerCTI.Mobile TUTAJ]'''

=='''MessengerCTI.Desktop''' w konfiguracji równoległej==

===Aplikacja z nieaktywnym trybem VoIP===
Przeprowadzanie rozmów (przesyłanie akustyki) odbywa się tylko za pomocą telefonu skojarzonego z aplikacją. Samodzielnie aplikacja pozwala:
* dla ruchu wychodzącego - wyszukanie numeru w książce kontaktów lub wpisanie numeru docelowego abonenta z klawiatury, wybrania opcji Zadzwoń, zestawienia połączenia w trybie głośnomówiącym na telefonie CTS
* dla ruchu przychodzącego - wyświetlenie numeru dzwoniącego w oknie wywołania, ewentualnie nazwy dzwoniącego pobranej z książki kontaktów centrali, odebranie połączenia w trybie głośnomówiącym na telefonie CTS
Dla telefonów FXS i SIP konieczne jest podniesienie słuchawki z widełek

<center>[[Plik:MessengerCTI.Desktop bez VoIP.png |800px]]</center>

===Aplikacja z aktywnym trybem VoIP===
Przeprowadzanie rozmów (przesyłanie akustyki) może odbyć się albo za pomocą telefonu, albo przez komputer i aplikację. Samodzielnie aplikacja pozwala:
* dla ruchu wychodzącego - wyszukanie numeru w książce kontaktów lub wpisanie numeru docelowego abonenta z klawiatury, wybrania opcji Zadzwoń, zestawienia połączenia i rozmowę za pomocą wbudowanego mikrofonu i głośnika komputera lub podłączone słuchawki zewnętrzne
* dla ruchu przychodzącego - wyzwolenie dzwonka, wyświetlenie numeru dzwoniącego w oknie wywołania, ewentualnie nazwy dzwoniącego pobranej z książki kontaktów centrali, odebranie połączenia i rozmowę przez wbudowany mikrofon i głośniki komputera lub podłączone słuchawki zewnętrzne.

<center>[[Plik:MessengerCTI.Desktop plus telefon.png |800px]]</center>

=='''MessengerCTI.Desktop''' jako samodzielny telefon (tylko NCP)==

===Aplikacja z aktywnym trybem VoIP===

Przeprowadzanie rozmów (przesyłanie akustyki) odbywa się tylko przez komputer i aplikację. Samodzielnie aplikacja pozwala:
* dla ruchu wychodzącego - wyszukanie numeru w książce kontaktów lub wpisanie numeru docelowego abonenta z klawiatury, wybrania opcji Zadzwoń, zestawienia połączenia i rozmowę przez wbudowany mikrofon i głośniki komputera lub podłączone słuchawki zewnętrzne
* dla ruchu przychodzącego - wyzwolenie dzwonka, wyświetlenie numeru dzwoniącego w oknie wywołania, ewentualnie nazwy dzwoniącego pobranej z książki kontaktów centrali, odebranie połączenia i rozmowę przez wbudowany mikrofon i głośniki komputera lub podłączone słuchawki zewnętrzne.

<center>[[Plik:MessengerCTI.Desktop bez telefonu.png |800px]]</center>

= Struktura programu =
==Okno główne ==
Okno główne aplikacji '''MessengerCTI.Desktop''' zawiera elementy interfejsu pełniące funkcje informacyjne oraz oferujące dostęp do okien dialogowych i wszystkich głównych funkcji:

<center>[[Plik:MessengerCTI_okno_główne.png]]</center>
===Górna część okna:===

[[Plik:MessengerCTI.Desktop - okno główne - góra.png]]
* z lewej:
** link do wersji programu

* z prawej:
** przycisk przywrócenia domyślnej pozycji okna
** Zamknij - przycisk zminimalizowania do tray'a

===Środkowa część okna:===

[[Plik:MessengerCTI.Desktop - okno główne - środek.png]]
* z lewej:
** ikona ręcznego ustawienia stanu aplikacji 

* w środku:
** nazwa programu, poniżej - Opis - edytowalne pole komentarza ustawiane przez użytkownika pozwalające na dodanie dodatkowej informacji opisowej, np. o zbliżającym się lub przebywaniu na urlopie, o zajmowaniu się wybranym projektem

* z prawej:
** Szukaj (lupa) - przycisk/pole wyszukiwania numeru lub nazwy abonenta
** Preferencje - dostęp do ustawień programu

===Dolna część okna:===

[[Plik:MessengerCTI.Desktop - okno główne - dół.png]]
* dostęp do zakładek:
** Kontakty - książka kontaktów centrali, z możliwością filtrowania
** Ostatnie - historia połączeń i przesyłanych wiadomości

== Stan aplikacji i abonenta ==
Aplikacja '''MessengerCTI.Desktop''' pozwala na przedstawienie swojego aktualnego stanu za pomocą ikony w odpowiednim kolorze i wyświetlenia go w aplikacjach uruchomionych u innych użytkowników. Stan aplikacji symbolizuje pośrednio stan dostępności abonenta, który w zależności od aktualnie wykonywanych przez siebie czynności może być przez niego zmieniany ręcznie bądź automatycznie przez aplikację. Dopełnieniem stanu może być odpowiednio ustawiony komentarz. Wybranie danej ikony/symbolu pozwala na ręczną zmianę statusu przez użytkownika. Dodatkowo, graficznie wyświetlana jest informacja o rozdzwanianiu telefonu i przeprowadzaniu przez niego rozmowy.

=== Wykaz ikon i symboli ===
W tabeli przedstawiono wykaz ikon występujących w zakładkach '''Kontakty''' i '''Ostatnie''':
* [[Plik:MessengerCTI_tv_green.png | 32px]] - dla abonentów wewnętrznych centrali - ikona w różnych kolorach (z lewej strony nazwy abonenta) przedstawiająca aktualny stan aplikacji. Może być on ustawiony ręcznie z okna głównego aplikacji - ikona [[Plik:MessengerCTI_free.png]], oraz w przypadku '''Zaraz wracam''' także automatycznie.
* [[Plik:MessengerCTI_history.png | 32px]] - dla abonentów publicznych
* [[Plik:MessengerCTI_close_door.png | 32px]] - dla bramofonów DPH.IP z przyłączonym czujnikiem otwarcia drzwi

{|{{prettytable}}
!{{Hl3}} colspan="2" | Stan aplikacji oraz bramofonów DPH.IP
|-
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTI_tv_green.png | 32px]] ||abonent centrali; aplikacja '''MessengerCTI.Desktop''' jest uruchomiona i '''Zalogowana''' z komputera abonenta. Klikniecie w ikonę pozwala wysłać wiadomość tekstową do innego użytkownika tej aplikacji,wiadomość SMS lub wykonać połączenie telefoniczne
|-
|{{align|center}}|[[Plik:MessengerCTI_chat_tv_yellow.png | 29px]] ||abonent centrali; użytkownik lub aplikacja ustawiła stan '''Zaraz wracam''', czas zwłoki zdefiniowany jest w ogólnych ustawieniach aplikacji
|-
|{{align|center}}|[[Plik:MessengerCTI_tv_red.png‎ | 32px]] ||abonent centrali; użytkownik ustawił stan '''Nie przeszkadzać'''
|-
|{{align|center}}|[[Plik:MessengerCTI_tv_grey.png | 32px]] ||abonent centrali; aplikacja nie zalogowana lub ustawiony stan '''Niewidoczny'''
|-
|{{align|center}}|[[Plik:MessengerCTI_tvtel_green.png | 32px]] ||abonent centrali; aplikacja zalogowana (stan aplikacji a więc i kolor ikony może zmieniać się), włączone uprawnienia do aplikacji mobilnej '''MessengerCTI.Mobile''' (ikona smartfona w kolorze niebieskim)
|-
|{{align|center}}|[[Plik:MessengerCTI_history.png | 32px]] ||abonent miejski; kliknięcie w ikonę pozwala na wysłanie wiadomości SMS lub wykonanie połączenia do wybranego abonenta
|-
|{{align|center}}|[[Plik:MessengerCTI_close_door.png | 32px]] ||bramofon; aktualne położenie drzwi - drzwi zamknięte, kliknięcie w ikonę umożliwia otwarcie drzwi
|-
|{{align|center}}|[[Plik:MessengerCTI_open_door.png | 32px]] ||bramofon; drzwi otwarte
|-
|{{align|center}}|[[Plik:MessengerCTI_alarm_open_door.png | 32px]] ||bramofon; alarm przekroczenia czasu otwarcia drzwi
|-
|}
'''''Tabela 1:''''' Ikony symbolizujące stan aplikacji, użytkowników oraz bramofonów. 

W tabeli przedstawiono wykaz ikon występujących po prawej stronie nazwy abonenta w zakładce '''Kontakty''' i '''Ostatnie'''. W przypadku telefonów będących numerami wewnętrznymi, pojawia się ikona symbolizująca stan telefonu.
<center>
{|{{prettytable}}
!{{Hl3}} colspan="2" | Stan telefonu oraz informacja o kamerze
|-
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTI_bell_red.png | 28px]] ||telefon rozdzwania się
|-
|{{align|center}}|[[Plik:MessengerCTI_phone_red.png | 32px]] ||z telefonu prowadzona jest rozmowa
|-
|{{align|center}}|[[Plik:MessengerCTI_camera.png | 25px]] ||kamera jest skojarzona z telefonem lub bramofonem, kliknięcie w ikonę pozwala na jej podgląd
|-
|}
</center>
<center>'''''Tabela 2:''''' Ikony symbolizujące stan telefonu i kamery</center>

== Preferencje ==

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

=== Połączenie ===
W zakładce '''''Połączenie''''' należy wprowadzić niezbędne dane logowania aplikacji:

<center>[[Plik:MessengerCTI_polaczenie.png]]</center>

'''Ustawienia logowania aplikacji'''

Do poprawnego zalogowania aplikacji wymagane jest wprowadzenie przez administratora w konfiguracji centrali odpowiednich danych:
* numeru abonenta - w ustawieniach numeracji abonentów centrali
* poziomu dostępu CTI i hasło:
** dla central IPx, MAC, CCT - '''ConfigMAN''' arkusz '''Abonenci/Ustawienia CTI''' - '''CTI - poziom dostępu''' i hasło '''Pss'''
** dla central NCP - '''ConfigWEB''' arkusz '''Numery wewnętrzne/Abonenci/CTI ustawienia''' - '''Dostęp do CTI''' i '''Hasło'''
* adresu IP centrali - w ustawieniach sieciowych centrali

Poziom dostępu CTI określa z jakich funkcjonalności aplikacji można będzie skorzystać:
* CTI.user - MessengerCTI bez funkcji VoIP i podglądu kamer
* CTI.userPlus - MessengerCTI z VoIP i podglądem kamer

W ustawieniach połączenia aplikacji należy wprowadzić:
* w polu '''Numer abonenta''' - numer wewnętrzny telefonu, na który aplikacja '''MessengerCTI.Desktop''' ma zostać zalogowana
* w polu '''Hasło''' - zdefiniowane hasło CTI (może zawierać od 4 do 16 znaków, z wyłączeniem ";" i "~"). Podczas pierwszego logowania programu do centrali, może być wymagana zmiana hasła.
* '''adres IP serwera''' - adres IP interfejsu sieciowego centrali. W przypadku logowania aplikacji spoza sieci centrali - adres IP rutera brzegowego (konieczne przekierowanie portów na ruterze 5529 TCP, 8100 - 8300 UDP dla IPx, 10000-30000 UDP dla NCP - na interfejs LAN centrali)

Administrator centrali po pierwszej zmianie hasła użytkownika nie ma do niego dostępu. Hasło może zostać zapamiętane w aplikacji przez wstawienie znacznika w polu znajdującym się po jego prawej stronie. Jeżeli znacznik nie będzie wstawiony, program będzie pytał o nie przy każdej próbie logowania.

Po poprawnym skonfigurowaniu wszystkich wymienionych pól naciśnięcie klawisza "Połącz" spowoduje połączenie programu z centralą telefoniczną i synchronizację książki telefonicznej oraz pozostałych danych związanych z podanym numerem wewnętrznym. W dolnej części okna pojawi się napis - "Zalogowano pomyślnie".

Jeżeli wprowadzone dane są nieprawidłowe lub występuje problem z połączeniem sieciowym mogą pojawić się komunikaty:
* ''Błędny login lub hasło. Sprawdź czy wprowadzono poprawny login lub hasło''
* ''Łączenie do centrali'' na przemian z
* ''Brak połączenia z centralą. Sprawdź wprowadzony adres IP oraz stan połączenia PC z siecią lokalną''

=== Ogólne ===

<center>[[Plik:MessengerCTI_ustawienia_ogólne.png]]</center>

W oknie tym istnieje możliwość ustawienia parametrów decydujących o sposobie działania programu. Definiują one sposób jego uruchamiania i zachowania.

Dostępne ustawienia:
* Uruchom aplikację przy starcie systemu - ustawienie automatycznego uruchamiania aplikacji
* Uruchom zminimalizowany - aplikacja uruchomi się i będzie dostępna w obszarze powiadomień paska zadań systemu Windows
* Ustaw stan "Zaraz wracam" po czasie bezczynności - ustawienie odpowiedniej ikony informującej o naszej nieobecności przy komputerze po zadeklarowanym przez użytkownika czasie
* Włącz VoIP gdy dostępny - pozwala na pracę aplikacji jako klient VoIP (telefon VoIP)
* Wybierz skrót klawiszowy do okna aplikacji - przełącza okno aplikacji do obszaru powiadomień paska zadań systemu Windows i odwrotnie
* Wybierz działanie podwójnego kliknięcia (na numer lub kontakt):
** pokaż okno połączenia - pojawia się okno wyboru - numeru, połączenia telefonicznego, otwarcia okna Czat/SMS, zamknięcia bieżącego okna
** zadzwoń pod główny numer - automatyczne wybranie numeru
** pokaż ostatnie zdarzenia - wyświetla historię aktywności (połączeń, wiadomości) do abonenta
* Ustaw aktualną pozycję okna jako domyślną - wskazuje domyślne położenie okna aplikacji na ekranie

=== Ustawienia audio ===
W oknie znajdują się ustawienia związane z dźwiękowymi powiadomieniami o przychodzących połączeniach i wiadomościach oraz ustawieniami urządzeń komputera obsługującymi sygnał audio

<center>[[Plik:MessengerCTI_ustawienia_audio.png]]</center>

==Wykonywanie i odbieranie połączeń==

Do przeprowadzenia rozmowy między użytkownikami, niezbędne jest zapewnienie odpowiedniego sprzętu, oprogramowania oraz ich prawidłowej konfiguracji:
* centrala telefoniczna Slican
* stanowisko komputerowe z zainstalowanym i odpowiednio skonfigurowanym oprogramowaniem MessengerCTI.Desktop,
** program zalogowany do centrali na numer wewnętrzny abonenta (zakładka Preferencje, pole Połączenie),
* telefon systemowy Slican, VoIP lub analogowy,
* w przypadku połączeń z podglądem obrazu - bramofon DPH.IP z kamerą lub telefon ze skojarzoną z nim kamerą zewnętrzną (nie dotyczy telefonów VoIP z wbudowaną kamerą)

Połączenie można zestawić przy pomocy myszki komputerowej i monitora komputera. Sama rozmowa między abonentami odbywa się za pomocą telefonu podłączonego do centrali skojarzonego z programem MessengerCTI.Desktop. Po wybraniu z aplikacji numeru abonenta żądanego i zainicjowaniu połączenia, centrala automatycznie oddzwoni najpierw do wybierającego (powiadomi go o gotowości zestawienia połączenia) a po podniesieniu przez niego słuchawki telefonu, automatycznie zestawi połączenie do abonenta żądanego.

==='''Wykonywanie połączeń na określony numer'''===
<center>[[Plik:MessengerCTI - okno rozmowy wych.png]]</center>

Przeprowadzenie połączeń można realizować na kilka odmiennych sposobów. Częściowo zależy on od konfiguracji ustawień ogólnych aplikacji - opcja "Wybierz działanie podwójnego kliknięcia".
* z zakładki '''Kontakty'''
** wybieramy abonenta z odpowiedniej grupy (jeśli taka istnieje) lub bezpośrednio z grupy Wszystkie kontakty, połączenie wykonujemy przez dwuklik na numer lub kontakt
** klikając w ikonę [[Plik:MessengerCTI_tv_green.png | 32px]] lub [[Plik:MessengerCTI_history.png | 32px]]
* z pola '''Szukaj''' - bezpośrednio wpisując numer telefonu za pomocą klawiatury komputera, następnie klikając skojarzoną z polem zieloną słuchawkę.
* z zakładki '''Ostatnie''' - historii połączeń:
** odnajdujemy połączenie z abonentem, z którym mieliśmy kontakt (dzwonił do nas lub my do niego) a następnie połączenie wykonujemy przez dwuklik na numer lub kontakt
** klikając w jedną z ikon przy danym połączeniu: [[Plik:MessengerCTI_tv_green.png | 32px]] [[Plik:MessengerCTI_history.png | 32px]] [[Plik:MessengerCTI Połączenie wychodzące.PNG | 32px]] [[Plik:MessengerCTI Połączenie przychodzące.PNG | 32px]] [[Plik:MessengerCTI Połączenie nieodebrane.PNG | 32px]] [[Plik:MessengerCTI Wiadomość.PNG | 32px]] [[Plik:MessengerCTI Wiadomość1.PNG | 32px]]

==='''Połączenie przychodzące:'''===
<center>[[Plik:MessengerCTI - okno rozmowy przych.png]]</center>

Połączenie sygnalizowane jest na komputerze za pomocą wyskakującego okienka rozmowy, dzwonka aplikacji oraz dzwonka telefonu równoległego. W zależności od przyjętej konfiguracji aplikacji połączenie odebrać można za pomocą aplikacji lub telefonu.

==='''Połączenie z podglądem z kamery:'''===

Połączenia do/z bramofonu DPH.IP z wbudowaną kamerą lub z telefonem ze skojarzoną, zewnętrzną kamerą IP (nie dotyczy telefonów VoIP z wbudowaną kamerą), spowoduje na monitorze komputera automatyczne otwarcie okna z obrazem. Połączenie z bramofonem pozwala na bezpośrednie zidentyfikowanie stojącej osoby i za pomocą ikony [[Plik:MessengerCTI_close_door.png | 32px]] otwarcie drzwi lub bramy bez odebrania połączenia.

<center>[[Plik:MessengerCTI połaczenie z bramofonu.png]]</center>

==Przesyłanie wiadomości==
Aplikacja umożliwia przesyłanie (wysyłanie i przyjmowanie) wiadomości tekstowych pomiędzy użytkownikami aplikacji (czat wewnętrzny) oraz SMS. Wiadomość wysyłamy klikając ikonę [[Plik:MessengerCTI_tv_green.png | 32px]] [[Plik:MessengerCTI_history.png | 32px]] lub wpisując numer GSM w polu wyszukiwania okna głównego aplikacji. Jeśli w książce kontaktów centrali do numeru wewnętrznego abonenta jest dopisany numer komórkowy, to osoba wysyłająca ma możliwość wyboru jej rodzaju - czatu lub SMS.

Otrzymanie nowej wiadomości sygnalizowane jest na pasku powiadomień głównego okna Windows naprzemiennym wyświetlaniem ikon: [[Plik:MessengerCTI_free.png | 32px]] i [[Plik:MessengerCTI_mail.png | 32px]] oraz popapem [[Plik:MessengerCTI_nowa wiadomość.png]].

Historia wiadomości dostępna jest pod linkiem '''Wczytaj poprzednie'''. Przechowywana jest lokalnie na dysku komputera.

<center>[[Plik:MessengerCTI_czat.png]]</center>

==Wyszukiwanie danych==
W programie MessengerCTI zastosowano zaawansowany sposób wyszukiwania tekstów. Wyszukiwania można dokonywać w zakładce '''Kontakty''' w polu '''Szukaj''':

<center>[[Plik:MessengerCTI - pole wyszukiwania.PNG]]</center>

W trakcie wprowadzania znaków do powyższego okna, program przeprowadza automatyczne wyszukiwanie w całej bazie danych. Wpisy znalezione w grupie abonentów wyświetlanej po lewej stronie pola, wyświetlane są poniżej. Wpisy z pozostałych grup kwalifikowane są jako '''Sugerowane'''.

== Kontakty==
Umożliwia dodawanie, wyświetlanie, personalizację oraz uruchamianie wybranych akcji związanych z kontaktem. Domyślnie widoczna jest grupa '''Ulubione'''. Dostęp do abonentów z pozostałych grup można uzyskać rozwijając listę za pomoca myszki.

<center>[[Plik:MessengerCTI_Kontakty2.png]]</center>

Dodawanie kontaktów jest możliwe:
* z pola wyszukiwania - wpisując numer i dodając go przez ikonę zielonej słuchawki
* z zakładki '''Kontakty''' lub '''Ostatnie''' - prawoklikiem w połączenie

Z poziomu listy kontaktów uzyskujemy dostęp do:
* ulubionych
* wszystkich kontaktów
* numerów wewnętrznych
* utworzonych grup abonentów
* kontaktów publicznych
* kontaktów prywatnych

== Historia połączeń ==
Wybranie zakładki '''Ostatnie''' - oknie głównym programu, spowoduje wyświetlenie historii połączeń z udziałem telefonu o numerze wewnętrznym, na który zalogowany jest program '''''MessengerCTI.Desktop'''''. Okno główne przybiera następujący wygląd:

<center>[[Plik:MessengerCTI_Historia.PNG]]</center>

W historii widoczne są wszystkie połączenia dotyczące zalogowanego numeru. Każda pozycja z okna oznacza co najmniej jedno połączenie lub wiadomość. Jeśli od tego samego abonenta (numeru) jest ich więcej niż jedno, to przy odpowiedniej ikonie wyświetlana jest stosowna liczba. W każdej pozycji widoczny jest numer dzwoniącego, jego komentarz (w połączeniach wychodzących - numer wybrany i komentarz), czas lub data realizacji połączenia. W przypadku numerów wewnętrznych również stan rozmowy.
Oprócz informacji tekstowych w każdym wierszu znajduje się szereg ikon opisujących połączenie:

[[Plik:MessengerCTI Połączenie wychodzące.PNG | 32px]]
Strzałka oznacza połączenie wychodzące, niezależnie od tego czy doszło ono do skutku, czy też nie.

[[Plik:MessengerCTI Połączenie przychodzące.PNG | 32px]]
Strzałka oznacza połączenie przychodzące, które zostało odebrane.

[[Plik:MessengerCTI Połączenie nieodebrane.PNG | 32px]] lub [[Plik:MessengerCTI Połączenie nieodebrane ile.PNG | 38px]]
Strzałka oznacza nieodebrane połączenia przychodzące. Cyfra wskazuje na ich liczbę.

[[Plik:MessengerCTI Wiadomość.PNG | 32px]] [[Plik:MessengerCTI Wiadomość1.PNG | 32px]] lub [[Plik:MessengerCTI Wiadomość ile.PNG | 32px]]
Symbol oznacza, że z danym numerem wewnętrznym prowadzony był czat tekstowy lub wysłany SMS. Cyfra wskazuje na liczbę nieprzeczytanych wiadomości.

Jeśli w historii znajdują się nie przejrzane nieodebrane połączenia lub nieodczytane wiadomości to ikona z zakładki '''Ostatnie''' jest podświetlona na czerwono.

Z okna Historii połączeń możliwe jest oddzwanianie lub wysyłanie wiadomości do wskazanych użytkowników przy pomocy prawokliku na komentarzu abonenta, numeru, kliknięcia na ikonach [[Plik:MessengerCTI_tv_green.png | 32px]] [[Plik:MessengerCTI_history.png | 32px]] oraz
[[Plik:MessengerCTI Połączenie wychodzące.PNG | 32px]] [[Plik:MessengerCTI Połączenie przychodzące.PNG | 32px]] [[Plik:MessengerCTI Połączenie nieodebrane.PNG | 32px]] [[Plik:MessengerCTI Wiadomość.PNG | 32px]] [[Plik:MessengerCTI Wiadomość1.PNG | 32px]]. Jeżeli abonent wewnętrzny posiada w książce kontaktów dodatkowe numery, to jest możliwość wyboru jednego z nich. Dodatkowo, przy abonentach wewnętrznych dostępna jest edycja i usuwanie kontaktu oraz usunięcie z listy ulubionych.

=Licencjonowanie=
==Centrale IPx, MAC, CCT==
Aplikacja MessengerCTI.Desktop:
* MUSI ZAWSZE być powiązana z dowolnym portem abonenckim - analogowym, systemowym lub VoIP; dla portów abonenckich obowiązują standardowe licencje - wynika z tego, że w przypadku powiązania z portem VoIP konieczna jest dla tego portu licencja na 1 abonenta VoIP.
* w konfiguracji wykorzystującej funkcjonalność VoIP (praca jako telefon równoległy) nie jest konieczne powiązanie aplikacji z portem VoIP, jest to funkcjonalność aplikacji i w związku z tym może być powiązana z dowolnym rodzajem portu abonenckiego
* rozmowy z aplikacji w trybie VoIP wykorzystują kanały VoIP, w ten sam sposób jak inne urządzenia VoIP
* MessengerCTI.Desktop w konfiguracji bez funkcjonalności VoIP i podglądu kamer - wymagana licencja CTIuser
* MessengerCTI.Desktop z funkcjonalnością VoIP i podglądem kamer - wymagana licencja CTIuserPlus

==Centrala NCP==
Aplikacja MessengerCTI.Desktop:
* MOŻE być powiązana z dowolnym portem abonenckim - analogowym, systemowym lub VoIP; każdy port abonencki traktowany jest jako 1 user z licencji Base, dodatkowo w przypadku powiązania aplikacji z portem VoIP konieczna jest dla tego portu 1 licencja NCP.VoIPuser
** do pracy wykorzystującej funkcjonalność VoIP (telefon równoległy) nie jest konieczne powiązanie aplikacji z portem VoIP, jest to funkcjonalność aplikacji i w związku z tym może być powiązana z dowolnym rodzajem portu abonenckiego
** praca MessengerCTI.Desktop bez funkcjonalności VoIP i podglądu kamer - wymagana licencja NCP.CTIuser
** praca MessengerCTI.Desktop z funkcjonalnością VoIP i podglądem kamer - wymagana licencja NCP.CTIuserPlus

* MessengerCTI.Desktop jako samodzielny abonent - MCTI (nie powiązany z portem abonenckim):
** MessengerCTI.Desktop z funkcjonalnością VoIP i podglądem kamer - wymagane licencje NCP.VoIPuser oraz NCP.CTIuserPlus

=Obsługa kilku numerów przez jednego użytkownika=
Czasami istnieje konieczność obsługi kilku numerów przez jednego użytkownika. Na stacji roboczej (komputerze) konieczne jest wykorzystanie tzw. instancji. Zainstalować aplikację (tylko raz). Użytkownik musi przygotować pomocnicze skróty do aplikacji z dodatkowym parametrem. Pozwoli to na utworzenie kilku odrębnych konfiguracji.

* domyślna lokalizacja instalacji programu: C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe
** jeśli program nie znajduje się w lokalizacji domyślnej to należy wyszukać plik przy pomocy wyszukiwarki systemu Windows lub przez menu Start. Dla systemu Windows 10 - otworzyć Menu Start, odszukać katalog Slican, w katalogu odnaleźć program MessengerCTI, prawoklik -> Więcej/ Otwórz lokalizację pliku - wyświetli się ikona programu, prawoklik --> Właściwości/ Skrót/ Element docelowy
* utworzyć skrót do programu na pulpicie
* we właściwościach skrótu dopisać instancję - Właściwości/ Skrót/ Element docelowy: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''
* wykonać tyle kopii skrótu ile telefonów obsługiwać będzie użytkownik, w każdym z nich zmienić cyfrę instancji na kolejną wartość, np.: '''-instance 2''', '''-instance 3''', ...
* uruchamiając aplikację z poszczególnych skrótów zyskujemy możliwość konfiguracji programu dla kolejnych numerów

Użytkownik:Marekg

2019-02-19T12:44:46Z

Marekg: Utworzono nową stronę "'''Informacja'''"

'''Informacja'''

Instrukcja obsługi MessengerCTI

2019-02-19T12:44:19Z

Marekg: Zmiana określenia z "akustyka" na "tryb głośnomówiący", w drugim akapicie wstępu.

= Wstęp =
Slican '''MessengerCTI.Desktop''' to aplikacja komputerowa, której zadaniem jest ułatwienie pracy abonenta centrali Slican. Dzięki zastosowaniu interfejsu graficznego wyświetlanego na ekranie monitora komputerowego aplikacja pozwala na wygodną obsługę połączeń telefonicznych oraz innych czynności związanych z telefonią. Posiada kilka dodatkowych funkcji pozwalających na rozszerzenie możliwości telefonu stacjonarnego. Łączy w sobie funkcje sterowania telefonem stacjonarnym podłączonym do centrali, np. wybierania numeru, odbierania połączeń oraz pracy jako telefonu równoległego do niego. Aplikacja pozwala również na: dostęp do książki telefonicznej centrali, historii połączeń, podglądu statusów telefonów i aplikacji MessengerCTI innych abonentów, czatów tekstowych oraz wysyłania i odbierania wiadomości SMS. Dodatkowo, specjalnie dla nowej wersji bramofonów DPH.IP wyposażonych w kamerę - wprowadzono funkcję podglądu obrazu wideo.

Aplikacja może być używana we współpracy z wszystkimi rodzajami telefonów przyłączonych do central Slican: systemowymi CTS, analogowymi i telefonami VoIP. W najnowszej obecnie wersji firmware central (6.53 IPx i 1.11 NCP) może pracować również jako samodzielny telefon VoIP. W zależności od rodzaju skojarzonego telefonu obsługa połączeń za pomocą aplikacji nieznacznie różni się. W połączeniu z systemowym CTS integracja jest pełna, sterowanie połączeniem odbywa się łącznie z włączeniem trybu głośnomówiącego (wybranie numeru, zestawienie, odebranie i rozłączenie połaczenia). Na telefonie analogowym i SIP czynności te zawsze są związane z fizycznym podniesieniem słuchawki telefonu. Niemniej niewątpliwie największą korzyść przy korzystaniu z niej odniosą użytkownicy telefonów analogowych, ponieważ uzyskują oni dostęp do funkcjonalności zupełnie niedostępnych dla tej klasy telefonów.

=Podstawowe funkcjonalności=

===Obsługa kamer i bramofonu DPH.IP===
Wprowadzenie do sprzedaży bramofonów DPH.IP z obsługą kamer wymusiło stworzenie opcji dla wyświetlania z nich obrazu wideo. Możliwość taką wprowadzono w aplikacji '''MessengerCTI.Desktop'''. W przypadku połączenia z bramofonu do użytkownika aplikacji obraz z jego kamery pojawia się w nowym okienku na monitorze komputera. Po odebraniu i przeprowadzeniu rozmowy, a także bez konieczności rozmowy z osobą przy bramofonie, tylko po jej identyfikacji wizualnej, można za pomocą specjalnego przycisku otworzyć drzwi, bramę lub szlaban. Również w przeciwną stronę, dzwoniąc do bramofonu lub na inny dowolny numer wewnętrzny skojarzony z kamerą, na ekranie monitora pojawia się obraz z kamery. Pozwala to na czasową obserwację otoczenia zainstalowanej kamery, np.: osoby do której dzwonimy. Możliwe jest również wybranie i obserwację obrazu z dowolnej kamery bez konieczności wykonywania połączenia, tylko przez wskazanie skojarzonej ikony w aplikacji. Za pomocą '''MessengerCTI.Desktop''' możliwe jest korzystanie również z kamer innych producentów ale muszą one obsługiwać formaty wideo i kodeki zgodne z bibliotekami aplikacji VLC.

{{Uwaga|
Aplikacja '''MessengerCTI.Desktop''' została wydana głównie na potrzeby wyświetlania obrazu wideo z bramofonów DPH.IP i obecnie nie posiada jeszcze wszystkich funkcjonalności obsługiwanych przez aplikację '''PhoneCTI'''. Będą one sukcesywnie wdrażane}}

===Klient VoIP===
'''MessengerCTI.Desktop''' może pracować jako klient VoIP - telefon równoległy, powiązany z wyposażeniem telefonu biurkowego, stacjonarnego (FXS, CTS, SIP). Użytkownik sam decyduje na którym urządzeniu odebrać połączenie i przeprowadzić rozmowę - telefonie czy komputerze - wykorzystując jego wbudowane urządzenia audio (kartę dźwiękową, mikrofon, głośniki, ewentualnie zewnętrzne słuchawki). Od wersji 1.11 NCP nowością jest możliwość wykorzystania aplikacji jako samodzielnego telefonu SIP. Do pracy w takiej konfiguracji wymagana jest licencja CTIuserPlus.

===Książka kontaktów===
Dużą zaletą oprogramowania jest łatwy i wygodny dostęp do kontaktów z książek telefonicznych i wyświetlanie ich na komputerze użytkownika. W MessengerCTI.Desktop wykorzystywane są tylko książki zgromadzone w centrali. Kontakty mogą być pogrupowane zgodnie z wymaganiami użytkownika. Wprowadzanie nowych abonentów oraz modyfikacja wpisów istniejących może być dokonywana zarówno z telefonu systemowego jak i w wygodniejszy sposób, z komputera - programu '''MessengerCTI.Desktop''' lub '''WebCTI'''. Modyfikacja jest widoczna natychmiast po jej wprowadzeniu. Dostęp do książki pozwala na proste i wygodne wyszukiwanie w bazie numeru osoby, do której chcemy zadzwonić. W przeciwną stronę, przy połączeniach przychodzących na ekranie monitora wyświetla się nam czytelna informacja o osobie dzwoniącej.

===Historia połączeń===
Użytkownik programu posiada wgląd do historii wszystkich swoich połączeń, zarówno odebranych jak i nieodebranych. Zapisana jest ona w centrali Slican. Za pomocą '''MessengerCTI''' można ją wyświetlić, uzyskać informację o kolejności połączeń, dacie i godzinie ich przeprowadzenia a także o sumie połączeń nieodebranych wykonanych z tego samego numeru.

===Wiadomości tekstowe===
Przy pomocy '''MessengerCTI''' można przesyłać informacje tekstowe - z komunikatora wewnętrznego (czatu) przez siec komputerową - do innej osoby posiadającej '''MessengerCTI''', jak i w formie SMS na telefon i z telefonu GSM. Z czatu mogą korzystać wszyscy abonenci danej centrali oraz central z nią zlinkowanych systemem eSSL ver.2. Funkcjonalność ta jest szczególnie atrakcyjna dla tych firm, które posiadając centrale Slican nie zezwalają ze względów bezpieczeństwa na korzystanie z komunikatorów ogólnodostępnych. Dla zapewnienia równoległego dostępu z różnych urządzeń (komputer, smartfon) historia czatów i SMS zapisuje się bezpośrednio w centrali i na bieżąco synchronizuje z aplikacją MessengerCTI.Mobile.

===Współpraca z wersją mobilną===
Aplikację można również używać równolegle oraz zsynchronizować z '''MessengerCTI.Mobile''', czyli wersją Android na urządzenia mobilne.

= Wymagania minimalne =
W celu zainstalowania aplikacji SLICAN '''MessengerCTI.Desktop''' spełnione muszą zostać następujące wymagania minimalne:
* Procesor z taktowaniem - > 800MHz
* Pamięć RAM - 1GB
* Karta graficzna - zgodna z DirectX 9
* System operacyjny - Windows 7 lub nowszy
Na komputerze, który nie spełnia powyższych wymagań minimalnych możliwe jest zainstalowanie aplikacji, ale będzie ona działała wolno lub nie będzie w pełni funkcjonalna.

{{Uwaga|
Aplikacja '''''MessengerCTI.Desktop''''' współpracuje z centralami IPx, MAC i CCT wyposażonymi w firmware 6.52 lub wyższy, oraz NCP od fw. 1.10}}

=Instalacja aplikacji =
Używanie aplikacji '''MessengerCTI.Desktop''' jest licencjonowane więc wymaga wykupienia odpowiedniej licencji. Zakupiony kod jest wprowadzany w trakcie konfiguracji centrali i decyduje o ilości stanowisk, które mogą używać programu. Licencjonowanie aplikacji nie ma wpływu na jej instalację. Wersję instalacyjną programu można pobrać ze strefy ServNET [https://slican.pl/servnet] i zainstalować go na swoim komputerze. Po zainstalowaniu należy go odpowiednio skonfigurować wprowadzając niezbędne dane do połączenia aplikacji z centralą: '''[[Instrukcja obsługi MessengerCTI#Ustawienia - Połączenie|Ustawienia - Połączenie]]'''.

{{Uwaga|
Jeżeli numer wewnętrzny wprowadzony w zakładce '''[[Instrukcja obsługi MessengerCTI#Ustawienia - Połączenie|Ustawienia - Połączenie]]''' nie posiada uprawnień do korzystania z aplikacji '''''MessengerCTI''''' - nie będzie możliwości połączenia z centralą i synchronizacji danych.}}

Drugi etap (nieobowiązkowy) polega na wgraniu do zasobów centrali odpowiednio przygotowanego pliku zawierającego aplikację '''MessengerCTI.Desktop'''. Może to zostać wykonane przez administratora centrali, posiadającego uprawnienia administratora WebCTI. Operacja ta, jeżeli zostanie wykonana, umożliwia automatyczną aktualizację oprogramowania na stanowiskach roboczych. Aktualizacja została opisana w rozdziale [[Instrukcja obsługi MessengerCTI#Aktualizacja aplikacji|Aktualizacja aplikacji]].

== Uruchomienie aplikacji ==
Program '''MessengerCTI.Desktop''' uruchamia się identycznie jak każdy inny program w systemie operacyjnym Windows. W ustawieniach programu można aktywować funkcję automatycznego uruchamiania programu po starcie systemu operacyjnego. W trakcie uruchomienia następuje zalogowanie się programu do centrali (zgodnie z ustawieniami określonymi w zakładce [[Instrukcja obsługi MessengerCTI#Ustawienia - Połączenie|Ustawienia - Połączenie]]). Po pomyślnym zalogowaniu następuje synchronizacja danych programu z danymi w centrali.

== Aktualizacja aplikacji ==
Aktualizacja programu jest dokonywana automatycznie i użytkownik nie ma wpływu na jej przebieg. Podobnie jak aktualizacja firmware centrali, karty VoIP lub karty REC dokonywana jest również aktualizacja programu '''MessengerCTI.Desktop''' (przez administratora centrali). Każdorazowo podczas uruchomienia programu następuje porównanie wersji programu w centrali i programu zainstalowanego na komputerze. Jeżeli są różne, następuje automatyczne pobranie wersji znajdującej się w centrali, zainstalowanie jej, a następnie logowanie się aplikacji do centrali. W zależności od wersji programu znajdującego się w centrali aktualizacja może spowodować zainstalowanie nowszej lub starszej wersji.

=Dostępne konfiguracje=

Możliwości oferowane przez aplikację '''MessengerCTI.Desktop''' są uzależnione od przyjętej konfiguracji:
* równoległa praca telefonu stacjonarnego i aplikacji (aplikacja z wyłączonym trybem VoIP) - rozmowa za pomocą telefonu, aplikacja - aranżowanie dla telefonu połączeń wychodzących (CTS, FXS, SIP) oraz odbieranie na telefonie połączeń przychodzących (CTS)
* równoległa praca telefonu stacjonarnego i aplikacji (aplikacja w trybie VoIP) - niezależna obsługa połączeń telefonicznych - albo za pomocą telefonu, albo aplikacji
* autonomiczna praca aplikacji, bez telefonu stacjonarnego (aplikacja w trybie VoIP) - obsługa połączeń tylko za pomocą aplikacji

Pozostałe funkcjonalności, np.: czat tekstowy, wysyłanie i odbieranie SMS, wyświetlanie obrazu z kamer, korzystanie z historii połączeń i i książki kontaktów, konfiguracja statusu abonenta i aplikacji Messenger dostępne są w każdej z powyższych konfiguracji

Aplikacja '''MessengerCTI.Mobile''' jest przeznaczona dla mobilnych urządzeń z systemem Android i jej opis znajduje się na: '''[http://pubwiki.slican.pl/index.php/Instrukcja_obs%C5%82ugi_MessengerCTI.Mobile TUTAJ]'''

=='''MessengerCTI.Desktop''' w konfiguracji równoległej==

===Aplikacja z nieaktywnym trybem VoIP===
Przeprowadzanie rozmów (przesyłanie akustyki) odbywa się tylko za pomocą telefonu skojarzonego z aplikacją. Samodzielnie aplikacja pozwala:
* dla ruchu wychodzącego - wyszukanie numeru w książce kontaktów lub wpisanie numeru docelowego abonenta z klawiatury, wybrania opcji Zadzwoń, zestawienia połączenia w trybie głośnomówiącym na telefonie CTS
* dla ruchu przychodzącego - wyświetlenie numeru dzwoniącego w oknie wywołania, ewentualnie nazwy dzwoniącego pobranej z książki kontaktów centrali, odebranie połączenia w trybie głośnomówiącym na telefonie CTS
Dla telefonów FXS i SIP konieczne jest podniesienie słuchawki z widełek

<center>[[Plik:MessengerCTI.Desktop bez VoIP.png |800px]]</center>

===Aplikacja z aktywnym trybem VoIP===
Przeprowadzanie rozmów (przesyłanie akustyki) może odbyć się albo za pomocą telefonu, albo przez komputer i aplikację. Samodzielnie aplikacja pozwala:
* dla ruchu wychodzącego - wyszukanie numeru w książce kontaktów lub wpisanie numeru docelowego abonenta z klawiatury, wybrania opcji Zadzwoń, zestawienia połączenia i rozmowę za pomocą wbudowanego mikrofonu i głośnika komputera lub podłączone słuchawki zewnętrzne
* dla ruchu przychodzącego - wyzwolenie dzwonka, wyświetlenie numeru dzwoniącego w oknie wywołania, ewentualnie nazwy dzwoniącego pobranej z książki kontaktów centrali, odebranie połączenia i rozmowę przez wbudowany mikrofon i głośniki komputera lub podłączone słuchawki zewnętrzne.

<center>[[Plik:MessengerCTI.Desktop plus telefon.png |800px]]</center>

=='''MessengerCTI.Desktop''' jako samodzielny telefon (tylko NCP)==

===Aplikacja z aktywnym trybem VoIP===

Przeprowadzanie rozmów (przesyłanie akustyki) odbywa się tylko przez komputer i aplikację. Samodzielnie aplikacja pozwala:
* dla ruchu wychodzącego - wyszukanie numeru w książce kontaktów lub wpisanie numeru docelowego abonenta z klawiatury, wybrania opcji Zadzwoń, zestawienia połączenia i rozmowę przez wbudowany mikrofon i głośniki komputera lub podłączone słuchawki zewnętrzne
* dla ruchu przychodzącego - wyzwolenie dzwonka, wyświetlenie numeru dzwoniącego w oknie wywołania, ewentualnie nazwy dzwoniącego pobranej z książki kontaktów centrali, odebranie połączenia i rozmowę przez wbudowany mikrofon i głośniki komputera lub podłączone słuchawki zewnętrzne.

<center>[[Plik:MessengerCTI.Desktop bez telefonu.png |800px]]</center>

= Struktura programu =
==Okno główne ==
Okno główne aplikacji '''MessengerCTI.Desktop''' zawiera elementy interfejsu pełniące funkcje informacyjne oraz oferujące dostęp do okien dialogowych i wszystkich głównych funkcji:

<center>[[Plik:MessengerCTI_okno_główne.png]]</center>
===Górna część okna:===

[[Plik:MessengerCTI.Desktop - okno główne - góra.png]]
* z lewej:
** link do wersji programu

* z prawej:
** przycisk przywrócenia domyślnej pozycji okna
** Zamknij - przycisk zminimalizowania do tray'a

===Środkowa część okna:===

[[Plik:MessengerCTI.Desktop - okno główne - środek.png]]
* z lewej:
** ikona ręcznego ustawienia stanu aplikacji 

* w środku:
** nazwa programu, poniżej - Opis - edytowalne pole komentarza ustawiane przez użytkownika pozwalające na dodanie dodatkowej informacji opisowej, np. o zbliżającym się lub przebywaniu na urlopie, o zajmowaniu się wybranym projektem

* z prawej:
** Szukaj (lupa) - przycisk/pole wyszukiwania numeru lub nazwy abonenta
** Preferencje - dostęp do ustawień programu

===Dolna część okna:===

[[Plik:MessengerCTI.Desktop - okno główne - dół.png]]
* dostęp do zakładek:
** Kontakty - książka kontaktów centrali, z możliwością filtrowania
** Ostatnie - historia połączeń i przesyłanych wiadomości

== Stan aplikacji i abonenta ==
Aplikacja '''MessengerCTI.Desktop''' pozwala na przedstawienie swojego aktualnego stanu za pomocą ikony w odpowiednim kolorze i wyświetlenia go w aplikacjach uruchomionych u innych użytkowników. Stan aplikacji symbolizuje pośrednio stan dostępności abonenta, który w zależności od aktualnie wykonywanych przez siebie czynności może być przez niego zmieniany ręcznie bądź automatycznie przez aplikację. Dopełnieniem stanu może być odpowiednio ustawiony komentarz. Ikony w aplikacji zazwyczaj pozwalają na wykonanie wybranej akcji. Dodatkowo, graficznie wyświetlana jest informacja o rozdzwanianiu telefonu i przeprowadzaniu przez niego rozmowy.

=== Wykaz ikon i symboli ===
W tabeli przedstawiono wykaz ikon występujących w zakładkach '''Kontakty''' i '''Ostatnie''':
* [[Plik:MessengerCTI_tv_green.png | 32px]] - dla abonentów wewnętrznych centrali - ikona w różnych kolorach (z lewej strony nazwy abonenta) przedstawiająca aktualny stan aplikacji. Może być on ustawiony ręcznie z okna głównego aplikacji - ikona [[Plik:MessengerCTI_free.png]], oraz w przypadku '''Zaraz wracam''' także automatycznie.
* [[Plik:MessengerCTI_history.png | 32px]] - dla abonentów publicznych
* [[Plik:MessengerCTI_close_door.png | 32px]] - dla bramofonów DPH.IP z przyłączonym czujnikiem otwarcia drzwi

{|{{prettytable}}
!{{Hl3}} colspan="2" | Stan aplikacji oraz bramofonów DPH.IP
|-
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTI_tv_green.png | 32px]] ||abonent centrali; aplikacja '''MessengerCTI.Desktop''' jest uruchomiona i '''Zalogowana''' z komputera abonenta. Klikniecie w ikonę pozwala wysłać wiadomość tekstową do innego użytkownika tej aplikacji,wiadomość SMS lub wykonać połączenie telefoniczne
|-
|{{align|center}}|[[Plik:MessengerCTI_chat_tv_yellow.png | 29px]] ||abonent centrali; użytkownik lub aplikacja ustawiła stan '''Zaraz wracam''', czas zwłoki zdefiniowany jest w ogólnych ustawieniach aplikacji
|-
|{{align|center}}|[[Plik:MessengerCTI_tv_red.png‎ | 32px]] ||abonent centrali; użytkownik ustawił stan '''Nie przeszkadzać'''
|-
|{{align|center}}|[[Plik:MessengerCTI_tv_grey.png | 32px]] ||abonent centrali; aplikacja nie zalogowana lub ustawiony stan '''Niewidoczny'''
|-
|{{align|center}}|[[Plik:MessengerCTI_tvtel_green.png | 32px]] ||abonent centrali; aplikacja zalogowana (stan aplikacji a więc i kolor ikony może zmieniać się), włączone uprawnienia do aplikacji mobilnej '''MessengerCTI.Mobile''' (ikona smartfona w kolorze niebieskim)
|-
|{{align|center}}|[[Plik:MessengerCTI_history.png | 32px]] ||abonent miejski; kliknięcie w ikonę pozwala na wysłanie wiadomości SMS lub wykonanie połączenia do wybranego abonenta
|-
|{{align|center}}|[[Plik:MessengerCTI_close_door.png | 32px]] ||bramofon; aktualne położenie drzwi - drzwi zamknięte, kliknięcie w ikonę umożliwia otwarcie drzwi
|-
|{{align|center}}|[[Plik:MessengerCTI_open_door.png | 32px]] ||bramofon; drzwi otwarte
|-
|{{align|center}}|[[Plik:MessengerCTI_alarm_open_door.png | 32px]] ||bramofon; alarm przekroczenia czasu otwarcia drzwi
|-
|}
'''''Tabela 1:''''' Ikony symbolizujące stan aplikacji, użytkowników oraz bramofonów. 

W tabeli przedstawiono wykaz ikon występujących po prawej stronie nazwy abonenta w zakładce '''Kontakty''' i '''Ostatnie'''. W przypadku telefonów będących numerami wewnętrznymi, pojawia się ikona symbolizująca stan telefonu.
<center>
{|{{prettytable}}
!{{Hl3}} colspan="2" | Stan telefonu oraz informacja o kamerze
|-
!{{Hl1}}|Ikona !!{{Hl1}}| Znaczenie ikony
|-
|{{align|center}}|[[Plik:MessengerCTI_bell_red.png | 28px]] ||telefon rozdzwania się
|-
|{{align|center}}|[[Plik:MessengerCTI_phone_red.png | 32px]] ||z telefonu prowadzona jest rozmowa
|-
|{{align|center}}|[[Plik:MessengerCTI_camera.png | 25px]] ||kamera jest skojarzona z telefonem lub bramofonem, kliknięcie w ikonę pozwala na jej podgląd
|-
|}
</center>
<center>'''''Tabela 2:''''' Ikony symbolizujące stan telefonu i kamery</center>

== Preferencje ==

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

=== Połączenie ===
W zakładce '''''Połączenie''''' należy wprowadzić niezbędne dane logowania aplikacji:

<center>[[Plik:MessengerCTI_polaczenie.png]]</center>

'''Ustawienia logowania aplikacji'''

Do poprawnego zalogowania aplikacji wymagane jest wprowadzenie przez administratora w konfiguracji centrali odpowiednich danych:
* numeru abonenta - w ustawieniach numeracji abonentów centrali
* poziomu dostępu CTI i hasło:
** dla central IPx, MAC, CCT - '''ConfigMAN''' arkusz '''Abonenci/Ustawienia CTI''' - '''CTI - poziom dostępu''' i hasło '''Pss'''
** dla central NCP - '''ConfigWEB''' arkusz '''Numery wewnętrzne/Abonenci/CTI ustawienia''' - '''Dostęp do CTI''' i '''Hasło'''
* adresu IP centrali - w ustawieniach sieciowych centrali

Poziom dostępu CTI określa z jakich funkcjonalności aplikacji można będzie skorzystać:
* CTI.user - MessengerCTI bez funkcji VoIP i podglądu kamer
* CTI.userPlus - MessengerCTI z VoIP i podglądem kamer

W ustawieniach połączenia aplikacji należy wprowadzić:
* w polu '''Numer abonenta''' - numer wewnętrzny telefonu, na który aplikacja '''MessengerCTI.Desktop''' ma zostać zalogowana
* w polu '''Hasło''' - zdefiniowane hasło CTI (może zawierać od 4 do 16 znaków, z wyłączeniem ";" i "~"). Podczas pierwszego logowania programu do centrali, może być wymagana zmiana hasła.
* '''adres IP serwera''' - adres IP interfejsu sieciowego centrali. W przypadku logowania aplikacji spoza sieci centrali - adres IP rutera brzegowego (konieczne przekierowanie portów na ruterze 5529 TCP, 8100 - 8300 UDP dla IPx, 10000-30000 UDP dla NCP - na interfejs LAN centrali)

Administrator centrali po pierwszej zmianie hasła użytkownika nie ma do niego dostępu. Hasło może zostać zapamiętane w aplikacji przez wstawienie znacznika w polu znajdującym się po jego prawej stronie. Jeżeli znacznik nie będzie wstawiony, program będzie pytał o nie przy każdej próbie logowania.

Po poprawnym skonfigurowaniu wszystkich wymienionych pól naciśnięcie klawisza "Połącz" spowoduje połączenie programu z centralą telefoniczną i synchronizację książki telefonicznej oraz pozostałych danych związanych z podanym numerem wewnętrznym. W dolnej części okna pojawi się napis - "Zalogowano pomyślnie".

Jeżeli wprowadzone dane są nieprawidłowe lub występuje problem z połączeniem sieciowym mogą pojawić się komunikaty:
* ''Błędny login lub hasło. Sprawdź czy wprowadzono poprawny login lub hasło''
* ''Łączenie do centrali'' na przemian z
* ''Brak połączenia z centralą. Sprawdź wprowadzony adres IP oraz stan połączenia PC z siecią lokalną''

=== Ogólne ===

<center>[[Plik:MessengerCTI_ustawienia_ogólne.png]]</center>

W oknie tym istnieje możliwość ustawienia parametrów decydujących o sposobie działania programu. Definiują one sposób jego uruchamiania i zachowania.

Dostępne ustawienia:
* Uruchom aplikację przy starcie systemu - ustawienie automatycznego uruchamiania aplikacji
* Uruchom zminimalizowany - aplikacja uruchomi się i będzie dostępna w obszarze powiadomień paska zadań systemu Windows
* Ustaw stan "Zaraz wracam" po czasie bezczynności - ustawienie odpowiedniej ikony informującej o naszej nieobecności przy komputerze po zadeklarowanym przez użytkownika czasie
* Włącz VoIP gdy dostępny - pozwala na pracę aplikacji jako klient VoIP (telefon VoIP)
* Wybierz skrót klawiszowy do okna aplikacji - przełącza okno aplikacji do obszaru powiadomień paska zadań systemu Windows i odwrotnie
* Wybierz działanie podwójnego kliknięcia (na numer lub kontakt):
** pokaż okno połączenia - pojawia się okno wyboru - numeru, połączenia telefonicznego, otwarcia okna Czat/SMS, zamknięcia bieżącego okna
** zadzwoń pod główny numer - automatyczne wybranie numeru
** pokaż ostatnie zdarzenia - wyświetla historię aktywności (połączeń, wiadomości) do abonenta
* Ustaw aktualną pozycję okna jako domyślną - wskazuje domyślne położenie okna aplikacji na ekranie

=== Ustawienia audio ===
W oknie znajdują się ustawienia związane z dźwiękowymi powiadomieniami o przychodzących połączeniach i wiadomościach oraz ustawieniami urządzeń komputera obsługującymi sygnał audio

<center>[[Plik:MessengerCTI_ustawienia_audio.png]]</center>

==Wykonywanie i odbieranie połączeń==

Do przeprowadzenia rozmowy między użytkownikami, niezbędne jest zapewnienie odpowiedniego sprzętu, oprogramowania oraz ich prawidłowej konfiguracji:
* centrala telefoniczna Slican
* stanowisko komputerowe z zainstalowanym i odpowiednio skonfigurowanym oprogramowaniem MessengerCTI.Desktop,
** program zalogowany do centrali na numer wewnętrzny abonenta (zakładka Preferencje, pole Połączenie),
* telefon systemowy Slican, VoIP lub analogowy,
* w przypadku połączeń z podglądem obrazu - bramofon DPH.IP z kamerą lub telefon ze skojarzoną z nim kamerą zewnętrzną (nie dotyczy telefonów VoIP z wbudowaną kamerą)

Połączenie można zestawić przy pomocy myszki komputerowej i monitora komputera. Sama rozmowa między abonentami odbywa się za pomocą telefonu podłączonego do centrali skojarzonego z programem MessengerCTI.Desktop. Po wybraniu z aplikacji numeru abonenta żądanego i zainicjowaniu połączenia, centrala automatycznie oddzwoni najpierw do wybierającego (powiadomi go o gotowości zestawienia połączenia) a po podniesieniu przez niego słuchawki telefonu, automatycznie zestawi połączenie do abonenta żądanego.

==='''Wykonywanie połączeń na określony numer'''===
<center>[[Plik:MessengerCTI - okno rozmowy wych.png]]</center>

Przeprowadzenie połączeń można realizować na kilka odmiennych sposobów. Częściowo zależy on od konfiguracji ustawień ogólnych aplikacji - opcja "Wybierz działanie podwójnego kliknięcia".
* z zakładki '''Kontakty'''
** wybieramy abonenta z odpowiedniej grupy (jeśli taka istnieje) lub bezpośrednio z grupy Wszystkie kontakty, połączenie wykonujemy przez dwuklik na numer lub kontakt
** klikając w ikonę [[Plik:MessengerCTI_tv_green.png | 32px]] lub [[Plik:MessengerCTI_history.png | 32px]]
* z pola '''Szukaj''' - bezpośrednio wpisując numer telefonu za pomocą klawiatury komputera, następnie klikając skojarzoną z polem zieloną słuchawkę.
* z zakładki '''Ostatnie''' - historii połączeń:
** odnajdujemy połączenie z abonentem, z którym mieliśmy kontakt (dzwonił do nas lub my do niego) a następnie połączenie wykonujemy przez dwuklik na numer lub kontakt
** klikając w jedną z ikon przy danym połączeniu: [[Plik:MessengerCTI_tv_green.png | 32px]] [[Plik:MessengerCTI_history.png | 32px]] [[Plik:MessengerCTI Połączenie wychodzące.PNG | 32px]] [[Plik:MessengerCTI Połączenie przychodzące.PNG | 32px]] [[Plik:MessengerCTI Połączenie nieodebrane.PNG | 32px]] [[Plik:MessengerCTI Wiadomość.PNG | 32px]] [[Plik:MessengerCTI Wiadomość1.PNG | 32px]]

==='''Połączenie przychodzące:'''===
<center>[[Plik:MessengerCTI - okno rozmowy przych.png]]</center>

Połączenie sygnalizowane jest na komputerze za pomocą wyskakującego okienka rozmowy, dzwonka aplikacji oraz dzwonka telefonu równoległego. W zależności od przyjętej konfiguracji aplikacji połączenie odebrać można za pomocą aplikacji lub telefonu.

==='''Połączenie z podglądem z kamery:'''===

Połączenia do/z bramofonu DPH.IP z wbudowaną kamerą lub z telefonem ze skojarzoną, zewnętrzną kamerą IP (nie dotyczy telefonów VoIP z wbudowaną kamerą), spowoduje na monitorze komputera automatyczne otwarcie okna z obrazem. Połączenie z bramofonem pozwala na bezpośrednie zidentyfikowanie stojącej osoby i za pomocą ikony [[Plik:MessengerCTI_close_door.png | 32px]] otwarcie drzwi lub bramy bez odebrania połączenia.

<center>[[Plik:MessengerCTI połaczenie z bramofonu.png]]</center>

==Przesyłanie wiadomości==
Aplikacja umożliwia przesyłanie (wysyłanie i przyjmowanie) wiadomości tekstowych pomiędzy użytkownikami aplikacji (czat wewnętrzny) oraz SMS. Wiadomość wysyłamy klikając ikonę [[Plik:MessengerCTI_tv_green.png | 32px]] [[Plik:MessengerCTI_history.png | 32px]] lub wpisując numer GSM w polu wyszukiwania okna głównego aplikacji. Jeśli w książce kontaktów centrali do numeru wewnętrznego abonenta jest dopisany numer komórkowy, to osoba wysyłająca ma możliwość wyboru jej rodzaju - czatu lub SMS.

Otrzymanie nowej wiadomości sygnalizowane jest na pasku powiadomień głównego okna Windows naprzemiennym wyświetlaniem ikon: [[Plik:MessengerCTI_free.png | 32px]] i [[Plik:MessengerCTI_mail.png | 32px]] oraz popapem [[Plik:MessengerCTI_nowa wiadomość.png]].

Historia wiadomości dostępna jest pod linkiem '''Wczytaj poprzednie'''. Przechowywana jest lokalnie na dysku komputera.

<center>[[Plik:MessengerCTI_czat.png]]</center>

==Wyszukiwanie danych==
W programie MessengerCTI zastosowano zaawansowany sposób wyszukiwania tekstów. Wyszukiwania można dokonywać w zakładce '''Kontakty''' w polu '''Szukaj''':

<center>[[Plik:MessengerCTI - pole wyszukiwania.PNG]]</center>

W trakcie wprowadzania znaków do powyższego okna, program przeprowadza automatyczne wyszukiwanie w całej bazie danych. Wpisy znalezione w grupie abonentów wyświetlanej po lewej stronie pola, wyświetlane są poniżej. Wpisy z pozostałych grup kwalifikowane są jako '''Sugerowane'''.

== Kontakty==
Umożliwia dodawanie, wyświetlanie, personalizację oraz uruchamianie wybranych akcji związanych z kontaktem. Domyślnie widoczna jest grupa '''Ulubione'''. Dostęp do abonentów z pozostałych grup można uzyskać rozwijając listę za pomoca myszki.

<center>[[Plik:MessengerCTI_Kontakty2.png]]</center>

Dodawanie kontaktów jest możliwe:
* z pola wyszukiwania - wpisując numer i dodając go przez ikonę zielonej słuchawki
* z zakładki '''Kontakty''' lub '''Ostatnie''' - prawoklikiem w połączenie

Z poziomu listy kontaktów uzyskujemy dostęp do:
* ulubionych
* wszystkich kontaktów
* numerów wewnętrznych
* utworzonych grup abonentów
* kontaktów publicznych
* kontaktów prywatnych

== Historia połączeń ==
Wybranie zakładki '''Ostatnie''' - oknie głównym programu, spowoduje wyświetlenie historii połączeń z udziałem telefonu o numerze wewnętrznym, na który zalogowany jest program '''''MessengerCTI.Desktop'''''. Okno główne przybiera następujący wygląd:

<center>[[Plik:MessengerCTI_Historia.PNG]]</center>

W historii widoczne są wszystkie połączenia dotyczące zalogowanego numeru. Każda pozycja z okna oznacza co najmniej jedno połączenie lub wiadomość. Jeśli od tego samego abonenta (numeru) jest ich więcej niż jedno, to przy odpowiedniej ikonie wyświetlana jest stosowna liczba. W każdej pozycji widoczny jest numer dzwoniącego, jego komentarz (w połączeniach wychodzących - numer wybrany i komentarz), czas lub data realizacji połączenia. W przypadku numerów wewnętrznych również stan rozmowy.
Oprócz informacji tekstowych w każdym wierszu znajduje się szereg ikon opisujących połączenie:

[[Plik:MessengerCTI Połączenie wychodzące.PNG | 32px]]
Strzałka oznacza połączenie wychodzące, niezależnie od tego czy doszło ono do skutku, czy też nie.

[[Plik:MessengerCTI Połączenie przychodzące.PNG | 32px]]
Strzałka oznacza połączenie przychodzące, które zostało odebrane.

[[Plik:MessengerCTI Połączenie nieodebrane.PNG | 32px]] lub [[Plik:MessengerCTI Połączenie nieodebrane ile.PNG | 38px]]
Strzałka oznacza nieodebrane połączenia przychodzące. Cyfra wskazuje na ich liczbę.

[[Plik:MessengerCTI Wiadomość.PNG | 32px]] [[Plik:MessengerCTI Wiadomość1.PNG | 32px]] lub [[Plik:MessengerCTI Wiadomość ile.PNG | 32px]]
Symbol oznacza, że z danym numerem wewnętrznym prowadzony był czat tekstowy lub wysłany SMS. Cyfra wskazuje na liczbę nieprzeczytanych wiadomości.

Jeśli w historii znajdują się nie przejrzane nieodebrane połączenia lub nieodczytane wiadomości to ikona z zakładki '''Ostatnie''' jest podświetlona na czerwono.

Z okna Historii połączeń możliwe jest oddzwanianie lub wysyłanie wiadomości do wskazanych użytkowników przy pomocy prawokliku na komentarzu abonenta, numeru, kliknięcia na ikonach [[Plik:MessengerCTI_tv_green.png | 32px]] [[Plik:MessengerCTI_history.png | 32px]] oraz
[[Plik:MessengerCTI Połączenie wychodzące.PNG | 32px]] [[Plik:MessengerCTI Połączenie przychodzące.PNG | 32px]] [[Plik:MessengerCTI Połączenie nieodebrane.PNG | 32px]] [[Plik:MessengerCTI Wiadomość.PNG | 32px]] [[Plik:MessengerCTI Wiadomość1.PNG | 32px]]. Jeżeli abonent wewnętrzny posiada w książce kontaktów dodatkowe numery, to jest możliwość wyboru jednego z nich. Dodatkowo, przy abonentach wewnętrznych dostępna jest edycja i usuwanie kontaktu oraz usunięcie z listy ulubionych.

=Licencjonowanie=
==Centrale IPx, MAC, CCT==
Aplikacja MessengerCTI.Desktop:
* MUSI ZAWSZE być powiązana z dowolnym portem abonenckim - analogowym, systemowym lub VoIP; dla portów abonenckich obowiązują standardowe licencje - wynika z tego, że w przypadku powiązania z portem VoIP konieczna jest dla tego portu licencja na 1 abonenta VoIP.
* w konfiguracji wykorzystującej funkcjonalność VoIP (praca jako telefon równoległy) nie jest konieczne powiązanie aplikacji z portem VoIP, jest to funkcjonalność aplikacji i w związku z tym może być powiązana z dowolnym rodzajem portu abonenckiego
* rozmowy z aplikacji w trybie VoIP wykorzystują kanały VoIP, w ten sam sposób jak inne urządzenia VoIP
* MessengerCTI.Desktop w konfiguracji bez funkcjonalności VoIP i podglądu kamer - wymagana licencja CTIuser
* MessengerCTI.Desktop z funkcjonalnością VoIP i podglądem kamer - wymagana licencja CTIuserPlus

==Centrala NCP==
Aplikacja MessengerCTI.Desktop:
* MOŻE być powiązana z dowolnym portem abonenckim - analogowym, systemowym lub VoIP; każdy port abonencki traktowany jest jako 1 user z licencji Base, dodatkowo w przypadku powiązania aplikacji z portem VoIP konieczna jest dla tego portu 1 licencja NCP.VoIPuser
** do pracy wykorzystującej funkcjonalność VoIP (telefon równoległy) nie jest konieczne powiązanie aplikacji z portem VoIP, jest to funkcjonalność aplikacji i w związku z tym może być powiązana z dowolnym rodzajem portu abonenckiego
** praca MessengerCTI.Desktop bez funkcjonalności VoIP i podglądu kamer - wymagana licencja NCP.CTIuser
** praca MessengerCTI.Desktop z funkcjonalnością VoIP i podglądem kamer - wymagana licencja NCP.CTIuserPlus

* MessengerCTI.Desktop jako samodzielny abonent - MCTI (nie powiązany z portem abonenckim):
** MessengerCTI.Desktop z funkcjonalnością VoIP i podglądem kamer - wymagane licencje NCP.VoIPuser oraz NCP.CTIuserPlus

=Obsługa kilku numerów przez jednego użytkownika=
Czasami istnieje konieczność obsługi kilku numerów przez jednego użytkownika. Na stacji roboczej (komputerze) konieczne jest wykorzystanie tzw. instancji. Zainstalować aplikację (tylko raz). Użytkownik musi przygotować pomocnicze skróty do aplikacji z dodatkowym parametrem. Pozwoli to na utworzenie kilku odrębnych konfiguracji.

* domyślna lokalizacja instalacji programu: C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe
** jeśli program nie znajduje się w lokalizacji domyślnej to należy wyszukać plik przy pomocy wyszukiwarki systemu Windows lub przez menu Start. Dla systemu Windows 10 - otworzyć Menu Start, odszukać katalog Slican, w katalogu odnaleźć program MessengerCTI, prawoklik -> Więcej/ Otwórz lokalizację pliku - wyświetli się ikona programu, prawoklik --> Właściwości/ Skrót/ Element docelowy
* utworzyć skrót do programu na pulpicie
* we właściwościach skrótu dopisać instancję - Właściwości/ Skrót/ Element docelowy: "C:\Program Files (x86)\Slican\MessengerCTI\messengercti.exe" '''-instance 1'''
* wykonać tyle kopii skrótu ile telefonów obsługiwać będzie użytkownik, w każdym z nich zmienić cyfrę instancji na kolejną wartość, np.: '''-instance 2''', '''-instance 3''', ...
* uruchamiając aplikację z poszczególnych skrótów zyskujemy możliwość konfiguracji programu dla kolejnych numerów