SMS 通道配置

本節將指導如何為單向 (電子郵件至行動電話) 與雙向 (電子郵件至行動電話與行動電話至電子郵件) 功能設定 SMS 通道。單向和雙向功能的 SMS 通道設定相同，除在主題為雙向 SMS 配置 SMS 通道中說明的例外。

本節包含以下主題：

• 新增 SMS 通道

• 建立 SMS 通道選項檔案

• 可用選項

• 新增額外的 SMS 通道

• 調整遞送重試的頻率

• 範例單向配置 (MobileWay)

• 為雙向 SMS 配置 SMS 通道

新增 SMS 通道

增加 SMS 通道至 Messaging Server 配置需要兩個步驟︰

1. 新增通道定義與重寫規則。

2. 建立 SMS 通道選項檔案。

由於沒有在所有狀況下都必須設定的通道選項，因此您可能只需設定一個或多個以下選項即可：ESME_PASSWORD、ESME_SYSTEM_ID、MAX_PAGE_SIZE、DEFAULT_SOURCE_TON和DEFAULT_DESTINATION_TON。而且，如上所述，SMPP 伺服器的主機名稱或 IP 位址以及 TCP 連接埠必須透過 imta.cnf 檔案或通道選項檔案中的通道定義進行設定。

您可以配置多個 SMS 通道，並為不同的 SMS 通道指定不同的特徵。請參閱新增額外的 SMS 通道，以取得有關使用多個 SMS 通道的進一步資訊。

請注意以下說明︰如果變更 imta.cnf 檔案，則必須重新編譯。如果僅變更通道選項檔案，則無需重新編譯。

另請注意，通道變更不同，其生效之前的等待時間也會有所不同。許多通道選項變更都在變更後於所有啟動的通道中生效，看起來似乎是即刻生效，這是因為 Job Controller 經常在啟動新的通道。某些變更要在您重新編譯並重新啟動 SMTP 伺服器後才會生效。處理這些選項是在郵件於通道中形成佇列時，而非通道本身執行時。

新增通道定義與重寫規則

若要新增通道定義與重寫規則，請執行以下步驟：

增加通道定義和重寫規則

步驟

1. 在增加 SMS 通道至 MTA 配置之前，需要為通道選取一個名稱。通道名稱可以是 sms 或 sms_x (其中 x 是長度在一到三十六個位元組之間的任何字串，且不區分大小寫)。例如，sms_mway。

2. 若要增加通道定義，請編輯 imta.cnf 檔案 (位於 installation-directory/config/ 目錄中)。在此檔案結尾處新增一個空行，其後再加入以下兩行：

   channel-name port p threaddepth t \ 
     backoff pt2m pt5m pt10m pt30m notices 1
   smpp-host-name
   

   其中 channel-name 是您為通道選擇的名稱，p 是 SMPP 伺服器偵聽的 TCP 連接埠，t 是每個傳送程序中同時執行的 SMPP 伺服器連線最大數目，而 smpp-host-name 則是執行 SMPP 伺服器的系統主機名稱。

   例如，您可指定以下通道定義：

   sms_mway port 55555 threaddepth 20 \ backoff pt2m pt5m pt10m pt30m notices 1 smpp.siroe.com

   如需有關如何計算 threaddepth 的說明，請參閱控制同時連線的數量

   請參閱調整遞送重試的頻率，以取得 backoff 和 notices 通道關鍵字的論述。

   如果您想為 smpp-host-name 指定 IP 位址而非主機名稱，請指定網域文字。例如，如果 IP 位址為 127.0.0.1，則為 smpp-host-name 指定 [127.0.0.1]。也可考量使用SMPP_SERVER通道選項。

   ---

   備註 –

   對於 Sun Java System Messaging Server 6.1，已停用 master 通道關鍵字。即使存在也會被忽略。

   ---

3. 新增通道定義後，請至檔案上半部分，然後依以下格式新增重寫規則：

   smpp-host-name $u@smpp-host-name

   例如，

   smpp.siroe.com $u@smpp.siroe.com

4. 儲存 imta.cnf 檔案。

5. 使用 imsimta cnbuild 指令重新編譯此配置。

6. 使用 imsimta restart dispatcher 指令重新啟動 SMTP 伺服器。

7. 透過上述配置，電子郵件會被定址至 id@smpp-host-name (例如，123456@smpp.siroe.com)，從而導向該通道。請參閱電子郵件至 SMS 轉換程序，以取得有關定址的進一步資訊。

8. 或者，如果您想對使用者隱藏 SMPP 伺服器的主機名稱，或想將同一通道與其他主機名稱關聯，請增加額外的重寫規則。例如，若要將此通道與 host-name-1 和 host-name-2 關聯，增加以下重寫規則：

   host-name-1 $U%host-name-1@smpp-host-name host-name-2 $U%host-name-2@smpp-host-name

   例如，如果 SMPP 伺服器的主機名稱為 smpp.siroe.com，但您希望使用者將電子郵件傳送至 id@sms.sesta.com，則可增加重寫規則：

   sms.sesta.com $U%sms.sesta.com@smpp.siroe.com

   請注意，SMPP_SERVER和SMPP_PORT通道選項將覆寫通道的正式主機名稱和 port 通道關鍵字設定。使用 SMPP_PORT 選項時，無需同時使用 port 關鍵字。使用這兩個選項的優點是，它們無需重新編譯配置即可生效，並可隨後進行變更。SMPP_SERVER 選項的其他用法在新增額外的 SMS 通道中說明。

