Difference between revisions of "SenderSMS manual"

From pubWiki-en
Jump to: navigation, search
(Contacts and groups configuration)
 
(13 intermediate revisions by the same user not shown)
Line 4: Line 4:
  
 
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.
 
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 13: Line 12:
 
|
 
|
 
| <b>WARNING:
 
| <b>WARNING:
SenderSMS works with '''6.22''' fimrware version or higher.
+
SenderSMS works with '''6.22''' firmware version or higher.
 
|}
 
|}
  
Line 44: Line 43:
 
Wizard has seven steps for initial configuration:
 
Wizard has seven steps for initial configuration:
  
[[Grafika:Kreator_sendersms_1.png|center|]]
+
<center>[[File:sender_wizard_1.png|500px]]</center>
 
- '''STEP 1''': SenderSMS wizard window.
 
- '''STEP 1''': SenderSMS wizard window.
  
[[Grafika:kreator_sendersms_2.png|center|]]
+
<center>[[File:sender_wizard_2.png|500px]]</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''').
 
- '''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|]]
+
<center>[[File:sender_wizard_3.png|500px]]</center>
 
- '''STEP 3''': Admin information configuration.
 
- '''STEP 3''': Admin information configuration.
  
[[Grafika:kreator_sendersms_4.png|center|]]
+
<center>[[File:sender_wizard_4.png|500px]]</center>
 
- '''STEP 4''': GSM module(s) selection for administrator.
 
- '''STEP 4''': GSM module(s) selection for administrator.
  
[[Grafika:kreator_sendersms_5.png|center|]]
+
<center>[[File:sender_wizard_5.png|500px]]</center>
 
- '''STEP 5''': SMS settings window.   
 
- '''STEP 5''': SMS settings window.   
  
[[Grafika:kreator_sendersms_6.png|center|]]
+
<center>[[File:sender_wizard_6.png|500px]]</center>
 
- '''STEP 6''': Country prefix according to application use location.  
 
- '''STEP 6''': Country prefix according to application use location.  
  
[[Grafika:kreator_sendersms_7.png|center|]]
+
<center>[[File:sender_wizard_7.png|500px]]</center>
 
- '''STEP 7''': Settings summary.
 
- '''STEP 7''': Settings summary.
  
 
==System configuration==
 
==System configuration==
 
===Contacts and groups configuration===
 
===Contacts and groups configuration===
<b>Contact</b>
+
'''Contact'''
  
 
Adding contacts is done by choosing Contacts tab and record configuration.
 
Adding contacts is done by choosing Contacts tab and record configuration.
  
[[Plik:Kontakty_dodawanie.jpg]]
+
<center>[[File:sender_contact_add.png|500px]]</center>
  
  
  
  
[[Grafika:kontakt_sendersms_1.png]][[Grafika:kontakt_sendersms_2.png]]
+
<center>[[File:sender_contact_1.png|300px]][[File:sender_contact_2.png|300px]]</center>
  
 
* definition of contact dana such as: Name, Last name, GSM number, group membership and title
 
* definition of contact dana such as: Name, Last name, GSM number, group membership and title
Line 88: Line 87:
 
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.
 
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]]
+
<center>[[File:sender_group.png|350px]]</center>
  
 
* definition of a group name
 
* definition of a group name
Line 98: Line 97:
 
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.
 
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]]
+
<center>[[File:sender_operator.png|500px]]</center>
  
 
Priviledged field values:
 
Priviledged field values:
Line 105: Line 104:
 
*Staff
 
*Staff
  
<b>Uprawnienia w zależności od ustawień</b>
+
<b>Priviledges dependence</b>
  
 
<b>Administrator</b>
 
