Get Latest Inbox Messages Service


You can link to this page to retrieve messages from your Esendex inbox 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
LastMessageID If this is blank the latest number of messages (defined by MaxMessages), will be returned. Specify a Message ID to retrieve the messages that were received after it
MaxMessages* The Maximum number of messages to retrieve
 
Other information
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

ID=value&Originator=value&Recipient=value&Body=value&ReceivedAt=value&Type=value&IndexID=value

where

ID is the identifier assigned to the message by Esendex.

Originator is the mobile number of the message sender.

Recipient is the recipient of the message (your virtual mobile number).

Body is the message content.

Type is the type of content contained in Body. This can be Text, Binary, SmartMessage or Unicode.

ReceivedAt is the time Esendex took delivery of the message.

IndexId is the ID of the index of the message in the inbox.

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 example is an HTML page you can use on your website: