首页 > API调用场景 > 用户标签开放接入指南 > 接入文档

接入文档

官方短信业务-ISV接入须知

一、      业务介绍

官方短信营销业务接入旨在通过将京东官方短信通道赋能给商家/ISV的方式,支持商家对基于京东平台用户标签筛选后的人群进行短信的精准触达。商家需先向京东采购短信,后使用ISV工具进行短信发送。具体实现方式为商家在工具中创建短信签名,通过工具内链接跳转京麦服务市场进行短信充值,在ISV工具后台进行短信余量和充值明细的查看,并在用户筛选后进行短信发放。

二、      接入流程

1.     提供appkey工具名称邮件至jiangwen5@jd.com申请开通业务,获取专属充值链接,获取链接后需装修在工具后台供商家充值;

备注:商家充值渠道一定要与商家签名报备渠道保持一致,否则将出现充值不到账情况

2.     按照接口列表申请接口权限,申请完毕后邮件至jiangwen5@jd.com审核

三、      接口列表

接口名

描述

jingdong.data.vender.userpack.isv.query

筛选人群包

jingdong.data.vender.userpack.isv.upload

上传人群包

jingdong.data.vender.userpack.isv.compute

计算人群包(交并差)

jingdong.data.vender.userpack.isv.create

保存人群包

jingdong.data.vender.userpack.isv.list

查询包列表信息

jingdong.data.vender.userpack.isv.delete

删除人群包

jingdong.data.vender.userpack.isv.status.get

获取人群包状态

jingdong.data.vender.userpack.isv.sms.sent

单条短信测试发送

jingdong.data.vender.userpack.isv.sensitive.word.check

短信敏感词校验

jingdong.data.vender.userpack.isv.sms.batch.sent

短信批量触达发送

jingdong.data.vender.sms.effect.get

短信效果数据

jingdong.data.vender.sms.recharge.surplus

短信资源余量查询接口

jingdong.data.vender.activity.status.query

查询活动状态

jingdong.data.vender.sms.recharge.status

充值状态查询

jingdong.shorturl.generateURL

生成短域

jingdong.data.vender.userpack.param.concat.check

检验页面埋点

jingdong.data.vender.sms.effect.getrt

获取短信实时效果数据

jingdong.data.vender.sms.sign.get

获取短信签名

jingdong.data.vender.sms.sign.add

短信签名注册与创建

jingdong.data.vender.sms.sign.status.get

获取签名审核状态

jingdong.data.vender.userpack.isv.scenesum.get

获取场景标签下人群信息

jingdong.data.vender.userpack.isv.multiupload.end

完成分片上传任务接口(用于用户标签开放)

jingdong.data.vender.userpack.isv.multiupload.process

上传单个分片接口

jingdong.data.vender.userpack.isv.multiupload.start

开始分片上传任务接口(用于用户标签开放)

jingdong.data.vender.userpack.isv.generate.activityid

生成活动ID

jingdong.data.vender.sms.effect.getrt

短信实时效果数据


四、      产品设计规范

1.必须包含用户标签筛选、短信发送、短信审核、短信充值和签名报备模块

2.充值链接为渠道专用,工具到期后短信无法转移到其他工具进行使用

3. 短信只能发送给本店铺会员,短信文本必须接入京东红盾审核接口屏蔽敏感词,单条人数超过5w条需人工审核,每日18点进行审核

4.短信发送时间:日常为早9:00-8:00,大促适当调整

5.短信短链接必须通过调用京东短地址接口获取,短信链接必须按以下固定格式拼接参数

XX短信

参数

解释

实例

 

wjfrom

渠道

ISV_{appkey}_SMS

wjwxpubid

活动ID

活动ID

wjunionid

筛选人群包ID

人群包ID

wjopenid

商家ID

商家ID

链接拼接参数示例: https://item.m.jd.com/product/7343289.html?wjfrom=WX_JK&wjwxpubid=wx47085439d65e5fbc&wjunionid=bmasdasdsad6&wjopenid=opN5bt_VRu40tuFIrVF0XXoH-ltA

a.务必按照M端链接规范进行参数拼接

b.必须为京东域内可以打开的链接,若为isvjcloud域名则需按京东规则进行埋点

必须按以上规则拼接参数,否则无法获取到效果数据!