SMTP Introduction

Minimal programming is necessary for use of our SMTP API Interface allowing the user to send messages programmatically.

Email to SMS Gateway

With our Email to SMS gateway, you can effortlessly send text messages from any email client; such as Microsoft Outlook/Outlook Express , Lotus Notes, Eudora, Elm, Pine, Unix Mail.

Current Uses Include:

No plugins or installation is required. Simply use the software you already have on your computer. You simply send an email to mobile@sms.worldtext.com

If combined with our service the Email to SMS gateway becomes a bi-directionalservice allowing two-way communication between email and mobile phone.

Using From Windows to Mac

Once setup, using the service could not be easier. From your favourite email client simply select create a new message.

On Microsoft Outlook, this is achieved by:

Using From Linux/Unix

UNIX offers very powerful scripting features making it very simple to send a message manually or more usefully, automatically to the SMS gateway.

SMTP Interface From Linux/Unix Command Line Example:

echo "My test message from UNIX" | mail 44777111222@sms.world-text.com -s "Test Subject"
                            

If you require any further help then we have UNIX experts available who can provide consultancy to help develop your own scripts/programs in almost all well know languages including; bourne-shell, C, C++, Perl, PHP, and Python.

Using From a Web Page/PHP

If you want to send messages from your own web page, then this can be achieved simply in PHP by using the built in mail command.

SMTP Interface With PHP Example:

                        function sendSMS($mobile, $from, $message)
                        {
                        mail("$mobile@sms.world-text.com", "", "$message", "From:$from");
                        }
                        sendSMS("44777111222", "user@domain.com", "Hello this is a PHP SMS Test from World-Text using the SMTP Interface");
                            

SMTP Bulk Interface Introduction

The SMTP Bulk API allows users to send SMS messages with dynamic message content to multiple recipients with a single email. It can also be used for static content.

Email can be sent from any email client that support plain text formatting, this includes, but is not limited to:

There is no limit to the number of recipients that can be specified in the bulk email.

Multi-part (concatenated) messages are supported up to a maximum of 9 parts.

Accessing the Interface

Access to the interface is provided through SMTP (Email), the user composes an email containing specific tags that identify instructions to the interface.

Tags

Format

The format of a tag and it"s associated value is as follows:

Each tag should be placed in the body text of the email on a new line, there should be no white space before or after the tag.

Values

The following table lists all the valid tags, tags in italics are optional:

Text Tag

The text tag specifies the content that is to be delivered to the mobile handset, the formatting of the value allows the user to specify multiple fields that should be populated using the values provided in the Recipient Tag (documented below).

The message text should be written as the user would expect to read it on the mobile handset, when a dynamic field is required the character pair " %s " should be inserted into the text, each occurence of " %s " is replaced by the relevant fields in the Recipient Tag.

It is the senders responsibility to ensure that the entire message text, including expanded fields, does not exceed 160 characters. If it does, the message(s) will be truncated before it/they are sent.

The above example shows a text message with two dynamic fields that will be replaced.

Recipient Tag

The recipient tag specifies the mobile number of the recipient as well as any dynamic fields that are required to fully populate the message text as specified in the Text Tag, it is the users responsibility to ensure that the correct number of fields are specified.

The only required field for the Recipient Tag is the mobile number, this should always be specified as the first field. If additional fields are required then they should be separated by a "|" (pipe) character.

The recipient tag can be specified as many times as is required for multiple recipients.

Formatting Tags

Currently supported format tags are:

Line break: %n

Using the line break format tag will in effect provide a carriage return in the message body.

Email Format

See the following section on Tags for a full description of the body content that is required.

Example Bulk Email

Complex Example

The following example sends to 3 recipients and the message text contianes 2 dynamic fields:

Simple Email

This email should be sent in Plain Text format only.