Bulk SMS upload

Step 1

Log in to your Delacon account here, navigate to the Services menu and click Upload Bulk SMS.

Step 2

Preparing the CSV file

The CSV file used for bulk SMS uploads needs to be carefully prepared so it is in the correct format. An example of this is below, defining firstly the recipients number and secondly the content of the message.

0400000000,This is the first test message
+61411111111,This is the second test message

Recipient Number

-Only Australian mobile (04) phone numbers can be entered

-The number needs to be formatted in local format (04xxxxxxxx) or E.164 formatting (+614xxxxxxxx)

Message Content

-Maximum 160 characters (includes spaces and punctuation)

Please consider the following when creating the CSV file:

-When creating a CSV file using Microsoft Excel (or other spreadsheet software) the first zero of the number may be lost when the number is entered in the local format (eg 0400000000 becomes 400000000). This issue can be avoided by using E.164 formatting (eg +61400000000). If the local number format is used, the file should be reviewed in a text editor (eg Notepad, not Excel) before it is uploaded.

-The file should not contain any column header information, the first line should contain the first record to be uploaded

-The maximum file size is 2MB

Step 3

Under Service ID (CID) select the Delacon mobile service you wish to send the SMS messages from.

Step 4

Click to Choose File and select the prepared CSV file (see below for guidance on formatting) from your local PC, then click Upload.

Step 5

Once the file has been uploaded the processing status can be viewed by clicking on Current Status

Step 1

Download the postman program to your computer: https://www.postman.com/downloads/

Step 2

Click on New and then select HTTP Request in the pop-up window

Step 3

Complete the highlighted fields with the respective information: 

1. Select Post from the drop-down menu and add this URL: https://pla.delaconcorp.com/rest/api/bulksms/uploaddata

2. Click on the Headers tab and add "Auth" within the Key column. 

3. In the Value column, add your Delacon API key. Follow this guide for the steps on retrieving this API key from your Delacon portal. 

Step 4

1. Click on the Body tab and set the toggle to raw.

2. Add your messages into the text field in the format: 

Delacon Service ID, the recipient's telephone number, the message

eg. 65786,0415123456,Thank you for your call

Notes for formatting: 

Recipient Number

-Only Australian mobile (04) phone numbers can be entered

-The number needs to be formatted in local format (04xxxxxxxx) or E.164 formatting (+614xxxxxxxx)

Message Content

-Maximum 160 characters (includes spaces and punctuation)

Step 5

Click on Send.

Once Delacon receives a hit on the URL, we will receive the data, validate the API key and start a thread process to save these records in our database.
You will not need to wait and keep the postman program open.
On submission, the following data will be shown as a response in postman. Please note the Request ID assigned to your request. 

{
"reason": "Background execution started for processing records",
"uploadstatus": "SUCCESS",
"requestid": "22"
}

Step 6

With the request id (e.g - 22) you can check the status of your request in the Delacon portal under Services > Upload Bulk SMS. Alternatively, you can click on this direct link: https://pla.delaconcorp.com/siteui/services/uploadbulksms 

Step 1

Search for "cmd" in your Windows search bar and open the command prompt.

Step 2

Insert below Curl command and update the variable parameters with the information specific to your account (highlighted in orange). Text highlighted in purple indicate static parameters that don't change. 

Curl command:

curl -X POST -H "Content-Type: text/csv" -H "Auth: Your Delacon API Key" -d Delacon CID, Recipient Number, Message https://pla.delaconcorp.com/rest/api/bulksms/uploaddata

• To find your Delacon API key, please review this guide.
• For the Delacon Service ID review the linked guide.

Example: 

curl -X POST -H "Content-Type: text/csv" -H "Auth: 1614_+rS5A/r6gKJ6Zzlv9iqfWjBeIcS5xEbTfBt72PTdAcJIEP95jCJZ20LhdtE9YOlY" -d 113548,0412345678,"Test MSG" https://pla.delaconcorp.com/rest/api/bulksms/uploaddata