Page History

Email Subject: Field and Authentication - There are two ways we allow emails to be authenticated

• Username and password

Your API username and password must go in the email subject, separated by the '%' sign. If you get the username or password wrong, or you forget the %, no text message will be sent and you will not get a response from the email gateway.

joe%secret

• Domain Authentication

In this instance the subject field is ignored and the domain name from the email is used, this has to 
be a company based domain (not hotmail etc) and your mail server needs to configured correctly 
as we will reverse look up the domain to prevent unauthorised use.

Email To: Field

For basic use of the email gateway, the To: field is used to specify the mobile number to send the message to. The address is:

where '<mobile-number>' is replaced with the mobile number of the recipient. For example to send to the mobile number 07777123123, the address to put in the To: field is either:

07777123123@textmarketer.biz

or, the international format for a UK number.

447777123123@textmarketer.biz

Please note that you cannot put multiple numbers in the To: field, only one number per email. If you want to send a message to multiple recipients, please see Advanced Use. 

Email Body

The content of your email is the message you wish to send to the recipient. Your message can be on more than one line, by default it must end with two #.

Everything in your email up to the ## will be sent to the recipient, so be careful how much you write. Remember that a normal text message is only 160 characters.

Please call 02012345678 to book your next car service.##

Please call 02012345678 to book your next car service

How much is 160 characters?

The multi-line example is exactly 160 characters

Hi George,
I thought you might like a reminder of our meeting tomorrow at 2pm.
Looking forward to discussing the project & planning the next step.
Regards,
John##
--
Widgets Ltd.
02012345678

So everything up to the ## is sent in the message, and the rest is discarded. This means that if your email software automatically includes a signature at the end of your email, it will not be sent to the recipient.

Hi George,
I thought you might like a reminder of our meeting tomorrow at 2pm.
Looking forward to discussing the project & planning the next step.
Regards,
John

Long messages

What happens when your message exceeds 160 characters?

If you exceed 160 characters you automatically invoke 'concatenation sending'. This will mean that each message consists of 153-character ‘chunks’, i.e. no longer 160 characters. The extra characters are used to 'glue' the messages together. So a message that is 307 characters long will actually require 3 text messages to send (153 characters + 153 characters + 1 character). Although it will appear as one long text message to the recipient, it will use 3 credits to send.

The originator/sender

The originator of the message is what is displayed to the recipient as 'the sender'. This can be text (up to 11 characters) or a mobile number (up to 16 digits), . For example, you might want the originator to be “Hair Salon”. Or you might want it set to Joe's mobile number, so that people who reply to the message will send it directly to Joe's mobile.

The originator is set by including a line in the email body that ends with a '#', e.g.: Hair Salon#

You'll notice that the originator ends with one '#', whereas the message ends with a double '##'. It doesn't matter whether the message comes first, or the originator comes first, so long as the ending is correct. As shown in the examples 1 and 2.

Will both work, and will mean  the recipient see's the sender as "Hair Salon". 

If you do not set an originator in the email body, the default originator on your acount will be used.