# 小程序訂閱消息

# 功能介紹

消息能力是小程序能力中的重要組成，我們?yōu)殚_(kāi)發(fā)者提供了訂閱消息能力，以便實(shí)現(xiàn)服務(wù)的閉環(huán)和更優(yōu)的體驗(yàn)。 訂閱消息推送位置：服務(wù)通知

訂閱消息下發(fā)條件：用戶自主訂閱

訂閱消息卡片跳轉(zhuǎn)能力：點(diǎn)擊查看詳情可跳轉(zhuǎn)至該小程序的頁(yè)面

# 消息類型

1. 一次性訂閱消息

一次性訂閱消息用于解決用戶使用小程序后，后續(xù)服務(wù)環(huán)節(jié)的通知問(wèn)題。用戶自主訂閱后，開(kāi)發(fā)者可不限時(shí)間地下發(fā)一條對(duì)應(yīng)的服務(wù)消息；每條消息可單獨(dú)訂閱或退訂。

2. 長(zhǎng)期訂閱消息

一次性訂閱消息可滿足小程序的大部分服務(wù)場(chǎng)景需求，但線下公共服務(wù)領(lǐng)域存在一次性訂閱無(wú)法滿足的場(chǎng)景，如航班延誤，需根據(jù)航班實(shí)時(shí)動(dòng)態(tài)來(lái)多次發(fā)送消息提醒。為便于服務(wù)，我們提供了長(zhǎng)期性訂閱消息，用戶訂閱一次后，開(kāi)發(fā)者可長(zhǎng)期下發(fā)多條消息。

目前長(zhǎng)期性訂閱消息僅向政務(wù)民生、醫(yī)療、交通、金融、教育等線下公共服務(wù)開(kāi)放，后期將逐步支持到其他線下公共服務(wù)業(yè)務(wù)。

# 訂閱消息語(yǔ)音提醒

當(dāng)前小程序訂閱消息通知與微信消息的通知的提示音是一樣的，對(duì)于部分訂閱消息模板，增加語(yǔ)音提醒能力，播報(bào)預(yù)料部分字段支持開(kāi)發(fā)者定義。

當(dāng)開(kāi)發(fā)者調(diào)用wx.requestSubscribeMessage時(shí)僅訂閱1條消息且該模板支持開(kāi)啟語(yǔ)音提醒，用戶在訂閱時(shí)可以選擇開(kāi)啟語(yǔ)音提醒。開(kāi)啟后將在接收訂閱消息時(shí)會(huì)同步播報(bào)語(yǔ)音提醒。當(dāng)用戶開(kāi)啟了語(yǔ)音提醒，該模板的訂閱狀態(tài)為'acceptWithAudio'。

訂閱彈窗樣式如下：

當(dāng)前支持開(kāi)啟語(yǔ)音提醒的模板及播報(bào)語(yǔ)料如下：

標(biāo)題 類型 類目 播報(bào)語(yǔ)料 收款到賬通知 長(zhǎng)期訂閱 銀行 小程序收款元

以下情況會(huì)導(dǎo)致語(yǔ)音提醒無(wú)法播報(bào)： 用戶將服務(wù)通知設(shè)置為免打擾

用戶開(kāi)啟了手機(jī)靜音模式或手機(jī)音量過(guò)低

用戶未打開(kāi)微信新消息通知，可引導(dǎo)用戶前往微信-“我”-“設(shè)置”-“新消息通知”中打開(kāi)

用戶未打開(kāi)系統(tǒng)對(duì)微信的通知

用戶開(kāi)啟了低電量模式

用戶版本過(guò)低：需要iOS 8.0.6與安卓8.0.3及以上

# 使用說(shuō)明

# 步驟一：獲取模板 ID

在微信公眾平臺(tái)手動(dòng)配置獲取模板 ID：

登錄 https://mp.weixin.qq.com 獲取模板，如果沒(méi)有合適的模板，可以申請(qǐng)?zhí)砑有履０?#xff0c;審核通過(guò)后可使用。

# 步驟二：獲取下發(fā)權(quán)限

# 步驟三：調(diào)用接口下發(fā)訂閱消息

# 注意事項(xiàng) 用戶勾選 “總是保持以上選擇，不再詢問(wèn)” 之后，下次訂閱調(diào)用 wx.requestSubscribeMessage 不會(huì)彈窗，保持之前的選擇，修改選擇需要打開(kāi)小程序設(shè)置進(jìn)行修改。