控制同時連線的數量

threaddepth 通道關鍵字控制每個傳送程序中，指定給每個傳送執行緒的郵件數量。若要計算允許的並行運作的連線總數，請將以下兩個選項的值相乘：SMPP_MAX_CONNECTIONS 和 job_limit (SMPP_MAX_CONNECTIONS * job_limit)。SMPP_MAX_CONNECTIONS選項控制傳送程序中傳送執行緒的最大數量。而 job_limit 選項 (適用於通道執行時所在的工作控制器處理池) 控制同步執行的傳送程序的最大數量。

若要限制並行運作的連線總數，您必須適當調整這兩個選項或其中之一。例如，如果遠端 SMPP 伺服器僅允許單一連線，則 SMPP_MAX_CONNECTIONS 與 job_limit 均必須設定為 1。調整這些值時，最好允許 job_limit 超過 1。

建立 SMS 通道選項檔案

通道選項檔案一般都包含通道作業所需的網站特定參數。通道選項檔案不是 SMS 所必需的。如果確定安裝需要一個通道選項檔案，請將其儲存為文字檔案，並置於 installation-directory/config/ 目錄下。如同其他通道選項檔案，此檔案名稱的形式如下：

channel_name_option

例如，如果通道名為 sms_mway，則通道選項檔案為：

installation-directory/config/sms_mway_option

每個選項在檔案中佔據一行，格式如下：

option_name=option_value

例如，

PROFILE=GSM
SMSC_DEFAULT_CHARSET=iso-8859-1 
USE_UCS2=1

如需可用 SMS 通道選項的清單以及每個選項的說明，請參閱可用選項

可用選項

SMS 通道包含大量選項，這些選項可以分為六大種類︰

• 電子郵件至 SMS 轉換：控制電子郵件至 SMS 轉換程序的選項。

• SMS 閘道伺服器選項︰閘道設定檔選項。

• SMS 欄位︰控制已產生的 SMS 郵件中特定 SMS 欄位的選項。

• SMPP 協定︰與經由 TCP/IP 的 SMPP 協定之使用關聯的選項。

• 本土化︰允許插入 SMS 郵件中的文字欄位本土化的選項。

• 其他︰除錯選項。

這些選項在下表中概括，並會在後續各節中加以更完整的說明。

電子郵件至 SMS 轉換選項

以下選項控制電子郵件至 SMS 郵件的轉換。括號中是選項值的範圍。一封給定的電子郵件一般都可以轉換成一封或多封 SMS 郵件。請參閱電子郵件至 SMS 轉換程序

GATEWAY_NOTIFICATIONS

(0 或 1) 指定是否將電子郵件通知轉換成 SMS 通知。電子郵件通知郵件必須符合 RFC 1892、1893、1894。預設值為 0。

當 GATEWAY_NOTIFICATIONS=0 時，這類通知將被捨棄，不會轉換成 SMS 通知。

若要啟用將通知轉換成 SMS 通知的功能，請設定 GATEWAY_NOTIFICATIONS=1。當此選項設定為 1 時，本土化選項 (DSN_*_FORMAT) 將控制轉換成 SMS 郵件並經由閘道傳送的通知類型 (成功、失敗、延遲、轉送)。(如果通知類型的值為空白字串，則此類型通知不會轉換成 SMS 郵件。)

MAX_MESSAGE_PARTS

(整數) 將多部分電子郵件轉換成一封 SMS 郵件時，僅第一批 MAX_MESSAGE_PARTS 數量的文字部分會被轉換。其餘部分將被捨棄。依預設，MAX_MESSAGE_PARTS 為 2。若要讓郵件部分的數量不受限制，可將此值指定為 -1。指定值為 0 時，沒有郵件內容會置於 SMS 郵件中。僅使用電子郵件中的標頭行 (例如，Subject:) 會產生 SMS 郵件。

請注意，包含文字和附件的電子郵件通常由兩個部分組成。更需注意，只有一般文字郵件部分才會轉換。所有其他 MIME 內容類型都將被捨棄。

MAX_MESSAGE_SIZE

(整數，>= 10) 使用此選項，可設定從電子郵件產生的 SMS 郵件中能包含的位元組總數的上限。具體來說，MAX_MESSAGE_SIZE 指定的最大位元組數量將用於一封或多封產生的 SMS 郵件。任何額外的位元組都將被捨棄。

依預設，設定上限為 960 個位元組。其與 MAX_MESSAGE_SIZE=960 對應。若要讓位元組數量不受限制，可將此值指定為零。

在將電子郵件從 Unicode 轉換成 SMSC 的預設字元集或 UCS2 後使用位元組計數。這意味著，對於 UCS2，將產生至多 960 位元組的 MAX_MESSAGE_SIZE，480 個字元 (由於每個 UCS2 字元至少兩個位元組長。)

請注意，MAX_MESSAGE_SIZE 和MAX_PAGES_PER_MESSAGE選項同時服務於同一目的︰限制產生的 SMS 郵件之整體大小。更確切地說，MAX_PAGE_SIZE=960 和MAX_PAGE_SIZE=160 表示 MAX_PAGES_PER_MESSAGE=6。那為何會有兩個不同的選項？這是為了便於控制整體大小或頁數，而不必考量單一 SMS 郵件的最大大小 MAX_PAGE_SIZE。在通道選項檔案中此功能可能不重要，但在使用將電子郵件導向通道或將電子郵件導向通道定址屬性時很重要，如將電子郵件導向通道中所述。

