客户端操作指引【NOC-Joey】

 

一.客户端【国际短信】模块功能介绍

短信应用：可查看已经开通的短信通道及相关信息。
短信发送：可在客户端手动发送短信活动，单批次只能发送一个短信内容。
模板发送：可在客户端手动发送短信活动，支持导入短信发送模板，不同的手机号码可以发送不同的短信内容。
记录查询：短信活动发送详细记录查询。
批次记录：按批次查询短信活动记录。
消费报表：短信活动消费报表统计。
短信价格：可查看当前应用短信费率和默认刊例价。

二.操作手册

一.短信应用的开通

发送短信首先需要开通短信服务，即创建短信应用。
目前客户端不支持自助创建短信应用，需要联系业务员进行开通。

在客户端【国际短信】→【短信应用】模块，可以查看当前已新增创建完成的短信应用(如下图)。


内容展示项说明：

应用名称	短信应用名称，可在开通的时候自定义名称。一般建议根据流量类型区分按验证/通知/营销的尾缀进行命名
appKey	短信应用密钥，用于API对接
secretKey	短信应用密钥，用于API对接；******表示处于加密状态，如需查看，需点击上方“查看密钥”按钮，获取查看权限
状态	短信应用状态，有以下状态：启用/停用/限流截停/防欺诈截停。只有启用状态下，短信应用可正常使用
回执推送地址	短信回调信息的接收地址，适用于Http对接方式的应用，由客户提供
签名	短信签名，非特殊定制可忽略
接口类型	短信应用对接类型，分为HTTP/SMPP/CMPP三种类型。NEW-SMPP即SMPP对接类型
操作	用户可操作按钮。“编辑”按钮，可修改短信应用名称，配置回执推送地址，配置IP白名单，更改短信应用状态

操作-编辑按钮功能说明：
点击 编辑 按钮，可以修改当前应用的配置信息

内容展示项说明：

应用名称	短信应用名称，可自定义编辑
回执推送地址	适用于HTTP类型对接的短信应用，可自助配置短信回调接收地址；每个应用仅可配置一个地址
允许IP	短信应用IP白名单，该配置仅对目标短信应用生效。开启白名单后，非白名单IP无法通过该应用成功提交流量
状态	可更改短信状态。限流截停/防欺诈截停是系统自动触发，不可主动更改状态目标为限流截停/防欺诈截停

 

 

二.发送短信

短信发送方式：
控制台：如果您习惯使用交互式操作界面，可通过控制台创建短信内容、发送短信，并查询统计数据等。
API：如果您习惯使用API或SDK编码，可通过API来发送短信。具体可以查看API发送短信

这里主要介绍下客户端控制台发送如何发送短信。

1.发送单一内容短信，适用于给批量号码发送相同的文本短信内容。
路径：国际短信→短信发送→普通短信
发送页面如下图所示：


发送页面内容展示项说明：

应用名称	可选用于发送的短信应用，下拉选择
发送方向	单个国家：发送的号码归属同一国家地区时选用 多个国家：发送的号码归属多个多家地区时选用
国家	发送短信号码归属国家地区，只适用于发送单个国家方向；选择多个国家发送方向时，无需填写
手机号	发送目标手机号。选择多个国家发送方向时，请务必在号码前加上国码；如果未在号码前加国码，短信将无法正常送达。 下载模板：下载号码模板文件 号码上传：导入号码模板文件，一次最多以模版方式提交50万个号码
SenderID	短信发件人，为非必填项目，因各国家的规则不同，有特殊需要请联系业务经理咨询。
定时发送	定时发送短信。如需定时发送，请设定发送时间；无需定时发送，请勿选择 GMT+8：可更改定时任务时区，默认GMT+8东八区时间
文本内容	短信发送内容，可自定义编辑。 [X]插入变量：在文本中插入变量内容；非特殊任务无需添加 内容预览：预览插入变量后的文本内容
短链接	使用NXCLOUD提供的短链接服务时，可选用。具体使用可以参考：短链接使用说明

