SMTP interface is NOT intended for Bulk sending. This is a low throughput interface intended for use with single low volume messaging.
Please refer to XML API for High volume Bulk sending.
Interfaces of the PSWinCom SMS Gateway. The Gateway supports
three main ways of using SMTP to submit SMS messages:
- Routed mail interface
- Simple mail interface
- XML mail interface
All three ways are described in detail in this document.
Mail (SMTP) is the preferred interface when the client is behind a
firewall or without a direct connection to internet. As long as a mail
system is present and operative, it is possible to submit messages to
the SMS Gateway without installing any additional software or
modifications of firewall settings.
Gateway connect information
Below is a matrix showing how the three mail-interfaces works
according to various functional requirements you or your software may
|Support for binary messages
|Specify sender-Id for each message
|No set-up on the account web
|Username/password not needed to
||Depends on settings
for Simple mail
|Suitable for email to SMS forwarding
Routed mail interface
The routed mail interface is a very simple way of sending SMS
messages from any mail software.
When SMTP is enabled on your account, you must enable the mailaddresses
you will allow to send messages. This can be done by
logging onto the account web: http://www.pswin.com
. On the menu,
select the “Mail Settings” link.
You can specify any number of email-addresses and/or mail-domains
that are trusted to send SMS messages using your account.Note:
Do not allow sending from any more addresses and/or domains
than you strictly need. If you’re using a public available ISP such as
hotmail.com, yahoo.com and others, you should only allow sending
from particular addresses and not the whole domain.
Sender-Id can be a number or a text of up to 11 characters (no special
characters allowed). The sender-Id should be a valid international
number (without the “+”plus prefix) if you like the receiver to be able
to reply directly.
A Default Prefix can be specified if you would like the SMS Gateway to
always add your country-code to the receiver number. Normally you
should set this to the country-code of your own country. The default
prefix can be overridden by simply sending to a fully prefixed
international number. For example: +email@example.com
override a default prefix of “46”. The “+” (plus) sign is in this case
For security reasons, your account can be set up with a fixed mail
address that will receive notification of each message processed by the
SMS Gateway. This feature can be used to keep track of the SMS
Receivers and group messages¶
When your account is properly set up to allow messages from your
email address, you can start sending messages. Start with creating a
new email. In the to-field, enter the receiver address as follows:
You can specify any number of SMS-addresses or a mixture of
ordinary and SMS-addresses. You can also use the CC and BCC fields
to specify receivers just as with ordinary email. You can also send to
groups by creating distribution lists in your mail software and put the
SMS-addresses into the list.
Put your message in the subject field and/or message body. The
message will contain subject and beginning of message body up to
160 characters in total.
A sample screenshot:
Delivery and receipt¶
When you send the mail-message, it will be processed immediately
upon reception of the Gateway. After processing, the message will be
delivered on your phone within seconds.
If the sender would like to receive a receipt, one can choose the
“Request Read Receipt” or similar option in the mail-software to
request a receipt. The receipt will state the receiver, the message sent
and a status of whether the message was successfully sent or not.
Please note that this is not a handset-status but a confirmation that
the message has been processed, verified and delivered to the SMS
Simple mail interface
By using this interface it is possible to send plain text SMS to one or a
few receivers by submitting a simple mail message to the PSWinCom
SMS Gateway. There are no extended options or features.
The receiver number is placed as the Subject of the message. Must be
specified including the international prefix, but without any leading “+”
or “00”. At least 9 digits. Several numbers can be specified, separated
with a single space character.
The username and password of the PSWinCom SMS Gateway account
must be placed at the beginning of the mail body, separated with a
single space character. Optionally
, the credentials may be stored on
the mail server and authentication can be done based on the sender email
address. Please contact firstname.lastname@example.org
for the latter
The actual SMS message is placed after the username and password,
either after a space character or after a line break.
A sample screenshot:
- 1) Only the 10 first lines of the mail will actually be handled.
- 2) Blank lines will be ignored.
- 3) All line breaks will be converted to single spaces.
- 4) A signature below a line like “—“ will be ignored.
- 5) The message will be truncated to max 160 characters.
- 6) Send the message to email@example.com
- 7) No receipt/confirmation mail will be returned.
Simple mail interface alternate method
This is an alternate method that allows you to specify the receivers in the body of the email.
To specify a receivernumber, use the parameter "PSW_RECEIVERS=".
You can use a single number, or a custom variable from your system (e.g. %MobileNumber%). Send to:
Any numeric value of at least 8 digits. The subject field will get overwritten if 'PSW_RECEIVERS' exists in the email body.
SMS Text here
XML based mail interface
The XML based mail interface is intended for automated use from
within applications and not for direct use from your mail-client. This is
due to that the message body is an XML document containing detailed
and specific information about the message(s) to send. The XML
document must be valid and formatted according to the specifications
given in the XML Interface documentation
Using this XML-based interface you have full control of the messagedata
you send, and it allows you to submit binary messages such as
ringtones and logos as well.
Consider the following XML document containing two text message:
<!DOCTYPE SESSION SYSTEM "pswincom_submit.dtd">
To send these two messages using the XML mail interface, simply
create a new mail and insert the above XML into the mail body.
Remember to replace username/password and receivernumber with
suitable values. Send the mail to firstname.lastname@example.org
and it will be parsed
and consumed by the SMS Gateway.
Please refer to the XML Interface documentation
to see all fields allowed in the XML sent to this interface.
A sample screenshot:
You do not need to fill out the Subject field, as it is not used for any
purpose when using the XML-based mail interface.
Please note that you will not receive any response back, regardless of
whether the message was successfully delivered or not.
See: Receive MO messages over SMTP