BabbleSMS Product Guide

BabbleSMS ProductGuideA Product of Tawi Commercial Services Ltd

2015

[email protected]

March 2015

Copyright © Tawi Commercial Services Ltd 2015. All rights reserved. 1

INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH TAWI COMMERCIALSERVICES’ PRODUCTS. NO INTELLECTUAL PROPERTY RIGHTS, LICENSE, EXPRESS OR IMPLIED,BY ESTOPPEL OR OTHERWISE, IS GRANTED BY THIS DOCUMENT, EXCEPT AS PROVIDED INTAWI COMMERCIAL SERVICES’ TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS. TAWICOMMERCIAL SERVICES ASSUMES NO LIABILITY WHATSOEVER, AND TAWI COMMERCIALSERVICES DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USEOF TAWI COMMERCIAL SERVICES’ PRODUCTS INCLUDING LIABILITY OR WARRANTIESRELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENTOF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT.The Programs (which include both the software and documentation) contain proprietaryinformation; they are provided under a license agreement containing restrictions on use anddisclosure and are also protected by copyright, patent, and other intellectual and industrialproperty laws. Reverse engineering, disassembly, or decompilation of the Programs, except tothe extent required to obtain interoperability with other independently created software or asspecified by law, is prohibited.The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or otherinherently dangerous applications. It shall be the licensee's responsibility to take all appropriatefail-safe, backup, redundancy and other measures to ensure the safe use of such applications ifthe Programs are used for such purposes, and we disclaim liability for any damages caused bysuch use of the Programs.Tawi Commercial Services may make changes to specifications and product descriptions at anytime, without notice.No part of this publication may be reproduced, transmitted, transcribed, stored in a retrievalsystem, or translated into any language or computer language, in any form or by any means,electronic mechanical, magnetic, optical, chemical, manual, or otherwise, without the priorwritten permission of Tawi Commercial Services Ltd.Copyright © 2015 by Tawi Commercial Services Ltd. All rights reserved.All other trademarks are property of their respective owners.Tawi Commercial Services Ltd.1st Floor, Corner View Centre,Naivasha Road,P.O. Box 20222 – 00100.Nairobi, Kenya.


Table of Contents1. Introduction 32. Feature List Overview 42.1. Login and Session Management 42.2. Account Management 52.3. Contact and Group Management 62.4. Inbox, Sent and Compose 72.5. Reports 93. Detailed Feature List 124. Appendices 154.1. Glossary 15


1. IntroductionTawi Commercial Services Ltd is a Kenyan based software development companythat specializes in mobile technology. The services that Tawi offers include; shortcodes, bulk SMS, USSD code and electronic airtime, and mobile applications.Tawi is licensed by the Communications Authority of Kenya (CA) as a contentservice provider. She offers SMS and USSD services through Safaricom and AirtelKenya.BabbleSMS is a turnkey web based application that allows for remote short codeand bulk SMS in interactivity through a portal. The client typically purchases creditfrom Tawi and is able to send messages on their own convenience. BabbleSMStargets users who want to send and receive SMS with Contacts and Groups.


2. Feature List OverviewBabbleSMS is a product that facilitates sending of SMS by multiple parties to bothSafaricom and Airtel network users. It also allows for the receiving of the messagesby the parties. The gateway is accessible through the URL:http://babblesms.tawi.mobi. Businesses and institutions are able to monitor theirown accounts.BabbleSMS is easy and convenient to use. As a user you are required to typicallypurchase credit from Tawi to top up your account. The application has featureswhich guarantee that it works effectively and to the user’s satisfaction. For example,it ensures that messages are not lost in transit through a continuous messagedelivery effort to the MNO SMS Centre. It also has security features necessary toprevent unwarranted sending of SMS.Interactivity with the system only happens after an account for your institution iscreated on the system manually by a Tawi System Administrator. Remote creationof accounts by either the business or the organization is not allowed. The followingfeatures are available;2.1. Login and Session ManagementTo be able to log in, the user requires a username and a password. You are alsoprovided with a captcha for verification. This ensures that your account is safesince the username and the password are to be known only by you.

http://babblesms.tawi.mobi/


Figure 2.1: Log In Page2.2. Account ManagementThe users are able to manage their accounts through a control panel. The user isable to manage his/her account and contacts upon logging in. for example, the usercan modify attributes of his/her contacts such as primary email and primary phone.

Figure 2.2: Dashboard


