微信移动应用一次性订阅消息开发指南

2017-07-25|HiShop
导读:[db:导读]...

  HiShop讯,2017年7月25日最新消息,hishop记者发现微信官方昨天发布新增了“一次性订阅消息”接口,这对于微信用户和开发者都是个好消息。开发者可以通过一次性订阅消息授权让微信用户授权第三方应用或公众号(接入说明),获得发送一次订阅消息给到授权微信用户的机会。授权微信用户可以不需要关注公众号。微信用户每授权一次,开发者可获得一次下发消息的权限,消息将下发至服务通知。以下为hishop记者整理的微信移动应用一次性订阅消息开发指南相关内容。

  一、【使用说明】:

  1.第三方发起微信一次性订阅授权请求,微信用户允许授权第三方应用后,微信会拉起应用或重定向到第三方网站,并且带上授权用户openid等信息

  2.通过API给授权用户推送一条订阅消息

  注:在进行一次性订阅消息授权接入之前,需要在微信开放平台注册开发者帐号,并拥有一个已审核通过的移动应用,获得相应的下发消息模板ID后,可开始接入流程。

  二、【授权流程】:

  ——第一步:微信用户同意授权,获取一次给用户推送一条订阅消息的机会

  开发者需要配合使用微信开放平台提供的SDK进行一次性订阅消息授权请求接入。正确接入SDK后,开发者移动应用会在终端本地拉起微信应用进行订阅消息授权,微信用户确认后微信将拉起开发者移动应用,并带上授权用户openid等信息。

  ▋iOS平台应用一次性订阅消息授权接入代码示例(请参考iOS接入指南):

  WXSubscribeMsgReq *req = [[WXSubscribeMsgReq alloc] init];

  req.scene = scene;

  req.templateId = templateId;

  req.reserved = reserved;

  [WXApi sendReq:req];

  ▋Android平台应用一次性订阅消息授权接入代码示例(请参考Android接入指南):

  SubscribeMessage.Req req = new SubscribeMessage.Req();

  req.scene = scene;

  req.templateID = templateID;

  req.reserved = reserved;

  【参数说明】

微信移动应用一次性订阅消息开发指南

  可拉起微信打开一次性消息订阅授权页:

微信移动应用一次性订阅消息开发指南

  【返回说明】:

  用户点击授权后,微信客户端会被拉起,跳转至授权界面,用户在该界面点击确认接收或取消,SDK通过SendAuth的Resp返回数据给调用方。

  【返回示例】:

  openid:oyAaTjt-xXvP87pubE4eUOF-ttD4

  template_id:7YuTL__ilzyZB9DXcDt2mHx-CAS_E7KtsQkhIGVhhRM

  action:confirm

  reserved:hello

  scene:1000

  【参数说明】

微信移动应用一次性订阅消息开发指南

  ——第二步:通过API推送订阅模板消息给到授权微信用户

  【接口请求说明】:

  http请求方式: post

  https://api.weixin.qq.com/cgi-bin/message/template/subscribe?access_token=ACCESS_TOKEN

  【post数据示例】

  {

  “touser”:”OPENID”,

  “template_id”:”TEMPLATE_ID”,

  “url”:”URL”,

  “scene”:”SCENE”,

  “title”:”TITLE”,

  “data”:{

  “content”:{

  “value”:”VALUE”,

  “color”:”COLOR”

  }

  }

  }

  【参数说明】

微信移动应用一次性订阅消息开发指南

  【返回说明】

  在调用接口后,会返回JSON数据包。正常时的返回JSON数据包示例:

  {

  “errcode”:0,

  “errmsg”:”ok”

  }

  附:微信公众号新增“一次性订阅消息”接口能力

推荐阅读