GenSuite Help Guide
GenSuite Help Guide
FOR
REVISION HISTORY
Date Re vi s i o n Author Re m ar k
10/20/09 1.0 Lim Y. N. -
12/21/09 1.1 Lim Y. N. Modification of profile and change password.
12/22/09 1.2 Lim Y. N. Modification of Administration Configuration, Customized Sms, Campaign
manager, Manage User, Contact and Security modules.
01/26/10 1.3 Lim Y. N. Include Steps of delete a contact from certain group.
Include Monthly Sms Limit, Allow Export and Allow Auto CC Sms features in
Manage Staff.
Indicate the label for Campaign Manager.
Modification of customize sms and outbox.
04/26/10 1.4 Lim Y. N. Include import contact format.
05/05/10 1.5 Lim Y. N. Layout modification of manage staff and configuration.
Include the special character table for Send Sms
06/17/10 1.6 Lim Y. N. Include explanation of valid characters for Sms Message
07/02/10 1.7 Lim Y. N. Modification of Campaign Manager
11/25/10 1.8 Lim Y. N. With the major changes on Contacts and Send SMS sections, older screenshots
have been replaced, and guides have been rewritten.
Added section to create domain name for reseller client.
08/07/11 1.9 Sung T. C. Include Billing Module, Email Module, and Voice Time Module.
09/15/11 1.10 Sung T. C. Modification of profile and change password.
03/19/12 2.0 Sung T. C. Merge ADMIN and USER manuals as one manual, using new manual template.
12/17/12 2.1 Lee Y. H. Update Contact module
01/02/13 2.2 Lee Y. H. Explain difference in between TAG GROUP and DUPLICATE TO GROUP under
Section 2.3.10 and 2.3.11
07/18/13 2.3 Lee Y. H. Update Contact module
TABLE OF CONTENTS
1 SYSTEM FEATURE........................................................................................................................... 5
1.1 MY ACCOUNT................................................................................................................................. 5
1.2 ADMINISTRATION............................................................................................................................. 5
1.3 CONTACT....................................................................................................................................... 6
1.4 SMS............................................................................................................................................ 6
1.5 2-WAY SMS.................................................................................................................................. 7
1.6 TRAFFIC......................................................................................................................................... 8
1.7 SYSTEM......................................................................................................................................... 8
1.8 EMAIL............................................................................................................................................ 8
1.9 VOICE TIME.................................................................................................................................... 9
2 USER GUIDELINE.......................................................................................................................... 10
2.1 MY ACCOUNT............................................................................................................................... 10
2.1.1 Company Profile................................................................................................................. 10
2.1.2 News................................................................................................................................... 11
2.1.3 My Price.............................................................................................................................. 11
2.1.4 My Top-Up (ADMIN)............................................................................................................ 11
2.1.5 Feedback............................................................................................................................ 12
2.1.6 Change Password............................................................................................................... 12
2.2 ADMINISTRATION........................................................................................................................... 13
2.2.1 Add a Department (ADMIN)................................................................................................ 13
2.2.2 Delete a Department (ADMIN)............................................................................................ 13
2.2.3 Add a User (ADMIN)........................................................................................................... 14
2.2.4 Edit a User (ADMIN)........................................................................................................... 14
2.2.5 Disable a User (ADMIN)..................................................................................................... 15
2.3 CONTACT..................................................................................................................................... 16
2.3.1 Add Contact Group............................................................................................................. 17
2.3.2 Edit Contact Group............................................................................................................. 18
2.3.3 Delete Contact Group......................................................................................................... 18
2.3.4 Add Contact........................................................................................................................ 20
2.3.5 Edit Contact........................................................................................................................ 21
2.3.6 Delete Contact.................................................................................................................... 22
2.3.7 Search Contact................................................................................................................... 24
2.3.8 Upload Contact in Batch..................................................................................................... 25
2.3.9 Add Prefix to Group............................................................................................................. 27
2.3.10 Tag / Untag Contact Group of a Contact........................................................................... 27
2.3.11 Duplicate Contact.............................................................................................................. 27
2.3.12 Export Contact.................................................................................................................. 28
2.3.13 Frequently Asked Questions............................................................................................. 28
2.4 SMS.......................................................................................................................................... 30
2.4.1 Send a SMS........................................................................................................................ 30
2.4.2 Save a Draft SMS............................................................................................................... 32
2.4.3 Outbox................................................................................................................................ 33
2.4.4 Draft.................................................................................................................................... 33
2.4.5 Delete Draft SMS................................................................................................................ 34
2.4.6 Schedule............................................................................................................................. 34
2.4.7 Delete a Scheduled SMS.................................................................................................... 34
2.4.8 Customized SMS................................................................................................................ 35
2.4.9 Reminder............................................................................................................................ 37
2.4.10 Sender ID.......................................................................................................................... 37
2.4.11 Filter List (ADMIN)............................................................................................................. 38
2.5 2-WAY SMS................................................................................................................................ 38
2.5.1 Add a Campaign (ADMIN).................................................................................................. 38
2.5.2 Add a Keyword (ADMIN)..................................................................................................... 39
1 SYSTEM FEATURE
1.1 My Account
A. Company Profile
Company Profile displays Account Information, Contact, Latest News, Recent Bulk SMS
Sent, and Bulk SMS to be Sent Soon. Account Information will show Company Name,
Available Balance, Client ID, Username, Monthly SMS Limit, Balance, Account Expiry Date,
and whether SMS/Email/Voice modules are enabled for this company. Contact tab will show
Address, Telephone, Fax, Contact Person, Name, Mobile Number, and Email.
For more details, please refer to section 2.1.1 COMPANY PROFILE, page 10.
B. News
This section allows user to view the news published by user's company.
For more details, please refer to section 2.1.2 NEWS, page 11.
C. My Price
User can view the price charges for each SMS, Email, 2-Way SMS, and Voice services at this
page.
For more details, please refer to section 2.1.3 MY PRICE, page 11.
D. My Top-Up (ADMIN)
For more details, please refer to section 2.1.4 MY TOP-UP, page 11.
E. Feedback
If the user has any feedback about the system, found any bug on the system, or would like
to enquire about the system, this page provides the facility for the user to do so.
For more details, please refer to section 2.1.5 Feedback, page 12.
F. Change Password
For more details, please refer to section 2.1.6 Changing Password, page 12.
1.2 Administration
A. Manage Staff (ADMIN)
User can view a list of users who have been created to login into the system. User also can
create users with two different levels, namely Admin and User levels. Besides, user can
create various departments for each user, so that they can easily manage the users.
• To add a department, please refer to section 2.2.1 Add a Department, page 13.
• To delete a department, please refer to section 2.2.2 Delete a Department, page
13.
• To add a user, please refer to section 2.2.3 Add a User, page 14.
• To edit a user, please refer to section 2.2.4 Edit a User, page 14.
• To disable a user, please refer to section 2.2.5 Disable a User, page 15.
1.3 Contact
Contact page can be accessed from main menu, by clicking on CONTACT link. User can
manage contacts in this page. This page provides various facilities to create contact
groups, sort contacts, add contacts, and upload contacts.
• To add a contact group, please refer to section 2.3.1 Add Contact Group.
• To edit a contact group, please refer to section 2.3.2 Edit Contact Group.
• To delete a contact group, please refer to section 2.3.3 Delete Contact Group.
• To add a contact, please refer to section 2.3.4 Add Contact.
• To edit a contact, please refer to section 2.3.5 Edit Contact.
• To delete a contact, please refer to section 2.3.6 Delete Contact.
• To search a contact, please refer to section 2.3.7 Search Contact.
• To upload contact in batch, please refer to section 2.3.8 Upload Contact in Batch.
• To add prefix to contact group, please refer to section 2.3.9 Add Prefix to Group.
• To tag / untag contact group of a contact, please refer to section 2.3.10 Tag /
Untag Contact Group of a Contact.
• To duplicate contact, please refer to section 2.3.11 Duplicate Contact.
• To export contact, please refer to section 2.3.12 Export Contact.
1.4 SMS
A. Send SMS
This page allows user to send SMS. There are two types of SMS that can be sent, namely
Standard and Unicode. SMS can be sent either immediately, or scheduled to be sent later.
For more details, please refer to section 2.4.1 Send SMS, page 26.
However, if a user does not want to send the SMS, the user can save the SMS message as
draft SMS, until the user decides to sent it.
For more details, please refer to section 2.4.2 Save a Draft SMS, page 28.
B. Outbox
After SMS has been sent out, it will appear in this page. User is able to search all SMS
records, based on phone number, User ID, from which date to which date, Sender ID,
department, or method. When the search result appears, user can export the result as
summary/itemized in CSV/Excel format.
For more details, please refer to section 2.4.3 Outbox, page 29.
C. Draft
Draft SMSes are saved in this section. User can edit the draft SMS, then save it again, or
send it out.
For more details, please refer to section 2.4.4 Draft, page 29.
For more details, please refer to section 2.4.5 Delete Draft SMS, page 30.
D. Schedule
Scheduled SMSes are displayed in this page. User can edit scheduled SMSes here.
For more details, please refer to section 2.4.6 Schedule, page 30.
For more details, please refer to section 2.4.7 Delete a Scheduled SMS, page 30.
E. Customized SMS
Sometimes, user may want to send a more complex SMS message than the normal
message. For example, each recipient will receive slightly different SMS message, like each
individual's account balance, or unique SMS reply for each individual.
For more details, please refer to section 2.4.8 Customized SMS, page 31.
F. Reminder
This module allows user to set the system to send various reminders, such as birthday
reminder, and reminder 1-3.
For more details, please refer to section 2.4.9 Reminder, page 33.
G. Sender ID
For more details, please refer to section 2.4.10 Sender ID, page 33.
If any recipient does not want to receive SMS from the system anymore, user can add the
phone number into filter list. In future, any filtered phone numbers will not receive the SMS
from the system again.
For more details, please refer to section 2.4.11 Filter List, page 34.
User can create campaigns for promotional events. Under campaigns, user can create
various keywords for various purposes.
• To add a campaign, please refer to section 2.5.1 Add a Campaign, page 34.
• To add a keyword, please refer to section 2.5.2 Add a Keyword, page 35.
B. View Keyword
Keywords that are created under various campaigns will be displayed here. In this page,
user can check keyword's type, status, date start, date end, and shortcode.
For more details, please refer to section 2.5.3 View Keyword, page 36.
CHAT keywords are special keywords which are used to interact with mobile users.
For more details, please refer to section 2.5.4 Start a Chat Session, page 36.
C. Report (ADMIN)
User can view various types of campaign reports, such as Summary Report, Graphical
Report, Trafc Report, and Profit Report. The reports will show the performance and the
profits gained from the running campaigns.
For more details, please refer to section 2.5.5 Report, page 38.
1.6 Traffic
A. Traffic
This report will display number of messages sent out based on which countries they were
sent to.
For more details, please refer to section 2.6.1 Trafc, page 40.
B. Statement
This report will generate CSV/PDF files that reports SMSes sent out from each User ID.
For more details, please refer to section 2.6.2 Statement, page 40.
1.7 System
A. History Log (ADMIN)
History Log page shows actions have been taken by each User ID in the system. This page
is good in keeping track each user's action in the system.
For more details, please refer to section 2.7.1 History Log, page 41.
B. Security (ADMIN)
Security section allows user to set various privileges for each user group in the system.
User also able to create another user groups to cater other needs, too.
• To create user group, please refer to section 2.7.2 Add Security Group, page 41.
• To set access privileges for each user group, please refer to section 2.7.3 Set Group
Access, page 42.
1.8 Email
A. Send Email
User can send emails to customers through this module. This module provides facilities to
compose email from scratch, compose email from draft, compose email from predefined
templates, and customize email.
For more details, please refer to section 2.8.1 Send Email, page 43.
B. Outbox
Similar to SMS outbox, when emails have been sent out, they will be stored in this email
outbox.
For more details, please refer to section 2.8.2 Outbox, page 45.
C. Schedule
User who has scheduled the email sending will be displayed here.
For more details, please refer to section 2.8.3 Schedule, page 46.
Any customer who does not want to receive anymore emails from the system, user can
upload the CSV/Excel file containing email addresses into this page. The system will filter
the email addresses before sending out emails.
For more details, please refer to section 2.8.4 Unsubscribed List, page 46.
Voice Time is like an operator voice over the phone. User can make his/her own voice time,
by uploading from own file, recording online, or composing from Text to Speech.
For more details, please refer to section 2.9.1 Send Voice, page 46.
B. Outbox (ADMIN)
Similar to SMS and email outbox, voice sent out will go to voice outbox.
For more details, please refer to section 2.9.2 Outbox, page 48.
2 USER GUIDELINE
2.1 My Account
2.1.1 Company Profile
2.1.2 News
2.1.3 My Price
2.1.5 Feedback
2.2 Administration
2.2.1 Add a Department (ADMIN)
2.3 Contact
• This section describes the features in Contact module.
• Following figure shows the landing page of Contact module.
NOTE:
1. There is a group called “My Contacts”. Each client account will have this group by default.
This group cannot be deleted and edited, but it can be viewed by everyone.
2. If Allow Private Contact Feature has been enabled in your account, you will see extra option
to let you decide whether you want to personalize your group or share among your users.
◦ “Public” means the group can be viewed by all users. However, the group can only
be edited by administrators and group owner.
◦ “Private” means the group can only be viewed and edited by administrators and
group owner.
◦ Only administrators and group owner can edit the group.
1. At the Contact main page, click the EDIT icon on one of the groups under the group list at
the right.
2. A dialog box will prompt out.
3. Enter the group name in the text box. Group name is unique, so same group name is not
allowed by the system.
4. Click the UPDATE button.
1. At the Contact main page, click the EDIT icon on one of the contact groups at the right.
2. In the Modify Group dialog box, click on DELETE button. A confirmation dialog box will
appear.
7. When user attempts to delete group 'Swimming Club', the system will pop out another
dialog box to request final confirmation from user.
9. If user chooses the first option “remove group and all contacts within this group”, all
contact under 'Swimming Club' will be deleted. As a result, 'Tengku, Herosimah' will
disappear from 'Tennis Friends' as well.
10. The contact retain in 'Tennis Friends' but removed from 'Swimming Club' if user chooses
'Remain contact in other group(s) when exists'.
1. Click ADD CONTACT button at the Contact landing page. The CREATE / EDIT CONTACT form
will appear.
2. Enter the contact information for corresponding text boxes in contact form.
• When a person has more than one mobile phone numbers, the first mobile phone
number will be displayed in contacts list, and also will be used for sending SMS.
3. Click on plus sign beside the Reminder to expand additional fields. Put a check on the
checkboxes will activate the reminder. The system will send reminder as long as it is
activated.
4. Click on “ADD TO GROUP” button, and put a check on the checkboxes to select which of the
contact group that the new contact should be tagged.
Note:
Every contact must be tagged under group(s).
2. Modify the contact information for corresponding text boxes in contact information form.
NOTE:
1. Only administrators and contact owner can modify the contact information when the Allow
Private Contact feature enabled in the account.
DELETE A CONTACT
1. In contact list, click on contact link.
2. Click on DELETE button.
3. A confirmation dialog box will appear. Left click the OK button.
4. This will delete the contact permanently from all of the groups that have been tagged.
1. At the contact landing page, user can check the contact to be deleted. The DELETE button
will appear on the top. Press the DELETE button. This action will delete the contact
permanently from all of the groups that have been tagged.
NOTE:
Only administrators and contact owner can delete the contact when Allow Private Contact feature
has been enabled in your account.
SIMPLE SEARCH
1. Above the contact landing page, there is a search textbox at the right.
2. Enter keyword that you want to search. Keywords that you can search are first name, last
name, display name, phones, faxes, pager and emails.
3. The searching result will be reflected in contact list after few seconds.
4. Searching may take longer response if contact database is huge.
ADVANCE SEARCH
1. At the Contact page, click the ADVANCE SEARCH link, right beside the search textbox.
Search Contact dialog box will appear.
2. Enter the search criteria.
3. Click on SEARCH button.
QUICK UPLOAD
UPLOAD CONTACT
1. At Contact page, click on MORE ACTION drop-down button, then select Upload Contact.
2. Upload Contact dialog box will appear.
3. Customize the fields, by clicking minus icon to remove unnecessary fields, or clicking plus
icon to add necessary fields.
4. Create a CSV (.csv) or Excel (.xls) file based on SELECTED FIELDS format.
5. Save the CSV (.csv) or Excel (.xls) file on desktop.
6. Select the contact group to be uploaded.
7. Choose the UPLOAD TYPE in either CSV or Excel based on the file created.
8. Enter the Fields Terminated By and Fields Enclosed By text box only if the CSV selected as
Upload Type.
9. Left click the Browse button to open the CSV or Excel (.xls) file on desktop.
10. Left click the UPLOAD button.
1. At Contact page, click on MORE ACTION drop-down button, then select ADD PREFIX.
2. Determine what prefix to put, and select appropriate contact group to be updated. Then,
determine which phone/fax to be updated with the prefix, and set the starting number
which needs to be prefixed.
3. Click on ADD button to add the prefix.
2. The contact 'Hiroka' will be untagged from Swimming Club if user press the [X] button.
1. User can duplicate multiple contact to another group by putting a check to the preferable
contact(s) and select the group under drop-down box ADD TO.
2. This will create new contact record and save into the preferable group.
1. In Contact page, click on the MORE ACTION drop-down button, then select Export Contact.
Export Contact dialog box will appear.
2. Choose the contact group to be exported. If ALL_GROUP is selected, all contact database
will be exported.
3. Set the EXPORT TYPE, whether in CSV or Excel format.
4. Enter the TERMINATED BY and ENCLOSED BY only if select CSV.
5. Tick the PUT FIELD NAME AT THE FIRST ROW if wish to export the field name.
6. Enter the file name in STORE FILE NAME AS text box.
7. Move the fields to export from UNSELECTED FIELDS text area to SELECTED FIELDS text
area.
• If a contact has two or more same field names, those field name values will be
exported as well. For example, if a contact has two or more Mobile Phone fields, the
two or more Mobile Phone fields' values will be exported as well. In the exported file,
two or more fields will be displayed when the exported file is opened.
8. Click on the EXPORT button.
9. Export feature may take few minutes if contact database to be exported is huge.
2. The date of birth / date reminder of my uploaded contact all becomes “1970-01-
01”
Ensure your date format is mm-dd-yyyy. Please upload in CSV format instead of Excel
format. Excel does not recognize date format properly.
3. I do not receive the birthday reminder even though I've set my DOB as today.
The auto-reminder feature perform every night to send out tomorrow's DOB reminders.
Please set tomorrow's date and checked the birthday auto-reminder. Then you will receive
the birthday reminder SMS tomorrow.
4. I receive an error when I create new contact: “Please tag your contact.”.
You did not tag your contact to any group. Please select group(s) when creating a new
contact. You must create group if you could not find any group under ADD TO GROUP.
5. I can not find any group names under ADD TO GROUP when create a new contact.
You did not create any group before. Please create a group before you create a new
contact.
6. I cannot find the group I want to select under ADD TO GROUP when create /
modify a contact.
The group list displayed under ADD TO GROUP are the group names created by contact
owner. For instance, you are modifying a contact owned by User A. The group list displayed
under TAG GROUP are the group names created by User A only. The group you want to
select is probably created by other user. Please select the user list under the ADD TO
GROUP button in order to view the groups that created by each user.
2.4 SMS
2.4.1 Send a SMS
• Click on TO button. A dialog box will appear below the To textbox. Click on Contact tab.
Select which contact you want to send SMS, and put a check on the checkbox. After
that, click on INSERT button. See screenshot below.
• Create a CSV (.csv) or Excel (.xls) file with the contact number at first column and make
sure each contact number starts with country code prefix, such as 60 for Malaysia.
Click on Upload Contact tab (folder with arrow pointing up icon). Left click the Browse
button to browse for the contact list file. Left click the UPLOAD button. A group named
as TempGroup followed by a running number will shown in TO text box to represent the
uploaded contact.
• Enter the contact number manually to the TO text box. If more than one contact
numbers entered, separate each other with a comma. Make sure that each contact
number has country code prefix.
4. Enter sms content to MESSAGE text box. (The character including space and symbols.
Enter key is considered as 2 characters.)
5. The Pages(s) label will display the page of sms utilize for references purpose. (Maximum is
3 pages.)
6. The Character Count label display the total characters entered in Message text box.
7. Select the SEND option:
• Now (The sms will send it immediately)
◦ Left click NOW option.
• Schedule (The user can set a schedule in date/time and the system will send sms on
the scheduled time automatically)
◦ Left click SCHEDULE option. (User can check the schedule list at SMS menu, then
SCHEDULE sub menu.)
8. Click on SEND button.
9. Confirm the sms detail before send it.
10. Left click the CONFIRM button.
NOTE:
Select the SMS Type by clicking the green icon (Standard), or red icon (Unicode).
Select the Sender ID tab (the purple icon) on the right side, and choose the correct
Sender ID in the drop-down box.
Note: The Sender ID not Applicable for most of the Malaysia customer
There is few ways to enter the receiver of sms :-
◦ Textbox
◦ Enter a phone number, then press ENTER key. Continue this process until
all numbers have been entered.
◦ To Button
◦ Click on the To button to pop-up a small window, displaying two tabs.
Choose Group tab, if you want to send SMS to a group of people, or Contact
tab if you want to send SMS to a selected people only.
◦ Upload
◦ Create a CSV or Excel file with the phone number at first column and make
sure each phone number start with country code prefix such as 60 for
Malaysia
◦ Click on Upload tab (folder icon) on the right. Click on the browse button to
browse for the contact list file and upload it
Enter the sms content in Message text box
The standard / text sms allows 160 character per page whereas unicode sms allows 70
characters per page.
The sms content only accepts the following characters:
Symbols such as !#$@%^&*()-_=+:;'"~<>,.?
Any alphanumerical characters from a-z, A-Z, and 0-9
Space
Enter key is considered as 2 characters and other special characters as below:-
The Page label will display the page of sms utilize for references purpose
The Character Count label display the total characters entered in Message text box
Vertical bar/Pipe | 2
Euro sign € 2
2.4.3 Outbox
2.4.4 Draft
2.4.6 Schedule
6. Left click the !FIELD1 to !FIELD6 button which next to the text box to include the
information that will define soon. (The CHARACTER COUNT refer to the total characters
entered in CUSTOMIZED MESSAGE text box.)
7. Create a CSV or Excel file as format below.
12. User allows to upload another CSV or Excel file if there is more than a file to upload (The
data will expand with the previous CSV or Excel file in Customized SMS List.)
2.4.9 Reminder
2.4.10 Sender ID
NOTE:
• A campaign can have more than one keyword.
• Keyword refer to the fix beginning term before enter the sms content
The format is <keyword> <sms content>
• User only can create keyword once the campaign is created
• Short Code refer to the short code of mobile phone number for each client sms will send
to
• Keyword must in alphanumeric and not allow space.
• Maximum length for keyword is 20 characters
• User ID refer to the user that has privilege to view the keyword detail
2.6 Report
2.6.1 Traffic
2.6.2 Statement
2.7 System
2.7.1 History Log (ADMIN)
2.8 Email
2.8.1 Send Email
Compose Your Own allows user to compose user's own email from scratch. User can use
available tools at the editor, just like Microsoft Word. Then, user can send email instantly, or
schedule it to be sent later.
Compose From Template allows user to choose preset templates for user's new email. Just click
on any of the template image, and the template will be displayed in email editor.
Compose From Draft allows user to edit user's saved emails. User either edits the emails, or you
can delete the emails that are no longer needed.
Customized Email allows user to customize user's email similar to mail-merge used in Microsoft
Word. There are six fields for user to use in user's customized email.
2.8.2 Outbox
2.8.3 Schedule
Upload from Own File allows you to upload your voice in WAV format
• Choose a WAV file to be uploaded.
• Click on UPLOAD button to upload your chosen WAV file.
Record Online allows you to record your on voice, and upload it. In order to use this feature, you
must have Java installed in your computer. Just follow step-by-step on the screen, and you can
record your own voice already.