This is a Quick Reports page. It shows the count of Incoming messages, Outgoingmessages, Contacts and Groups.2.3. Contact and Group ManagementUsers are able to edit their own accounts. For example, the user can add, modify ordelete a Contact from his/her account. As a user, you can also modify the attributesof your account such as primary email address and primary phone number. Youwill be able to view a list of all your contacts in alphabetical order as user, whichare paginated if they are many.Moreover, the user is able to group his/her Contacts, and a contact can belong tomore than one Group. Groups have attributes like name, description and date ofcreation and can support mobile phone numbers of heterogeneous networks.

Figure 2.3.1: Contact Page


The figure above shows the Contact page. It has the name, phone number, emailand group of your Contacts.

Fig 2.3.2: Group PageThe figure above shows the group page of the user as they created them.2.4. Inbox, Sent and ComposeUser Inbox view has a list of all incoming SMS. Each SMS shows a Message Id, Text,Source (phone number or name), Destination and Timestamp.Sent SMS also has a list of all outgoing SMS. In addition to the details above, theuser is able to see the Status of the message such as Sent, Success and Failure.The user is able to compose messages that can be sent to Groups and Contacts.


Fig 2.4.1: Incoming SMS

Fig 2.4.2: Sent SMS


Fig 2.4.3: Compose SMS

2.5. ReportsUpon logging in, the user has access to a graphical report of activity. This isachieved by use of charts and graphs. The reports show the credit purchase historywhich has details of amount, network and the date of purchase. A client is also ableto view amount of credit balance in each network.


Figure 2.5.1: Incoming SMS By NetworkThe figure above shows information about incoming messages by network. It is acontinuation of the landing page.


Figure 2.5.2: Outgoing SMS By Day in Week


3. Detailed Feature List

Client Web PortalLogin and Session Management

1 A Client is able to log in using a valid username and password and verified by a captcha.2 A Client is automatically logged out after 20 minutes of inactivity.3 The username of the Client is displayed in the header section of the portal when logged in.

Account Management4 A Client is able to modify the following attributes of his / her account: Primary Email (unique

in the system), and Primary Phone.5 A Client is able to reset his/her website login password. The client will receive an

automatically generated email with a new password. Upon logging in with the new password,the client is prompted to change the password.

Contact Management6 A Client is able to add, modify and delete a Contact in his account. Contact attributes are

name, mobile phone number(s) with corresponding MNO, email(s) and description. A Contactmay have more than one mobile number and email. The mobile number should always beassociated with a network.

7 A Client is able to view a list of all Contacts in his/her account in alphabetical order. Thedisplay can be paginated if they are many. The primary attributes of the Contacts aredisplayed. Secondary attributes which can be accessed away from the primary list displayinclude: Groups that the Contact belongs to.

8 A Client is able to search through the Contacts list using Name, Mobile Number or Email.9 A Client is able to add, modify and delete a Group in his account. Group attributes are Name,

Description and Date of Creation.10 A Client is able to add or delete Contacts from within a Group. Groups support mobile phone

numbers of heterogeneous networks.11 A Client is able to view a list of all Groups in alphabetical order. The display can be paginated if

they are many. The primary attributes of the Groups will also be displayed. Secondaryattributes which can be accessed away from the primary list display include: Number ofContacts in the Group and number of SMSs sent cumulatively.

12 The Client is able to import Contacts into the system using a CSV file. The columns in the fileare: Name, Phone Number, Email and Description. The Name and Phone Number fields arecompulsory on each row. If a row is inconsistent or cannot be deciphered, it is skipped. At theend of the import process, the system generates a report of the count of successful importsand which row numbers of the CSV were not imported.


Navigation and Page Layout13 A Client has the following views of SMS: Inbox and Contact Sent and Group Sent.14 The Inbox view has a list of all incoming SMS. Attributes of the SMS are: Message Id, text,

source (phone number or name), destination (short code) and timestamp. If the source of theSMS is inside the phonebook, the name of the sender should be displayed in place of thephone number. The SMS should be ordered in time descending. They will be paginated ifmany. A column with the count will be available.

15 The Contact Sent view has a list of all outgoing SMS to Contacts. Attributes of the SMS are:Message Id, text, source (short code or mask), destination (phone number or name),timestamp and Message Status (“Sent”, “Success” and “Failure”). If the destination of the SMSis inside the phonebook, the name of the recepient should be displayed in place of the phonenumber. The SMS should be ordered in time descending. They will be paginated if many. Acolumn with the count will be available.

