Difference between revisions of "SenderSMS manual"

From pubWiki-en
Jump to: navigation, search
(Created page with "==Wstęp== SenderSMS to aplikacja służąca do seryjnego wysyłania wiadomości SMS przy wykorzystaniu serwerów SLICAN. Jej głównym zadaniem jest zapewnienie skutecznej komu...")
 
Line 1: Line 1:
==Wstęp==
+
==Introduction==
SenderSMS to aplikacja służąca do seryjnego wysyłania wiadomości SMS przy wykorzystaniu serwerów SLICAN.  
+
SenderSMS is a application for serial SMS messages sending using Slican PBXes.
Jej głównym zadaniem jest zapewnienie skutecznej komunikacji SMS zarówno w kontaktach z kontrahentami, klientami lub też celach marketingowych oraz typowo informacyjnych z pacjentami, studentami czy centrami powiadamiania SMS(Urzędy Powiatowe, Gminne, Miejskie, Biura Bezpieczeństwa i Zarządzania Kryzysowego).  
+
Its main purpose is providing efficent SMS communication between contractors and clients, for marketing purposes or as information center for patients, students or notification centers (agencies, authorities, security bureaus).
  
Aplikacja przeznaczona jest do pracy jednostanowiskowej z możliwością pracy sieciowej (wspólna baza danych) jednakże z pewnymi ograniczeniami. W przypadku pracy jednostanowiskowej operatorzy mogą mieć przypisane te same bramki przez które realizowana jest wysyłka natomiast w przypadku pracy sieciowej każde stanowisko musi mieć przypisaną indywidualną bramkę. Związane jest to z faktem utrzymywania tylko jednego połączenia sieciowego przez centrale.
+
Application is design for one-stand work with possibility of network cooperation (shared database) with some limitations. In case of multi-stands, each user needs to be assigned to a individual GSM module. It's a matter of one connection session, uptimed by PBX.
 +
to aplikacja służąca do seryjnego wysyłania wiadomości SMS przy wykorzystaniu serwerów SLICAN.  
  
 
{| style="background-color: transparent" cellspacing="0" cellpadding="0" align="center" width="100%"
 
{| style="background-color: transparent" cellspacing="0" cellpadding="0" align="center" width="100%"
Line 11: Line 12:
 
|-
 
|-
 
|
 
|
| <b>UWAGA:
+
| <b>WARNING:
SenderSMS współpracuje z firmware centrali w wersji '''6.22''' lub wyższym.
+
SenderSMS works with '''6.22''' fimrware version or higher.
 
|}
 
|}
  
==Wymagania minimalne==
+
==Minimal requirements==
W celu zainstalowania aplikacji SenderSMS spełnione muszą zostać następujące wymagania:
+
*800MHz processor,
*Komputer taktowany zegarem nie mniej niż 800MHz,
+
*1GB RAM or higher,
*Pamięć RAM komputera nie mniej niż 1GB,
+
*WindowsXP SP2 or newer.
*WindowsXP SP2 lub nowszy.
+
  
==Funkcjonalność programu==
+
==Application features==
*Tworzenie kontaktów, grup kontaktów,
+
*Adding contacts or contact groups,
*Szablony wiadomości(prywatne, publiczne),
+
*Messages templates (private, public),
*Personalizowanie wiadomości na podstawie pól kontaktu,
+
*Personalization of messages, based on contacts fields,
*Automatyczne rejestrowanie i wyrejestrowanie kontaktu na podstawie przesłanego kodu SMS,
+
*Automatic contact registration/deregistration with sent SMS message,
*Obsługa polskich znaków diakrytycznych,
+
*"Flash" type messages,
*Wiadomości typu "flash",
+
*History of sent/received messages, along with delivery report,
*Rejestrowanie wiadomości przychodzących, wychodzących wraz z raportami doręczeń,
+
*Numbers blacklist,
*Zabezpieczenie przed wysłaniem wiadomości na wybrane numery (czarna lista),
+
*Contacts import/export,
*Import/eksport kontaktów,
+
*Multi-level application access (admin, manager, operating personel),
*Wielopoziomowy dostęp do aplikacji (administrator, zarządzający, obsługa),
+
*Multi GSM modules handling.
*Obsługa wielu bramek GSM.
+
  
