|
SMS to email
Received SMS messages delivered to you by email
With the It's Arrived 2 way service your customers can send SMS text messages to the It's Arrived servers and the messages will then be immediately forwarded to you. We can deliver their messages to you in several ways including email, XML or to an URL. This page describes the SMS to email service.
You can design the email message that is sent to you and specify the address that it is sent to. If you wish, we can send the incoming messages to different email addresses dependent on the first word in the incoming message.
The email delivery system is simple to use and quick to setup.
At the moment we will configure the SMS to email system for you but shortly you will be able to configure it yourself on the website.
What can be configured?
- Keywords that are matched against the first word in the incoming SMS message
- The To: address that the SMS message is to be delivered to
- The Cc: address that the SMS message is to be copied to
- The Subject: line of the email
- The body of the email message
- The Reply-To: line of the email
- The From: line of the email
What can be placed in each of the above fields?
When each SMS message arrives the following information in automatically stored in the placeholders indicated
| Placeholder | Information |
|---|---|
| <CSOFT_FROM> | The number of the mobile phone that sent the message |
| <CSOFT_TO> | The number that the message was sent to |
| <CSOFT_MESSAGE> | The text message that was sent |
| <CSOFT_TIMESTAMP> | The date and time the message was received. format is YYYY-MM-DD hh:mm:ss |
| <CSOFT_GIVENNAME> <CSOFT_FAMILYNAME> <CSOFT_GROUP> |
If the <CSOFT_FROM> number matches a number in your address book then these tags are replaced with the corresponding entries for that number in the address book. If there is no match, they are replaced by a blank. |
You can also use <CSOFT_NEWLINE> or \n to indicate a new line where appropriate.
When you design the layout and contents of your email you can use the above placeholders to specify what information appears and where it should appear.
Where can the various placeholders be placed?
You can place any of the placeholders
- <CSOFT_FROM>
- <CSOFT_TO>
- <CSOFT_MESSAGE>
- <CSOFT_TIMESTAMP>
- <CSOFT_GIVENNAME>
- <CSOFT_FAMILYNAME>
- <CSOFT_GROUP>
up to 5 times in any of the fields
- email_to (maximum of 100 characters)
- email_cc (maximum of 100 characters)
- email_subject (maximum of 50 characters)
- email_body (maximum of 255 characters)
- email_signature (maximum of 255 characters)
- email_from (maximum of 100 characters). The default value is dumb_robot(at)csoft.co.uk.
- email_replyto (maximum 100 characters). The default value is dumb_robot(at)csoft.co.uk
and <CSOFT_NEWLINE> up to 10 times in the the email_body and email_signature fields.
Designing your emails
Here are the fields that you need to specify in order to design your email.
| Field | Description | Example value |
|---|---|---|
| email_to | The email address that the SMS message is to be delivered to | someone@somewhere2go.com |
| email_cc | The email address that the SMS message is to be copied to | another@somewhere4u.com |
| email_subject | The subject line of the email | SMS message from $$$<CSOFT_FROM>$$$ |
| email_body | The body of the email | Message was: [<CSOFT_MESSAGE>] <CSOFT_NEWLINE> |
| email_signature | This text is appended to the body of every email | ***END*** |
The above might produce the following email if an SMS message "Please call the office" was received
To: someone@somewhere2go.com
Cc: another@somewhere4u.com
From: support(at)csoft.co.uk
Subject: SMS message from $$$447700912345$$$
Date: Wed, 17 Apr 2002 15:13:54 +0100
Message was: [Please call the office]
***END***
Another example
| Field | Description | Example value |
|---|---|---|
| email_to | The email address that the SMS message is to be delivered to | abc@def.com |
| email_cc | The email address that the SMS message is to be copied to | ghi@jkl.com |
| email_subject | The subject line of the email | <CSOFT_FROM> |
| email_body | The body of the email | <CSOFT_FROM>, <CSOFT_TO>, "<CSOFT_MESSAGE>", "<CSOFT_TIMESTAMP>"<CSOFT_NEWLINE> |
| email_signature | This text is appended to the body of every email | # Do not reply<CSOFT_NEWLINE># to this message<CSOFT_NEWLINE># |
The above might produce the following email
To: abc@def.com
Cc: ghi@jkl.com
From: support(at)csoft.co.uk
Subject: 447700912345
Date: Wed, 17 Apr 2002 15:13:54 +0100
447700912345,447700954321,"test message","2002-04-18
10:41:32 GMT"
# Do not reply
# to this message
#