Bulk SMS API - SMS to email

With a Connection Software Two-way SMS service your customers can send SMS text messages to your Virtal Mobile Number, Short Code Number or Hosted SIM number and the messages will be immediately forwarded to you by email (SMTP).

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 (keyword) of the incoming message.

The email configuration is simple and straightforward. You can configure this yourself in the Two-Way SMS Configuration section of your account, or contact us and request support if you would like us to configure the service for you.

Configuration

The following items can be configured to receive SMS messages by email.

  • 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

Placeholders

When we forward an SMS, the following information is 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. The 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.
[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. The 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 use any of these placeholders up to 5 times in the following fields:

Field Maximum size Default value
email_to 100 characters
email_cc 100 characters
email_subject 50 characters
email_body 255 characters
email_signature 255 characters
email_from 100 characters dumb_robot(at)csoft.co.uk
email_replyto 100 characters dumb_robot(at)csoft.co.uk
  • email_to (100 characters)
  • email_cc (100 characters)
  • email_subject (50 characters)
  • email_body (255 characters)
  • email_signature (255 characters)
  • email_from (100 characters)
  • Default: dumb_robot(at)csoft.co.uk
  • email_replyto (100 characters)
  • Default: dumb_robot(at)csoft.co.uk

You can also use [CSOFT_NEWLINE] or \n to indicate a new line where appropriate. You can use this placeholder up to 10 times in the the email_body and email_signature fields.

Examples

Specifying the following fields:

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***

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***

would result in the following email when an SMS message "Please call the office" was received

SMS text messages to Email - example 1

As another example, specifying the following fields:

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]#

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]#

might produce the following email

SMS text messages to Email - example 2

The [CSOFT_TIMESTAMP] will always be in the format shown above.