==Instalacja aplikacji==
+
==Application installation==
Działanie aplikacji SenderSMS jest licencjonowane i jej używanie wymaga wykupienia odpowiedniej licencji. Zakupiony kod licencji jest wprowadzany w trakcie konfiguracji centrali i decyduje o ilości bramek GSM, które mogą być wykorzystywane przez aplikację. Licencjonowanie aplikacji nie ma wpływu na jej instalację. Wersję instalacyjną programu można pobrać ze strony domowej Slican i zainstalować program na swoim komputerze, wprowadzając po instalacji odpowiednie, niezbędne do połączenia aplikacji z centralą dane.  
+
SenderSMS work is licenced, and requires to purchase proper licence key. It describes GSM modules quantity for handling by application. Install file can be downloaded from Slican's website and executed on users PC, for typing required connection data.
  
===Kreator pierwszego uruchomienia===
+
===First Run Wizard===
Przy pierwszym uruchomieniu aplikacji startuje kreator, którego zadaniem jest utworzenie głównego nieusuwalnego operatora(administrator) oraz skonfigurowanie:
+
At first application run, a Wizard is started for creation a admin account (not deletable) and configuring:
*połączenia z centralą,
+
*connection with PBX,
*konfiguracja bramek GSM przeznaczonych dla systemu,
+
*GSM modules for application use configuring,
*konfiguracja parametrów globalnych SMS oraz lokalnych administratora,
+
*SMS and account global parameters configuring,
*przydzielenie bramek GSM obsługiwanych przez administratora.
+
*GSM modules assigning by administrator.
Kreator zawiera siedem kroków do wstępnej konfiguracji przedstawionych poniżej:
+
Wizard has seven steps for initial configuration:
  
 
[[Grafika:Kreator_sendersms_1.png|center|]]
 
[[Grafika:Kreator_sendersms_1.png|center|]]
- '''KROK 1''': wstępne okno kreatora.
+
- '''STEP 1''': SenderSMS wizard window.
  
 
[[Grafika:kreator_sendersms_2.png|center|]]
 
