Batch Sender Web Interface¶
The basic Batch Sender web interface for businesses provides instant access to a proven platform for transmitting large volumes of text messages. With no software to install, the clean, fast online interface provides effortless batch creation and reporting.
- Store and edit SMS Batch Number Lists online
- Upload number lists delimited by new line, comma or tab
- Personalise your messages by Mail Merging up to 10 additional pieces of data from your original number list
- Choose from 160 character Plain Text 7 bit, 70 character Unicode (280 character UCS2 Hex) or 140 byte Binary 8 bit message formats
- Custom originator, 11 alphanumeric characters or 16 digits (route dependent)
- Schedule SMS batches up to 5 days in advance
- Assign a unique reference to each batch
- Pause and resume batches
- Load balancing across multiple routes (route dependent)
- Automatically seed batches with up to 4 test numbers at custom intervals
- Route test interface
- View completed batches online with delivery confirmations (route dependent) and export to CSV for offline analysis
You can send a message to a batch of numbers by logging into your batch sender account at batchsend.clxcommunications.com using the username and password for your batch sender service.
Sending a Batch¶
Once you have logged in, you can send a message to a batch of numbers in two ways; firstly, by uploading a CSV file containing a list of phone numbers or secondly by using the List Editor feature.
Upload Number File¶
This is useful if you are only sending to the set of numbers once. To upload a file click the “Browse” button and locate the file on your PC. This method allows you to specify merge fields to create customised messages for each recipient. If your upload file contains merge fields, be sure to check the “File contains merge fields” box.
If you plan to send to a list of numbers multiple times, an online list editor is available. This allows number files to be uploaded or copied and pasted into lists held inside your batch sender account for easy editing and the convenience of just selecting a list to send SMS to. The List Editor does support merge fields.
Once you have uploaded or selected your list of recipients, you can enter the “Sender ID” and message body. Select the type of message encoding you wish to use and then enter the message.
Next click “Preview Message” and you will be taken to a preview of the message along with other information about the batch like the number of recipients. From this page you can then enter a start and stop time for the batch to be sent.
When you are ready, click “Send”, to confirm the batch.
Upload File Format¶
To format a batch of numbers for upload, the numbers should be listed one per line, in either a plain text or CSV file, for example:
447973123456 447973123457 447973123458
The numbers should be in international format. That is:
Country Code + Exchange Code + Subscriber Number
For example, an international number might be: 44789735533
44 - Country Code 7897 - Exchange number (which identifies the mobile operator) 35533 - Subscriber number
The same format also applies to uploading a file to the List Editor.
If you have a list of recipients you would like to store to use later, open the “List Editor” page and go to the “Create New List” section
From here you can give a name to the list and then choose the file that you wish to upload. You can also select the delimiter which you would like to use for the file you are uploading. If you have not included the country prefix in your upload file, you can enter one to use; this will be added to the front of all the numbers in the list. Once uploaded, the list will be saved and will then be available from the List Editor page, under the heading “Batch Number Lists”.
If you do not have a file to upload and instead, wish to create a new list directly in the List Editor, you can use the native list creator, by manually entering in the numbers you wish to add to your list:
Your number list must include additional columns of data in order for these to be merged into your messages. The check box entitled “File contains merge fields:” must be selected.
To display a merge field in a message you use the placeholder #MM#. The column numbers start at #MM00#, which is the mobile number, subsequent columns are numbered in ascending order. For example, the message:
Hello #MM01# #MM02#, this is a test message. This message was sent to #MM00#.
For the above example, a CSV containing the following:
...would create these messages:
Hello Thomas Smith this is a test message. This message was sent to 447000000000. Hello John Brown this is a test message. This message was sent to 447000000001.
Examples of the merged fields can be viewed by using the ‘Preview Message’ button at the bottom of the screen.
Note: each mail merge field length will almost certainly be different for each recipient (depending on the data held for that recipient) and so the length of the message will vary and in some cases the amount of messages sent to each recipient will differ.
Results for your batches can be viewed from within the batch sender by clicking on the “Completed” option from the navigation bar at the top.
Here you will see a list of all the batches you have sent in descending date order. If a batch is not listed, then it may not have completed and will therefore appear on the “Pending” page. To view details about the batch, such as the text and message options, you can click on the reference. If you wish to view the progress/delivery report, you can either view the progress file, or download the CSV listed under the “Sent to” heading.
The different states are described below:
Batches are in the Pending state when they have been paused. A batch is paused if the automatic end time is reached, or if the batch could not complete fully due to some numbers failing. Alternatively, the user could have paused the batch. Once in this state, a batch can be resumed or canceled.
Waiting to send¶
A batch enters this state when it is about to be processed, either because the batch has just been uploaded, or it has had a delayed start time which has just passed, or it is being resumed by the user. In this state, a batch will be listed under the Pending Batches screen. This state should not last for more than a minute.
In this state, a batch is being processed and the SMS are being sent to the mobile numbers. Once all numbers have been processed and there have been no failures, the batch will be moved to the Completed state. If there have been some errors, the failed numbers will be moved to the end of the list and the batch will be moved to the Pending state. If a batch reaches its automatic end time it will be paused. The user can also pause the batch manually.
This is the final state that a batch enters after it is completed or if the user cancels it. Once in this state, a batch cannot be moved to any other state.
The Batch Sender automatically detects the type of originator you are sending to decide whether it is alphanumeric or if it is a number. In the case of a number, it will assume that any number that is shorter than 10 digits is a shortcode and does not require a + symbol in front of it. Additionally, any number beginning with a 0 will also not have a + placed in front of it as it is considered a national number.
Originator numbers that are longer than 9 digits and do not begin with a 0 will automatically have a + inserted at the beginning of the originator to make the originator replyable in International format when it is displayed on a mobile handset.
In addition to the above rules, it is possible to insert random digits into the originator by placing the special character combination $X in the Originator field when sending your batch. Each occurrence of $X will be replaced with 2 random digits. Therefore to achieve a 10 digit random number starting with 55, the following should be entered:
This may produce an originator such as:
Originators for France¶
If you are sending in France without an alphanumeric originator, please set the originator to ‘36500’. When the batch is sent out, this short code will be replaced by short codes from our range of shared French short codes.
Message Status Values¶
The below table lists all the possible delivery report status values that appear in the Completed Batches screen.
|1||Delivered||Message delivered to handset.|
|2||Buffered||Message buffered, usually because it failed first time and is now being retried.|
|3||Failed||The message failed to deliver, possibly invalid number or other error.|
|5||Expired||Message expired, could not be delivered within the validity period.|
|6||Rejected||Message rejected by SMSC, treat as Failed.|
|7||Error||SMSC error, message could not be processed this time.|
|11||Unknown||Unknown status, automatically generated if no status has been returned from the SMSC for a long time.|
|12||Unknown||Unknown status, SMSC returned a non standard status code.|