HTTP to SMS

Introduction

Subscribed users of iflow’s Message Centre service can submit their messages by HTTP POST across the Internet.

Prerequisites

The following conditions must be met to enable SMS delivery via email:

1. Existing Message Centre user account; the email address and mobile number in the user account will be used to authenticate the user and to specify a return address for the text message.
2. Sufficient account credit; messages will not be delivered if the account balance is zero at the time of delivery

Furthermore, usage of and access to iflow’s Message Centre service and systems is subject to our terms and conditions of service.

HTTP Service

In order to transmit delivery requests to iflow’s systems you need access to the Internet with the ability to send POST requests using HTTP.

The Message Centre SMS HTTP address is
http://www.iflow-tech.com/MessageCentre/sendsms_http.asp

Form Fields

The following is a list of fields that can be used in the form post with their meaning.

Authentication

The ID and PWD fields are required to authenticate the user before a message is sent. If multiple messages are being submitted in the same session then the ID and PWD fields are only required with the first message. This will authenticate the entire Internet session. Subsequent send requests of the same session will not need to be authenticated.

Originator

The originator address is taken from the ORIG field and must conform to the following format:

Entirely composed of up to 16 digits (0-9). In this case, the originator address will be treated as an international phone number and will appear on the recipient's phone prefixed with a "+".

Composed of up to 11 alphanumeric characters. The following character set is valid (Unicode characters are not allowed in originators):

@£$¥èéùìòçØøÅåßÉ!"#¤%&\'()*+./0123456789:;<=>?¡AB
CDEFGHIJKLMNOPQRSTUVWXYZÄÖÑܧ¿abcdefghijkl
Mnopqrstuvwxyzäöñüà

Mobile Number Formats

The TO field contains the mobile phone number that the message will be sent to. The phone number of the recipient must consist of 9-14 digits and must conform to the following format:

National Numbers

Short Format

Mobile operator code with leading zero + recipient’s handset number

E.g. 087 2203574

International Format

Two zeros indicating international + International Country Dialing code + Mobile operator code without leading zero + Recipient’s handset number

E.g. 00 353 87 2203574

Short International Format

International Country Dialing Code + Mobile operator code without leading zero + Recipient’s handset number

E.g. 353 87 2203574

International Numbers

International Format

Two zeros indicating international + International Country Dialing code + Mobile operator code without leading zero + Recipient’s handset number

E.g. 00 44 79 xxxxxxxx

Short International Format

International Country Dialing Code + Mobile operator code without leading zero + Recipient’s handset number

E.g. 44 79 xxxxxxxx

SMS Text Message

The text message can be a single message of up to 160 characters, a multi-part message of 320 or 480 characters or a flash message of 159 characters.

To send a single message of up to 160 characters populate the MSG field with the message. To send a flash message of up to 159 characters populate the MSG field with a / followed by the message. For example ‘/Hi there’

To send a multi-part message populate the MSG field with the message and the PARTS field with the number of 160 character blocks required. E.g. to send a message that is 170 characters long will require 2 parts of 160. i.e. PARTS=2. The account will be charged for 2 messages.

Any message of between 320 and 480 characters will require 3 parts.

Date and Time Fields

To queue a message for delivery at a specific date and time populate the DATE, HOUR and MINUTE fields.

The DATE field should contain the date the message is to be sent in the format DD/MM/YYYY.

The HOUR field should be in 24 hour format HH – 0-23.

The MINUTE  field should contain 0-59

Response Codes

If the RETURNURL field is empty then every POST request will respond with one of the following values

If the RETURNURL field is populated with a valid URL then every POST request will be redirected to that URL. If an error occurs the corresponding error value will be included in a field called ER.

Example

Here is a sample HTML form