最後，請注意，會使用 MAX_MESSAGE_SIZE 和 MAX_PAGE_SIZE * MAX_PAGES_PER_MESSAGE 兩個中較小的限制。

MAX_PAGE_SIZE

(整數，>= 10) 允許在單一 SMS 郵件中使用的最大位元組數目由 MAX_PAGE_SIZE 選項控制。依預設，將使用 160 個位元組的值。其與 MAX_PAGE_SIZE=160 對應。

MAX_PAGES_PER_MESSAGE

(整數，1 - 255) 此選項可控制給定的電子郵件能產生的 SMS 郵件之最大數目。實際上，此選項會截斷電子郵件，只將電子郵件中符合 MAX_PAGES_PER_MESSAGE SMS 郵件選項的部分轉換成 SMS 郵件。請參閱MAX_PAGE_SIZE選項的說明，以取得進一步論述。

依預設，MAX_PAGES_PER_MESSAGE 設定為 1 和由MAX_PAGE_SIZE分割的MAX_MESSAGE_SIZE 兩者中較大值。

ROUTE_TO

(字串，IP 主機名稱，1-64 個位元組) 所有以設定檔為目標的 SMS 郵件將會使用以下格式的電子郵件位址重新路由至指定的 IP 主機名稱：

SMS-destination-address@route-to

其中 SMS-destination-address 為 SMS 郵件的目標位址，而 route-to 為此選項指定的 IP 主機名稱。SMS 郵件的整個內容會作為產生的電子郵件之內容傳送。PARSE_RE_* 選項會被忽略。

PARSE_RE_* 和 ROUTE_TO 選項互相排斥。在同一閘道設定檔中同時使用這兩個選項會造成配置錯誤。

SMSC_DEFAULT_CHARSET

(字串) 透過此選項，可以指定 SMSC 的預設字元集。請使用以下檔案中給定的字元集名稱

installation-directory/config/charsets.txt

如果未指定此選項，則假定為 US-ASCII。請注意，charsets.txt 中使用的快捷名稱在同一目錄中的 charnames.txt 內定義。

處理電子郵件時，標頭行和文字郵件部分會先被解碼，然後轉換成 Unicode。然後，資料會轉換成 SMSC 的預設字元集或 UCS2，具體取決於USE_UCS2選項的值，以及 SMS 郵件是否至少包含一個在預設 SMSC 字元集中找不到的文字影像。請注意，UCS2 字元集是 16 位元的 Unicode 編碼，通常被稱為 UTF-16。

USE_HEADER_FROM

(整數，0 - 2) 設定此選項以允許 From: 位址傳送至 SMSC。該值表示 From: 位址的來源及其具有的格式。表 D–6 顯示允許的值及其涵義。

USE_HEADER_PRIORITY

(0 或 1) 此選項控制 RFC 822 Priority: 標頭行的處理。依預設，Priority: 標頭行的資訊用於設定產生的 SMS 郵件之優先權旗標，覆寫由DEFAULT_PRIORITY選項指定的預設 SMS 優先權。其與 USE_HEADER_PRIORITY=1 對應。若要停用 RFC 822 Priority: 標頭行，請指定 USE_HEADER_PRIORITY=0。

請參閱 DEFAULT_PRIORITY 選項的說明，以取得有關處理 SMS 優先權旗標的進一步資訊。

USE_HEADER_REPLY_TO

(0 或 1) 當 USE_HEADER_FROM =1 時，此選項控制是否考量將 Reply-to: 或 Resent-reply-to: 標頭行做為 SMS 來源位址使用。依預設，忽略 Reply-to: 和 Resent-reply-to: 標頭行。與此對應，選項值為 0。若要啟用對這些標頭行的考量，請使用選項值 1。

請注意，RFC 2822 已停用 Reply-to: 和 Resent-reply-to: 標頭行。

USE_HEADER_RESENT

(0 或 1) 當 USE_HEADER_FROM =1 時，此選項控制是否考量使用 Resent- 標頭行做為 SMS 來源位址。依預設，忽略 Resent- 標頭行。與此對應，選項值為 0。若要啟用對這些標頭行的考量，請使用選項值 1。

請注意，RFC 2822 已停用 Resent- 標頭行。

USE_HEADER_SENSITIVITY

(0 或 1) USE_HEADER_SENSITIVITY 選項控制 RFC 822 Sensitivity: 標頭行的處理。依預設，Sensitivity: 標頭行的資訊用於設定產生的 SMS 郵件之私密性旗標，覆寫由 DEFAULT_PRIVACY 選項指定的預設 SMS 私密性。這種情況為預設，對應於 USE_HEADER_SENSITIVITY=1。若要停用 RFC 822 Sensitivity: 標頭行，請指定 USE_HEADER_SENSITIVITY=0。

請參閱DEFAULT_PRIVACY選項的說明，以取得有關處理 SMS 私密性旗標的進一步資訊。

USE_UCS2

(0 或 1) 如果可能，通道將在其產生的 SMS 郵件中使用 UCS2 字元集。此為預設運作方式，對應於 USE_UCS2=1。若要停用 UCS2 字元集，請指定 USE_UCS2=0。請參閱SMSC_DEFAULT_CHARSET選項的說明，以取得有關字元集問題的進一步資訊。

