©2010-2026 宁波自信网络信息技术有限公司 版权所有
客服电话：0574-28810668 投诉电话：18658249818
浙ICP备2021020529号-1 | 浙B2-20240490
关注我们 ：
1、 SMPP协议描述 1 接口协议简介 随着短消息业务在移动通信网上的广泛开展，运营商可以利用短消息平台向用户提供丰富的增值业务。短消息中心（SMSC）可以与人工台、自动台、WEB Server、E-mail Server、WAP网关等各种非PLMN网的扩展短消息实体（ESME）配合工作，从而为移动用户提供丰富多采的功能。在SMSC与ESME间采用标准的协议接口，有助于实现其他厂家的ESME的接入，为运营者集成第三方产品、发展短消息新业务提供方便。 SMPP协议规范的内容主要针对扩展短消息实体与短消息中心的通信协议。协议主要描述短消息中心和扩展短消息实体之间的协议数据传输
2、格式。此协议运行在底层通讯协议（例如TCP/IP，X.25）上。 GSM03.39 v5.0.0中推荐的SMPP协议的内容中，能支持GSM的 PHASE2+的业务，另外还包括了可选的短消息用户管理的功能。规范面向现有的短消息业务，以后对于新业务（如WAP业务）的支持，可做相应修改。GSM 03.39 v5.0.0协议中错误状态和短消息状态没有定义具体的值，以Aldiscon的SMPP Application定义为准。 参考资料 《GSM 03.39(Version 5.0.0)》：European digital cellular telecommunications syste
3、m(Phase 2);Interface protocols for the connection of Short Message Service Centres(SMSCs)to Short Message Entities(SMEs); 《GSM 03.40(Version 4.8.1)：European digital cellular telecommunications system(Phase 2);Technical realization of the Short Message Service Point to Point》 《GSM 03.38(Version 5
4、2.0)：Digital cellular telecommunications system(Phase 2+)；Alphabets and language_specific information》 《GSM 03.47(Version 5.0.0)：Digital cellular telecommunications system;Example protocol stacks for interconnecting Service Center(SC) and Mobile_services Switching Center(s)(MSC)》 1.1 缩略语 SM
5、E 短消息实体 SMPP 短消息点对点协议 SMSC 短消息服务中心 ESME 扩展短消息实体 SMEI 短消息扩展接口（协议） 2 功能概述 通过SMEI，ESME（例如寻呼台，语音邮箱系统）能连接（BIND）或断连（UNBIND）短消息中心，提交（SUBMIT）短消息。 此协议包含以下两部分： *（协议）ESME到SMSC的消息 *（协议）SMSC到扩展ESME的消息 其中用户管理部分只适用于SMSC有用户数据库支持的情况 ESME可以与SMSC直接或者间接相连，直接相连时通过本规范确定的协议与SMSC通信，间接相连时
6、通过ESME Agent与SMSC相连，ESME Agent为ESME与SMSC之间的连接代理。ESME Agent与SMSC间走内部消息，ESME和ESME Agent之间则走标准的SMPP协议。采用ESME Agent间接相连方式，对接入SMSC的ESME提供了分类管理的便利（不同ESME连接到不同的Agent），有利于负荷分担和系统的稳定。见图1。 图1：ESME与SMSC的直接和间接连接方式图 SMSC和ESME连接的短消息系统网络 ESME到SMSC的消息 ESME能提交短消息到SMSC，也可以查询以前所提交的短消息的状态等信息。 SM
7、SC到ESME的消息 SMSC可以下发短消息到ESME。 3 消息协议 l 所有的消息，不管是从ESME到SMSC，还是从SMSC到ESME的消息，消息都是交互的，都必须产生一个响应（acknowledge）。 l 从ESME到SMSC所提交的消息，可能有两种响应： *SMSC收到消息的响应（ACK） *如果这条短消息设置了需要状态报告，那么当这条短消息到达目标地之后，SMSC会产生一个状态报告的消息给ESME。 4 ESME到SMSC的消息 ESME到SMSC的消息，如：提交、查询、删除短消息等请求，ESME必须以TRANSMITTER类型连接到SMSC。
8、 图4描述了一个典型的TRANSMITTER类型的请求应答的示例。TRANSMITTER类型的ESME是以BIND_TRANCESMITTER连接到SMSC的ESME，此类型的ESME向SMSC发起提交短消息，查询短消息状态，删除短消息等请求，SMSC返回请求的应答。 ESME和SMSC之间的请求应答消息可以是同步方式也可以是异步方式的。所以ESME可能在SMSC没有应答的情况下，发起多个请求到SMSC。 SMSC应该按照收到的请求顺序，给EMSE回响应。但是ESME必须能够处理没有按顺序的响应。 图4：TRANSMITTER类型的EMSE和SMSC的消息序列示例 表1：E
9、SME到SMSC的消息 命令 描述 bind_receiver ESME要求以接收者身份连接到SMSC bind_transmitter ESME要求以发送者身份连接到SMSC Unbind ESME要求断开连接到SMSC submit_sm ESME提交短消息到SMSC，以便SMSC下发此短消息到指定的移动台。 deliver_sm_resp deliver_sm的响应。 query_sm ESME查询以前所提交的短消息的状态 cancel_sm ESME要求取消以前所提交的某条短消息 replace_sm ESME要求替换以前所提交的某条短消息 enq
10、uire_link 询问与SMSC的连接情况 generic_nak 表示消息头有错误的响应 5 SMSC到ESME的消息 SMSC到ESME的消息，如：SMSC转发短消息到ESME，ESME必须以RECEIVER类型连接到SMSC。 图5描述了一个典型的RECEIVER类型的ESME和SMSC之间的消息序列的示例。RECEIVER类型的ESME是以BIND_RECEIVER连接到SMSC的ESME，SMSC向此类ESME转发短消息，ESME向SMSC回应答。 ESME和SMSC之间的请求应答消息可以是阻塞方式也可以是异步方式的。所以SMSC可能在ESME没有回应答的情况下，发送
11、发起多个deliver_sm请求到ESME。 ESME应该按照收到的请求顺序，给SMSC返回响应。但是SMSC必须能够处理没有按顺序回的响应。 图5：RECEIVER类型的EMSE和SMSC的消息序列示例 表2：SMSC到ESME的消息 命令 描述 bind_receiver_resp bind_receiver的响应，status表示连接成功与否 bind_transmitter_resp bind_transmitter的响应，status表示连接成功与否 unbind_resp unbind的响应，status表示断开连接成功与否 submit_sm_r
12、esp submit_sm的响应，status表明提交短消息是否成功 deliver_sm SMSC下发短消息到ESME query_sm_resp query_sm的响应，status表明此次询问是否成功，其它内容返回查询到的短消息信息 cancel_sm_resp cancel_sm的响应。Status表明取消短消息是否成功 replace_sm_resp replace_sm的响应，status表明此次替换是否成功 enquire_link_resp Enquire_link的响应 enquire_link 询问与ESME的连接情况 generic_nak
13、表示消息头有错误的响应 6 消息语法 在以下语法说明中，遵从以下规则： A.未使用的字段，依据类型必须设置为0或NULL。 B.消息由消息头和消息体组成 C.状态（status)如在命令语法中未加说明 0：表示成功 非0：表示失败 <0x80000000：未定义值保留 D.在类型中，可能用到以下定义 l integer ：一定字节数所组成的整数，高位在前，低位在后。例如：1字节（BYTE），2字节（WORD ) , 4字节(DWORD)。 l C_String ：以NULL结束的ASCII字符串 l C_
14、DecString ：以NULL结束的ASCII字符串，它由一系列的10进制字符组成（‘0’---‘9’)。 l C_OctetString ：由任意8位字节组成数据流串。 l C_HexString ：以NULL结束的ASCII字符串，它由一系列的16进制字符组 成（‘0’---‘9’，‘A’（‘a’)---‘F’(‘f’)) l C_StringTime ：表示时间的字符串，它为以下格式 “YYMMDDhhmmsstnnp" ，格式如下 YY' 年份的最后2位 (00-99) MM 月份(01-12) DD 日 (01-31) Hh 小时 (00-23) Mm
15、 分 (00-59) Ss 秒 (00-59) T 十分之一秒 (0-9) Nn 与UTC (Universal Time Constant) 时间超前或落后的差距(00-48). ‘+’（p) 时间超前于UTC time. ‘-’（p) 时间落后于 UTC time. l C_UnicodeString ：Unicode编码的字符串。 6.1 消息头语法 字段 长度（字节） 类型 Command Length 4 Integer Command ID 4 Integer Command_status 4
16、integer Sequence No. 4 integer Optional Message Body 可变 混合 具体字段描述说明： Command Length：整个包的长度（包括该字段本身）。 Command ID ：这个字段表明该条短消息的类型，相当于标识符。例如 ESME_SUB_SM表示此消息为ESME向SMSC提交短 消息。当该标识符表示该条消息是请求消息（request） 时，标识符的保留取值范围是0h到FFh。
17、当该标识符表 示该条消息是应答消息（response）时,标识符的保留 取值范围是080000000h到0800000FFh。一般来说， 应答消息的类型对应相应的请求消息的类型，所不同的 是，应答消息的类型在第31位比特处是置位的。 取值说明 ： Command ID 编码 Command ID 描述 ESME_BNDRCV bind_receiver 0x00000001 ESME要
18、求以接收者身份连接到SMSC ESME_BNDRCV_RESP bind_receiver_resp 0x80000001 bind_receiver的响应 ESME_BNDTRN bind_transmitter 0x00000002 ESME要求以发送者身份连接到SMSC ESME_BNDTRN_RESP bind_transmitrer_resp 0x80000002 bind_transmitter的响应 ESME_UBD Unbind 0x00000006 ESME要求断开连接到SMSC ESME_UBD_RESP unbind_resp 0x8
19、0000006 Unbind的响应 ESME_SUB_SM submit_sm 0x00000004 ESME提交短消息到SMSC ESME_SUB_SM_RESP submit_sm_resp 0x80000004 submit_sm的响应 SMSC_DELIVER_SM deliver_sm 0x00000005 SMSC下发短消息到ESME SMSC_DELIVER_SM_RESP deliver_sm_resp 0x80000005 deliver_sm的响应 ESME_QRYLINK enquire_link 0x00000015 ESME询
20、问与SMSC的连接情况 ESME_QRYLINK_RESP enquire_link_resp 0x80000015 enquire_link的响应 ESME_NACK Nack 0x80000000 表示消息头有错误的响应 Command Status ：此字段表示一个请求消息的成功与失败，如失败，指 示引起失败的错误类型等信息。该字段只用在应答消 息中，在请求消息中，该字段必须为NULL。 取值说明 ： 错误码 描述 ESME_ROK 消息发送成功
21、 ESME_RINVMSGLEN 无效的消息长度 ESME_RINVCMDLEN 无效的命令长度 ESME_RINVCMDID 无效的Command ID ESME_RINVBNDSTS 无效的连接状态 ESME_RALYBND 已经处于连接状态 ESME_RINVPRTFLG 无效的优先级标志 ESME_RINVREGDLVFLG 无效的注册短消息标志 ESME_RSYSERR 短消息中心系统错误 ESME_RINVPAR 参数无效 ESME_RINVSRCADR 源地址无效 ESME_RINVDSTADR 目的地址无效 ESME_RINVMSG
22、ID 无效的message-id ESME_RINVPASWD 无效的密码 ESME_RINVPASWDLEN 密码长度错误 ESME_RINVSYSIDSRV 无效的接口ID ESME_RCNTCANMSG 不能删除短消息 ESME_RINVDATFMT 无效的日期格式 ESME_RCNTREPMSG 不能替换短消息 ESME_RMSGQFUL 目前队列中有太多的短消息 ESME_RSERNOTSUP 服务不支持 ESME_RINVREPADDR 尝试替换时地址不匹配 ESME_RUNKNOWNERR 未知错误 Sequence No .：此
23、字段表示消息的序列号，它由ESME产生，它是消息和 它的应答之间的对应标志，数值在01h到07FFFFFFFh 间。对于每条请求消息，该字段必须保证严格单调的递增。 Optional Message Body：此字段表示短消息的消息体部分，具体定义见1.1。 6.1.1 generic_Nak命令 此命令用于当接收消息头有错误的时候的响应，该响应只能由收到请求方发出。 6.1.1.1 generic_Nak语法 该命令只有消息头，没有消息体。 6.2 消息体语法 6.2.1 BIND_RECE
24、IVER命令 在扩展短消息实体和短消息中心之间建立虚连接，接收SMSC转发的短消息。 6.2.1.1 BIND_RECEIVER语法 字段 长度(字节) 类型 system_id 最大 16 C_String Password 最大 9 C_String system_type 最大 13 C_String interface_version 1 integer addr_ton 1 integer addr_npi 1 integer address_range 最大 41 C_DecString 具体字段描述说明：
25、 system_id ：该字段是系统登录到短消息中心所用的接口号。 Password ：该字段是系统登录到短消息中心所用的密码。 system_type ：该字段标明登录的接口类型。 interface_version ：该字段标明登录的接口版本号。 addr_ton ：该字段指明编码类型。如不需要，可设为NULL。 取值说明 ： 0 未知，当用户或网络不含关于编码方案的较早信息 1 国际号码， 2 国内号码，不能包含地区和退出数字 3 网络特殊号码 4 用户号码 5 字符数字
26、 6 缩写号码 7 保留 addr_npi ：该字段指明编码方案。如不需要，可设为NULL。 取值说明 ： 0 未知 1 ISDN或电话号码编码方案（E164/E163），对于任意实体SC，MSC或MS，都有效 2 保留 3 数据编码方案（X121） 4 电报编码方案 5-7 保留 8 国内编码方案 9 私有编码方案 10 ERMES编码方案（ETSI DE/PS 3 01-3） 11-15 保留 address_range ：该字段
27、用来给短消息指明路由，和将状态报告转 发给ESME。如不需要，可设置为NULL。 6.2.1.2 BIND_RECEIVER_RESP语法 此命令用于对MI_BIND_RECEIVER响应。 字段 大小(字节) 类型 system_id 最大 16 C_String 具体参数说明： system_id ：该字段是系统登录到短消息中心所用的接口号。 6.2.2 BIND_TRANSMITTER命令 在扩展短消息实体和短消息中心之间建立虚连接，扩展短消息实体能向SMSC提交短消息。 6.2.2.1 BIN
28、D_TRANSMITTER语法 此命令和BIND_RECEIVER的语法一样，只是在消息头里的Command_id为"bind_transmitter"。 6.2.2.2 BIND_TRANSMITTER_RESP语法 此命令和BIND_RECEIVER_RESP的语法一样，只是在消息头里的Command_id为"bind_transmitter_resp"。 6.2.3 UNBIND命令 此命令用于断开ESME和SMSC之间的连接。 6.2.3.1 UNBIND语法 此消息只有消息头，没有消息体。 6.2.3.2 UNBIND_RESP语法 此消息只有消息头，没有消息体
29、 6.2.4 SUBMIT_SM命令 此命令用于用于ESME提交短消息到SMSC,以便SMSC把此短消息发给特定ESME。 6.2.4.1 SUBMIT_SM语法 字段 长度（字节） 类型 service_type 6 C_String source_addr_ton 1 integer source_addr_npi 1 integer source_addr 最大21 C_DecString dest_addr_ton 1 integer dest_addr_npi 1 integer destination_addr 最大21
30、C_DecString esm_class 1 integer protocol ID 1 integer priority_flag 1 integer schedule_delivery_time 最大 17 C_StringTime validity_period 最大 17 C_StringTime registered_delivery_flag 1 integer replace_if_present_flag 1 integer data_coding 1 integer sm_default_msg_id 1 integer
31、 sm_length 1 integer short_message 最大160 可变 具体参数说明: service_type ：保留字段，为将来扩展用。必须设为NULL。 source_addr_ton ：源地址编码类型，如不需要，可设为NULL。 source_addr_npi ：源地址编码方案，如不需要，可设为NULL。 source_addr ：提交该短消息的SME的地址。是提交的短消息的 源地址。如不需要，可设为NULL。 dest_addr_ton ：目的地址编码类型，如不需要，可设为NULL。 dest_add
32、r_npi ：目的地址编码方案，如不需要，可设为NULL。 destination_addr：短消息的目的地址。对于移动终止的短消息来说， 它就是目的手机的MSISDN。如不需要，可设置为 NULL。 esm_class ：该字短为短消息类型。对submit_sm消息来说， 该字段必须为NULL;对deliver_sm消息来说，该 字段表示这条消息是状态报告。该字段的具体解 释请参考后面的消息体参数说明。
33、但对于普通的 SUBMIT_SM命令，此字段设为0。 取值说明 ： 此字段的说明如下： Bit 7 6 5 4 3 2 1 0 Flag Reserved UDHI Reserved Reserved Reserved Delivery Receipt Reserved Reserved 其中： UDHI：表示短消息内容是否有头结构。置位表示有。 Delivery R
34、eceipt：在DELIVER_SM协议中使用，表示 此条消息是否是状态报告。 protocol ID ：GSM协议类型。详细是解释请参考GSM03.40中的 9.2.3.9。 priority_flag ：短消息的优先级。当设置了短消息为高优先级， 短消息中心会将该短消息移到同一目的地址的消 息队列的前端，优先进行发
35、送。 取值说明 ： 0：普通优先级（缺省值） 1：高优先级 >1：保留。 schedule_delivery_time：该字段表示计划下发该短消息的时间。 时间格式请参考前面定义的C_StringTime 的格式. 如不需要，可设置为NULL。 validity_period：该字段表示短消息的最后生存期限。时间格式请
36、 参考前面定义的C_StringTime的格式.如不需要， 可设置为NULL。 registered_delivery_flag：该字段是注册短消息标志，它表示当 短消息到达最后的目的地后，是否需 要状态报告。 取值说明： 0：不需要 1：需要 >1：保留。 re
37、place_if_present_flag：该字段表示替换短消息标志。即当提交 的短消息的源地址和目的地址相同时， 是否替换存在的短消息。 取值说明： 0：不替换 1：替换 >1：保留。 data_coding ：该字段表示数据编码方案。 取值说明 ： 0 缺省编码方案(7位) 4 英
38、文编码方案(不被手机支持) 8 UCS2编码方案 其他 保留 sm_default_msg_id：该字段表示预定义短消息ID。该ID是短消息中 心管理者建立的预定义短消息表的索引。不想 发送预定义短消息时，该字段应设为NULL。预 定义短消息ID值从0x01到0x64。详细说明请参 考SMPP Applications Guide [9] - Default Shor
39、t Message。 sm_length ：要发送的短消息数据内容的字节长度。 short_message ：该字段表示短消息数据内容。最大可到160字符。 只有sm_length中定义的字节长度可用。 6.2.4.2 SUBMIT_SM_RESP语法 字段 长度（字节） 类型 Message_id 最大9 C_HexString 具体参数说明： Message_id ：该字段表示短消息ID，由短消息中心产生，用于 以后查询及替换短消息用，或是表明状态报
40、告所 对应的源消息。如果没有，该字段必须设为 NULL。 6.2.5 DELIVER_SM命令 此命令由SMSC产生，SMSC通过此命令发送短消息到目的ESME，它也可用于发送DELIVERY RECEIPT消息。 6.2.5.1 DELIVER_SM语法 它的语法和SUBMIT_SM的语法消息体是相同的，只是在消息头中的Command_id是“deliver_sm"。 6.2.5.2 DELIVER_SM_RESP语法 它的语法和SUBMIT_SM_RESP的语法消
41、息体是一样的，只是在消息头中的Command_id是“deliver_sm_resp"。 6.2.6 ENQUIRE_LINK命令 此命令用于ESME确认和SMSC之间的连接。ESME发送一条ENQUIRE_LINK命令，SMSC响应一条ENQUIRE_LINK_ACK命令，表示ESME和SMSC之间的连接正常。 6.2.6.1 ENQUIRE_LINK语法 此命令只有消息头，没有消息体。 6.2.6.2 ENQUIRE_LINK_RESP语法 此命令只有消息头，没有消息体。 6.3 消息体参数说明 address： 地址号码 address_range：地址范围
42、 data_coding：数据编码方案, ( 详见GSM 03.40 [1] 9.2.3.10) 例如： 0：缺省编码方案(7位) 4：英文编码方案(不被手机支持) 8：UCS2编码方案(比如中文编码) dest_addr_npi：目的地址编码方案，同npi dest_addr_ton：目的地址编码类型，同ton destination_addr： 目的地址，同address esm_class： 短消息类型 此字段的说明如下： Bit 7 6 5 4 3 2 1 0 Flag Reserved UDHI Reserv
43、ed Reserved Reserved Delivery Receipt Reserved Reserved 其中 UDHI 表示短消息内容是否有头结构。置位表示有。Delivery Receipt，在DELIVER_SM协议中使用，表示是否是此条消息是否是状态报告。 对于普通的SUBMIT_SM命令，此字段设为0。 final_date：短消息的生命期终止的实际时间，如果此短消息已从SMSC的等待发送队列中删除，即为删除时间，否则为SMSC当前的时间 interface_version：用来描述SMEI协议的版本号 Message_id：短消息ID，它由SM
44、SC设置。用于查询以及替换短消息等操作时使用。 Command Status：短消息当前的状态.0表示成功，非0表示失败 npi：地址编码方案，（定义详见GSM03.40[1] 9.1.2.5) 例如： 1 表示ISDN电话编码计划 password： 用来登录的密码 priority_flag：优先级 1：高优先级 0：普通优先级 >1：保留 protocol_ID：GSM协议类型（定义详见GSM03.40[1] 9.2.3.9) registered_delivery_flag： 注册短消息标志，它表示当此短消息到达最后的目的地后，是否需要 送达
45、状态报告（DELIVERY RECEIPT）。 0：不需要 1：需要 >1：保留 replace_if_present_flag：替换标志，当存在的短消息的源地址和目的地址都相同时，是否替换存在的短消息。 0：不替换 1：替换 >1：保留 schedule_delivery_time： 计划下发短消息的时间 service_type:： 保留，必须设为NULL short_message： 短消息数据内容。在7bit时，是160字符;在8bit时，是140字符。 sm_default_msg_id： 预定义短消息ID，不是预定义短消息时应设为0，预定
46、义短消息ID值从0x01到0x64。 sm_length： 短消息的数据长度，以字节计算 source_addr：源地址编号，同address source_addr_npi： 源地址编码方案，同npi source_addr_ton： 源地址编码类型，同 ton system_id：接口ID，用来描述虚拟连接的用户名 system_type：用来描述用户的类型 ton：地址编码类型，（定义详见GSM03.40[1] 9.1.2.5) 0 未知号码 1 国际号码 2 国内号码 3 网络专用号码 4 用户号码 5 字母号码(按照
47、GSM TS03.38 7-bit 缺省字母表编码) 6 缩写号码 7 保留 validity_period：短消息的最后生存期限 npi： 地址编码方案，（定义详见GSM03.40[1] 9.1.2.5) 0：未知 1：ISDN电话编码方案 3：数据编码方案(X.121) 4：电报编码方案 8：国家编码方案 9：专用编码方案 10：ERMES 编码方案(ETSI DE/PS 3 01 3) 15：扩充保留 从0到15的其他值保留 7．举例 人工台发一条消息到某一手机用户的所有动作： 7.1人工台在129后台的配置 人工台的接入号
48、 7．2人工台开始登录 发送bindtransmitter请求消息 码流分析 0 0 0 1d 消息长度： 29 1 0 0 2 消息类型： Bind_Transmitter 消息头 0 0 0 0 消息状态： 成功 0 0 0 1 序列号： 1 31 30 32 0 system_id ＝“102”最后 0 表示字符串结束符 0 password = 0 此时 0 既表示该字段值为0 也表示分隔符 4d 41 4e 0
49、 system_type ＝“MAN”最后 0 表示分隔符 3 接口版本 3.3 消息体 0 ton 0 npi 0 address_range smsc给以bindtransmitter响应消息 链路建立成功，人工台发送SubmitReq消息 短消息中心回复submit响应 常见问题回答： 1． 为什么Esme接入短信中心时报“Esme未配置” 2． 发送短信消息时为何报“无效的绑定状态”
©2010-2026 宁波自信网络信息技术有限公司 版权所有
客服电话：0574-28810668 投诉电话：18658249818
浙ICP备2021020529号-1 | 浙B2-20240490
关注我们 ：
