When the SMS channel is configured as per C.3 SMS Channel Configuration purposes of discussion, let us assume that the host name sms.siroe.com is a host name associated with the channel. In that case, email is directed to the channel with an address of the form:
local-part@sms.siroe.com
in which local-part is either the SMS destination address (for example, a wireless phone number, pager ID, etc.) or an attribute-value pair list in the format:
/attribute1=value1/attribute2=value2/.../@sms.siroe.com
The recognized attribute names and their usages are given in Table C–1. These attributes allow for per-recipient control over some channel options.
Table C–1 SMS Attributes
Attribute Name |
Attribute Value and Usage |
---|---|
ID |
SMS destination address (for example, wireless phone number, pager ID, etc.) to direct the SMS message to. This attribute and associated value must be present. |
FROM |
SMS source address. Ignored when option USE_HEADER_FROM=0. |
FROM_NPI |
Use the specified NPI value. Ignored when option USE_HEADER_FROM=0. |
FROM_TON |
Use the specified TON value. Ignored when option USE_HEADER_FROM=0. |
MAXLEN |
The maximum, total bytes (that is, eight bit bytes) to place into the generated SMS message or messages for this recipient. The lower value of either MAXLEN and the value specified by the MAX_MESSAGE_SIZE channel option is used. |
MAXPAGES |
The maximum number of SMS messages to split the email message into for this recipient. The lower value of either MAXPAGES and the value specified by the MAX_PAGES_PER_MESSAGE channel option is used. |
NPI |
Specify a Numeric Plan Indicator (NPI) value for the destination SMS address specified with the ID attribute. See the description of the DEFAULT_DESTINATION_NPI channel option for information on the accepted values for this attribute. When this attribute is used, its value overrides the value given by the DEFAULT_DESTINATION_NPI channel option. |
PAGELEN |
Maximum number of bytes to place into a single SMS message for this recipient. The minimum of this value and that specified with the MAX_PAGE_SIZE channel option is used. |
TO |
Synonym for ID. |
TO_NPI |
Synonym for NPI. |
TO_TON |
Synonym for TON. |
TON |
Specify a Type of Number (TON) value for the destination SMS address given with the ID attribute. See the description of the DEFAULT_DESTINATION_TON channel option for information on the accepted values for this attribute. When this attribute is used, its value overrides the value given by the DEFAULT_DESTINATION_TON channel option. |
Some example addresses:
123456@sms.siroe.com /id=123456/@sms.siroe.com /id=123456/maxlen=100/@sms.siroe.com /id=123456/maxpages=1/@sms.siroe.com |
For information on performing translations, validity checks, and other operations on the SMS destination address portion of the email address, see C.2.4 Site-defined Address Validity Checks and Translations