# 訂閱消息事件推送

1、當(dāng)用戶觸發(fā)訂閱消息彈框后，用戶的相關(guān)行為事件結(jié)果會(huì)推送至開(kāi)發(fā)者所配置的服務(wù)器地址。

# XML格式示例

1610969440

2

2

# JSON 格式示例

{

"ToUserName": "gh_123456789abc",

"FromUserName": "o7esq5OI1Uej6Xixw1lA2H7XDVbc",

"CreateTime": "1620973045",

"MsgType": "event",

"Event": "subscribe_msg_popup_event",

"SubscribeMsgPopupEvent": [ {

"TemplateId": "hD-ixGOhYmUfjOnI8MCzQMPshzGVeux_2vzyvQu7O68",

"SubscribeStatusString": "accept",

"PopupScene": "0"

}],

}

# 參數(shù)說(shuō)明

參數(shù) 說(shuō)明 ToUserName 小程序帳號(hào)ID

FromUserName 用戶openid

CreateTime 時(shí)間戳

TemplateId 模板id(一次訂閱可能有多個(gè)id)

SubscribeStatusString 訂閱結(jié)果(accept接收；reject拒收)

PopupScene 彈框場(chǎng)景，0代表在小程序頁(yè)面內(nèi)

**2、當(dāng)用戶在手機(jī)端服務(wù)通知里消息卡片右上角“...”管理消息時(shí)，或者在小程序設(shè)置管理中的訂閱消息管理頁(yè)面內(nèi)管理消息時(shí)，相應(yīng)的行為事件會(huì)推送至開(kāi)發(fā)者所配置的服務(wù)器地址。(目前只推送取消訂閱的事件，即對(duì)消息設(shè)置“拒收”)**

# XML 格式示例

1610969440

# JSON 格式示例

{

"ToUserName": "gh_123456789abc",

"FromUserName": "o7esq5OI1Uej6Xixw1lA2H7XDVbc",

"CreateTime": "1610968440",

"MsgType": "event",

"Event": "subscribe_msg_change_event",

"SubscribeMsgChangeEvent": [ {

"TemplateId":"BEwX0BOT3MqK3Uc5oTU3CGBqzjpndk2jzUf7VfExd8",

"SubscribeStatusString": "reject"

}],

}

# 參數(shù)說(shuō)明

參數(shù) 說(shuō)明 ToUserName 小程序帳號(hào)ID

FromUserName 用戶openid

CreateTime 時(shí)間戳

TemplateId 模板id(一次訂閱可能有多個(gè)id)

SubscribeStatusString 訂閱結(jié)果(reject拒收)

**3、調(diào)用訂閱消息接口發(fā)送消息給用戶的最終結(jié)果，會(huì)推送下發(fā)結(jié)果事件至開(kāi)發(fā)者所配置的服務(wù)器地址。**

# XML格式示例

1610969468

1700827132819554304

0

# JSON 格式示例

{

"ToUserName": "gh_123456789abc",

"FromUserName": "o7esq5PHRGBQYmeNyfG064wEFVpQ",

"CreateTime": "1620963428",

"MsgType": "event",

"Event": "subscribe_msg_sent_event",

"SubscribeMsgSentEvent": {

"List": {

"TemplateId": "BEwX0BO-T3MqK3Uc5oTU3CGBqzjpndk2jzUf7VfExd8",

"MsgID": "1864323726461255680",

"ErrorCode": "0",

"ErrorStatus": "success"

}

}

}

# 參數(shù)說(shuō)明

參數(shù) 說(shuō)明 ToUserName 小程序帳號(hào)ID

FromUserName 用戶openid

CreateTime 時(shí)間戳

TemplateId 模板id(一次訂閱可能有多個(gè)id)

MsgID 消息id(調(diào)用接口時(shí)也會(huì)返回)

ErrorCode 推送結(jié)果狀態(tài)碼(0表示成功)

ErrorStatus 推送結(jié)果狀態(tài)碼對(duì)應(yīng)的含義

注意：失敗僅包含因異步推送導(dǎo)致的系統(tǒng)失敗

總結(jié)

以上是生活随笔為你收集整理的小程序消息服务器webapi,小程序订阅消息的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。