對接上遊

更新日期:2025-12-11  

本節將詳細介紹使用SMPP協議對接上游的實現方式。

對接參數配置

核心配置

配置路徑

管理員登錄--通道管理--網關--新增/修改--核心配置項

參數說明

配置項	說明
C-狀態	請啟用
C-協議類型	在此請選擇SMPP34
C-主機	請填寫上游的協議IP
C-端口	請填寫上游的協議端口
C-企業代碼	請填寫您的SP_ID或協議賬號
C-SPID	請填寫您的SP_ID或協議賬號
C-密碼	請填寫您的認證密鑰
速度方式	TPS: 按時間(秒)控制並發量,配合下方TPS值限制每秒可發送的短信條數 WINDOW: 按滑動窗口大小控制並發量,配合下方WINDOW值限制未確認的在途短信條數 TPS+WINDOW: 滑動窗口大小控制和每秒並發量控制同時生效

提示

WINDOW和TPS之間存在線性關系,其影響因素為單條消息從發送到收到確認的時間(RTT),如果 WINDOW = 16 ,RTT = 20ms,那麼理論最大 TPS=16 / 0.02s = 800 。

SMPP參數

配置路徑

管理員登錄--通道管理--網關--新增/修改--smpp參數

參數說明

配置項	說明
BindType	指鏈路類型,默認為Transceiver,通常無需修改 Transceiver: 同時支持發送和接收消息 Receiver: 僅支持接收消息 Transmitter: 僅支持發送消息
ESM-Class	指消息模式和消息類型,SMSC缺省值為0,通常無需修改
SysType	System_type 參數用來對與SMSC正在連接的ESME的類型進行分類,一些SMSC可能並不要求ESME提供詳細情況,此時可以設置system_type為空
SvcType	指短消息的SMS應用服務,SMSC未指定時可置空
Addr-Ton/S-Ton/D-Ton	指SME地址參數中的數據類型 0: 不能識別(默認) 1: 國際 2: 國家標準 3: 特殊網絡 4: 用戶數 5: 字母數字 6: 可蔽體
Addr-Npi/S-Npi/D-Npi	指SME地址參數中的編碼方案指示 0: Unknown(默認) 1: ISDN (E163/E164) 3: Data (X.121) 4: Telex (F.69) 6: Land Mobile (E.212) 8: National 9: Private 10: ERMES 14: Internet (IP) 18: WAP Client Id (to be defined by WAP Forum)
編碼00	指採用SMSC DEFAULT編碼向上遊網關提交消息時,兼容的字符集映射版本,支持ASCII、GSM 7bit V1、GSM 7bit V2、GSM 7bit V3等,默認為 GSM 7bit V1
SMPP提交暫停	待補充
TLV	指是否提交自定義參數,在上遊網關要求提交指定自定義參數時才開啟
TLV-JSON-ARRAY	指自定義參數內容

雜項配置

配置路徑

管理員登錄--通道管理--網關--新增/修改--雜項

參數說明

配置項	說明
號碼 預Lookup	開啟後,該網關發送消息前會檢查接收方號碼格式/長度是否正確,格式/長度不正確時本網關會直接拒絕提交對應消息
權重	指消息優先級,取值範圍為1~ 9,默認為7,通常不用修改
號碼 提交 Add 00	開啟後,該網關發送的消息都會在接收方號碼頭部添加「00」
號碼 提交 Add +	開啟後,該網關發送的消息都會在接收方號碼頭部添加「+」
提交 響應 成功 標識	採用標準SMPP、CMPP協議時無需自定義該標識,特殊情況請聯繫網關管理員協助處理
提交 響應 成功 為 Delivrd	採用標準SMPP、CMPP協議時無需重新指定該標識,特殊情況請聯繫網關管理員協助處理
提交 響應 失敗 暫停 發送	遇到提交響應失敗時,通常原因為網關斷鏈或上遊服務故障,這種情況下及時暫停發送消息有利於排查處理問題
內容 Add MMSID	開啟後,該網關發送彩視消息時,會攜帶(已經向上遊報備通過的)彩視模板ID參數
狀態報告 成功 標識	採用標準SMPP、CMPP協議時無需重新指定該標識,特殊情況請聯繫網關管理員協助處理
忽略 狀態報告 中間 狀態碼	若上遊網關在返回正常狀態報告之前還返回了中間狀態報告,此時需定義該中間狀態報告被忽略,否則可能影響短消息狀態處理
狀態報告 交換 號碼 與 SenderId	開啟後,該網關在處理狀態報告報文時會交換「Originator address」和「Recipient address」
上行 交換 號碼 與 SenderId	開啟後,該網關在處理上行消息報文時會交換「Originator address」和「Recipient address」
DLR MID 值	網關處理消息狀態報告時默認直接匹配狀態報告報文中的Msg_Id值,並且狀態報告中的的Msg_Id值通常與狀態報告內「detail Deliver Report」的Msg_Id值一致 開啟後,使用CMPP協議時,網關處理消息狀態報告時會匹配狀態報告中「detail Deliver Report」的Msg_Id值
狀態報告 MID Dec 2 Hex	開啟後,網關處理消息狀態報告時會將Msg_Id由10進製轉換為16進製再進行匹配
網關 強制 用戶 上行	開啟後,發往該網關的上行消息會強制匹配給右側指定的網關用戶
強制 用戶 上行	指定強制接收該網關所有上行消息的網關用戶
頻次控制	開啟後,該網關會對消息接收方號碼進行發送(成功)計次
提交 頻次控制	開啟後,該網關會對消息接收方號碼進行提交計次,無論消息是否發送成功,提交次數都會增加
黑名單 號碼 功能網關	當該網關專用於給網關用戶調用遠程黑名單庫時開啟
黑名單 號碼 - 庫	指定遠程黑名單庫命中後本地存儲位置,當網關用戶調用遠程黑名單庫時,部分接收方號碼可能命中遠程黑名單庫,此時該網關會將命中的號碼加入本地黑名單庫
黑名單 號碼 A 庫-過濾	開啟後,網關層面允許本地黑名單A庫過濾
黑名單 號碼 B 庫-過濾	開啟後,網關層面允許本地黑名單B庫過濾
黑名單 號碼 C 庫-過濾	開啟後,網關層面允許本地黑名單C庫過濾
黑名單 號碼 D 庫-過濾	開啟後,網關層面允許本地黑名單D庫過濾
攜號轉網 功能網關	開啟後,該網關發送消息前會嘗試對所有接收方號碼匹配本地攜號轉網庫

對接狀態管理

管理員登錄--隊列管理--網關發送隊列可實時查詢/管理對接上游的SMPP鏈路,如遇網關斷鏈問題,請及時檢查本網關網關核心配置項並與上遊聯系處理。