申请短信模板

提交短信模板申请单。

模板审核规范

格式规范 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退订 同上

1.请求参数:

请求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”公众号刷新订单获取最新物流信息哦~给您造成不便敬请谅解。 短信模板内容

2. 请求示例代码(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);
    }

3. 返回结果如下:

3.1 成功返回
 {
    "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为成功.

4 返回字段说明

参数名称 参数类型 示例值 参数描述
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 成功 说明
文档更新时间: 2023-03-14 16:54   作者:admin