SMS 閘道伺服器選項

GATEWAY_PROFILE

SMS 閘道伺服器配置檔案 sms_gateway.cnf 中的閘道設定檔名稱。

SMS 選項

以下選項允許用於產生的 SMS 郵件中的 SMS 欄位規格。

DEFAULT_DESTINATION_NPI

(整數，0 - 255) 依預設，會為目標位址指定 NPI (數值規劃指示器) 零值。透過此選項，可以指定替代整數值，範圍為 0 至 255。典型 NPI 值包含下面表 D–8 中的內容︰

此選項的值可用以下三種方式指定：

• 十進位值 (例如 10)。

• 「0x」前置的十六進制值 (例如，0x0a)。

• 以下不區分大小寫的文字字串 (括號中是相應的十進位值) 之一資料 (3)、預設 (0)、e.163 (1)、e.164 (1)、e.212 (6)、ermes (10)、f.69 (4)、網際網路 (14)、ip (14)、isdn (1)、陸上行動電話 (6)、國內 (8)、private (9)、電報 (4)、未知 (0)、wap (18)、x.121 (3)。

DEFAULT_DESTINATION_TON

(整數，0 - 255) 依預設，會為目標位址指定 TON (數字類型) 指標值零。透過此選項，可以指定替代整數值，範圍為 0 至 255。典型 TON 值包含下面表 D–9 中的內容︰

此選項的值可用以下三種方式指定：

• 十進位值 (例如 10)

• 「0x」前置的十六進制值 (例如，0x0a)

• 以下不區分大小寫的文字字串 (括號中是相應的十進位值) 之一縮寫式 (6)、字母數字式 (5)、預設 (0)、國際 (1)、國內 (2)、網路特定 (3)、訂閱者 (4)、未知 (0)。

DEFAULT_PRIORITY

(整數，0 - 255) SMS 郵件具有強制性優先權欄位。SMS 優先權值的轉譯在下面表 D–10 中顯示︰

透過此選項可以指定 SMS 郵件的預設優先順序。未指定時，會將預設優先權 0 用於 PROFILE=GSM 和 CDMA，將優先權 1 用於PROFILE=TDMA。

請注意，如果USE_HEADER_PRIORITY=1，且電子郵件具有 RFC 822 Priority: 標頭行，則在該標頭行中指定的優先權將用於設定產生的 SMS 郵件之優先權。尤其是，如果 USE_HEADER_PRIORITY=0，則 SMS 優先權旗標將總是依據 DEFAULT_PRIORITY 選項設定，且 RFC 822 Priority: 標頭行總是會被忽略。如果 USE_HEADER_PRIORITY=1，則會使用原始電子郵件 RFC 822 Priority: 標頭行設定 SMS 郵件的優先權旗標。如果此標頭行不存在，則使用 DEFAULT_PRIORITY 選項設定 SMS 優先權旗標。

用於將 RFC 822 Priority: 標頭行值翻譯為 SMS 優先權旗標的對映在下表中顯示︰

DEFAULT_PRIVACY

(整數，-1、0 - 255) 是否在 SMS 郵件中設定私密性旗標，且要使用的值由 DEFAULT_PRIVACY 和 USE_HEADER_SENSITIVITY 選項控制。依預設，值 -1 用於 DEFAULT_PRIVACY。表 D–12 顯示了將 DEFAULT_PRIVACY 和USE_HEADER_SENSITIVITY選項設定為各種值的結果。

SMS 私密性值的轉譯在下面表 D–13 中顯示︰

用於將 RFC 822 Sensitivity: 標頭行值翻譯為 SMS 私密性值的對映，在下面表 D–14 中顯示︰

DEFAULT_SERVICE_TYPE

(字串，0 - 5 位元組) 與通道產生的 SMS 郵件關聯的服務類型。依預設，不指定服務類型 (即為零長度字串)。一些常見服務類型為：CMT (行動郵件傳送)、CPT (行動傳呼)、VMN (語音郵件通知)、VMA (語音郵件提示)、WAP (無線應用程式協定) 以及 USSD (非結構化輔助資料服務)。

DEFAULT_SOURCE_ADDRESS

(字串，0 - 20 位元組) 供電子郵件產生的 SMS 郵件使用的來源位址。請注意，當 USE_HEADER_FROM=1 時，透過此選項指定的值會由電子郵件的創建者位址所覆寫。依預設，停用此值，亦即值為 0。

DEFAULT_SOURCE_NPI

(整數，0 - 255) 依預設，為來源位址指定 NPI 值零。透過此選項，可以指定替代整數值，範圍為 0 至 255。請參閱用於典型 NPI 值的DEFAULT_DESTINATION_NPI選項的說明。

DEFAULT_SOURCE_TON

(整數，0 - 255) 依預設，為來源位址指定 TON 指標值零。透過此選項，可以指定替代整數值，範圍為 0 至 255。請參閱用於典型 TON 值的DEFAULT_DESTINATION_TON選項說明。

DEFAULT_VALIDITY_PERIOD

(字串，0 - 252 位元組) 依預設，不會為 SMS 郵件指定相對有效期，而是使用 SMSC 的預設值。使用此選項來指定不同的相對有效期。以秒、分鐘、小時或天為單位來指定值。下面表 D–15 指定了此選項的各種值之格式和說明︰

