文档中心 > 店铺动态卡片-开发指引

店铺动态卡片-开发指引

订阅消息

更新时间：2023/07/06 访问次数：14575

一、背景


小程序内有大量场景需要召回用户的需求，尤其在商家和服务侧需求旺盛， 在淘内触达用户核心通道是店铺客服消息， 为了帮忙商家实现商家服务闭环， 同时也为了用户提供更优的体验， 小程序平台搭建了完整用户主动订阅、客服消息召回的产品链路。


二、功能介绍


1.订阅消息推送位置：淘宝客服消息通知；

2.订阅消息下发条件：用户主动完成订阅，商家发送客服消息；

3.订阅消息跳转能力： 点击查看详情可跳转至商家设置投放计划关联着的小程序见面；

4.订阅消息面向通道： 客服消息（店铺客服通道）；


image


三、适用范围


目前仅面向商家开放消息能力，适用类目将逐步扩展。


一级类目

二级类目

三级类目

开放消息通道

用户运营

会员全案

会员运营-商家自研

客服消息

会员运营-会员运营

客服消息

会员运营-会员定制

客服消息


四、使用说明

步骤一：申请消息公告模板库


小程序开发者请登录 淘宝开放平台 ，打开【开发 -> 应用管理 -> 创建应用 -> 淘宝购物小程序】页面，选择类目【用户运营 -> 会员运营】，资质审核通过后，创建小程序；


image


image


在小程序的【订阅消息】页面，申请所需的公共模板。填写申请理由后请等待小程序运营审批。


image


image


image


步骤二：创建消息模板实例


待公共模板审批通过后，在上述页面对已批准的公共模板进行选用，可以根据需要生成最多22个小程序消息模板实例；（每个小程序消息模板实例都有资源ID与模板ID，是小程序消息订阅开发过程中所必须的参数信息）。

1）自研&定制场景： 小程序消息实例ID通过控制申请获得；

2）模板sass场景： 实例化出来的小程序ID继承模板的消息实例ID；


image

image


步骤三：录入素材添加素材


本期借助投放计划为商家设置订阅消息要跳转的小程序， 在创建投放计划之前需要先在【素材录入 -> 页面录入 -> 录入小程序页面功能】 页面功能关联到对应消息模板信息； 如下图：“奖励领取通知”。


特殊说明：因为素材录入要求小程序必须是上线状态， 对于已经上线小程序，可先使用任意界面作为素材录入，等应用正在上线后再替换素材； 对于未上线的小程序要先线上一版，在版本提审中写好配置说明； 第二期平台会优化掉这个流程；


image


image

image


在素材已经完成录入后， 完成场景设置【素材录入 -> 场景设置 -> 服务中心 -> 添加素材】 选择刚才上传界面；


image


image


步骤四：配置投放计划


在场景和素材都完成配置后， 商家需要继续在服务中心选择服务方案， 对应自研和定制进入到这个地址直接看到自己创建订阅消息解决方案；

统一入口地址：https://qn.taobao.com/microapp/app-customer-service/service-centre/commonSetting/{场景code}


说明：开放者在B端千牛应用通过web-view标签加载要打开跳转链接， 或者引导商家点击服务中心场景详情链接进去自主完成配置；注意引导商家配置需要商家先登录；


针对Sass模板实例化场景， 在商家订购完服务后，ISV为商家实例化小程序，亦可商家的小程序ID自动创建好投放计划， 对于调用接口：taobao.miniapp.distribution.order.create



image



如果没有以为服务方案，可通过设置服务商找到自己自研定制解决方案 、sass场景找到商家订购的解决方案B端应用；

1）自研&定制：在选择场景服务注意，需要满足解决方案B端千牛应用要存在千牛PC端应用，

2）sass场景： 需要满足

① ISV解决方案B端千牛应用要存在千牛PC端应用；

② 商家已经服务市场订购了ISV解决方案；

③ ISV已经为商家实例出C端小程序；


image


选择对应B端应用找到对应C端小程序，为C端应用创建投放计划，选择投放场景为对应消息模板；


image


新建完投放计划，并保存、开启投放计划；注意：投放计划尽量选择长期优先；


image


步骤五：发起用户授权


小程序端消息订阅接口 my.tb.subscribe。

参数：

业务域： message；

资源点： 1000110、1000114 (可在消息订阅-我的消息模板中看到)；

返回值：

