注册送短信

SUBMAIl CMPP 协议接入文档



SUBMAIL CMPP 协议基于中国移动短消息 CMPP 2 通讯协议。
参考开发文档:《中国移动通信 互联网短信网关接口协议 (China Mobile Peer to Peer, CMPP) (V2.0)》

基于 CMPP 通讯协议,接入 SUBMAIL CMPP 可实现短消息发送、状态和短消息上行等功能;要接入SUBMAIL CMPP 网关,请前往 短信-》创建/管理 AppID 页面创建一个 CMPP 应用;


参数示例


CMPP参数示例描述
IP/URLcmpp.mysubmail.com接口URL,如果您的系统仅支持 IP 对接或无法使用域名,请联系商务或售后支持
Port7890CMPP 端口号
User / SP_IDappidSP_ID /用户名;前往 短信-》创建/管理 AppID 页面获取
Passwordcmpp key密码;前往 短信-》创建/管理 AppID 页面获取
Src_Idappid企业ID/接入号;前往 短信-》创建/管理 AppID 页面获取



请注意:

  1. 每个独立的 CMPP 应用默认为 1 个TCP链路,初始流速默认为 100/秒;
  2. CMPP 要求必须指定一个 授权的 IP 进行绑定;您可以绑定多个 IP;
  3. 当一个链路已成功登录后,其他链路将无法继续使用该 APPID 进行登录;
  4. CMPP 短消息正文编码统一采用 UCS 2 编码即 Msg_Fmt = 8,其他编码均不被支持;
  5. CMPP 应用支持 6 位自定义扩展


SUBMAIL CMPP 网关支持大多数的常用 CMPP 指令


CMPP 指令支持列表

指令指令描述
CMPP_CONNECT连接/登录
CMPP_TERMINATE链路拆除
CMPP_SUBMIT短消息发送
CMPP_DELIVER回执/短消息上行
CMPP_ACTIVE_TEST链路检测(心跳包)



除上述列表中的指令外,其他 CMPP 指令均不被支持;如遇特殊需求,请联系商务或售后支持;



关于长短信



SUBMAIl CMPP 网关支持长短信发送,最大字符限制为1000 字,包含签名,正文、标点符号和空格;
要发送长短信,请正确的设置 TP_udhiPk_totalPk_number 参数;
正文 UDHI 头采用 6 字节 UDHI,格式:05 00 03 XX MM NN

  • byte 1 : 05, 表示剩余协议头的长度
  • byte 2 : 00, 这个值在GSM 03.40规范9.2.3.24.1中规定,表示随后的这批超长短信的标识位长度为1(格式中的XX值)
  • byte 3 : 03, 这个值表示剩下短信标识的长度
  • byte 4 : XX,这批短信的唯一标志(被拆分的多条短信,此值必需一致),事实上,SME(手机或者SP)把消息合并完之后,就重新记录,所以这个标志是否唯 一并不是很 重要。
  • byte 5 : MM, 这批短信的数量。如果一个超长短信总共5条,这里的值就是5。
  • byte 6 : NN, 当前短信的序号。如果当前短信是这批短信中的第一条的值是1,第二条的值是2。

示例:05 00 03 39 02 01




错误/状态码



SUBMAIL CMPP 网关除透传短消息实际状态外会有一些特殊的状态码,如模板审核拒绝、频率超限、余额不足等

状态码交互方式描述
SUBERRLCMPP_DELIVER提交失败(长短信并包超时)
SIGNERRCMPP_DELIVER短信正文未包含短信签名,或短信签名没有前置
CONTERRCMPP_DELIVER短信正文超过最大长度限制(1000字)
BEYONDDCMPP_DELIVERCMPP应用请求超限(请前往短信-》创建/管理 APPID 页面设置发送限制参数)
FRQEBYDCMPP_DELIVER发送超限(相同内容同一天内对同一手机号发送超过15条)
UBLOCKDCMPP_DELIVER自定义黑名单 (请前往短信-》创建/管理 APPID 页面设置或管理黑名单)
REJECTDCMPP_DELIVER审核拒绝
此状态与网关REJECTD状态码一致,如遇相同内容全部返回该错误码,则模板审核被拒,请前往 短信-》创建 /管理模板页面查看具体驳回原因,修改后重新提交该模板进行审核即可正常发送
BALANCUCMPP_DELIVER通用/运营类短信余额不足
BALANCTCMPP_DELIVER事务类短信余额不足
NOROUTECMPP_DELIVER无路由
BLOCKEDCMPP_DELIVER系统屏蔽
BEYONDTCMPP_DELIVER模板发送超限;请前往 短信-》创建 /管理模板页面 更改此模板发送限制
UNSUBEDCMPP_DELIVER用户已退订;请前往 短信-》上行交互页面设置取消退订规则