Receive MO messages over SMTP

Modified on Mon, 12 Jan 2015 15:55 by henrik — Categorized as: Uncategorized

You can receive mobile originated messages (MO) over e-mail (SMTP). Following is an example of an SMS sent over SMTP:

X-Sender: "4712345678" <4712345678@pswin.com>
X-Receiver: email@my.domain.com
X-PSWinCom-Receiver: 26112
X-PSWinCom-Sender: 4712345678
X-PSWinCom-Text: Hei
MIME-Version: 1.0
From: "4712345678" <4712345678@pswin.com>
To: email@my.domain.com
Date: 12 Jan 2015 15:22:23 +0100
Subject: PSWinCom SMS Gateway Incoming Message
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: quoted-printable

Receiver=3D26112=0D=0ASender=3D4712345678=0D=0AText=3DHei=0D=0A

For Content-Type the gateway will choose an appropriate encoding based on content. In most cases this is either us-ascii or UTF-8 when the message contains language specific characters (æ, ø, å etc). In this example the e-mail body translates into plain text:

Receiver=26112
Sender=4712345678
Text=Hei

As you see the SMS content is included both in headers and body.

Possible headers and body elements that are always sent are:

Header	Body element	Description
X-PSWinCom-Receiver	Receiver	The shortcode the message was sent to
X-PSWinCom-Sender	Sender	The phone number of the sender
X-PSWinCom-Text	Text	The text content of the message, this may be multiline in the body while line breaks are stripped in the header

Additional headers and body may be sent if these are enabled for the keyword/short code. These are:

Header	Body element	Description
X-PSWinCom-Address	Address	Semi colon separated name and address information for the sender. See ... for details. ^*
X-PSWinCom-Longitude	Longitude	The sender's longitude position ^**
X-PSWinCom-Latitude	Latitude	The sender's latitude position ^**
X-PSWinCom-Radius	Radius	The accuracy of the sender position, given in meters ^**
X-PSWinCom-Council	Council	The council of the sender position (in norwegian: kommune) ^**
X-PSWinCom-CouncilNumber	CouncilNumber	The council number of the sender position (in norwegian: kommunenummer) ^**
X-PSWinCom-Place	Place	City/town/area of the sender position ^**
X-PSWinCom-County	County	The county of the sender position (in norwegian: fylke) ^**
X-PSWinCom-Country	Country	Country of the sender position ^**
X-PSWinCom-SubPlace	SubPlace	In some cases a sub place is given to further describe the sender position ^**
X-PSWinCom-ZipCode	Country	ZipCode of the sender position (not always given) ^**
X-PSWinCom-City	City	City of the sender position (not always given, use Place if not) ^**
X-PSWinCom-TimeStamp	TimeStamp	The time when PSWinCom received MO from the operator ^***

^* Requires address lookup to be enabled, costs per MO may incur
^** Requires position lookup to be enabled, costs per MO may incur
^*** Requires timestamp to be enabled and is only available on selected short codes, ask support for more information