Customers

Policies

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 in UTC when the message was received. The format is
YYYY-mm-dd HH:MM:SS, i.e. 2017-13-07 12:23:52

[CSOFT_TIMESTAMP_LOCAL]

The date and time in your local timezone when the message was received. The format is
aaa, dd bbb YYYY HH:MM:SS ZZZ, i.e. Thu, 13 Jul 2017 23:34:44 CST

[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