<b>Administrator</b>
*dodawanie/usuwanie operatorów  typu zarządzający, obsługa oraz przydzielanie dozwolonych bramek GSM,
+
*adding/deleting operators,
*dostęp do konfiguracji globalnej,
+
*access to global settings,
*dostęp do konfiguracji lokalnej,
+
*access to local settings,
*konfiguracja czarnej listy,
+
*personalization of messages based on contact data,
*tworzenie kontaktów, grup kontaktów, szablonów wiadomości,
+
*Blacklist configuration,
*personalizowanie wiadomości na podstawie pól kontaktu,
+
*creating contacts, groups, templates,
*zlecanie wysłania wiadomości do dowolnie zdefiniowanej liczby grup, kontaktów,
+
*sending messages to unlimited quantity of groups and contacts,
*zlecenie wysłania wiadomości do dowolnych numerów GSM wprowadzonych ręcznie,
+
*sending messages to unlimited quantity of manually typed GSM numbers,
*przegląd wiadomości wysłanych, odebranych oraz raportów,
+
*scrolling through SMS history and reports,
*eksport danych, kontaktów do pliku csv,
+
*data export to .csv file
*import kontaktów z pliku csv.
+
*contacts import from .csv file.
  
<b>Zarządzający</b>
+
<b>Manager</b>
*dodawanie/usuwanie operatorów  typu  obsługa oraz przydzielanie dozwolonych bramek GSM,
+
*adding/deleting operators,
*dostęp do konfiguracji lokalnej,
+
*access to local settings,
*tworzenie kontaktów, grup kontaktów, szablonów wiadomości,
+
*creating contacts, groups, templates,
*personalizowanie wiadomości na podstawie pól kontaktu,
+
*personalization of messages based on contact data,
*zlecanie wysłania wiadomości do dowolnie zdefiniowanej liczby grup, kontaktów,
+
*sending messages to unlimited quantity of groups and contacts,
*zlecenie wysłania wiadomości do dowolnych numerów GSM wprowadzonych ręcznie,
+
*sending messages to unlimited quantity of manually typed GSM numbers,
*przegląd wiadomości wysłanych, odebranych oraz raportów,
+
*scrolling through SMS history and reports,
*eksport danych, kontaktów do pliku csv,
+
*data export to .csv file
*import kontaktów z pliku csv.
+
*contacts import from .csv file.
  
<b>Obsługa</b>
+
<b>Staff</b>
*dostęp do konfiguracji lokalnej,
+
*access to local settings,
*personalizowanie wiadomości na podstawie pól kontaktu,
+
*personalization of messages based on contact data,
*zlecanie wysłania wiadomości do dowolnie zdefiniowanej liczby grup, kontaktów,
+
*sending messages to unlimited quantity of groups and contacts,
*przegląd wiadomości wysłanych.
+
*scrolling through sent SMS history.
  
<b>Ustawienia administratora</b>
+
<b>Administrator settings</b>
  
[[Grafika:ustawienia_admin_sendersms_1.png]]
+
<center>[[File:sender_settings_1.png|500px]]</center>
[[Grafika:ustawienia_admin_sendersms_2.png]]
+
<center>[[File:sender_settings_2.png|500px]]</center>
  
Wartości dla pola Typ wiadomości
+
Messages type values
*Normalny
+
*Normal
 
*Flash
 
*Flash
  
Wartości dla pola Ważność wiadomości
+
Message validity values
*Pięć minut
+
*Five minutes
*Kwadrans
+
*Quarter of an hour
*Pół godziny
+
*Half hour
*Jedna godzina
+
*One hour
*Sześć godzin
+
*Six hours
*Jeden dzień
+
*One day
*Trzy dni
+
*Three days
*Jeden tydzień
+
*One week
*Czas maksymalny
+
*Maximum time
  
Wartości dla pola Przechowuj wiadomości starsze niż:
+
Keep messages not older than values:
*Bez ograniczeń
+
*Without limits
*Jeden miesiąc
+
*One month
*Trzy miesiące
+
*Three months
*Pół roku
+
*Half a year
*Rok
+
*Year
*Dwa lata
+
*Two years
*Trzy lata
+
*Three years
*Pięć lat
+
*Five years
  
===Lista niedozwolonych prefiksów===
+
===Prefix blacklist===
  
[[Grafika:czarna_lista_sendersms.png]]
+
<center>[[File:sender_blacklist.png|500px]]</center>
  
<b>Czarna lista</b>
+
<b>Blacklist</b>
  
