Send Advanced SMS Service
You can link to this page to send an advanced 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 EX0000000 | |
| 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* | Encoding depends on the values of the esmClass and dataCodingScheme. If binary data required, supply a hex encoded string, otherwise up to 160 characters of text. Max length of binary data is 140 bytes (or 280 Hex encoded characters). | |
| ValidityPeriod | The validity period of the message in hours. The default is zero, meaning the message never expires. | |
| ESMClass* | A number representing the value of the ESM Class PDU parameter. | |
| DataCodingScheme* | A number representing the value of the DCS PDU parameter. | |
| 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: