Monday, December 29, 2008

Send SMS Service with esendex (for United Kingdom)

For messaging in UK, I have used the service by Esendex, which too uses the SOAP protocol. I am hereby listing the code to send the text message with Esendex in UK. 

Here is the list of the variables to be sent and links for testing
Version:1.0 StartHTML:0000000168 EndHTML:0000005362 StartFragment:0000000520 EndFragment:0000005345

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.

1 comment:

kevin Peter said...
This comment has been removed by the author.