可以使用 0、0s、0m、0h 或 0d 規格選取 SMSC 的預設有效期。即，使用 0、0s、0m、0h 或 0d 的規格時，會為產生的 SMS 郵件中的有效期指定一個空白字串。

請注意此選項不接受 UTC 格式的值。

DESTINATION_ADDRESS_NUMERIC

(0 或 1) 使用此選項刪除擷取自電子郵件訊息封 To: 位址的 SMS 目標位址中的所有非數值字元。例如，如果訊息封 To: 位址為︰

"(800) 555-1212"@sms.siroe.com

將被縮減成：

8005551212@sms.siroe.com

若要啟用此刪除功能，請指定此選項的值為 1。依預設，停用此刪除功能，對應於選項值 0。請注意，啟用後，刪除作業會在透過DESTINATION_ADDRESS_PREFIX選項增加任何目標位址前綴之前完成。

DESTINATION_ADDRESS_PREFIX

(字串) 在某些情況下，可能需要確保所有 SMS 目標位址都前置有固定文字字串，例如「+」。此選項可以用於指定這樣一個前綴。然後，該前綴會加入缺少指定前綴的任何 SMS 目標位址中。若要防止被DESTINATION_ADDRESS_NUMERIC選項刪除，應在 DESTINATION_ADDRESS_NUMERIC 選項之後套用此選項。

PROFILE

(字串) 指定與 SMSC 配合使用的 SMS 設定檔。可能的值為 GSM、TDMA 和 CDMA。如未指定，則假定為 GSM。此選項僅用於為其他通道選項 (例如DEFAULT_PRIORITY和DEFAULT_PRIVACY) 選取預設。

USE_SAR

(0 或 1) 過大的電子郵件可能需要分割成多封 SMS 郵件。發生這種情況時，個別 SMS 郵件可以選擇性地包含使用 SMS sar_ 欄位加入的定序資訊。這會產生「分段的」SMS 郵件，這些郵件可以透過接收終端機重新組合成單一 SMS 郵件。指定 USE_SAR=1 來指示增加此序列資訊 (如果有)。預設為不增加序列資訊，對應於 USE_SAR=0。

指定 USE_SAR=1 時，會忽略REVERSE_ORDER選項。

SMPP 選項

以下選項允許用於 SMPP 協定參數規格。這些名稱以字串「ESME_」開頭的選項可用於識別充當外部簡短郵件實體 (ESME) 的 MTA；亦即 MTA 連結至 SMPP 伺服器，以將 SMS 郵件提交至該伺服器的關聯 SMSC 的情況。

ESME_ADDRESS_NPI

(整數，0 - 255) 依預設，連結作業將指定 ESME NPI 的值為零，表示不明的 NPI。透過此選項，可以指定替代整數值，範圍為 0 至 255。請參閱DEFAULT_DESTINATION_NPI選項的說明，以取得典型 NPI 值表。

ESME_ADDRESS_TON

(整數，0 - 255) 依預設，連結作業將指定 ESME TON 的值為 0。透過此選項，可以指定替代整數值 (範圍為 0 至 255)。請參閱DEFAULT_DESTINATION_TON選項的說明，以取得典型 TON 值表。

ESME_IP_ADDRESS

(字串，0 - 15 位元組) 連結至 SMPP 伺服器時，BIND PDU 表示用戶端 (亦即 ESME) 的位址範圍是一個 IP 位址。透過指定 TON 值為 0x00，NPI 值為 0x0d 來完成此作業。位址範圍欄位的值會設定為正在執行 SMS 通道的主機之 IP 位址。請以帶點的十進位格式指定 IP 位址，例如 127.0.0.1。

ESME_PASSWORD

(字串，0 - 8 位元組) 連結至 SMPP 伺服器時，可能需要密碼。如果是這樣，請透過此選項指定密碼。依預設，使用零長度密碼字串。

ESME_SYSTEM_ID

(字串，0 - 15 位元組) 連結至 SMPP 伺服器時，可以提供 MTA 的系統 ID。依預設，不指定系統 ID (即，使用零長度字串)。若要指定系統 ID，請使用此選項。

ESME_SYSTEM_TYPE

(字串，0 - 12 位元組) 連結至 SMPP 伺服器時，可以提供 MTA 的系統類型。依預設，不指定系統類型 (即，使用零長度字串)。

MAX_PAGES_PER_BIND

(整數，>= 0) 有些 SMPP 伺服器可能會限制單一連結階段作業中提交的 SMS 郵件之最大數目。鑑於此，此選項可規定單一階段作業中可提交的 SMS 郵件的最大數量。達到此限制時，通道將中斷連結，關閉 TCP/IP 連線，然後重新連線並再次連結。

依預設，MAX_PAGES_PER_BIND 使用值 1024。請注意，通道還會偵測 ESME_RTHROTTLED 錯誤並在通道的單次執行中相應地調整 MAX_PAGES_PER_BIND。

REVERSE_ORDER

(0 或 1) 當電子郵件產生多個 SMS 郵件時，這些 SMS 郵件可以提交至 SMSC，以循序順序 (REVERSE_ORDER=0) 或反向循序順序 (REVERSE_ORDER=1)。反向排定次序適用於接收終端機首先顯示最後收到的郵件之情形。在這種情況下，最後收到的郵件會是電子郵件的第一部分，而非最後一部分。依預設，使用 REVERSE_ORDER=1。

