Send SMS Service


You can link to this page to send an SMS message using the HTML Form Post protocol. The table below shows the fields you can include in your form. The fields marked with an asterisk (*) are mandatory.


Authentication
Username* Your Esendex username, for example joe.bloggs@test.com
Password* Your Esendex password, for example joe1234
Account* Your Esendex account reference, for example 441234567890
 
Message details
Originator The alias the message should appear to come from. Can be another phone number or up to 11 alpha numeric characters. For Evaluation accounts, this field must be set to the same value as your Esendex account reference.
Recipient* The mobile number to send the message to. To send to multiple recipients, separate their numbers with commas.
Body* The content of the message. 160 max characters for Text, 140 octets max for Binary and SmartMessaging, 70 octet pairs for Unicode messages.
Type The type of message (Text, Binary, SmartMessage, Unicode). The default is Text.
ValidityPeriod The validity period of the message in hours. The default is zero, meaning the message never expires.
 
Other information
SuccessPage The URL to redirect to if the message is submitted successfully. If you omit this field, an XML response is returned.
FailurePage The URL to redirect to if an error occurs when submitting the message. If you omit this field, an XML response containing the message ID is returned.
Test Specify a value for the Test field to have this page redisplayed with the values submitted by your form. This is for test purposes only, and no SMS message will be sent.
PlainText

Specify a value for this field to return plain text results instead of a formatted HTML page.

For a successful request, results are in the format:

Result=OK

MessageIDs=value

where MessageIDs value is the ID that Esendex assigned to the message. You can use this value to query the status of the message using the Query Status service. If a message is sent to multiple recipients, multiple IDs are returned; each seperated by a comma.

For an unsuccessful request, results are in the format:

Result=Error

Message=value

where Message value is a URL encoded description of the error.


Note: If any of the field names conflict with those in your existing HTML page, prefix them with Esendex, for example (EsendexUserName). 

The following examples are HTML pages you can use on your website: