Home

Personalised SMPP Client - Microsat Internet Technologies

1. During anytime that you are using the application and you need help on a particular feature you need not go searching for this document The Help Panel offers application embedded and feature specific help right inside the application This makes using the application even more useful and efficient as you do have to navigate or search for the topic that you need help on in a user manual such as this The help is offered on all of the features of the application that would typically require help Plus this help is offered in a brief format and hence can be read typically within a few minutes For any other comprehensive help or details about the application you can always concern this document In the help panel just click the topic that you need help on and you can read on the topic there itself SendSMS AddressBook Delivery Reports Unicode Converter Credit Details Proxy Settings Help Please click a topic for help Bulk SMS Credit Details Delivery Reports 39
2. column headers or tag names separated by tab E message csv Notepad E olx File Edit Format View Help Destinations Hessage 971503698541 Your account balance 9678451235691 Your Interest amount And enter one message per row followed by destination as above li Once the file is ready with all the tags and their corresponding values save the file as a CSV And choose Encoding as Unicode 20 Personalised SMPP Client Ix Save As E Save in Files v 3 E p mje og Address files E Destinations tet Message ta My Recent Documents My Computer Save as type Text Documents bd M Encoding a File name Unicode big endian LITF 8 Once the file is browsed and selected all the tags are populated from the file except the first column header since it will be the destination and those populated tags will be displayed in tag list Personalised Tag List Populated Mame Name Account ms mr 3 Where ever you wish to insert the tag into the message place the cursor there and click on Insert Tag Tag will be inserted at the cursor position For example any of the above tags is to be inserted at any place in the message then just select the tag and click Insert Tag You can see tag name is inserted into the message 4 The tag name would be enclosed inside lt and gt that would be inserted in the message like the one below Reason for using lt and gt is to bifurcate th
3. it does the next section might just answer them Those who do not want to get into much technical detail can feel free to skip the next section Personalised SMPP Client Requirements Protocols and Network connection The application works on the Short Message Peer To Peer SMPP Protocol SMPP Protocol allows an ESME External Short Messaging Entity to communicate with a SMSC Short Message Service Centre The SMPP Protocol defines PDUs Protocol Data Units for the entities to communicate with each other The SMPPClient acting as an ESME sends PDUs to the SMPP Server or SMSC to connect send messages disconnect receive delivery reports of send messages etc During sending a batch of messages the application needs to be connected to the server all the time If it disconnects in between then the sending might stop immediately and to start again the user might have to enter all the parameters again The application even needs to send and receive PDUs just to stay connected to the server And a non active Internet connection or a connection that keeps dropping might pose problems in the proper functioning of the application In such regard one of the core requirements for the application to work appropriately is an active Internet connection at all times Operating Systems Windows The application runs on Microsoft Windows XP Other editions not tested Other Systems The application also runs on Linux based systems but is no
4. save it with a txt text extension else the application won t allow you to select the file through the interface When you are done select the Bulk message option so you see the bulk messaging options On the bulk message menu click the button to select file It will open a file selecting dialog select the file that you saved and set the other parameters accordingly Once you have selected the file click on the Check File button Bulk Message dialog will appear which displays the information regarding filename Total Numbers Valid Numbers and Invalid Numbers Total Numbers Total numbers displays the total number of destinations number Valid Numbers Length of the number should be less than or equal to 14 digits and plus sign before the number is optional Invalid numbers This will displays the total number of invalid numbers If you do not check the file then you cannot upload the file on server Bulk Message 1 The selected file C Files Address filestDestinations ba contains Total Numbers 100000 Valid Numbers 100000 Invalid Numbers 0 Finally click Upload amp Send which begins the file uploading process In File Uploading process the new Job is created for uploading the file Once the new job is created the file is uploaded on the Server and then job is updated Progress bar will show the progress of file uploading process 13 Personalised SMPP Client Create Destinations file like this N
5. 10 Personalised SMPP Client SendSMS AddressBook Delivery Reports Unicode Converter Credit Details Proxy Settings Help amp Single Test for single message 23 Characters 1 Message Save Message Clear Message If you wish to send the message any other time then you can just save the message content in a txt file by clicking the Save Message button which will open a save file dialog to save the message into txt file where ever you want to save the file and import the same message from the file and use the content for sending Click Send to send the message Quick Message A 1 Messagets sent successfully You will get a success message if the message is sent successfully 11 Personalised SMPP Client Quick Message Quick Message feature allows you to send message to maximum of 10 destinations For this you need to write a mobile numbers with comma separated When you are done click Send to send the messages to maximum of 10 destinations SendSMS AddressBook Delivery Reports Unicode Converter Credit Details Proxy Settings Help gt Single Z Bulk DD Group Save Message 12 Personalised SMPP Client Bulk Message Bulk Message feature allows you to send a message to multiple destinations For this you need to create a file containing all the destinations mobile numbers with each destination on a new line Once you have created such a file
6. 4006500200063006f006e00760065007200740065007 2002 E Enter the text that you need to convert into the text area provided for normal text Click Convert to get the Unicode for that text Copy Ctrl C Cut Ctrl X 8 Paste Ctrl V or Right Click Mouse the converted text from the Unicode text area to the message area provided for message text in the SendSMS panel Remember to change the type of the message to Unicode in the message type box and then send the message 36 Personalised SMPP Client Credit Details The credit details panel shows you the credit details for the user such as credit allotted Balance left and credit used This panel proves helpful so that the user does not have to open a browser window go to the web interface provided by the company every time he has to check his credit details He can just access the tab for credit details and he can check all the details right there Username demo Credit Allotted 100 Balance 90 Used 10 37 Personalised SMPP Client Proxy Setting Proxy server serves one more step toward security It filters all request or response And allow only those request or response which has authorization Pass is nothing a code or text set in your proxy server You can set your username and password as well as server and port no It restricts unauthorized access to your data Proxy Server s Settings Server Port Username Password 38 Personalised SMPP Client Help
7. B E D E F 3 H 1 Destination Name Account 5 This is the second column header or the 7 2 491900000000 John Your acco second tag name that will be used in the 397922000102 Jack Mana 14 message any time you wish to use the z dvalues of this column to send to their 4 corresponding destinations 5 A G ik LF i Fi ja 4 10 11 12 13 41a Similarly you can set the number of column headers or tag names that you need to use in the message ii Once the file is ready with all the tags and their corresponding values save the file as a CSV Comma delimited file If the file contains Unicode Characters or Special characters Like Arabic Hindi Chinees Japanees etc Destinations csv Microsoft Excel m bl x Home Inset PageLayout Formulas Data Review View Add Ins DT x Ce 2 C D E Destinations Name Messagel Messages 973399598990 Ahmed Hindi cal 9722558966026 Jack Arabic olu 3 4 4 gt H Destinations Sheet ri Sheet3 ART 19 Personalised SMPP Client K ES D My Recent 750 Real World Documents G Adobe E Desktop 4 Downloads GS Firewall E TE z I horsecar ae 17 My Data Sources My AA oe Computer ba i ay 2 my Pictures uJ My Network Places File name Destinations csv 09090900 M save as TYPE Unicode Text bet Save Cancel Then Save the file as File Name Book1 csv and Save astype Unicode Text OR I Open notepad The first row of the sheet will be the
8. Delivery Report of the selected date Select Datewise Report No Records to display for current date 34 Personalised SMPP Client After selecting the date month year for view the Delivery report you will view this kind of page if there is not any record of delivery report of the selected date SendSMS AddressBook Delivery Reports Unicode Converter Credit Details Proxy Settings Help 35 Personalised SMPP Client Sending a Unicode Message This section not only explains sending how to send a Unicode message but also how to use the Unicode converter Both these features are fairly simple and would not require much explaining but an example makes things all clear We take a simple example to send a Unicode message Here we need to understand that though we use the Unicode converter to convert a text message which can be sent in its original form as a text message Unicode converters are typically used to convert Arabic text to Unicode so that it can be received in its original Arabic form on cell phones that support Unicode character encoding Unicode Converter Typefenter text here This is a simple text to explain the uasge of unicode converter Convert Unicode 0054006860069007 300700069007 30020006 1002000 73006900640070 006t006 S00 2000 740065007300 740020007 4006700200065007 8007 0006c0061 0069006 e00 2000 F400680065002000F 50061007 30067 006500 000606600 000r S006 e00680063006f006
9. Personalised SMPP Client Personalised SMPP Client User Manual Version 1 1 Personalised SMPP Client Table of Contents Introduction 3 LF Installation 004 Post Installation 09090909 6 Using Desktop e 7 Si singemessage SSS 2 ME OB o 16 0024 3 A 5 7 10 12 13 16 24 5 Personalised SMPP Client Introduction The Personalised SMPP Client is an application that runs on a client computer and connects to an SMPP Server This application enables you to send messages and receive Delivery Reports Apart from the send receive provisions you can manage your contacts with the Desktop Client using the AddressBook feature The AddressBook allows you to create new Groups and add upload contacts to a group It also allows the creation and modification of Distribution Lists Distribution Lists contain only numbers as opposed to groups which contain contacts that have a name and a number Using the Desktop SMPPClient a user can also check his CreditDetails online CreditDetails show the user details like the initial credit allotted to him the credit used by the user till date and the balance left The next section discusses certain technical details about the application and its working environment so as to understand the requirements of the application and also to appreciate them One does not need to read this section to use this application But if you have a few questions as to why the application behaves the way
10. ading contacts This feature allows you to add multiple contacts to a group at once Select a group that you want to upload contacts to and click Upload contacts Fill in the details for the contacts in the specified format The contact name and number should be mentioned on one line separated by a comma or space One contact on one line Upload Contacts Group Mame Tabby All Contacts should be in a line separated Format Mames and Numbers within a contact should be either commal 1 or space separated For Ex Mame Number or Mame Mumber You can CopyiCtrl 0 PastelChrl V numbers from Files Contacts Chris 2341111111111 Save Cancel When you are done click Save On clicking Save the entries will be scanned and all valid entries please see the Errors section for information on what entries will be treated as invalid will be added leaving out the invalid entries You will get a message for the entries that were treated as invalid and their line numbers 28 Personalised SMPP Client 2 line s have errors Possible Causes 1 You entered the Contact in a format that is not supported 2 You might have entered contacts with same numbers duplication in this list 3 You might have entered a contact with a number that is previously existing in the group Possible Solutions 1 See Above for supported formats or check the help document 2 Check the list below for duplication within the list 3 Check your c
11. an use any of these shortcuts to start the application at a later time First Run When you run the application for the first time after installation the application will install the Java Runtime Environment JRE if you do not already have it and if you have downloaded the JRE Embedded pack As stated in the requirements section this is one of the must requirements that the application cannot run without The application will inform you before installing the JRE through a dialog If you have a non JRE Embedded pack it will redirect you to the page where you could find the latest JRE Personalised SMPP Client Using Desktop Client Once you have installed the application on your desktop you can start using it right away Just double click the desktop short cut or select the application from under the programs menu This will start the application and you will see a login screen similar to this Login m Username Password Enter the Username Password and then click OK to proceed to the application If you get a dialog saying Invalid Username Password check and re enter your Username and Password If you continue getting this message contact your business manager Login Failure x Invalid Username Password Please try again Once you have entered all the login details you can start using the application The first screen you will see is Bee kl iad pS There is one main panel that allows you to access
12. e tag names from rest of the message content 21 Personalised SMPP Client Personalised Hi Mamez Tag List Populated Name yr Insert Tag Auto complete tags Auto complete tags Auto complete tags feature allows you to complete all the tags with the appropriate tag names where ever the value in the message is enclosed into lt and gt For example if the value in the message is lt Ne gt or lt ne gt or lt NE gt or lt nE gt then the value will be replaced by the actual tag name which starts with N or n and ends with e or E Here it will replace all of the above specified values with lt Name gt Message Type Text File AdministratoriDesktopione csy O Flash 25 Sender ID Message Personalised Hi snes YOU account number is lt Act Tag List Populated Mame yt Insert Tag Auto complete tags When you click Auto Complete Tags all the values in the message enclosed between lt and gt that matches with the tag list will be replaced by their corresponding tag names in the message as shown below 22 Personalised SMPP Client fT SY Text Sender ID Flash Message Personalised Hi Mamez You account number is Account Tag List Populated Mame yr Insert Tag AUTO complete tags Po Jeets Tag names and their corresponding values which are not reguired but are there in the file will not affect the message Only those values will be used for creati
13. eate Group EES Group Mame Tobby Type in the name for the group and click Save You can see the group created in the Group Box Select Group Adding Contacts Now to add contacts within this group select the group from the group box and click Add Contacts You can see a dialog similar to this 25 Personalised SMPP Client Select Group Select Contacts Name Number Delete Ek ae E select E Add Contact x Delete Contact Upload Contacts Add Contact Contact Mame Contact Number 234000000001 Cancel Enter the details for the contact and click Save You can see the contact added to the selected group in contact table Select Contacts Mame Humber Delete Edit John 234000000001 F MA z345122202 O Select All 26 Personalised SMPP Client Editing Contacts You can edit previously added contacts from a group To do this make use of the fourth column in the contacts table In this column titled edit select the contacts that you want to edit Once you have selected the contact to be edited the Edit Contact dialog will appear Then Edit the contact and click on save The Edited contact will be reflected immediately Select Contacts Number Delete Edit Edit Contact Contact Mame E g Joesmith Mot Joe Smith Contact Number 234000000001 E g 44 Mot 44 Save Cancel 27 Personalised SMPP Client Uplo
14. le showing the editing of a list is shown here Firstly select a previously created list from the distribution lists list Then select Edit List You will see a dialog as shown below Distribution List OK List Mame DistList Please enter numbers in a line separated format You can Copy Ctrl kC PastelCtrl FY numbers from Files List 234101010101 kail Remove the last two entries and click Save Now if you select the list again for editing you can see that the changes you made have taken effect SUCCESS JI Added all valid entries to the Distribution List 32 Personalised SMPP Client Group Message After getting to know how to add and manage Groups and Distribution Lists you can move ahead with sending a Group Message A group message is a message that you send to a previously configured group or a distribution list You can also send message to all contacts from your entire group set by selecting All Contacts Select Group message from the SendSMS panel Select the Group or Distribution list to which to send the message from the Select Group list or select All Contacts as said above to send a message to all contacts from all groups ia Th Select v STEE e Text C Flash Sender 1D O Unicode CY Unicode Flash Select Contacts Message Name Number Select John 234000000001 Joe 2345122202 w Here as you select a group from Group List the contacts from the list are listed in the select co
15. lect Contacts Mame Humber Delete Edit John 24000000001 F OQ we aste Q O The contact has been deleted and the updated group formation can be seen here 30 Personalised SMPP Client Distribution Lists To create a distribution list click Add List You will see a dialog for entering the numbers in the distribution list Set a name for the list Then fill in the list with the numbers again the numbers are supposed to be in the line separated format Also one can cut copy paste by right click of a mouse from excel sheet An example is shown below Distribution List EOK List Name Please enter numbers in a line separated Format You can CopytCtrl C Pastetctrl V9 numbers from Files List 234101010101 Save Cancel Once done click Save You will see a success dialog as shown below SUCCESS Jj Distribution list with walid entries created successfully Here again the distribution list will only be created containing all the valid entries The invalid entries will be reported and discarded 31 Personalised SMPP Client Editing Distribution Lists Once the list has been created you can manage it by selecting it from the distribution list combo box Select the list that you want to manage and click Edit List You now have the option of editing and deleting the list Through edit list you can also add or delete a few contacts from an existing list and save it so that the changes get affected An examp
16. ng file whose tag names are there in the message and the samefile will be uploaded For example tag Balance is there in the file and can be seen in the tag list but it is not required for this message Without including the tag lt Balance gt into the message will not lead to any problem 23 Personalised SMPP Client Address Book The address book feature allows you to store and manage your contacts You can create Groups and Distribution Lists here In a group you can store contacts whereas in distribution lists you can store numbers A contact is a name number pair for e g John 919829123456 etc A number is just a destination number and would allow you to store the name for the number This section guides you in creating Groups and Distribution lists It would also guide you in creating managing and deleting contacts and numbers within them Select Group Select Contacts Number Delete Edit T Create Group g Edit Group Distribution Lists Select All O E Add Contact Add List x Delete Contact Edit List Upload Contacts Note Follow below rules before saving the numbers 1 Length of number never less than 6 digit 2 Length of number never exceed than 18 digit 3 Number never contains characters 24 Personalised SMPP Client Groups Select the address book tab from within the main panel To create a group click Create Group and you will see a dialog such as this Cr
17. ns mobile at the same time Please note that Personalised messages for normal English text can be sent in text or flash message but for other language other than English can be sent in Unicode and Unicode Flash To send personalised message you must select CSV Comma delimited file which contains the destinations and tag names Once the file is selected you can see the tag names are displayed into the tag list of personalized panel as shown below SendSMS addressBook Delivery Reports Unicode Converter Credit Details Proxy Settings Help SBuk one Save Message Import Message Template Schedule SMS Once the file is selected all the tag names will be populated and displayed in the 16 Personalised SMPP Client personalised panel which can be selected and inserted into the message where ever the tag value is to replaced against the tag name while sending the message to their corresponding destination except the first column header since it is the destination column and will not be used as tag name Important points for creating a CSV Comma delimited file for A Containing Normal English text message type Text or Flash For example to send the message like Hi John Your account number is 1234 to one destination and the second message like Hi Jack Your account number is 1235 to another destination For this you need to i Open an excel sheet The first row of the sheet will be the c
18. ntacts table You can opt here to deselect a few contacts from the message recipient group if you want to do so By default all contacts in the selected group will be selected Fill in the required parameters and click Connect to send the message The progress of the messages sent can be seen in the Progress Bar next to the Clear Message option When sending to a distribution list you cannot see the numbers that exist in the distribution list nor can you have the option of sending the messages to a subset of those numbers This is because distribution lists are typically used for business purposes where a message is broadcasted to all numbers 33 Personalised SMPP Client Delivery Reports DLR Delivery Reports specify the details of a sent message You receive these from the SMSC SMPP server that you sent the message to Delivery Reports specify details such as the delivery status source address or sender destination address or mobile number submit date the date time that the message was submitted to the SMSC done date the date time that the message was forwarded by the SMSC SMPP Server any error flags if required etc You need to select the day month year for view the delivery report of that particular day To receive delivery reports move to the Delivery Reports panel You see delivery report of current date and able to see the delivery report of the date month year that you will select Export DLR button will export the
19. olumn headers or tag names 1 Microsoft Excel Book File Edit Wiew Insert Format Tools Data Window Help lar db KD Taho A ka ix A E C E F E 1 Destination H This column is for n 2 47qo00000000 destinations to which 7 3 91922200102 the message is All the mobile numbers must be formatted to number with O decimal places as it is done below 17 Personalised SMPP Client Destination Format Cells EJES 97000000001 213222001021 Mumber Alignment Font Border Patterns Protection Category Sample 81000000001 General a Number Currency Decimal places bp Accounting Date Time Use 1000 Separator 1 Percentage Fraction Scientific Text 15 Special 1234 Custom 1234 Megative numbers Mumber is used for general display of numbers Currency and Accounting offer specialized formatting For monetary value Caneel EA Microsoft Excel Book File Edit View Insert Format Tools Data Window Help i A db 8 Tahc Comment 2 fre A B i D E F E 1 Destination Name E This is the first column header 2 47900000000 John aor tag name that will be used in 4 94999900102 Jack Athe message any time you wish to use these column s values A rd il T 18 Personalised SMPP Client EA Microsoft Excel Book File Edit wiew Insert Format Tools Data Window Help j Al db Kk gt Tahoma Comment 3 fe A
20. ontact list for the selected group in the Select Contacts table for duplication of previous entries Following numbers have problems 5478951548 At Line Ho 3 457895604158 At Line Ho 5 Please Remove Invalid Entry 29 Personalised SMPP Client If you have already created a file with contacts you can copy paste your entries from that file to the upload contacts list by using Copy Ctri C and Paste Ctrl V All the entries that were added to the selected group will be reflected in the contact box Select Contacts Delete Edit 234000000001 DO Io we asza O O crs fanm O O Deleting Contacts You can delete previously added contacts from a group To do this make use of the third column in the contacts table In this column titled delete select the contacts that you want to delete if you want to delete just a few contacts or check the Select All check box to select all the contacts at once and delete them Once you have selected the contacts to be deleted Click Delete Contacts The changed group will be reflected immediately If you want to delete all contacts and also do not want to keep the group you can simply delete the entire group by clicking Delete Group select Contacts Humber Delete Edit 234000000001 DO 10 Chris SALAJA AL EI tee asz O O le This example shows deleting of a selected contact We have selected a contact here We delete that particular contact by clicking Delete Contacts Se
21. ote 1 2 3 4 E Destinations txt Notepad E File Edit Format View Help 9898066632 9898066633 98980666 34 9898066635 9898066636 9898066637 9898066635 9898066639 9898066640 9898066641 9898066642 g898066643 9898066644 9898066645 9898066Bbdb 9898066647 9898066648 9898066649 9898066650 9898066651 9898066652 9898066653 9898066654 9898066655 9898066656 9898066657 Add one destination in each line Destination must be numeric Destination never contain characters Destination never less than 6 digit and greater the 18 digit 14 Personalised SMPP Client SendSMS AddressBook Delivery Reports Unicode Converter Credit Details Proxy Settings Help File s Address files Destinations tt Sender ID update v Personalised Test for bulk upload Message Type Text Save Message Import Message Template Upload amp Send If the file does not uploaded successfully you will get an error message dialog File Upload X Error occured during a file operation Cannot upload the File now Please try again later File Upload l The file was uploaded successfully NOTE If you don t have sufficient Credit balance then you cannot upload the file on server 15 Personalised SMPP Client Personalised Message Personalised Message allows you to send message with some of the contents in the message to be different for different destinatio
22. t thoroughly tested on such systems Also User Interface generated on such systems might be inappropriate No Support or help would be available for running the application on such systems Also no guarantees and assurances about the proper working of the application on these systems would be offered Runtime Environment The application would require Java Runtime Environment 1 6 0 to be installed on your system But incase you don t have this software installed on your system or have a lower version of it the application will download and install the software for you Note For download and installation you would require an active network connection Personalised SMPP Client Installation After downloading the application executable exe file double click it to start the installation Once the installation begins you just need to enter appropriate inputs as the installation proceeds After the installation has successfully completed it will show you a dialog about successful installation of the software and would ask you whether you like to launch the application immediately Tick the check box named Launch the application if you intend to use it right away or if you want to use it at a later time you can uncheck the check box Personalised SMPP Client Post Installation The installer will register short cuts in three places on your desktop 1 Under the Programs Menu 2 Top of Start Menu 3 On your Desktop You c
23. the different features of the application On the main panel you can see various tabs allowing you access to those features of the application The current selection or the default tab is for send messages Personalised SMPP Client SendSMS Panel Here you can select whether to send a single Bulk or a Group Message To send message through either of the message sending options click on the corresponding button and enter the parameters for that type of message You can cut and paste text in the message box Once you have written a message but you wish to send the message at any other time then you can save the message SendSMS AddressBook Delivery Reports Unicode Converter Credit Details Proxy Settings Help gt Group Import Message Template Personalised SMPP Client Single Message To send a single message click on the Single button and you can see the single options as below SendSMS AddressBook Delivery Reports Unicode Converter Credit Details Proxy Settings Help Save Message Import Message Template Enter the details for the message according to the guidelines as shown below Message Type Text gt Flash Unicode Unicode Flash This panel allows you to set the type of the message Set it to of your current message NOTE The sender ID should not be longer than 11 characters if the sender is alphanumeric

Personalised SMPP Client - Microsat Internet Technologies

Contents

Download Pdf Manuals

Related Search

Related Contents