請注意，指定USE_SAR=1 時，會忽略此選項。

SMPP_MAX_CONNECTIONS

(整數，1 - 50) 此選項控制每個程序中同步執行的 SMPP 連線的最大數量。由於每個連線都有一個關聯的執行緒，因此，此選項還可對每個程序中「工作者」執行緒的最大數量進行限制。依預設，SMPP_MAX_CONNECTIONS=20。

SMPP_PORT

(整數，1 - 65535) 可以使用此選項或 port 通道關鍵字指定 SMPP 伺服器偵聽的 TCP 連接埠。此連接埠號碼必須透過這兩種機制之一指定。如果同時使用這兩種機制指定，則透過 SMPP_PORT 選項做出的設定優先。請注意，此選項無預設值。

對於雙向 SMS，請確定其連接埠與 SMPP 轉送的 LISTEN_PORT 相同。

SMPP_SERVER

(字串，1 - 252 位元組) 對於單向 SMS，依預設，要連線的 SMPP 伺服器之 IP 主機名稱為與通道關聯的正式主機名稱，亦即顯示在 MTA 配置內通道定義第二行的主機名稱。此選項可用於指定不同的主機名稱或 IP 位址，而該主機名稱或 IP 位址將置換通道定義中指定的值。指定 IP 位址時，請使用帶點的十進位表示法，例如 127.0.0.1。

對於雙向 SMS，設定為指向 SMS 閘道伺服器主機名稱或 IP 位址。如果使用 SMPP 轉送的 LISTEN_INTERFACE_ADDRESS 選項，則務必使用與指定的網路介面位址關聯的主機名稱或 IP 位址。

TIMEOUT

(整數，>= 2) 依預設，等候資料寫入 SMPP 伺服器完成或從 SMPP 伺服器接收資料時，逾時時間為 30 秒。使用 TIMEOUT 選項來指定不同的逾時值 (以秒為單位)。指定的值至少為 1 秒。

本土化選項

建構 SMS 郵件時，SMS 通道有大量固定文字字串將置入郵件中。例如，這些字串說明了電子郵件的 From: 位址和 Subject: 標頭行。透過本小節說明的通道選項，可以為不同語言指定這些字串版本，並指定通道的預設語言。範例 D–2 顯示選項檔案的語言部分：

範例 D–2 通道選項檔案的語言規格部分

LANGUAGE=default-language

[language=i-default]
FROM_PREFIX=From:
SUBJECT_PREFIX=Subj:
CONTENT_PREFIX=Msg:
LINE_STOP= NO_MESSAGE=[no message]
REPLY_PREFIX=Re:

[language=en]
FROM_PREFIX=From:
SUBJECT_PREFIX=Subj:
CONTENT_PREFIX=Msg:
LINE_STOP= 
NO_MESSAGE=[no message]
REPLY_PREFIX=Re:
  ...

在每個 [language=x] 區段內，均可以指定與該語言相關的本土化選項。如果在該區塊內未指定特定選項，則會使用此選項的全域值。[language=x] 區段以外指定的本土化選項會設定此選項的全域值。

對於下列選項字串值必須使用 US-ASCII 或 UTF-8 字元集指定。請注意，US-ASCII 字元集為 UTF-8 字元集的特例。

CONTENT_PREFIX

(字串，0 - 252 位元組) 置於 SMS 郵件內、電子郵件內容自身之前的文字字串。預設的全域值為 US-ASCII 字串「Msg:」。

DSN_DELAYED_FORMAT

(字串，0 - 256 個字元) 傳送延遲通知的格式化字串。依預設，此選項使用空白字串，因此禁止延遲通知轉換成 SMS。請注意，GATEWAY_NOTIFICATIONS必須設定為 1，才能使此選項生效。GATEWAY_NOTIFICATIONS=0 時，會忽略此選項。

DSN_FAILED_FORMAT

(字串，0 - 256 個字元) 永久性傳送失敗通知的格式化字串。此選項的預設值為字串：

Unable to deliver your message to $a; no further delivery attempts will be 
made.

若要禁止轉換失敗通知，請為此選項指定空白字串。請注意，GATEWAY_NOTIFICATIONS必須設定為 1，才能使此選項生效。GATEWAY_NOTIFICATIONS=0 時，會忽略此選項。

DSN_RELAYED_FORMAT

(字串，0 - 256 個字元) 轉送通知的格式化字串。預設值為字串：

Your message to $a has been relayed to a messaging system which may not 
provide a final delivery confirmation

若要禁止轉換轉送通知，請為此選項指定空白字串。請注意，GATEWAY_NOTIFICATIONS必須設定為 1，才能使此選項生效。GATEWAY_NOTIFICATIONS=0 時，會忽略此選項。

DSN_SUCCESS_FORMAT

(字串，0 - 256 個字元) 傳送成功通知的格式化字串。預設值為字串：

Your message to $a has been delivered

若要禁止轉換遞送成功通知，請為此選項指定空白字串。請注意，GATEWAY_NOTIFICATIONS必須設定為 1，才能使此選項生效。GATEWAY_NOTIFICATIONS=0 時，會忽略此選項。

FROM_FORMAT

(字串，0 - 252 位元組) 用於格式化創建者資訊以插入 SMS 郵件中的格式化範本。預設全域值為 US-ASCII 字串「$a」，它會在創建者的電子郵件位址進行替換。請參閱格式化範本

