The MTA SMS channel may be used with any SMPP V3.4 compatible SMPP server. For purposes of illustrating an example configuration, this section explains how to configure the SMS channel for use with a MobileWay SMPP server. MobileWay (http://www.mobileway.com/) is a leading provider of global data and SMS connectivity. By routing your SMS traffic through MobileWay, you can reach SMS subscribers on most of the major SMS networks throughout the world.
When requesting an SMPP account with MobileWay, you may be asked to answer the following questions:
IP address of your SMPP client: Supply the IP address of your Messaging Server system as seen by other domains on the Internet.
Default validity period: This is the SMS validity period which MobileWay will use should a validity period not be specified in the SMS messages you submit. SMS messages which cannot be delivered before this validity period expires will be discarded. Supply a reasonable value (for example, 2 days, 7 days, etc.).
Window size: This is the maximum number of SMS messages your SMPP client will submit before it will stop and wait for responses from the SMPP server before submitting any further SMS messages. You must supply a value of 1 message.
Timezone: Specify the timezone in which your Messaging Server system operates. The timezone should be specified as an offset from GMT.
Timeout: Not relevant to one-way SMS messaging.
IP address and TCP port for outbind requests: Not relevant for one-way SMS messaging.
After supplying MobileWay with the answers to the above questions, they will provide you with an SMPP account and information necessary to communicate with their SMPP servers. This information includes
Account Address: a.b.c.d:p Account Login: system-id Account Passwd: secret |
The Account Address field is the IP address, a.b.c.d, and TCP port number, P., of the MobileWay SMPP server you will be connecting to. Use these values for the SMPP_SERVER and SMPP_PORT channel options. The Account Login and Passwd are, respectively, the values to use for the ESME_SYSTEM_ID and ESME_PASSWORD channel options. Using this information, your channel’s option file should include
SMPP_SERVER=a.b.c.d SMPP_PORT=p ESME_SYSTEM_ID=system-id ESME_PASSWORD=secret |
Now, to interoperate with MobileWay you need to make two additional option settings
ESME_ADDRESS_TON=0x01 DEFAULT_DESTINATION_TON=0x01 |
The rewrite rule in the imta.cnf file can appear as
sms.your-domain $u@sms.your-domain
And, the channel definition in the imta.cnf file can appear as
sms_mobileway sms.your-domain |
Once the channel option file, rewrite rule, and channel definition are in place, a test message may be sent. MobileWay requires International addressing of the form
+<country-code><subscriber-number>
For instance, to send a test message to the North American subscriber with the subscriber number (800) 555-1212, you would address your email message to
+18005551212@sms.your-domain
To debug the channel, specify the master_debug channel keyword in the channel’s definition. For example,
sms_mway port 55555 threaddepth 20 \ backoff "pt2m" "pt5m" "pt10m" "pt30m" notices 1 master_debug |
With the master_debug channel keyword, basic diagnostic information about the channel’s operation will be output to the channel’s log file. For verbose diagnostic information about the SMPP transactions undertaken by the channel, also specify
DEBUG=-1
in the channel’s option file.