wxjava 发送小程序订阅信息小程序发订阅消息

转载

AI独步天下 2024-03-11 16:35:42

文章标签 wxjava 发送小程序订阅信息小程序接口 javascript node 文章分类 Java 后端开发

一、什么是订阅消息

订阅消息就是需要用户主动订阅，开发者才能面向这些用户发送消息。

wxjava 发送小程序订阅信息小程序发订阅消息_接口

主要内容：

订阅消息推送位置：服务通知
订阅消息下发条件：用户自主订阅
订阅消息卡片跳转能力：点击查看详情可跳转至该小程序的相应页面

订阅消息类型：

一次性订阅消息：该类型主要用于解决使用小程序后，后续服务环节的通知问题。用户自主订阅后，开发者可不限时间地下发一条对应的服务消息；每条消息可单独订阅或退订。
长期订阅消息：对于部分业务场景，一次性订阅消息是不能够满足小程序的需求的，为了便于服务，提供了长期性的订阅消息，用户一开始订阅一次后，开发者可以长期下发多条消息给用户。

目前长期性订阅消息仅向政务民生、医疗、交通、金融、教育等线下公共服务开放，后期将逐步支持到其他线下公共服务业务。

二、如何实现订阅消息

微信小程序实现订阅消息发送一共需要分为三步来实现：

步骤一：获取订阅消息模板 ID

在微信公众平台手动配置获取模板 ID：
登录 https://mp.weixin.qq.com/wxamp/newtmpl/mytmpl?start=0&limit=10&token=30714040&lang=zh_CN 获取模板，如果没有合适的模板，可以申请添加新模板，审核通过后可使用。

wxjava 发送小程序订阅信息小程序发订阅消息_node_02

步骤二：获取小程序的订阅消息下发权限

在我们发送小程序的订阅消息之前我们需要用户自己来决定是否需要接受到订阅消息，以及是否选择 “总是保持以上选择，不再询问” 选项。
注意：用户勾选 “总是保持以上选择，不再询问” 之后，下次订阅调用 wx.requestSubscribeMessage 不会弹窗，保持之前的选择，修改选择需要打开小程序设置进行修改。

实现方法：wx.requestSubscribeMessage(Object object)

wx.requestSubscribeMessage({
  tmplIds: ['MUtLwsw0xCndRULTgNHiXwGDyHJ-xx'],  // 模板ID
  success (res) { 
  	// 成功的回调
  	console.log(res)
  }
})

步骤三：调用接口下发订阅消息

当用户同意接受订阅消息，实现第三步之后就可以接收到订阅消息了，如果用户拒绝接收的话，即使执行完第三步用户也不会接收到订阅消息。

调用下发订阅消息接口

小程序端代码：

// index.wxml 
<button bindtap="sendMessage">发送订阅消息</button>

// index.js
// 点击发送订阅消息
sendMessage: function(e) {
	wx.request({
		url: 'https://xxx/xx/sendMessage', 
		method: 'POST',
		data: { },
		success(res) {
			console.log(res)
		}
	})
}

定义发送订阅消息接口

这部分内容主要是在服务端进行调用，具体使用请移步至服务端消息发送接口 subscribeMessage.send 微信官方文档进行查看。

在这里主要介绍一下里面的几个重点关注的内容：

调用方式：HTTPS 调用和云调用
在这里主要用到的是 HTTPS 调用，在上面的文档中也有介绍云调用的整体开发。
请求地址：
POST https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=ACCESS_TOKEN
请求参数：
access_token：接口调用凭证（这个凭证还是很重要的，不了解的小伙伴欢迎移步官网查看）
touser：接收者（用户）的 openid
template_id：所需下发的订阅模板id
data：模板内容
返回值
Object，返回的 JSON 数据包

服务端（nodejs koa2）代码实例：

// index.js
const router = require('koa-router')()
const request = require('superagent')
let AppID = 'xxxxx'
let AppSecret = 'xxxxx'
let access_token = 'xxxxx'
let openid = 'xxxxx'

// 点击发生订阅消息
router.post('/xx/sendMessage', async (ctx, next) => {
    let requestData = {
        "touser": openid,
        "template_id": "MUtLwsw0xCndRULTgNHiXwGDyHJ-xx",
        "page": "index",
        "data": {
            "phrase1": {
                "value": "王小二"
            },
            "date5": {
                "value": "2019年10月1日 15:01"
            },
            "phrase4": {
                "value": "王老师"
            }
        }
    }

    // 2、发送模板消息
    let res = await request
        .post(`https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=${access_token}`)
        .send(requestData)
        .set('Accept', 'application/json')

    console.log(res)

    ctx.body = {
        code: '200',
        data: null,
        msg: '操作成功'
    }
})