FROM_NONE

(字串，0 - 252 位元組) 沒有創建者位址可供顯示時，置於 SMS 郵件中的文字字串。預設全域值為空白字串。

請注意通常不使用此選項，因為網站通常會拒絕缺少創建者位址的電子郵件。

LANGUAGE

(字串，0 - 40 位元組) 用於從中選取文字字串的預設語言群組。如未指定，則該語言將取自主機的預設本機規格。如果主機的本機規格不可用或對應於「C」，則使用 i-default。(i-default 對應於「適用於國際使用者的英語文字」。)

LINE_STOP

(字串，0 - 252 位元組) 置於 SMS 郵件內、自電子郵件擷取的各行之間的文字字串。預設全域值為 US-ASCII 空格字元「 」。

NO_MESSAGE

(字串，0 - 252 位元組) 置於 SMS 郵件內以表示電子郵件沒有內容的文字字串。預設全域值為 US-ASCII 字串「[no message]」。

SUBJECT_FORMAT

(字串，0 - 252 位元組) 格式化在 SMS 郵件中顯示的 Subject: 標頭行內容的格式化範本。此選項的全域預設值為 US-ASCII 字串「($s)」。請參閱格式化範本，以取得進一步詳細資訊。

請參閱 SUBJECT_NONE 選項，以取得不存在 Subject: 標頭行，或該標頭行內容為空字串時如何進行處理的說明。

SUBJECT_NONE

(字串，0 - 252 位元組) 當原始電子郵件不具有 Subject: 標頭行或 Subject: 標頭行值為空字串時，顯示的文字字串。此選項的預設全域值為空白字串。

DEBUG

(整數，位元遮罩) 啟用除錯輸出。預設值為 6，選取警告郵件和錯誤郵件。任何非零值均會啟用通道自身的除錯輸出，與通道定義上指定 master_debug 相同。表 D–16 定義了 DEBUG 位元遮罩的位元值。

格式化範本

使用FROM_FORMAT、SUBJECT_FORMAT以及所有 DSN_* 通道選項指定的格式化範本為 UTF-8 字串，其可能包含文字列文字和替換序列的組合。假定範例電子郵件位址為

Jane Doe <user@siroe>

識別的替換序列在下面表 D–17 中顯示︰

例如，格式化範本

From: $a

會產生文字字串

From: user@siroe

建構

${xy:alternate text}

可用於在序列 x 關聯的文字中進行替換。如果該文字為空白字串，則會使用與序列 y 關聯的文字。而如果此文字也為空白字串，則以替代文字進行替代。例如，考量格式化範本

From: ${pa:unknown sender}

對於創建者電子郵件位址

John Doe <jdoe@siroe.com>

該位址中包含片語部分，因此範本產生：

From: John Doe

但是對於位址

jdoe@siroe.com

該位址缺少片語，因此產生

From: jdoe@siroe.com

而對於空白創建者位址，則會產生

From: unknown sender

新增額外的 SMS 通道

您可以將 MTA 配置為具有多個 SMS 通道。這樣做的典型原因有兩個：

1. 與不同的 SMPP 伺服器通訊。

   十分簡單：只需新增額外的 SMS 通道至配置，並確定 (a) 為該通道給定不同的通道名稱，(b) 並將其與不同的主機名稱關聯。例如，

   sms_mway port 55555 threaddepth 20 smpp.siroe.com sms_ace port 777 threaddepth 20 sms.ace.net

   請注意無需新的重寫規則。如果沒有直接相符的重寫規則，Messaging Sever 會尋找具有關聯主機名稱的通道。例如，如果伺服器使用的是 user@host.domain，則會搜尋名為「host.domain」的通道。如果找到此類通道，會將郵件路由至該通道。否則，會開始搜尋「.domain」的重寫規則，如果仍找不到，則會繼續搜尋小數點號 (「.」) 規則。如需有關重寫規則的更多資訊，請參閱第 11 章, 配置重寫規則。

2. 與同一 SMPP 伺服器通訊但使用不同的通道選項。

   若要與同一 SMPP 伺服器通訊，但使用不同的通道選項，請在每個通道定義的SMPP_SERVER通道選項中指定同一 SMPP 伺服器。

   使用此機制很有必要，因為兩個不同的通道不能具有同一正式主機名稱 (即通道定義第二行列出的主機名稱)。若要允許它們與同一 SMPP 伺服器通訊，請定義兩個單獨的通道，每個通道均在其通道選項檔案內的 SMPP_SERVER 中指定同一 SMPP 伺服器。

   例如，您可以使用以下通道定義

   sms_mway_1 port 55555 threaddepth 20 SMS-DAEMON-1 sms_mway_2 port 55555 threaddepth 20 SMS-DAEMON-2

   以及重寫規則

   sms-1.siroe.com $u%sms-1.siroe.com@SMS-DAEMON-1 sms-2.siroe.com $U%sms-2.siroe.com@SMS-DAEMON-2

   然後，讓它們都使用同一 SMPP 伺服器，這兩個通道中每一個都要在其通道選項檔案中指定SMPP_SERVER=smpp.siroe.com。

調整遞送重試的頻率

