SUBMAIl SMPP 協(xié)議接入文檔
SUBMAIL SMPP 協(xié)議基于 SMPP 3.4 通訊協(xié)議。
參考開發(fā)文檔：《Short Message Peer to Peer Protocol Specification v3.4》 《CDMA 數(shù)字蜂窩移動(dòng)通信網(wǎng)擴(kuò)展短消息實(shí)體到短消息中心 的接口協(xié)議規(guī)范 SMPP v3.4 》
基于 SMPP 通訊協(xié)議，接入 SUBMAIL SMPP 可實(shí)現(xiàn)短消息發(fā)送、狀態(tài)接收等功能；要接入SUBMAIL SMPP 網(wǎng)關(guān)，請(qǐng)前往 國(guó)際短信-》創(chuàng)建/管理 AppID 頁(yè)面創(chuàng)建一個(gè) SMPP 應(yīng)用；
參數(shù)示例
| SMPP參數(shù) | 示例 | 描述 |
|---|---|---|
| IP/URL | smpp.mysubmail.com | 接口URL，如果您的系統(tǒng)僅支持 IP 對(duì)接或無(wú)法使用域名，請(qǐng)聯(lián)系商務(wù)或售后支持 |
| Port | 9000 | SMPP 端口號(hào) |
| User/System ID | appid | 用戶名 / System ID；前往 國(guó)際短信-》創(chuàng)建/管理 AppID 頁(yè)面獲取 |
| Password | smpp key | 密碼；前往 國(guó)際短信-》創(chuàng)建/管理 AppID 頁(yè)面獲取 |
請(qǐng)注意：
- 每個(gè)獨(dú)立的 SMPP 應(yīng)用默認(rèn)為 2 個(gè)TCP鏈路，支持 BIND_TRANSMITTER（TX）、BIND_RECEIVER (RX)，和 BIND_TRANSCEIVER（TRX）類型的連接，初始流速默認(rèn)為 100/秒；
- SMPP 要求必須指定一個(gè) 授權(quán)的 IP 進(jìn)行綁定；您可以綁定多個(gè) IP;
- 當(dāng)鏈路已成功登錄并已占用超過(guò)最大鏈路限制后，其他鏈路將無(wú)法繼續(xù)使用該 APPID 進(jìn)行登錄；
- SMPP 短消息正文編碼支持 GSM 7 和 UCS 2編碼；
SUBMAIL SMPP 網(wǎng)關(guān)支持常用 SMPP 指令
SMPP 指令支持列表
| 指令 | 指令描述 |
|---|---|
| BIND_TRANSMITTER | 發(fā)送器 TX 連接/登錄 |
| BIND_RECEIVER | 接收器 RX 連接/登錄 |
| BIND_TRANSCEIVER | 收發(fā)器 TRX 連接/登錄 |
| UNBIND | 鏈路拆除 |
| GENERIC_NACK | generic_nack 無(wú)效指令應(yīng)答 |
| SUBMIT_SM | 短消息發(fā)送 |
| DELIVER_SM | 短消息發(fā)送狀態(tài)獲取 |
| ENQUIRE_LINK | 鏈路檢測(cè)（心跳包） |
除上述列表中的指令外，其他 SMPP 指令均不被支持；如遇特殊需求，請(qǐng)聯(lián)系商務(wù)或售后支持；
關(guān)于長(zhǎng)短信
SUBMAIl SMPP 網(wǎng)關(guān)支持長(zhǎng)短信發(fā)送，支持 UDHI 模式和 message_payload 模式，最大字符限制為1000 字，包含簽名，正文、標(biāo)點(diǎn)符號(hào)和空格；SMPP 短信長(zhǎng)度與短信正文編碼相關(guān) gsm7 編碼通常普通短信支持 160字，長(zhǎng)短信為 154 字；UCS 2編碼普通的短信長(zhǎng)度為 70 字，長(zhǎng)短信為 67 字；全球許多國(guó)家或地區(qū)的短信長(zhǎng)度規(guī)范不統(tǒng)一，詳情請(qǐng)聯(lián)系 SUBMAIL 商務(wù)和售后部門；
UDHI 模式
要使用 UDHI 模式發(fā)送長(zhǎng)短信，請(qǐng)正確的設(shè)置 esm_class 參數(shù) 和 正文的 UDHI 頭；
正文頭采用 6 字節(jié) UDHI，格式：05 00 03 XX MM NN
- byte 1 : 05, 表示剩余協(xié)議頭的長(zhǎng)度
- byte 2 : 00, 這個(gè)值在 GSM 03.40 規(guī)范 9.2.3.24.1中規(guī)定，表示隨后的這批超長(zhǎng)短信的標(biāo)識(shí)位長(zhǎng)度為 1（格式中的 XX 值）
- byte 3 : 03, 這個(gè)值表示剩下短信標(biāo)識(shí)的長(zhǎng)度
- byte 4 : XX，這批短信的唯一標(biāo)志(被拆分的多條短信,此值必需一致)，事實(shí)上，SME(手機(jī)或者SP)把消息合并完之后，就重新記錄，所以這個(gè)標(biāo)志是否唯 一并不是很 重要。
- byte 5 : MM, 這批短信的數(shù)量。如果一個(gè)超長(zhǎng)短信總共 5 條，這里的值就是 5。
- byte 6 : NN, 當(dāng)前短信的序號(hào)。如果當(dāng)前短信是這批短信中的第一條的值是 1，第二條的值是 2。
示例：05 00 03 39 02 01
請(qǐng)注意：GSM7 編碼中有部分字符占用 2 個(gè)字節(jié)，如括號(hào) “[” 和 “]”，如果您的短信正文中包含 2 字節(jié)的字符時(shí)，應(yīng)限制每條短信的最大長(zhǎng)度-1；例：普通短信 160 字，減去 6 字節(jié) UDHI 頭 減1 ，既153字符 （160-6-1=153）
message_payload 模式
要使用 message_payload（TLV） 模式, sms_lenth 必須設(shè)置為 0，將全部的短消息正文設(shè)置在 message_payload 參數(shù)中發(fā)送
message_payload 最大支持 1000 字
錯(cuò)誤/狀態(tài)碼
SUBMAIL SMPP 網(wǎng)關(guān)除透?jìng)鞫滔?shí)際狀態(tài)外會(huì)有一些特殊的狀態(tài)碼，如模板審核拒絕、頻率超限、余額不足等
| 狀態(tài)碼 | 交互方式 | 描述 |
|---|---|---|
| SUBERRL | DELIVER_SM | 提交失?。ㄩL(zhǎng)短信并包超時(shí)） |
| NONECHN | DELIVER_SM | 不支持的國(guó)家或地區(qū) |
| OVERRUN | DELIVER_SM | 短信正文超過(guò)最大長(zhǎng)度限制（1000字） |
| RGBLOCK | DELIVER_SM | 用戶屏蔽區(qū) |
| BEYONDD | DELIVER_SM | SMPP應(yīng)用請(qǐng)求超限（請(qǐng)前往 國(guó)際短信-》創(chuàng)建/管理 AppID 頁(yè)面設(shè)置發(fā)送限制參數(shù)） |
| FRQEBYD | DELIVER_SM | 發(fā)送超限（相同內(nèi)容同一天內(nèi)對(duì)同一手機(jī)號(hào)發(fā)送超過(guò)15條） |
| UBLOCKD | DELIVER_SM | 自定義黑名單 （請(qǐng)前往國(guó)際短信-》創(chuàng)建/管理 AppID 頁(yè)面設(shè)置或管理黑名單） |
| REJECTD | DELIVER_SM | 審核拒絕 此狀態(tài)與網(wǎng)關(guān)REJECTD狀態(tài)碼一致，如遇相同內(nèi)容全部返回該錯(cuò)誤碼，則模板審核被拒，請(qǐng)前往 短信-》創(chuàng)建 /管理模板頁(yè)面查看具體駁回原因，修改后重新提交該模板進(jìn)行審核即可正常發(fā)送 |
| BALANCE | DELIVER_SM | 余額不足 |
| BLOCKED | DELIVER_SM | 系統(tǒng)屏蔽 |
| BEYONDT | DELIVER_SM | 模板發(fā)送超限；請(qǐng)前往 國(guó)際短信-》創(chuàng)建 /管理模板頁(yè)面 更改此模板發(fā)送限制 |