【小程序订阅消息】介绍

【消息能力】是小程序能力中的重要组成，我们为开发者提供了【订阅消息】能力，以便实现服务的闭环和更优的体验。

【订阅消息】推送位置：服务通知

【订阅消息】下发条件：开发者通过一定的方式触发用户主动订阅

【订阅消息】卡片跳转能力：点击查看详情可跳转至该小程序的页面

详细可以点击《微信官方文档：小程序订阅消息》

【小程序订阅消息】对接步骤

对接步骤说明

对接背景说明

【小程序订阅消息】功能的对接有以下一些特殊性：

由于该功能在【第三方平台权限集】是【互斥权限集】，所以不能以【第三方平台】授权方式研发，需要请【客户】对接小程序的【Access_token】和【消息推送回调地址】，再中转给LinkFlow

研发获取小程序【Access_token】的接口，客户获取小程序【Access_token】保存后，LinkFlow或其他供应商再调用该接口获取【Access_token】。
对接【小程序消息】推送，将LinkFlow需要的消息推送到指定地址。
在小程序中开发【用户订阅弹窗】。

1、在LinkFlow中对接小程序，详细可以点击查看《Linkflow与小程序链接指引》（事件埋点可以参看《小程序SDK埋点指引》）

2、获取【Access_token】（具体可以点击此处查看《接口调用说明》）（需要客户的开发同事完成）+加密秘钥（客户的开发自定义：任意形式均可，11##@）

3、登录LinkFlow【小程序账号配置】，输入步骤【2】的【Access_token】并复制【消息推送地址】（此处如果客户不采取【第三方回调】的方式，需要选择【微信回调】，请根据【微信回调】操作，点击下方可查看）

4、客户将已复制的【消息推送地址】提供给公司的开发，粘贴到公司的【中控服务器】

5、配置完成

6、客户需要登录【小程序管理后台】>申请【订阅消息模板】>提供给客户自己的开发同事完成相关配置

7、客户通过客户旅程外发【小程序订阅消息】>客户的小程序用户确认订阅小程序消息>通过MA操作的关于【小程序订阅消息】LinkFlow会记录相关事件。

对接流程图

【小程序订阅消息】对接详细说明

将需要对接的【小程序】与LinkFlow对接

详细可以点击查看《小程序与LinkFlow对接指引》

获取【Access_token】&相关开发操作

调用和存储【Access_token】

官方接口调用说明：可以点击此处查看《接口调用说明》

操作方：【小程序】归属公司的开发同事

获取信息：【Access_token】

提供第三方获取access_token的API，LinkFlow请求规范如下：

请求方式：GET

请求参数：小程序appId

期望的返回值结果
{"access_token": "加密后的token", "expires_in": 8809000}
expires_in为token过期的毫秒数

token传输需要加密，加密解密代码如下：

String originalString = "Hello, this is a secret message!";
String preSharedKey = "1yo0VURmWmDLzCDG"; // 自定义密钥
byte[] keyBytes = preSharedKey.getBytes();
SecretKey secretKey = new SecretKeySpec(keyBytes, "AES");
Cipher cipher = Cipher.getInstance("AES");
// 加密
cipher.init(Cipher.ENCRYPT_MODE, secretKey);
byte[] encryptedBytes = cipher.doFinal(originalString.getBytes());
String encryptedString = Base64.getEncoder().encodeToString(encryptedBytes);

// 解密
cipher.init(Cipher.DECRYPT_MODE, secretKey);
byte[] decryptedBytes = cipher.doFinal(Base64.getDecoder().decode(encryptedString));
String decryptedString = new String(decryptedBytes);

System.out.println("Original: " + originalString);
System.out.println("Encrypted: " + encryptedString);
System.out.println("Decrypted: " + decryptedString);