當 SMS 郵件因暫時性錯誤 (例如 SMPP 伺服器無法到達) 而無法遞送時，電子郵件會保留在遞送佇列中並會在稍後再重試。除非另有配置，否則，Job Controller 不會在一小時內重試遞送。對於 SMS 郵件傳送，似乎等待時間太長。因此，建議將 backoff 通道關鍵字與 SMS 通道配合使用，指定更積極的遞送嘗試排程。例如，

sms_mway port 55555 threaddepth 20 \ 
  backoff pt2m pt5m pt10m pt30m notices 1
smpp.siroe.com

透過上述設定，首次嘗試後兩分鐘會進行重新遞送嘗試。如果這次也失敗，則會在第二次嘗試後五分鐘再次進行嘗試。然後是十分鐘，最後是每三十分鐘一次。notices 1 通道關鍵字可使一天後還無法傳送的郵件做為無法傳送的郵件傳回。

範例單向配置 (MobileWay)

MTA SMS 通道可與任何 SMPP V3.4 相容的 SMPP 伺服器配合使用。為說明範例配置，本節會詳細說明如何將 SMS 通道配置為與 MobileWay SMPP 伺服器配合使用。MobileWay 是全域資料與 SMS 連結的領先供應商。透過 MobileWay 路由您的 SMS 通訊流，您可以觸及全世界大多數主要 SMS 網路上的 SMS 訂閱者。

透過 MobileWay 請求 SMPP 帳號時，您可能要回答以下問題：

• 您的 SMPP 用戶端 IP 位址：請提供您的 Messaging Server 系統的 IP 位址，正如網際網路上其他網域一樣。

• 預設有效期：如果您提交的 SMS 郵件中未指定有效期，則此 SMS 有效期就為 MobileWay 將使用的有效期。在此有效期過期之前無法遞送的 SMS 郵件將被捨棄。請提供一個合理值 (例如，2 天、7 天等等)。

• 視窗大小：這是您的 SMPP 用戶端在停止並等待伺服器回應之前將提交的 SMS 郵件之最大數量，SMPP 伺服器作出回應後用戶端才能提交更多 SMS 郵件。您必須提供的值為 1 封郵件。

• 時區︰請指定您的 Messaging Server 系統運作時所在的時區。時區應以 GMT 時差的方式指定。

• 逾時：與單向 SMS 郵件傳送無關。

• 用於外寄請求的 IP 位址與 TCP 連接埠：與單向 SMS 郵件傳送無關。

向 MobileWay 提供上述問題的答案後，他們會提供給您一個 SMPP 帳號以及與他們的 SMPP 伺服器通訊的必要資訊。這些資訊包括

Account Address: a.b.c.d:p
Account Login: system-id
Account Passwd: secret

[帳號位址] 欄位為 IP 位址 a.b.c.d 以及您要連線至 MobileWay SMPP 伺服器的 TCP 連接埠號碼 p。將這些值用於SMPP_SERVER和SMPP_PORT通道選項。帳號登入和密碼分別是用於ESME_SYSTEM_ID和ESME_PASSWORD通道選項的值。使用此資訊後，您的通道選項檔案應包含

SMPP_SERVER=a.b.c.d
SMPP_PORT=p
ESME_SYSTEM_ID=system-id
ESME_PASSWORD=secret

現在若要與 MobileWay 互通，您需要設定兩個額外選項

ESME_ADDRESS_TON=0x01
DEFAULT_DESTINATION_TON=0x01

imta.cnf 檔案中的重寫規則可能如下所示

sms.your-domain $u@sms.your-domain

而 imta.cnf 檔案中通道定義可能如下所示

sms_mobileway 
sms.your-domain

通道選項檔案、重寫規則及通道定義均已設定妥當後便可傳送一封測試郵件。MobileWay 需要國際定址，形式如下

+<country-code><subscriber-number>

例如，若要傳送一封測試郵件至電話號碼為 (800) 555-1212 的北美訂閱者，您可以將電子郵件傳送至

+18005551212@sms.your-domain

除錯

若要對通道除錯，請在通道的定義中指定 master_debug 通道關鍵字。例如，

sms_mway port 55555 threaddepth 20 \ 
backoff pt2m pt5m pt10m pt30m notices 1 master_debug

透過 master_debug 通道關鍵字，有關通道作業的基本診斷資訊會被輸出至通道記錄檔。如需有關通道所進行的 SMPP 異動之詳細診斷資訊，還需在通道選項檔案中指定

DEBUG=-1

。

為雙向 SMS 配置 SMS 通道

如需有關配置 SMS 通道的一般說明，請參閱從SMS 通道配置開始的上述主題。配置 SMS 通道內容，將其視為可直接與遠端 SMSC 進行通訊，但在表 D–18 中列出的異常除外︰

所有其他通道配置的完成方式應如 SMS 通道說明文件所述。

如設定雙向 SMS 路由中所述，需要配置遠端 SMSC 以路由 SMS 位址 (在 DEFAULT_SOURCE_ADDRESS 通道選項中定義的) 至閘道的 SMPP 伺服器 (使用由 LISTEN_PORT 選項指定的 TCP 連接埠號碼)。(如需如何指定 LISTEN_PORT 的資訊，請參閱SMPP 伺服器。)

請注意多個 SMS 通道可以使用同一 SMPP 轉送器。同樣，只需一個 SMPP 伺服器或閘道設定檔即可處理多個 SMS 通道的 SMS 回覆與通知。配置多個轉送器、伺服器和閘道設定檔之功能會透過配置選項來影響不同的使用特徵。