16 The Group Sent view has a list of all outgoing SMS to groups. Attributes of the SMS are: GroupSent Id, text, source (short code or mask), destination Group and timestamp. The SMS shouldbe ordered in time descending. They will be paginated if many. A column with the count willbe available.

17 An inline Help section is available. The Help will include Frequently Asked Questions (FAQ).18 A Contacts section is available. Here, the company details to be displayed are physical address,

postal address, landline and support email. A form will be available through which the userwill be able to submit a contact email, topic of enquiry and a general description in the form offree text.

19 The Client has access to a Live Chat window that allows for real time text chatting to a supportadministrator.

20 The website provides Path (History) Breadcrumbs and a Site Map.

SMS Management21 A Client is able to send SMS individually to a Contact in his account. The system should check if

the account has sufficient credit before approving the transaction.22 A Client is able to send SMS to a Group in his account. The system should check if the account

has sufficient credit on all networks in the Group before approving the transaction.23 A Client is able to create and manage SMS templates. These are pre-written text that can be

used to send to Contacts or Groups.24 The user is able to create and manage autoreply of SMS.25 A Client is able to export the Inbox and Contact Sent SMS to MS Excel 2007 format (OOXML)

or CSV text file.26 A Client is able to search through SMS using the Message Id or mobile phone number.27 A Client is able to export the results of an SMS search to MS Excel 2007 format (OOXML) or

CSV text file.28 The Client is able to set up a maximum daily limit of SMS that can be sent from his/her

account.


29 A Client is able to optionally set minimum credit amount for his/her account thus below thatthe system sends an email notification to the user.Reports

30 A Client is able to view a pie chart of SMS divided by networks, for incoming and outgoingSMS.

31 A Client is able to view a bar graph of incoming and outgoing SMS over a number of days. TheClient is able to specify the start and end day. The bar graph can be composite to indicatetraffic across each network provider.

32 A Client is able to see the following details in text format:31.1 * A count of incoming SMS per network31.2 * A count of total outgoing SMS per network31.3 * A count of successfully delivered SMS per network

33 A Client is able to see the sources of SMS that he/she can use to send. These will be specifiedwith the network. He/she is also able to view the short codes from which he/she can receiveSMS, if the Client account has that ability.

34 A Message Board is provided for system generated and administrator generated notices.35 A Client is able to optionally receive a summary of credit activity on email. Attributes to be

configured for email reports include frequency (daily, weekly or monthly) and email(s) toreceive reports.

36 A Client is able to see all past purchases of credit. Details of purchases include network,amount and date of purchase.

37 A Client is able to view the amount of credit balance in each network within which he/she hasbought credit in the past.


4. Appendices

4.1. Glossary

API …………………………………….. Application Based Interface; refers to a set ofroutines, protocols and tools for building software applications.Captcha ………………………………. an acronym for "Completely Automated PublicTuring test to tell Computers and Humans Apart") is a type of challenge-responsetest used in computing to determine whether or not the user is human.CSV …………………………………………Comma Separated Value; refers to a file that storestabular data (numbers and text) in plain text form.MNO ……………………………………….Mobile Network Operator; also known as wirelessservice provider, MNO is a provider of services wireless communications that ownsor controls all the elements necessary to sell and deliver services to an end user.URL …………………………………… Uniform Resource Locator; refers to a reference (anaddress) to a resource that specifies the location of a resource on a computernetwork and a mechanism for retrieving it.USSD …………………………………….Unstructured Supplementary Service Data; this is aprotocol used by Global System for Mobile (GSM) cellular telephones tocommunicate with the service provider’s computers. USSD can be used for WAPbrowsing, prepaid callback service, mobile-money service, location based contentservices, menu based information services and as part of configuring the phone onthe network.PRS ……………………………………... Premium Rates Service; these are services usuallychanneled through SMS short codes or special numbers leased by networkoperators to PRS providers.

http://en.wikipedia.org/wiki/Wireless_communications


Short Codes ………………………….. Refers to special telephone numbers, usuallyshorter than full telephone numbers that can be used to address SMS and MMSmessages from certain mobile providers’ mobile phones or fixed phones.Web Based Interface ………………… refers to the interaction between a user andsoftware running on a web server.

Date post:	12-Jan-2017
Category:	Documents
Upload:	tawi123
View:	87 times
Download:	3 times

BabbleSMS Product Guide

Documents