[[Grafika:kreator_sendersms_2.png|center|]]
- '''KROK 2''': w polu ''"Adres IP centrali"'' podajemy adres IP sterownika centrali oraz konfigurujemy bramki GSM podając identyfikator bramki oraz PIN (pola ID i PIN arkusza      '''Translacje/Ustawienia GSM''' w programie ConfigMAN).
+
- '''STEP 2''': in '''PABX IP address''' we define PBX's controller card IP address, '''ID''' and '''PIN''' fields needs to be filled accoring to fields from ConfigMAN ('''Trunks/GSM settings''').
  
 
[[Grafika:kreator_sendersms_3.png|center|]]
 
[[Grafika:kreator_sendersms_3.png|center|]]
- '''KROK 3''': konfiguracja danych Administratora.
+
- '''STEP 3''': Admin information configuration.
  
 
[[Grafika:kreator_sendersms_4.png|center|]]
 
[[Grafika:kreator_sendersms_4.png|center|]]
- '''KROK 4''': wybór bramki/bramek GSM dla Administratora
+
- '''STEP 4''': GSM module(s) selection for administrator.
  
 
[[Grafika:kreator_sendersms_5.png|center|]]
 
[[Grafika:kreator_sendersms_5.png|center|]]
- '''KROK 5''': konfiguracja ustawień wiadomości SMS   
+
- '''STEP 5''': SMS settings window.  
  
 
[[Grafika:kreator_sendersms_6.png|center|]]
 
[[Grafika:kreator_sendersms_6.png|center|]]
- '''KROK 6''': ustawienie prefiksu kraju, w którym użytkowana jest aplikacja
+
- '''STEP 6''': Country prefix according to application use location.
  
 
[[Grafika:kreator_sendersms_7.png|center|]]
 
[[Grafika:kreator_sendersms_7.png|center|]]
- '''KROK 7''': podsumowanie konfiguracji powyższych kroków
+
- '''STEP 7''': Settings summary.
  
==Konfiguracja systemu==
+
==System configuration==
===Konfiguracja kontaktów i grup===
+
===Contacts and groups configuration===
<b>Kontakt</b>
+
<b>Contact</b>
  
Dodawanie kontaktów wykonuje się przez wybranie zakładki Kontakty i konfigurację kontaktu.
+
Adding contacts is done by choosing Contacts tab and record configuration.
  
 
[[Plik:Kontakty_dodawanie.jpg]]
 
[[Plik:Kontakty_dodawanie.jpg]]
Line 79: Line 78:
 
[[Grafika:kontakt_sendersms_1.png]][[Grafika:kontakt_sendersms_2.png]]
 
[[Grafika:kontakt_sendersms_1.png]][[Grafika:kontakt_sendersms_2.png]]
  
* definiowanie głównych danych kontaktu takich jak: imię, nazwisko,numer GSM, przynależność do grupy oraz tytuł
+
* definition of contact dana such as: Name, Last name, GSM number, group membership and title
* definiowanie pozostałych dodatkowych informacji: dane adresowe, opis    
+
* definition of contact's additional data: address, description    
  
Pole "Należy do grupy" umożliwia przypisanie kontaktu do dowolnej liczby grup zdefiniowanych w systemie.
+
In field '''Belongs to group''' we can assigned configured contact to group(s). Sending messages is possible only to contacts, with '''Active''' box checked.
Wysyłanie wiadomości SMS jest tylko do kontaktów którzy mają włączoną opcję "Aktywny".
+
  
<b>Grupa</b>
+
<b>Groups</b>
  
Funkcjonalność ta umożliwia logiczny podział kontaktów w grupy. W systemie istnieje jedna nieusuwalna grupa "Wszyscy" do której należą wszystkie kontakty.
+
This feature allows to group contacts. There is on not deletable group called "Everyone" which contains all created contacts.
W zależności od ustawień globalnych do grupy można przypisać kody, które umożliwiają automatyczne zapisywanie i wypisywanie się odbiorców na podstawie przesłanego SMS. Dzięki takiemu rozwiązaniu możliwe jest automatyczne tworzenie bazy kontaktów.
+
Depending on global settings, group can be assigned with codes for automatic registering/unregistering to group for contacts (with SMS message).Therefore, dynamic groups can be created in one system.
  
 
[[Grafika:grupa_sendersms.png]]
 
[[Grafika:grupa_sendersms.png]]
  
* definiowanie nazwy grupy
+
* definition of a group name
* przypisanie kodu aktywacyjnego i dezaktywacyjnego
+
* assigning activation/deactivation code to group
  
===Konfiguracja operatorów systemu ===
+
===System users configuration===
  
W zakładce Operatorzy definiujemy poszczególnych użytkowników aplikacji, nadając im odpowiednie uprawnienia.
+
In "Operators" tab we can add another system users with giving them proper priviledges.
Nieusuwalny operator "admin" powoływany jest podczas kreatora pierwszego uruchomienia. Przy powoływaniu nowego operatora systemu nadawane jest tymczasowe hasło które należy zmienić przy pierwszym zalogowaniu. Poza tym należy pamiętać o przypisaniu odpowiedniego poziomu uprawnień oraz bramki/bramek GSM przez które będzie mógł wysyłać oraz odbierać wiadomości.
+
First account was created during First Run Wizard. Temporary password for a new user will have to be changed suring first user log in into application.
 
   
 
   
 
[[Grafika:operator_sendersms.png]]
 
[[Grafika:operator_sendersms.png]]
  
Wartości dla pola Uprawnienia
+
Priviledged field values:
*brak
+
*None
*zarządzający
+
*Manager
*obsługa
+
*Staff
  
 
<b>Uprawnienia w zależności od ustawień</b>
 
<b>Uprawnienia w zależności od ustawień</b>

Revision as of 07:33, 5 October 2015

Introduction

SenderSMS is a application for serial SMS messages sending using Slican PBXes. Its main purpose is providing efficent SMS communication between contractors and clients, for marketing purposes or as information center for patients, students or notification centers (agencies, authorities, security bureaus).

Application is design for one-stand work with possibility of network cooperation (shared database) with some limitations. In case of multi-stands, each user needs to be assigned to a individual GSM module. It's a matter of one connection session, uptimed by PBX. to aplikacja służąca do seryjnego wysyłania wiadomości SMS przy wykorzystaniu serwerów SLICAN.

WARNING:

SenderSMS works with 6.22 fimrware version or higher.

Minimal requirements

  • 800MHz processor,
  • 1GB RAM or higher,
  • WindowsXP SP2 or newer.

Application features

  • Adding contacts or contact groups,
  • Messages templates (private, public),
  • Personalization of messages, based on contacts fields,
  • Automatic contact registration/deregistration with sent SMS message,
  • "Flash" type messages,
  • History of sent/received messages, along with delivery report,
  • Numbers blacklist,
  • Contacts import/export,
  • Multi-level application access (admin, manager, operating personel),
  • Multi GSM modules handling.

Application installation

SenderSMS work is licenced, and requires to purchase proper licence key. It describes GSM modules quantity for handling by application. Install file can be downloaded from Slican's website and executed on users PC, for typing required connection data.

First Run Wizard

At first application run, a Wizard is started for creation a admin account (not deletable) and configuring:

  • connection with PBX,
  • GSM modules for application use configuring,
  • SMS and account global parameters configuring,
  • GSM modules assigning by administrator.

Wizard has seven steps for initial configuration:

center| - STEP 1: SenderSMS wizard window.

center| - STEP 2: in PABX IP address we define PBX's controller card IP address, ID and PIN fields needs to be filled accoring to fields from ConfigMAN (Trunks/GSM settings).

center| - STEP 3: Admin information configuration.

center| - STEP 4: GSM module(s) selection for administrator.

center| - STEP 5: SMS settings window.

center| - STEP 6: Country prefix according to application use location.

center| - STEP 7: Settings summary.

System configuration

Contacts and groups configuration

<b>Contact

Adding contacts is done by choosing Contacts tab and record configuration.

Plik:Kontakty_dodawanie.jpg



Grafika:kontakt_sendersms_1.pngGrafika:kontakt_sendersms_2.png

  • definition of contact dana such as: Name, Last name, GSM number, group membership and title
  • definition of contact's additional data: address, description

In field Belongs to group we can assigned configured contact to group(s). Sending messages is possible only to contacts, with Active box checked.

Groups

This feature allows to group contacts. There is on not deletable group called "Everyone" which contains all created contacts. Depending on global settings, group can be assigned with codes for automatic registering/unregistering to group for contacts (with SMS message).Therefore, dynamic groups can be created in one system.

Grafika:grupa_sendersms.png

  • definition of a group name
  • assigning activation/deactivation code to group

System users configuration

In "Operators" tab we can add another system users with giving them proper priviledges. First account was created during First Run Wizard. Temporary password for a new user will have to be changed suring first user log in into application.

Grafika:operator_sendersms.png

Priviledged field values:

  • None
  • Manager
  • Staff

Uprawnienia w zależności od ustawień

Administrator

  • dodawanie/usuwanie operatorów typu zarządzający, obsługa oraz przydzielanie dozwolonych bramek GSM,
  • dostęp do konfiguracji globalnej,
  • dostęp do konfiguracji lokalnej,
  • konfiguracja czarnej listy,
  • tworzenie kontaktów, grup kontaktów, szablonów wiadomości,
  • personalizowanie wiadomości na podstawie pól kontaktu,
  • zlecanie wysłania wiadomości do dowolnie zdefiniowanej liczby grup, kontaktów,
  • zlecenie wysłania wiadomości do dowolnych numerów GSM wprowadzonych ręcznie,
  • przegląd wiadomości wysłanych, odebranych oraz raportów,
  • eksport danych, kontaktów do pliku csv,
  • import kontaktów z pliku csv.

Zarządzający

  • dodawanie/usuwanie operatorów typu obsługa oraz przydzielanie dozwolonych bramek GSM,
  • dostęp do konfiguracji lokalnej,
  • tworzenie kontaktów, grup kontaktów, szablonów wiadomości,
  • personalizowanie wiadomości na podstawie pól kontaktu,
  • zlecanie wysłania wiadomości do dowolnie zdefiniowanej liczby grup, kontaktów,
  • zlecenie wysłania wiadomości do dowolnych numerów GSM wprowadzonych ręcznie,
  • przegląd wiadomości wysłanych, odebranych oraz raportów,
  • eksport danych, kontaktów do pliku csv,
  • import kontaktów z pliku csv.

Obsługa

  • dostęp do konfiguracji lokalnej,
  • personalizowanie wiadomości na podstawie pól kontaktu,
  • zlecanie wysłania wiadomości do dowolnie zdefiniowanej liczby grup, kontaktów,
  • przegląd wiadomości wysłanych.

Ustawienia administratora

Grafika:ustawienia_admin_sendersms_1.png Grafika:ustawienia_admin_sendersms_2.png

Wartości dla pola Typ wiadomości

  • Normalny
  • Flash

Wartości dla pola Ważność wiadomości

  • Pięć minut
  • Kwadrans
  • Pół godziny
  • Jedna godzina
  • Sześć godzin
  • Jeden dzień
  • Trzy dni
  • Jeden tydzień
  • Czas maksymalny

Wartości dla pola Przechowuj wiadomości starsze niż:

  • Bez ograniczeń
  • Jeden miesiąc
  • Trzy miesiące
  • Pół roku
  • Rok
  • Dwa lata
  • Trzy lata
  • Pięć lat

Lista niedozwolonych prefiksów

Grafika:czarna_lista_sendersms.png

Czarna lista

W zakładce Czarna lista definiujemy listę prefiksów uniemożliwiających wysyłanie wiadomości na wybrane numery. Domyślnie powołanych jest pięć wpisów zabraniających wysyłanie wiadomości na numery zagraniczne oraz SMS premium.

Wysyłanie wiadomości

Główną funkcjonalnością aplikacji jest możliwość wysyłania wiadomości SMS do zdefiniowanej liczby odbiorców. Można to wykonać w oknie głównym aplikacji:

center|

Aplikacja umożliwia wysyłanie wiadomości tylko i wyłącznie na żądanie operatora. Wysłanie będzie możliwe w przypadku wypełnienia pola "Treść" oraz gdy aplikacja połączona jest z centralą. Maksymalna długość wiadomości wynosi 160 znaków. W przypadku długich wiadomości SMS aplikacja dzieli je przy wysyłaniu na części nadając im wspólny identyfikator. W przypadku użycia polskich znaków diakrytycznych długość pojedynczej wiadomości skraca się do 70 znaków.

Listę odbiorców można utworzyć na kilka sposobów:

  • 1 Poprzez wybór grupy

Plik:SendSMS_group.jpg

  • 2 Poprzez wybór konkretnych kontaktów

Grafika:SendSMS kontakt.jpg

  • 3 Dodatkowo listę odbiorców można uzupełnić dodając numery ręcznie rozdzielone znakiem ',' wybierając opcję "Dodaj do listy"

Plik:SendSMS_pers.jpg

Szablon wiadomości

W przypadku częstego wysyłania tej samej treści wiadomości do odbiorców istnieje możliwość zdefiniowania szablonu. Szablony mogą być publiczne bądź prywatne. Szablony prywatne widoczne są tylko dla operatora który go stworzył. Dodatkowo każdy szablon można spersonalizować wybierając opcję "Dodaj pole". Polega to na wstawianiu do treści wiadomości wartości które są zdefiniowane w kontakcie do którego wysyłany jest SMS np.:

Szablon:

"{Tytul} {Imie} proszony jest o kontakt" podczas wysyłania może zostać zastąpiony treścią: "Pan Jan proszony jest o kontakt"

- tworzenie szablonu

Plik:Szablon_wiad1.jpg

- dodatkowa personalizacja wiadomości

Plik:Szablon_wiad2.jpg

Przeglądanie historii

Aplikacja utrzymuje historię wiadomości wysłanych i odebranych oraz raport dostarczenia.

Plik:Historia_send.jpg

Eksport danych

Aplikacja umożliwia eksport danych do pliku z rozszerzeniem CSV z dowolnie parametryzowanym separatorem. Aplikacja umożliwia eksport: kontaktów, wiadomości wysłanych, wiadomości odebranych oraz raportów.

Krok 1 Wybór danych do eksportu.

Grafika:eksport_sendersms_1.png

Krok 2 Parametry eksportu.

Grafika:eksport_sendersms_3.png

Krok 4 Postęp eksportu danych.

Grafika:eksport_sendersms_5.png

Import danych

Aplikacja umożliwia import kontaktów z plików CSV:

Grafika:import_sendersms_1.png Grafika:import_sendersms_2.png center|

Praca sieciowa

Aplikacja umożliwia prace sieciową polegającą na współdzieleniu wspólnej bazy danych zainstalowanej na dedykowanym serwerze.

Licencjonowanie

Używanie aplikacji wymaga wprowadzenia licencji "MaxTrial" lub "SMS"(Ilość bramek GSM dla SenderSMS) z poziomu programu ConfigMAN. Poza tym należy udostępnić bramkę GSM aplikacji SenderSMS konfigurując pole SMSStat w arkuszu Translacje/Ustawienia GSM.