营销短信指的是用户商家通过发送“打折信息”、“促销活动”、“新品发布”等相关内容的短信到目标受众群体客户手机上,从而达到营销的目的。现如今,营销短信群发已经被越来越多的商家当做客情维护的重要营销手段。
营销短信群发服务不仅在国内深受众多企业所青睐,在国际市场同样也是如此。因为其较于其他营销方式来说,营销成本更低,覆盖范围更广,非常适合用户开拓市场,提升品牌影响力的场景。
新九游·产品应用范围:
- 活动促销——用户新九游·产品大促,搞活动进行大规模宣传。
- 平台推广——用于业务平台功能升级、等信息及时通知会员,引导会员关注新动态。
- 优惠劵发送——用于业务重大更新、新店开张优惠通知等,引导会员关注新动态。
- 新九游·产品宣传——用于新新九游·产品发布宣传,引导用户更好了解新九游·产品动态。
- 新店开张——用于新店开张宣传,短时间内让店知名度更好提升。
- 加群短信——用于邀请会员加群,加微信,进行社交营销!
API文档
短信发送接口:
- 请求方式:post
- 接口地址:https://market.juncdt.com/smartmarket/msgService/sendMessage
- 编码方式:utf-8
- 参数格式:json
请求参数说明:
名称 |
必填 |
类型 |
说明 |
accessKey |
是 |
string |
您可以在 我的接口-短信服务-获取密钥中找到:accessKey |
accessSecret |
是 |
string |
您可以在 我的接口-短信服务-获取密钥中找到:accessSecret |
classificationSecret |
是 |
string |
您可以在 短信服务-获取密钥中找到:套餐码 |
signCode |
是 |
string |
短信签名code(您可以在 我的接口-短信设置-签名管理-签名CODE列找到) |
templateCode |
是 |
string |
短信模板code(您可以在 我的接口-短信设置-模板管理-模板CODE列找到) |
phone |
是 |
string |
目标手机号 |
params |
否 |
map |
若有参数则必填且参数需与所选模版中参数名称以及数量一致 |
JSON请求示例:
- {
- "accessKey":"您可以在 我的接口-短信服务-获取密钥中找到:accessKey",
- "accessSecret":"您可以在 我的接口-短信服务-获取密钥中找到:accessSecret",
- "classificationSecret":"您可以在 短信服务-获取密钥中找到:套餐码",
- "signCode":"设置短信签名的CODE(您可以在 我的接口-短信设置-签名管理-签名CODE列找到)",
- "templateCode":"设置短信模板的CODE(您可以在 我的接口-短信设置-模板管理-模板CODE列找到)",
- "phone":"11位的手机号",
- "params":{
- "code":"例如:短信模板为 - 您的验证码为${code},此时参数名称为code,value按业务方需求填写"
- }
- }
公共响应参数说明:
名称 |
类型 |
说明 |
BusinessData |
object |
业务数据 |
BusinessException |
object |
异常数据 |
Timestamps |
long |
时间戳 |
BusinessData参数说明:
名称 |
类型 |
说明 |
code |
int |
结果返回码 |
msg |
string |
结果消息描述 |
phone |
string |
目标手机号 |
JSON响应示例:
- {
- "BusinessData":{
- "code":10000,
- "msg":"短信发送成功",
- "phone":"13800138000",
- },
- "Timestamps":1627540760769,
- "BusinessException":{
- "resultCode":1000,
- "resultMessage":"操作成功"
- }
- }
示例代码——Java:
- import com.alibaba.fastjson.JSONObject;
- import cn.hutool.http.HttpUtil;{
- import java.util.HashMap;
- import java.util.Map;
- /**
- * 云极发送短信示例
- * 说明:需要引入两个jar包,fastjson和hutool工具包
- * pom文件加入配置如下:
- * <dependency>
- * <groupId>com.alibaba</groupId>
- * <artifactId>fastjson</artifactId>
- * <version>1.2.69</version>
- * </dependency>
- * <dependency>
- * <groupId>cn.hutool</groupId>
- * <artifactId>hutool-all</artifactId>
- * <version>5.4.3</version>
- * </dependency>
- * @author junbs
- * @since 2021/10/21 21:22 下午
- */
- public class SmsSendDemo {
- public static void main(String[] args) {
- String url = "https://market.juncdt.com/smartmarket/msgService/sendMessage";
- JSONObject jsonBody = new JSONObject();
- jsonBody.put("accessKey", "这里填accessKey");
- jsonBody.put("accessSecret", "这里填accessSecret");
- jsonBody.put("classificationSecret", "这里填短信套餐分类码");
- jsonBody.put("signCode", "这里填短信签名code");
- jsonBody.put("templateCode", "这里填短信模版code");
- jsonBody.put("phone", "这里填目标手机号码");
- // 变量参数用map存
- Map<String, String> params = new HashMap<>();
- // 验证码参数示例
- params.put("code", "这里填验证码");
- // 自定义变量参数示例
- //params.put("这里填自定义变量名", "这里填自定义变量值");
- //params.put("money", "100");
- //params.put("name", "测试");
- //params.put("typeName", "微信");
- // 变量参数map存入json对象
- jsonBody.put("params", params);
- System.out.println(jsonBody);
- System.out.println(doPost(url, jsonBody));
- }
- /**
- * 发起post请求
- * @param url 请求url
- * @param json json格式请求体
- * @return json格式响应体
- */
- public static JSONObject doPost(String url, JSONObject json) {
- JSONObject response;
- try {
- String result = HttpUtil.post(url, json.toString());// 返回json格式
- response = JSONObject.parseObject(result);
- } catch (Exception e) {
- throw new RuntimeException(e);
- }
- return response;
- }
- }
示例代码——PHP:
- public function phpSendMessage(){
- //接入账号,从云极个人中心获取
- $accessKey = "这里填accessKey";
- //接入密钥,从云极个人中心获取
- $accessSecret = "这里填accessSecret";
- //套餐码,从云极个人中心获取
- $classificationSecret = '这里填accessSecret';
- //短信签名code,从云极个人中心获取
- $signCode = '这里填短信签名code';
- //短信模板code,从云极个人中心获取
- $templateCode = '这里填短信模版code';
- //手机号,仅支持单个
- $phone = '这里填目标手机号码';
- //如模板有变量,根据自己真实变量名称、个数填写,变量名和变量值一一对应,格式如下;如果模板无变量则为空
- $params = [
- "code" => "1234",
- ];
- ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
- $data = [
- "accessKey" => $accessKey,
- "accessSecret" => $accessSecret,
- "classificationSecret" => $classificationSecret,
- "signCode" => $signCode,
- "templateCode" => $templateCode,
- "phone" => $phone,
- "params" => $params
- ];
- if(empty($params)){
- unset($data['params']);
- }
- //curl请求
- $ch = curl_init("https://market.juncdt.com/smartmarket/msgService/sendMessage"); //请求的URL地址
- curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
- curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));//$data JSON类型字符串
- curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
- curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'Content-Length: ' . strlen(json_encode($data))));
- curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
- curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
- $output = curl_exec($ch);
- if($output === false)
- {
- //请求失败,打印失败原因
- echo 'Curl error: ' . curl_error($ch);
- }
- curl_close($ch);
- print_r($output."\n");
- }
错误代码参照:
错误码 |
说明 |
10000 |
短信发送成功 |
10001 |
短信发送失败 |
30001 |
签名未经审核,无法使用 |
30002 |
签名已被冻结,无法使用 |
30003 |
模板未经审核,无法使用 |
30004 |
模板已被冻结,无法使用 |
30005 |
无效的签名CODE |
30006 |
无效的模板CODE |
30007 |
发送失败,签名中含有非法关键词! |
30008 |
发送失败,模板中含有非法关键词! |
30009 |
系统异常,请联系技术人员! |
30010 |
手机号码不能为空,至少需要一个手机号码! |
30011 |
手机号码校验失败,非法手机号码! |
30012 |
手短信内容不能为空! |
30013 |
发送失败,短信内容中含有非法关键词! |
30014 |
变量不匹配,存在非法变量,请重新检查变量名称,变量属性,详情请参考变量说明 |
30015 |
发送失败,用户无权使用该签名! |
30016 |
发送失败,用户无权使用该模板! |
30017 |
内容超过最大长度300! |
30018 |
不支持发送的手机号段,请检查是否为移动。联通。电信三大运营商的手机号段! |
30019 |
当前功能接口可用次数不足,请重新购买后再次重试! |
30020 |
验签失败,请重新检查参数! |
30021 |
签名信息缺失,请重新检查! |
30022 |
accessKey信息缺失,请重新检查! |
30023 |
非法或者无效的调用! |
30024 |
无效accessKey,请重新检查! |
30025 |
无效套餐码,请重新检查! |
30026 |
使用模板类型与套餐码不匹配,请求失败! |
30027 |
一次请求发送目标手机号码最多500个! |
30028 |
请求发送的目标手机号已经超过当日发送上限 |