W zakładce Czarna lista definiujemy listę prefiksów uniemożliwiających wysyłanie wiadomości na wybrane numery.
+
In Blacklist tab we define prefixes than will be restricted for outgoing messagess traffic.
Domyślnie powołanych jest pięć wpisów zabraniających wysyłanie wiadomości na numery zagraniczne oraz  SMS premium.
+
  
==Wysyłanie wiadomości==
+
==Sending messages==
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:
+
Main feature in SenderSMS is possibility to sent messages for specified quantity of GSM numbers.
  
[[Grafika:okno_glowne_sendersms.png|center|]]
+
<center>[[File:sender_main.png|500px]]</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.
+
Only manually sending is possible in application. Sending will be available only after filling Content field, and when connection with PBX is established.
 +
Maximum message length is set to 160 characters. Longer messages will be divided into two SMS with same ID (receiver will receive one SMS message).
 
    
 
    
<b> Listę odbiorców można utworzyć na kilka sposobów:</b>
+
<b>Receiver list can be created in several ways:</b>
  
*1 Poprzez wybór grupy
+
*1 By group choosing
  
[[Plik:SendSMS_group.jpg]]
+
<center>[[File:sender_group_add.png|500px]]</center>
  
*2 Poprzez wybór konkretnych kontaktów
+
*2 By specified contacts choosing
  
[[Grafika:SendSMS kontakt.jpg]]
+
<center>[[File:sender_contacts_add.png|500px]]</center>
  
*3 Dodatkowo listę odbiorców można uzupełnić dodając numery ręcznie rozdzielone znakiem ',' wybierając opcję "Dodaj do listy"
+
*3 Receiver list can be supplemented with another records divided with ''',''' character.
  
[[Plik:SendSMS_pers.jpg]]
+
<center>[[File:sender_contacts_manual.png|500px]]</center>
  
<b>Szablon wiadomości</b>
+
<b>Messages templates</b>
  
W przypadku częstego wysyłania tej samej treści wiadomości do odbiorców istnieje możliwość zdefiniowania szablonu.  
+
In case of repeating the Content of message sent, we can add a template.
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.:
+
There are public and private templates. Private templates are visible only for oerator who created it. Each template can be personalized with proper characters, from '''Add field''' option, eg.:
  
<b>Szablon:</b>
+
<b>Template:</b>
 
   
 
   
"{Tytul} {Imie} proszony jest o kontakt"  
+
"{Title}{First name} is requested for contact."
podczas wysyłania może zostać zastąpiony treścią:  
+
will be replaced with data in contact:
"Pan Jan proszony jest o kontakt"
+
"Mr. John is requested for contact."
  
- tworzenie szablonu
+
- creating a template
  
[[Plik:Szablon_wiad1.jpg]]
+
<center>[[File:sender_template_1.png|500px]]</center>
  
- dodatkowa personalizacja wiadomości
+
- additional message customization
  
[[Plik:Szablon_wiad2.jpg]]
+
<center>[[File:sender_template_2.png|500px]]</center>
  
==Przeglądanie historii==
+
==Data export==
 +
Application allows to export data to .csv file with configured separator. Possible export data: contacts, sent messages, received messages, reports.
  
Aplikacja utrzymuje historię wiadomości wysłanych i odebranych oraz raport dostarczenia.
+
Step 1 Choose data to export.
  
[[Plik:Historia_send.jpg]]
+
<center>[[File:sender_export_1.png|500px]]</center>
  
==Eksport danych==
+
Step 2 Export parameters.
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.
+
<center>[[File:sender_export_2.png|500px]]</center>
  
[[Grafika:eksport_sendersms_1.png]]
+
Step 3 Data export progress.
  
Krok 2 Parametry eksportu.
+
<center>[[File:sender_export_3.png|500px]]</center>
  
[[Grafika:eksport_sendersms_3.png]]
+
==Data import==
  
Krok 4 Postęp eksportu danych.
+
Import from .csv file is possible:
  
[[Grafika:eksport_sendersms_5.png]]
+
<center>[[File:sender_import_1.png|500px]]</center>
 +
<center>[[File:sender_import_2.png|500px]]</center>
 +
<center>[[File:sender_import_3.png|500px]]</center>
  
==Import danych==
+
==Shared work==
 