文本内容 [X]插入变量 功能介绍：适用于在文本内容中需要添加指定变量名称的发送需求。

可插入变量说明：

手机尾号	{@phone#4}	取值发送的目标手机号尾数，示例：177****7564 → 7564
随机数字	{@randnum#4}	随机生成数字变量，支持1-10位长度
随机字符串	{@randstr#4}	随机生成字符串，支持1-10位长度
随机字符串+数字	{@randmix#4}	随机生成字符串+数字，支持1-10位长度
随机巴西人名	{@name#4}	随机生成人名，示例：Daniel, Carlos

请注意，插入变量会导致短信整体的计费长度增加，可能导致计费条数变动。


DID短信发送

什么是DID短信？
DID = Direct Inward Dialing 虚拟号码，如果有购买DID号码，并且该号码支持短信下行服务，那么可以在此模块发送DID下行短信(如下图所示)。
路径：路径：国际短信→短信发送→DID短信

发送页面内容展示项说明：

DID号码	已购买可用于发送短信的DID号码
上传号码	导入发送目标手机号。 下载模板：下载号码模板文件 上传文件：导入号码模板文件，一次最多以模版方式提交5万个号码
定时发送	定时发送短信。如需定时发送，请设定发送时间；无需定时发送，请勿选择 GMT+8：可更改定时任务时区，默认GMT+8东八区时间
文本内容	短信发送内容，可自定义编辑。

如果您想要通过API接口访问我们的DID短信服务，我们为您提供了DID短信的接口文档，请点击访问

2.发送多样性模板内容短信
模板发送适用于给不同的号码发送不同的短信内容的发送需求，发送的文本内容中，存在变量。
例如：
发给张三的短信内容是：Hello，张三。
发给李四的短信内容是：Hello，李四。

路径：国际短信→模板发送
发送界面如下图所示：

发送页面内容展示项说明：

应用名称	可选用于发送的短信应用，下拉选择
国家	发送短信号码归属国家地区
手机号	发送目标手机号。需要导入号码，无法手动输入号码。 下载模板：下载号码模板文件 导入模板：导入号码模板文件，一次最多以模版方式提交50万个号码
SenderID	短信发件人，为非必填项目，因各国家的规则不同，有特殊需要请联系业务经理咨询。
定时发送	定时发送短信。如需定时发送，请设定发送时间；无需定时发送，请勿选择 GMT+8：可更改定时任务时区，默认GMT+8东八区时间

模板发送的内容，无法直接在客户端进行编辑。具体的发送内容，会根据导入的模板文件中的内容进行发送。

 

 

三.短信记录查询

短信下发的详细记录可以在此模块进行检索查询。根据发送的短信是普通下行短信和DID短信的差异，区分普通短信和DID短信两个查询模块。

记录查询-普通短信

通过短信应用或下行短信API接口提交的短信可以在此模块查询短信记录详单。



内容展示项说明：

流量概况 展示项：

总发送数	发送的短信总数。
成功数	回执成功的数量。成功回执：DELIVRD
失败数	回执失败的数量。失败回执包括：UNDELIV,REJECTED,UNKNOWN,EXPIRED等
等待回执数	未返回回执状态的数量
成功比例	回执成功率。成功数/总发送数

请注意，这里统计的数量均是发送的总号码数量，并不是短信总计费条数

短信记录查询 展示项：

应用名称	短信发送使用的应用名称
手机号	发送目标手机号，号码格式：国码+号码(国码号码间去0)，例如：84392833602
国家	发送目的地国家或地区
SenderID	提交的短信发件人。该项未传值则显示为空
内容	文本短信内容
回执状态	短信回执状态，常见的回执状态有：DELIVRD(成功)，UNDELIV(失败)，REJECT(被拒绝)，UNKNOWN(未知)等。回执状态为空，则表示未收到从运营商处返回的短信回执状态。 回执状态一般会在几分钟返回。 如果发送的是营销类短信，回执状态更新可能会存在延迟
messageID	短信id，对应的短信提交成功得到的id。具有唯一性，每条短信的messageID不相同
计费条数	短信计费条数
单价	短信单价
总价	短信总价。总价=单价*计费条数
赠送	该条短信是否赠送。默认为否
发送时间	短信提交时间

记录查询-DID短信

通过DID虚拟号码自带的短信功能下发的短信可以在此模块查询短信记录详单。

DID短信 记录查询 展示项说明：

DID号码	发送短信的DID虚拟号码
手机号	发送目标手机号，号码格式：国码+号码(国码号码间去0)，例如：84392833602
国家	发送目的地国家或地区
内容	文本短信内容
messageID	短信id，对应的短信提交成功得到的id。具有唯一性，每条短信的messageID不相同
回执状态	短信回执状态，常见的回执状态有：DELIVRD(成功)，UNDELIV(失败)，REJECT(被拒绝)，UNKNOWN(未知)等。回执状态为空，则表示未收到从运营商处返回的短信回执状态。 回执状态一般会在几分钟返回。
计费条数	短信计费条数
短信类型	上行/下行短信
单价	短信单价
总价	短信总价。总价=单价*计费条数
发送时间	短信提交时间

 

四.按批次记录查询短信

客户端或API接口单次提交号码数≥2的短信均会生成一个批次记录。
可以根据批次号查看每个批次短信的发送情况。

普通短信 批次记录
通过短信应用或下行短信API接口提交的短信可在此模块查询批次记录。
批次记录可以查询批次短信的提交状态，但是无法准确获取短信的发送状态(比如短信回执，成功率等信息)

批次记录展示项说明

应用名称	短信应用
批次号	批次记录ID，格式根据批次提交时间自动生成，例如：20260120133752868。点击批次号，可以查看具体号码的提交状态信息。
号码数	批次包含号码数量
文本内容	文本短信内容
定时发送	是否设置定时发送
定时时间	定时发送时间。未设置定时则显示为空
结果反馈	点击可查询批次的初步发送状态统计。例如：总条数3已发送3未发送0撤销0
操作	再次发送：再次发送该批次短信。请注意，再次发送会重新生成一个批次发送任务 编辑重发：定时短信可用，非定时不可用。重新编辑定时短信任务进行发送，原任务会被撤销 失败重发：会将提交失败、发送失败的短信进行重新发送，重发将对此部分短信进行重新收费。系统会自动剔除格式错误的号码。

按“批次号”查看提交状态信息

点击具体的批次号，可以查看具体号码的提交状态信息。


内容展示项说明：

手机号	发送目标手机号码
状态	短信提交状态。 待提交：适用于定时任务。该批次短信等待提交中。定时任务未触发时，会显示待提交状态。 已提交：该批次短信已经提交递送， 提交失败：该批次短信提交失败(用户端➡NXLCOUD端)。提交失败时，短信未发出。 发送成功：该批次短信发送成功。 发送失败：该批次短信发送失败。 撤销任务：适用于定时任务。该批次定时短信已经撤销。撤销的短信不会发送
结果提示	提交结果。请求成功/请求失败
SenderID	提交的短信发件人。未传值则显示为空

需要注意的是，非定时任务是即时触发不可撤销。

 

 

五.短信消费报表

短信消费日报表，可以按天查询短信消费情况。消费日报表不可查询当日的数据。

报表数据展示项说明：

应用名称	短信应用名称
成功条数	发送成功的条数
失败条数	发送失败的条数
短信发送条数	发送总条数
计费条数	已收费的条数
总金额	消费总金额
日期	统计日期

请注意，报表统计的各项条数是短信的计费条数，并不是号码数。长短信会按多条计费长度进行统计。

 

 

六.短信价格

此模块可查看不同短信应用的费率和默认刊例价。

内容展示项说明：

国码	国家地区码
国家	国家地区名称
应用特殊价格	当前费率；“-”表示费率为空，即该国家地区未开通
默认刊例价	NXCLOUD官方指导参考价格