申请短信模板

提交短信模板申请单。

模板审核规范

格式规范	500字以内；不可出现【】，可能会与签名混淆，导致发送失败；不可使用如￥、★、_、&、√、※等特殊符号，可能会导致短信出现乱码。
变量规范	变量名称请用全英文字母编写（例如：${name}），同一个模板中如有多个变量，请使用不同的名称；营销短信不支持变量。
内容规范	模板内容需可以明确判断企业业务场景及发送目的，不支持发送以下类型内容： * 禁止发送涉及以下信息的短信：POS机、代开发票、金融、毒品、赌博、众筹、慈善募捐、股票、移民、面试招聘、彩票、返利、贷款、催款、投资理财、中奖、一元夺宝、一元秒杀、刷单、A货、医疗、整形、美容、会所、酒吧、足浴、暴力、恐吓、色情、内容不雅、皮草、助考、商标注册、加群、加QQ或者加微信、贩卖个人信息、APP下载链接、申请好评返现、宣传短信通道、用户拉新、用户召回、运营商相关（营业厅，移动，联通，电信等）、党政议论、上访维权、迷信、八卦风水、及其他违反法律法规的内容； * 不允许向非企业会员用户发送短信，例如针对邀请注册、邀请加入会员等短信内容。

格式规范

500字以内；不可出现【】，可能会与签名混淆，导致发送失败；不可使用如￥、★、_、&、√、※等特殊符号，可能会导致短信出现乱码。

变量规范

变量名称请用全英文字母编写（例如：${name}），同一个模板中如有多个变量，请使用不同的名称；营销短信不支持变量。

内容规范

模板内容需可以明确判断企业业务场景及发送目的，不支持发送以下类型内容： * 禁止发送涉及以下信息的短信：POS机、代开发票、金融、毒品、赌博、众筹、慈善募捐、股票、移民、面试招聘、彩票、返利、贷款、催款、投资理财、中奖、一元夺宝、一元秒杀、刷单、A货、医疗、整形、美容、会所、酒吧、足浴、暴力、恐吓、色情、内容不雅、皮草、助考、商标注册、加群、加QQ或者加微信、贩卖个人信息、APP下载链接、申请好评返现、宣传短信通道、用户拉新、用户召回、运营商相关（营业厅，移动，联通，电信等）、党政议论、上访维权、迷信、八卦风水、及其他违反法律法规的内容； * 不允许向非企业会员用户发送短信，例如针对邀请注册、邀请加入会员等短信内容。

审核时间

模板预计2个工作日内审核完成，审核通过后可使用。
工作时间:9:00-19:00 （法定节日顺延），建议您尽量在18:00前提交申请

Tips：请ISV/商家严格按照平台规范使用短信模版内容，一经发现短信内容违规将有相应的惩处。错误案例可参考下表。

错误案例

模板	说明
收到宝贝请帮忙点满五星好评，截图给客服领2元，非常感谢你的支持，回T退订	禁止好评返现内容
亲，十分抱歉没能让您满意。麻烦修改下评价，提供截图给到客服获伍元哦 ~期待您的好评。回T退订	禁止修改差评内容
感谢购买，请您加助理VX号:1868475XXX。回T退订	禁止站外引流（不限于引导加微、加群、私人电话、加q、网盘等形式）
您购买的PC版XX已到账电脑版链接: http://XXX 提取码：1234	同上
您申请的售后订单已为您办理成功，售后金额会按照您支付渠道原路退回，您注意查看是否到账。回T退订	提醒通知短信申请模板时请选择”通知短信”，并且删除 T退订
hello,${content}	大变量/连续变量，无法识别短信发送内容
您申请的售后订单已为您办理成功，${name} ${product},回T退订	同上

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/dd/sms/template/apply

公共参数

参数名称	参数类型	是否必须	示例值	参数描述
appid	String	是		合作伙伴AppId
timestamp	String	是	1657525936	当前Unix时间戳，秒
seller_nick	String	是	oms38173182	抖店的账号，对应蜂巢授权返回doudianseller字段
sign	String	是

业务参数

参数名称	参数类型	是否必须	示例值	参数描述
sms_account	String	是	12345	短信发送渠道，主要做资源隔离
template_type	String	是	CN_NTC	CN_NTC 国内通知短信 CN_MKT 国内营销短信（营销短信将自带退订功能） CN_OTP 国内验证码
template_name	String	是	618大促	短信模板名称
template_content	String	是	您购买的商品已重新发出，${name}快递运单号：${number}，关注“XXX”公众号刷新订单获取最新物流信息哦~给您造成不便敬请谅解。	短信模板内容

二、请求示例代码

Java

@Test
    public void  smsTemplateApplyRequest() throws Exception {
        Map<String, Object> data = new HashMap<String, Object>();
        data.put("appid",  Config.AppId);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("seller_nick", Config.DDSellerNick);
        data.put("template_type","CN_NTC");
        data.put("template_name","发货通知");
        data.put("template_content","您购买的商品已重新发出，${name}快递运单号：${number}，刷新订单获取最新物流信息哦~给您造成不便敬请谅解。");
        data.put("sign", Sign(data,Config.AppSecret));
        // 调用服务API
        String resp = doHttpRequest(Config.DDSmsTemplateApplyRequestUrl, data);
        System.out.println(resp);
    }

三、返回结果

三（一）、成功返回

{
    "code": 0,
    "message": "ok",
    "data": {
        "code": 0,
        "message": "",
        "sms_account": "723fc3f6",
        "sms_template_apply_id": "147418",
        "sms_template_id": "ST_72e7423f",
        "template_content": "您购买的商品已重新发出，${name}快递运单号：${number}，刷新订单获取最新物流信息哦~给您造成不便敬请谅解。",
        "template_name": "发货通知"
    }
}

说明： code为0表示成功，非0为失败，message会包含失败原因。业务层面的成功与否见内层的code, 0为成功.

四、返回字段说明

参数名称	参数类型	示例值	参数描述
template_content	String	您购买的商品已重新发出，${name}快递运单号：${number}，关注“XXX”公众号刷新订单获取最新物流信息哦~给您造成不便敬请谅解。	短信模板内容
template_name	String	618大促	短信模版名称
sms_template_id	String	234234	模版id
sms_template_apply_id	String	23423423	短信模板申请单id
code	Int64	0	是否成功 0表示成功
message	String	成功	说明