+
Database can be shared by locating it on server storage.
Aplikacja umożliwia import kontaktów z plików CSV:
+
 
+
[[Grafika:import_sendersms_1.png]]
+
[[Grafika:import_sendersms_2.png]]
+
[[Grafika:import_sendersms_3.png|center|]]
+
 
+
==Praca sieciowa==
+
Aplikacja umożliwia prace sieciową polegającą na współdzieleniu wspólnej bazy danych zainstalowanej na dedykowanym serwerze.
+
  
 
==Licencjonowanie==
 
==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.
 
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.

Latest revision as of 10:36, 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.

WARNING:

SenderSMS works with 6.22 firmware 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:

Sender wizard 1.png

- STEP 1: SenderSMS wizard window.

Sender wizard 2.png

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

Sender wizard 3.png

- STEP 3: Admin information configuration.

Sender wizard 4.png

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

Sender wizard 5.png

- STEP 5: SMS settings window.

Sender wizard 6.png

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

Sender wizard 7.png

- STEP 7: Settings summary.

System configuration

Contacts and groups configuration

Contact

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

Sender contact add.png



Sender contact 1.pngSender contact 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.

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

Sender group.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.

Sender operator.png

Priviledged field values:

  • None
  • Manager
  • Staff

Priviledges dependence

Administrator

  • adding/deleting operators,
  • access to global settings,
  • access to local settings,
  • personalization of messages based on contact data,
  • Blacklist configuration,
  • creating contacts, groups, templates,
  • sending messages to unlimited quantity of groups and contacts,
  • sending messages to unlimited quantity of manually typed GSM numbers,
  • scrolling through SMS history and reports,
  • data export to .csv file
  • contacts import from .csv file.

Manager

  • adding/deleting operators,
  • access to local settings,
  • creating contacts, groups, templates,
  • personalization of messages based on contact data,
  • sending messages to unlimited quantity of groups and contacts,
  • sending messages to unlimited quantity of manually typed GSM numbers,
  • scrolling through SMS history and reports,
  • data export to .csv file
  • contacts import from .csv file.

Staff

  • access to local settings,
  • personalization of messages based on contact data,
  • sending messages to unlimited quantity of groups and contacts,
  • scrolling through sent SMS history.

Administrator settings

Sender settings 1.png
Sender settings 2.png

Messages type values

  • Normal
  • Flash

Message validity values

  • Five minutes
  • Quarter of an hour
  • Half hour
  • One hour
  • Six hours
  • One day
  • Three days
  • One week
  • Maximum time

Keep messages not older than values:

  • Without limits
  • One month
  • Three months
  • Half a year
  • Year
  • Two years
  • Three years
  • Five years

Prefix blacklist

Sender blacklist.png

Blacklist

In Blacklist tab we define prefixes than will be restricted for outgoing messagess traffic.

Sending messages

Main feature in SenderSMS is possibility to sent messages for specified quantity of GSM numbers.

Sender main.png

Only manually sending is possible in application. Sending will be available only after filling Content field, and when connection with PBX is established. Maximum message length is set to 160 characters. Longer messages will be divided into two SMS with same ID (receiver will receive one SMS message).

Receiver list can be created in several ways:

  • 1 By group choosing
Sender group add.png
  • 2 By specified contacts choosing
Sender contacts add.png
  • 3 Receiver list can be supplemented with another records divided with , character.
Sender contacts manual.png

Messages templates

In case of repeating the Content of message sent, we can add a template. There are public and private templates. Private templates are visible only for oerator who created it. Each template can be personalized with proper characters, from Add field option, eg.:

Template:

"{Title}{First name} is requested for contact." will be replaced with data in contact: "Mr. John is requested for contact."

- creating a template

Sender template 1.png

- additional message customization

Sender template 2.png

Data export

Application allows to export data to .csv file with configured separator. Possible export data: contacts, sent messages, received messages, reports.

Step 1 Choose data to export.

Sender export 1.png

Step 2 Export parameters.

Sender export 2.png

Step 3 Data export progress.

Sender export 3.png

Data import

Import from .csv file is possible:

Sender import 1.png
Sender import 2.png
Sender import 3.png

Shared work

Database can be shared by locating it on server storage.

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.