授权TOKEN：40000100d13AWDIzo5bh3j2eI1378fe78verwEeCgReMutGGEtJxmswFH0B96cNDyfrxx

（资源授权Token，需要开发者存储起来， 在发送订阅消息携带上来）


//点击事件 
onClickMessage(){
  my.tb.subscribe({
    domainKey:"message", //资源域
    resourceKeys:['1000110','1000114'], //资源点
    success: (res) => {
      my.alert({ title: JSON.stringify(res)});
      console.log(res);
      this.setData({
        text: JSON.stringify(res)
      });
    },
    fail: (res) => {
      my.alert({ title: JSON.stringify(res)},);
      console.log(res);
      this.setData({
        text: JSON.stringify(res)
      });
    },
  })
},


步骤六：服务端发送消息


服务端调用TOP API发送订阅消息接口 taobao.bc.chat.message.send需要商家登录授权。


属性

类型

是否必填

描述

app_id

String

是

发送消息接收的小程序

msg_data

JSON

是

发送消息的消息体

{

"keyword1DATA":"服务预约时间",

"keyword2DATA":"服务人员xx"

}

template_instance_id

String

是

消息模板实例ID的

如：zoe5eE1CZY5ZXa/2w4cuymlBETl/2Ex5JvXoDJKo8QiJand6SKPg1X3/K5ZuwXcB

url_params

JSON

否

业务自定义参数字段，目前支持字段bizId{

"bizId":"自定义参数"

}


必要的系统参数


属性

类型

是否必填

描述

top_recource_token

String

是

用户订阅消息拿到Token

top_recource_id

String

是

资源点ID列表


相关错误码


错误码

错误码code

错误信息

描述

OPEN_NORMAL_ERROR_PARAM_NULL

1008

缺少必要参数

必须转值参数：

app_id、

template_instance_id

AUTH_RESOURCE_TENANT_CODE_EMPTY

5028

开发者租户信息为空

在开发者在申请消息模板时，平台为每个开发者分配一个对应租户信息， 如出现这个错误，联系平台技术支持协助处理

AUTH_RESOURCE_PLAN_APP_NOT_SETTING

5029

尚未订阅小程序设置投放计划

查询不到商家为小程序设置投放计划信息；检查投放计划是否完成配置、或者投放计划已经到期下线；

AUTH_RESOURCE_PLAN_APP_SETTING_LEGAL

5030

投放计划设置小程序和订阅授权小程序不一致

设置投放计划的小程序ID和消息实例ID关联小程序ID不一致，需要检查投放计划关联小程序ID、消息实例关联应用ID、参数上传ID是否一致

AUTH_RESOURCE_APP_TEMPLATE_LEGAL

5031

小程序未申请订阅消息

自研和定制小程序在开发者控制台申请到消息模板实例ID， 对应模板实例化小程序继承模板的消息实例ID

AUTH_RESOURCE_APP_TEMPLATE_STATUS_LEGAL

5032

小程序未申请订阅消息未生效

申请消息模板未通过平台审批

AUTH_RESOURCE_MSG_SEND_FAIL

5033

发送小程序消息失败

发送消息失败端侧未收到消息

  • 未配置投放计划
  • 发送消息者不是商家店铺ID
  • 商家店铺已经被关闭或者下架


要实现小程序消息订阅和服务端消息发送需要以上权限，正常情况下在上述步骤一和二完成后，就会自动分配权限。请开发者检查一下，如果缺少权限请联系小程序运营小二@闻山。


五、测试环境


客服消息


订阅消息说明：发送商家账号没有对应店铺信息或者店铺状态被关闭状态会导致发送失败。


FAQ

关于此文档暂时还没有FAQ
有用(0) 我要提问
返回
顶部
阿里巴巴集团 | 淘宝网 | 天猫 | 聚划算 | 全球速卖通 | 阿里巴巴国际交易市场 | 1688 | 阿里妈妈 | 阿里旅行·去啊 | 阿里云计算 | YunOS | 阿里通信 | 万网 | 高德 | 优视 | 友盟 | 酷盘 | 虾米 | 天天动听 | 来往 | 钉钉 | 11Main | 支付宝
关于淘宝 合作伙伴 营销中心 联系客服 开放平台 诚征英才 联系我们 网站地图 法律声明 © 2016 Taobao.com 版权所有
网络文化经营许可证：文网文[2010]040号 | 增值电信业务经营许可证：浙B2-20080224-1 | 信息网络传播视听节目许可证：1109364号