微信小程序推送

一、需求背景

1.1背景描述

微信小程序是一种不用下载就能使用的应用，经过将近些年的发展，已经构造了新的微信小程序开发环境和开发者生态。越来越多的开发者开始布局微信小程序。开发者在日常运营小程序的过程中，也会使用微信小程序消息推送能力，将运营消息触达到用户微信端内。个推深耕推送行业多年，引入小程序推送通道，帮助开发者能快速集成推送服务，从而实现app、小程序两端的消息推送。

个推小程序分别提供小程序在线推送和小程序订阅消息的方式，开发者进行选择。

1.2 名词解释

二、功能实现

开发者可通过调用个推服务api或者登录个推开发者中心从页面下发消息

2.1 个推开发者中心设置

1、小程序通道配置

①、在应用创建过程，应用平台需要勾选小程序；

②、创建完成的应用，需要到开发者中心-推送服务-应用设置-小程序内完成小程序扫码授权。

这个扫码授权需要小程序的管理员进行扫码授权。个推统一使用「个推消息推送」这个第三方平台供应商，使用本方式授权时无需配置回调地址。

• 考虑开发自身可能已经自行接入了小程序业务，在个推·消息推送服务中使用小程序不要与业务系统产生冲突（token、获取统计数据），则可以在小程序通道开通时，选择使用扫码授权的方式进行。

小程序推送所需要的配置权限集说明如下：

2、小程序订阅消息模板同步

同步模板，需要在开发者中心-推送服务-应用设置-小程序模板中进行模板同步

小程序模板需要在微信公众平台手动配置获取模板，登录 https://mp.weixin.qq.com 获取模板，如果没有合适的模板，可以申请添加新模板，审核通过后可使用。

3、小程序消息下发

目前小程序只支持透传的方式进行消息下发。

在消息推送-创建推送-透传消息中，勾选小程序，并对小程序的下发参数进行填写。

4、小程序下发数据查看

在消息发送成功后，可以通过消息推送-数据统计-推送记录-透传消息/API推送记录查看小程序已经下发的消息情况。

2.2 服务端api设置

1、绑定小程序openid

小程序通道配置和小程序订阅模板同步在开发者平台完成配置后，开发者在推送前，还需要将小程序的openid和个推cid进行绑定。openid和cid的绑定，可以在每次小程序进行初始化的时候进行，从而保证后续消息能正常送达。

绑定接口详见：【用户】批量绑定或解绑cid和deviceToken

2、下发小程序订阅消息

下发接口详见：push_channel离线厂商通道消息内容-微信厂商通道消息

下发示例：

{
  "mp":{
    "wx":{
      "template_id":"TEMPLATE_ID",
      "page":"index",
      "miniprogram_state":"formal",
      "lang":"zh_CN",
      "data":{
        "number01":{
          "value":"782719"
        },
        "date01":{
          "value":"2019年03月25日"
        },
        "site01":{
          "value":"杭州"
        }
      }
    }
  }
}